接続のエクスポートとインポート

実装済み

サーバー、データベース、ログイン(パスワードを含める・含めないを選択可)、さらにラベルの色とアイコンを、含める内容を細かく選んで1つのファイルにまとめ、別のマシンへ移せます。

A 接続ファイル 作業環境一式をマシンやチームメイトの間で 1 ステップで移行します。サーバー、そのサーバー上のデータベース、使うログイン、(選択すれば)そのパスワードに加えて、接続が属するクライアント、プロジェクト、環境のラベルも一緒に(各ラベルの 色 そして アイコン。どちらのエクスポートも同じファイルを書き出し、違いはパスワードを含むかどうかだけです。SQLly からエクスポートするか、チームにプロビジョニングするために手で書いて、SQLly のどのコピーにもインポートできます。

パスワードを含むファイルは、それらを平文で保持します。 だからこそ便利であり、同時に機密性が高いのです。SQLly はエクスポートしたファイルを自分だけが読める状態で保存し、インポート時にすべてのパスワードをシステムのキーチェーンへ移し、ファイルのコピーは一切保持しません。信頼できる経路で送り、インポート後は削除してください。接続を共有するには なし パスワードを渡さずに共有したいときは、 ファイル → 接続をエクスポート….

接続のエクスポート

選択 ファイル → 接続をエクスポート… パスワードのないファイル用、または ファイル → 接続をエクスポート (認証情報付き)… はパスワードを含むファイル用です (どちらもコマンドパレットからも実行できます)。どちらも、保存されているすべての接続をツリーで表示するピッカーが開きます: 各 サーバー (ホスト、ポート、エンジン)と、次の データベース その下に保存したもの。「接続をエクスポート (認証情報付き)」を選ぶと、ファイルにパスワードが平文で含まれるという警告が上部に表示された状態で開きます。

  • 一部またはすべてのサーバーを選択 - サーバーにチェックを入れると配下のデータベースがすべて対象になり、もう一度チェックすると解除されます。
  • 一部またはすべてのデータベースを選択できます - サーバーを展開して、個々のデータベースにチェックを入れます。サーバーの行には、そのうち何個のデータベースが選択されているかが表示されます。
  • すべてを選択 / クリア すべてを一括で切り替えます。最初はすべてが選択されています。
  • 選択したものだけが引き継がれます - 選択した接続が使う共有ログイン、トンネルプロファイル、クライアント/プロジェクト/環境のラベルが含まれ、それ以外は含まれません。

クリック エクスポート 保存先を選びます。接続エディターにあるすべての設定が、各接続のサインイン方法を含めて、どちらの場合も一緒に書き出されます。認証情報ありの場合、SQLlyは各パスワード、パスフレーズ、トークンをキーチェーンから読み出してファイルに書き込みます。なしの場合は、すべてのシークレットを除外し、保存前にファイルにシークレットが含まれていないことを確認します。書き出す複数の接続で使われているログインは、共有ログインとして1回だけ書き込まれます。1つの接続だけで使われているログインは、その接続に書き込まれます。ラベルのアイコンはファイルに埋め込まれるため、そのファイル単体で完結します。

SQLly
パスワードを含めるかどうかの選択と保存先のファイルを備えた、SQLLY の接続エクスポートダイアログパスワードを含めるかどうかの選択と保存先のファイルを備えた、SQLLY の接続エクスポートダイアログ
接続のエクスポートダイアログ: パスワードを含めるかどうかを選び、ファイルを指定します。

接続をインポート

選択 ファイル → 接続をインポート… ファイルを選びます。同じコマンドで、パスワードありのファイルもなしのファイルも、以前のバージョンのSQLlyで「接続のエクスポート」により保存されたファイルも読み込めます。何かを変更する前にファイル全体を検証し、1つでも誤ったエントリがあれば、すべての問題を一覧表示して何もインポートしないため、中途半端に適用されたインポートは起こりません。設定名の打ち間違いは、黙ってスキップされず、報告されます。インポートした接続は、すぐにサーバーエクスプローラーに表示されます。

  • パスワードはキーチェーンに保存されます - macOS ではキーチェーン、Windows では資格情報マネージャー、Linux では Secret Service に保存され、SQLly の接続ファイルには決して入りません。ステータスバーに、何件取り込まれたかが表示されます。
  • ラベルは名前でマージされます - 既存のクライアント、プロジェクト、環境は、ファイルで設定されていない項目をそのまま保持し、ファイルに記載された安全スイッチだけが変更されます。
  • 共有ログインはその場で更新されます - 同じ名前とユーザー名で保存済みのログインには新しいパスワードが設定されるため、それをすでに使っているすべての接続は動作し続けます。
  • パスワードなし、問題なし - パスワードのないログイン(認証情報なしでエクスポートされたファイルでは、すべてのログインが該当)もそのままインポートされ、SQLly は初回接続時にパスワードを尋ねます。

Redis Insight からのインポート

Redis Insight で、データベースを選択し、次を選びます エクスポート (チェックを入れる パスワードを含める それらを引き継ぎたい場合)。SQLly では次を選びます 他のツールからインポート… エクスポートしたファイル(プレーンなJSON、またはRedis Insightが受け付けるbase64形式)を選びます。各データベースは、ホスト、ポート、論理データベース、ACLユーザー名、SSHトンネル、TLS設定を持つRedis接続になります。

  • TLS が無効化されることはありません - TLS(または CA やクライアント証明書)付きでエクスポートされたデータベースは、暗号化された状態でインポートされます: CA の検証 Redis Insight がサーバー証明書を検証していた場合、 必須 そうでなかったのに。証明書と鍵の内容は SQLly のデータフォルダーに PEM ファイルとして保存され (鍵を読めるのは本人だけ)、接続はそのファイルを参照します。
  • シークレットはキーチェーンに保存されます - エクスポートに含まれるパスワード、SSH パスワード、キーのパスフレーズは、接続ファイルと同じ方法で保存され、保存済み接続ファイルには決して書き込まれません。あとでエクスポートを削除してください。そこには平文で入っています。
  • Azure Entra データベース Microsoft Entra のサインインでインポートします。接続エディタで Azure アカウントを選択します。
  • クラスターデータベース Redis Cluster 接続としてインポートされ、指定されたノードがシードになります(Redis Insight でスタンドアロンを強制するよう設定されていた場合は 1 ノードとして)。 Sentinel データベースはSentinel接続としてインポートされ、マスターグループ、センチネルのパスワード(キーチェーンに移動)、マスター自身のサインインが引き継がれ、引き継げなかったものはステータスバーに一覧表示されます。

接続ファイルに含められるもの

セクション含まれるもの
接続任意の数のサーバーと、各サーバー上の任意の数のデータベース: エンジン、ホスト、ポート、データベース、環境、クライアントとプロジェクト、サインイン方法、(資格情報を保存する場合は)パスワード、TLS モードと証明書ファイル、接続とステートメントのタイムアウト、アプリケーション名、起動時 SQL、接続ごとの安全設定、お気に入りの星、マスキングルール、リレールート、インラインの SSH トンネル、プロキシ、または Kubernetes のポートフォワード。
共有ログイン複数の接続で使える、名前付きのログイン(ユーザー名と、認証情報ファイル内のパスワード)。
トンネルプロファイル名前を付けた SSH(ジャンプホスト)、プロキシ、Kubernetes のチェーンに加え、SSH パスワードとキーのパスフレーズを認証情報ファイルに保存します。
クライアント、プロジェクト、環境名前、色、アイコン画像(ファイルに埋め込み)、およびクエリ保護の各設定。

SQLly がサポートするサインイン方法はすべて記述できます: ユーザー名とパスワード、Windows 統合セキュリティ、Microsoft Entra (ブラウザーまたはデバイスコード)、AWS RDS IAM、Google Cloud SQL IAM、libSQL / Turso トークン。SQLite と DuckDB のファイルにはサインインは不要です。

手作業で書く場合

接続ファイルはプレーンな JSON なので、管理者が 1 つ書けば、チームにすぐ使える設定を渡せます。接続の name, engine、そして server は必須です。それ以外はすべて、接続エディターが使うのと同じ既定値になります。このファイルは、読み取り専用ログインを共有する1台のサーバー上の2つのデータベース、独自のパスワードを持つ2台目のサーバー、アイコン付きの色付きクライアントを追加します:

{
  "format": "sqlly-credentials",
  "version": 1,
  "clients": [
    { "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
  ],
  "sql_auth_accounts": [
    { "name": "Reader", "username": "ro", "password": "ro-secret" }
  ],
  "connections": [
    { "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
      "client": "Acme", "environment": "production",
      "authentication": { "type": "sql-login", "account": "Reader" },
      "tls": { "mode": "verify-full" } },
    { "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
      "client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
    { "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
      "authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
  ]
}
  • エンジン ゆるに書き込むことができます - postgres, PostgreSQL, mssql, sql-server, mysql, sqlite, duckdb, clickhouse, redis、など。
  • 色 は、 #RGB, #RRGGBB、または #RRGGBBAA.
  • アイコン ベース64 - a data:image/…;base64, 最大 1 MB の PNG、JPEG、GIF、WebP、BMP、ICO、SVG 画像の URI、またはプレフィックスなしの base64。
  • 環境 は、 local, dev, test, staging、または production.

事前構成済み接続(Docker、Kubernetes、マネージドマシン)

ファイルを一度だけインポートする代わりに、SQLly に次のことをさせられます プロビジョニング する接続を、起動のたびに次の場所で用意します - デスクトップアプリ、 sqlly-cli エージェントコマンド、およびセルフホスト型 sqlly-bridge embedded サーバー内で実行することもできます。次の SQLLY_PROVISIONED_CONNECTIONS_FILE ファイルに(または次を置く provisioned-connections.json を SQLly の設定フォルダー内、次のファイルの隣に connections.json)、および/または次のいずれかを設定します SQLLY_CONNECTION_<NAME> 接続ごとに、その URL を保持する変数が 1 つあります。ファイルは上記の接続ファイル形式を使用します(format そして version 省略できます。また、 connections が読み取られます)。どの接続にも次を指定できます url の代わりに、エンジン、サーバー、ポート、データベース、サインインの各フィールドを置き換えます:

{
  "connections": [
    { "name": "Cache",
      "url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
      "environment": "production" },
    { "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
      "authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
      "tls": { "mode": "verify-full" } }
  ]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=...        # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
  • Sentinel URL - redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>]、次を付けて rediss+sentinel:// TLS 用、および valkey+sentinel:// / valkeys+sentinel:// Valkey 用。 ?sentinelPassword= はセンチネル自体のパスワードを設定し、 ?preferReplica=true 読み取り専用スクリプトをレプリカに送ります。ポートを省略したセンチネルは 26379 を使います。同じ URL は、接続エディタの「URL を貼り付け」でもそのまま使えます。
  • ${VARIABLE} ファイルのどこでも(または SQLLY_CONNECTION_ URL)は、その環境変数に置き換えられます。次のように書きます $${ リテラルの ${.
  • パスワードはファイルに保存されません - パスワード、トークン、 redis_sentinel_password、URL パスワード、または sentinelPassword ちょうど次のように書かれた ${VARIABLE} は、SQLly が接続するたびに環境から読み取られ、プロファイルにコピーされたり、どこかに保存されたりすることはありません。
  • マネージド、読み取り専用 - プロビジョニングされた接続はお使いの接続と並んで表示されますが、次の場所に書き込まれることはありません connections.json、これらには「保存」と「削除」は使えません。代わりにファイルや変数を変更するか、次を使用してください 複製 編集可能な自分用のコピーを作成するには。
  • 項目が 1 つ壊れていても、ほかの項目はブロックされません - 不明な設定、未設定の変数、読み取れない URL がある接続は、その 1 件だけがスキップされ、どの接続でなぜかを示す警告が出力されます。すでに使われている名前を持つ後続の接続も同じようにスキップされます。
  • ブリッジ側 - sqlly-bridge embedded 読み取り専用プロファイルとして提供します provisioned (次からも --provisioned-connections <file>)。起動トークンでは他のプロファイルと同じように名前を指定でき、状態ディレクトリには書き込まれません。