クイックスタート

SQLly Embeddedパッケージをlocalhost上で5分で実行します: ブリッジとサンプルアプリを起動し、ライセンスをリンクし、プロファイルを追加して、ユーザーとしてSQLlyを開きます。

これは、ブリッジ、そのエンジン、サンプル管理アプリという SQLly Embedded パッケージ全体を 1 台のマシンで実行します。すべての処理は localhost、sqlly.app アカウントの無料トライアルでまかなえます。必要なのは Node.js 20 以降と、SQLly から接続できるデータベース。

実行する

  1. ダウンロードして解凍 お使いのプラットフォーム用の SQLly Embedded パッケージを、次から ダウンロード (Linux x86-64 と arm64、macOS Apple シリコン、Windows x86-64 と arm64)。Linux では、次のコマンドで展開します。 tar -xzf そのため、実行ファイルはパーミッションを保持します。

    スクリプトから利用する場合は、プラットフォームごとに、そのプラットフォーム向けにビルドされた最新のパッケージを常に配信する固定のリンクがあります。お使いのプラットフォーム向けにリリースがビルドされていない場合は、ビルドされた中で最新のものが配信されます。

    プラットフォーム最新のパッケージ
    Linux x86-64https://sqlly.app/download/embedded/latest/linux-amd64
    Linux arm64https://sqlly.app/download/embedded/latest/linux-arm64
    macOS Apple siliconhttps://sqlly.app/download/embedded/latest/macos-arm64
    Windows x86-64https://sqlly.app/download/embedded/latest/windows-amd64
    Windows arm64https://sqlly.app/download/embedded/latest/windows-arm64
    curl -fsSL -o sqlly-embedded.tar.gz https://sqlly.app/download/embedded/latest/linux-amd64
    tar -xzf sqlly-embedded.tar.gz

    追加 /version それらのいずれか(たとえば /download/embedded/latest/linux-amd64/version)。ダウンロードせずに、バージョンとファイル名を JSON で取得できます

  2. すべて開始 次から sqlly-embedded フォルダ:

    macOS / Linux
    ./start-sample.sh
    Windows
    start-sample.cmd

    スクリプトは次を作成します .env から .env.example、Node.js を確認し、初回実行時に共有の管理トークンを生成し、ブリッジを起動し、その管理 API を待ってから、サンプルアプリを次で起動します http://127.0.0.1:8090.

  3. 管理者としてサインイン で http://127.0.0.1:8090/admin を伴う sqlly-admin / GoodLittlePiggy。(サンプルアプリは、そのパスワードを変更するまで、ループバック以外では待ち受けません。)

  4. ライセンスをリンクします。 オン ステータス、次をクリックします sqlly.app に接続、次に 承認するには sqlly.app を開いてください。sqlly.app にサインインし、管理ページのコードと一致しているか確認し、ライセンス(トライアルでも可)を選んで、次をクリックします 承認する。ステータスページが自動で検知し、リンクされたアカウントを表示します。このインストールには専用のキーが発行され、ブリッジは再起動後もそれを保持します。

    設定のほうが好みなら、キーの生成先は 埋め込みページ 、そして設定します SQLLY_EMBEDDED_LICENSE_KEY 内 .env 開始前に。オフラインプランでは次が設定されます SQLLY_EMBEDDED_LICENSE_FILE 代わりにダウンロードしたファイルへ。

  5. プロファイルを作成します。 プロファイル → プロファイルの作成、名前を付けて、接続を追加します。エンジンを選び、サーバー、データベース、サインイン情報を入力します。次をクリックします テスト ブリッジが到達できることを確認します。結果は保存する前にフォームに表示されます。その後、 起動 そのプロファイルで SQLly を新しいタブで開きます。

  6. ユーザーを追加します。 ユーザー → ユーザーを作成 ユーザー名、パスワード、プロファイルを指定します。次を開きます http://127.0.0.1:8090/ プライベートウィンドウで、そのユーザーとしてサインインし、次をクリックします SQLly を開く。これが、ユーザーが実際に得る体験です。

話を戻すと、 ステータス そのユーザーが今持っているシートが表示されます。その人の SQLly タブを閉じれば、シートは解放されます。

次の設定 .env

設定何のためのものか
SQLLY_EMBEDDED_LICENSE_KEY接続型のライセンスキー(sqe_…)。空のままにすると、代わりに管理ページからリンクできます。
SQLLY_EMBEDDED_LICENSE_FILEオフラインライセンスファイル。両方を設定しないでください。
SQLLY_EMBEDDED_MANAGE_TOKENブリッジと管理アプリの間で共有されるシークレット。初回実行時に生成されます。
SQLLY_EMBEDDED_DOMAINアプリを配信するドメイン。localhost では空欄にします。設定すると、最初のチェックインで未バインドのライセンスがバインドされます。
SQLLY_EMBEDDED_PUBLIC_URLその wss://…/proxy リバースプロキシの背後にある場合に、ブラウザーが使用する URL。
SQLLY_EMBEDDED_STATE_DIRブリッジがプロファイル、ライセンスキャッシュ、リンクされたキーを保持する場所。

ブリッジのすべてのフラグには環境変数が用意されており、完全な一覧は次のページにあります 本番運用へ.

パッケージの内容

パスこれは何か
bin/sqlly-bridgeSQLly ブリッジ; sqlly-bridge embedded … このパッケージが使用するモードです。
bin/sqlly-cliブリッジがセッションごとに起動するエンジン。ブリッジのそばに置いてください。
web/SQLly ブラウザービルド: index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg。プラットフォームに依存しません。
sample-app/サンプルの管理・ランチャーアプリ。 server.js はルーティングです。 lib/bridge.js 完全な管理APIクライアント、 lib/credentials.js 認証情報ドキュメントを作成します。
start-sample.sh, start-sample.cmdブリッジとサンプルアプリを一緒に起動します。次の場所から .env.

次へ

まずは サンプルアプリツアー 各画面を確認するか、直接次へ進みます アプリを自分でビルドする.