SQLly Embedded
SQLly を自社の Web アプリ内でホストする方法: パッケージの内容、ブリッジ、アプリ、sqlly.app の組み合わせ方、どこから始めるか。
SQLly Embedded は、SQLly のブラウザービルドを独自の Web アプリに組み込みます。ユーザーは、サイトのページ上でフルワークベンチを利用できます。IntelliSense 付きの SQL エディター、オブジェクトエクスプローラー、結果グリッド、チャート、実行プランが含まれます。データベースのパスワードはすべてサーバー側に保管されます。各ユーザーグループに表示する接続を決めるのはお客様で、SQLly ブリッジがライセンスを適用します。
実行するもの
| ピース | 何ができるか | 実行される場所 |
|---|---|---|
| Webアプリ | ユーザーのサインインを処理し、どのユーザーが プロファイル (各ユーザーが利用できる接続のセット)を決め、ブリッジに起動トークンを要求し、SQLly を読み込むページを配信します。 | サーバー |
SQLly ブリッジ (sqlly-bridge embedded) | プロファイルとその資格情報を保持し、起動トークンを発行し、ブラウザーの WebSocket を受け付け、セッションごとに 1 つのエンジンを実行し、シート数を集計し、sqlly.app でライセンスを確認します。 | サーバーはアプリの隣に |
SQLly エンジン (sqlly-cli) | 1 つのブラウザーセッションの間だけ、データベースに接続してクエリを実行します。起動と停止を行うのはブリッジで、これと通信するものは他にありません。 | サーバー(ブリッジの子プロセス) |
SQLly web バンドル (web/) | WebAssembly にコンパイルされた SQLly アプリ。アプリが配信する静的ファイル。 | ユーザーのブラウザー |
| sqlly.app | ライセンスを発行し、ブリッジがチェックインするたび(20 分ごと)に、有効期間の短い許可に署名します。オフラインライセンスがここに接続することはありません。 | 当社側 |
パッケージには、次のものも含まれます: サンプル管理アプリ (Node.js 製、依存関係なし)で、お使いのアプリが行うことをひととおり実装しています。プロファイル、ラベル、ユーザーの管理画面と、各ユーザーに対して SQLly を開くサインインページです。実行してフロー全体を確認し、その後は自分のアプリに置き換えるか、このコードをもとに作ってください。
このセクションでは
- 仕組み
- 動作原理: ブリッジ、セッションごとのエンジン、起動トークン、署名付きライセンス付与、チェックイン、シート、Origin ルール、資格情報の保管場所。
- クイックスタート
- SQLly Embeddedパッケージをlocalhost上で5分で実行します: ブリッジとサンプルアプリを起動し、ライセンスをリンクし、プロファイルを追加して、ユーザーとしてSQLlyを開きます。
- サンプルアプリツアー
- SQLly Embedded に同梱されているサンプル管理アプリを画面ごとに案内するツアー: ステータスとライセンス、プロファイルと接続、ラベル、ユーザー、SQLly の起動。
- 独自のアプリをビルド
- 手順どおりに進めるガイド: 自分のウェブアプリから SQLly Embedded ブリッジを動かします。プロファイルの保存、起動トークンの発行、ブラウザ版の提供、シートの解放、インストールのリンクまで扱います。
- クエリを指定して SQLly を開く
- SQLly をクエリタブに直接起動します。スクリプト、その接続とデータベース、パラメーター値、カーソルが、「SQLly で開く」ボタン用の起動トークンとともに送信されます。
- API リファレンス
- SQLly Embedded ブリッジの管理 API のすべてのエンドポイント (OpenAPI (swagger.json) ドキュメントから生成) と、sqlly.app とのリンク用エンドポイント。
- ライセンス
- プラン、シート数、セッション、インスタンス、ドメイン、チェックイン、猶予期間、オフラインライセンスファイル、ブリッジが取り得るすべてのライセンス状態と、それぞれの対処法。
- 本番運用へ
- TLS、リバースプロキシ、ライセンス対象ドメイン、サービスマネージャー、バックアップ、Content-Security-Policy と分離ヘッダー、そして SQLly Embedded 向けの本番環境チェックリスト。
パスを選ぶ
- 試用を検討中ですか? 読む 仕組み、その後、次に従ってください クイックスタート。sqlly.app のアカウントにはすべて、3 か月間の無料トライアル(ユーザー 1 人、ブリッジ 1 つ)が付いているので、試すために何かを購入する必要はありません。
- 統合をお考えですか? まずは サンプルアプリツアー アプリが用意すべきものを確認し、そこから順に進めます 独自のアプリをビルド 次を使って API リファレンス (または読み込む swagger.json API ツールにそのまま取り込めます)。
- デプロイ中ですか? 読む ライセンス シート、ドメイン、各ライセンス状態の意味について、次に 本番運用へ.
要点
- 資格情報がブラウザに届くことはありません。 プロファイルのパスワードはブリッジの状態ディレクトリに保存されます。ブラウザーが受け取るのは接続リスト(名前、エンジン、ラベル)だけで、クエリはブリッジの WebSocket 経由で送信します。
- シートは同時ユーザー数です。 ユーザーは、SQLly が開いている間、または有効期限が切れていない起動トークンを持っている間、シートを占有します。作業が終われば、その時点で解放されます。有料プランでは、ユーザーごとに 4 つのタブを使えます。
- ライセンスごとに 1 つのドメイン - すべてのサブドメインを含めて。ブリッジは、次の条件を満たすブラウザーのみを受け入れます
Originがそのドメインにあります (さらにlocalhost開発中) - SQLly がサポートするすべてのエンジン ブリッジ経由で動作します: SQL Server、Azure SQL、PostgreSQL、MySQL、MariaDB、SQLite、DuckDB、ClickHouse、Oracle、libSQL/Turso、Redis、Valkey、およびクラウドバリアント。
- 接続型またはオフライン。 接続型ライセンスは 20 分ごとに sqlly.app にチェックインします。オフラインライセンスは署名付きファイルで、ブリッジがローカルで検証し、外部に問い合わせることは一切ありません。
プランと価格が掲載されているのは SQLly Embedded ページ。お使いのプラットフォーム用のパッケージを次からダウンロードします ダウンロード、ライセンス、キー、リンク済みのインストールを次で管理します 埋め込みページ.