ターミナルで開く
実装済み接続情報を入力済みの状態で、psql、mysql、sqlcmd、redis-cli などをそのまま開けます。
右クリック サーバー オブジェクトエクスプローラーで、次を選択します ターミナルで開く、または次を実行 ターミナルで接続を開く コマンドパレットから実行すると、アクティブな接続が使用されます。SQLly は、エンジン独自のコマンドラインクライアントを実行する新しいターミナルウィンドウを開き、接続済みの状態にします。ホスト、ポート、データベース、ユーザー、TLS モードは、接続プロファイルから自動入力されます。
| エンジン | クライアント | パスワードの渡し方 |
|---|---|---|
| PostgreSQL と互換製品 | psql | PGPASSWORD 環境変数。TLSモードは次に指定します PGSSLMODE、プロファイルの CA ファイル、クライアント証明書、キーは、それぞれ次の変数に入ります PGSSLROOTCERT, PGSSLCERT、そして PGSSLKEY。CA ファイルのない検証プロファイルは、次を使用します PGSSLROOTCERT=system、システムのトラストストア(psql 16 以降)。 |
| MySQL / MariaDB | mysql | MYSQL_PWD 環境変数。CAファイルとクライアント証明書は次に設定します --ssl-ca, --ssl-cert、そして --ssl-key。MySQL クライアントは CA ファイルに対してしか証明書を検証できないため、CA ファイルのない検証プロファイルはシステムの CA バンドルを使用します。それもない場合(Windows)は、セッションは暗号化されますが検証は行われず、その旨が SQLly に表示されます。 |
| SQL Server | sqlcmd | SQLCMDPASSWORD 環境変数。統合認証は次を使用します -E。SQLly は、インストールされている sqlcmd の次を読み取ります -? バナーでgo-sqlcmdとMicrosoftのODBC版sqlcmdを見分け、そのバージョンが受け付ける形で暗号化を指定します: -Nm (必須。加えて -C サーバー証明書を信頼するには)、または -No (任意。暗号化なしのプロファイル向け。sqlcmd 18 は暗号化を要求するため)go-sqlcmd 1.4 以降および ODBC sqlcmd 18 以降の場合; -Ntrue / -Nfalse 古い go-sqlcmd の場合、および単独の -N デフォルトでは暗号化されないODBC sqlcmd 17以前の場合。 |
| Redis | redis-cli | REDISCLI_AUTH 環境変数。Unixソケットのプロファイルは次を使用します -s。CA ファイルとクライアント証明書は次に指定します --cacert, --cert、そして --key. |
| ClickHouse | clickhouse-client | CLICKHOUSE_PASSWORD 環境変数。 clickhouse-client ClickHouse のネイティブプロトコルを使用します(SQLly が使う HTTP プロトコルではありません)。そのため、接続の ネイティブポート (接続エディターの ClickHouse 専用フィールド)が設定されている場合はそれを使います。設定されていない場合は、プロファイルの HTTP ポートをネイティブポートに対応付けます。8123 は 9000、8443 は 9440 です。それ以外のポートでは SQLly は 9000(TLS では 9440)と仮定し、起動後にその旨を表示します。カスタム CA やクライアント証明書は、clickhouse-client 自身の設定ファイルで指定する必要があります。 |
| DuckDB / SQLite | duckdb / sqlite3 | パスワード不要。データベースファイルを直接開きます。 |
| Oracle | sqlplus、または SQL*Plus がインストールされていない場合は SQLcl | どちらのクライアントも環境変数からパスワードを読み取らないため、ターミナルでパスワードの入力を求めます。 |

パスワードがコマンドラインに渡されることはありません
コマンドライン上の内容は、他のユーザーが次の方法で見ることができます: ps、そのため、SQLly が組み立てる引数にシークレットが含まれることはありません。パスワードはクライアントプロセスの環境変数でのみ受け渡されます。Linux と Windows では、ターミナルがその環境を直接引き継ぐため、パスワードがディスクに書き込まれることはありません。macOS の Terminal.app は環境を引き継がないため、SQLly は代わりに短いランチャースクリプトを書き出します。このスクリプトはあなただけが読み取れ、あなただけが開けるフォルダーに置かれます。最初の行で自分自身を削除し、その後クライアントを起動します。Terminal が実行しなかった場合、SQLly は 5 分後にそれを削除します。
ホスト名、ユーザー名、データベース名は、どんな文字を含んでいてもシェルコマンドとして解釈されることはありません。Linux ではクライアントに別々の引数として渡し、macOS ではシェル用にクォートし、Windows ではコマンドプロンプトの特殊文字をすべてエスケープして小さなランチャースクリプトに書き込みます。Windows のスクリプトにパスワードは含まれません。
Cloud IAM サインイン(AWS RDS と Google Cloud SQL)は、SQLly が接続するときにトークンを発行し、そのトークンはターミナルには渡されないため、クライアントがパスワードを求めます。ここには新しいトークンを貼り付けてください。
SSH トンネルとリレー
SSH トンネル接続は、トンネルのローカルポート経由で行われます。そのためクライアントは 127.0.0.1 に接続することになり、サーバー名に対する証明書チェックには追加の設定が必要です。psql は、トンネルへの接続に次のものを使います PGHOSTADDR 実際のホスト名を検証しつつ、redis-cli は実際の名前を SNI として送信します。sqlcmd は -F を実際のホスト名 (証明書で想定されるホスト名) にして送るもので、インストール済みのバージョンがそのスイッチに対応している場合 (go-sqlcmd 1.9 以降、ODBC sqlcmd 18 以降) です。mysql クライアントは証明書チェーンだけを確認し (MariaDB のクライアントは確認せずに暗号化だけします)、古い sqlcmd は証明書を拒否することがあります。SQLly はこれらの注意点を起動後に表示します。ClickHouse の場合、トンネルが運ぶのは SQLly が使う HTTP ポートなので、「ターミナルで開く」は同じ SSH 経路 (またはプロキシ) を通ってネイティブポート (接続のネイティブポート、または 9000 / 9440) への 2 つ目のフォワードを開き、clickhouse-client をそこへ向けます。このフォワードは接続を切断するか SQLly を終了するまで開いたままです。切断すると閉じて、ターミナルセッションも終わります。トンネル越しの clickhouse-client は検証済みの証明書を 127.0.0.1 に対して確認するため、拒否される可能性があることを SQLly が注記します。Kubernetes のポートフォワードが運べるのは接続自体のポートだけなので、Kubernetes 経由の ClickHouse ではターミナルを開けません。リレーブリッジ経由の接続ではターミナルを開けません。クライアントがこのマシンからデータベースへ直接到達する必要があるためです。

どのターミナルが開くか
- macOS: Terminal.app を Launch Services 経由で開きます。オートメーションの許可プロンプトは表示されません。
- Linux:
$TERMINAL設定した場合は、x-terminal-emulator、GNOME Terminal、Konsole、Xfce Terminal、kitty、Alacritty、WezTerm、およびxterm。SQLly は、起動できる最初のものを使用します。$TERMINALそれらのいずれかを指定すると、そのターミナル固有のコマンド実行方法が使われます。クライアントの終了後もウィンドウは開いたままなので、エラーを確認できます。Enter を押すと閉じます。 - Windows: クライアントの終了後も開いたままになる新しいコンソールウィンドウ。任意のキーを押すと閉じます。
SQLly は、ダンプツールを見つけるのと同じ方法でクライアントを見つけます。設定でパスの上書きを指定している場合は、ここにも適用されます。クライアントがインストールされていない場合、メニュー項目は無効になり、何をインストールすればよいかが表示されます。ターミナルクライアントが引き継げない接続の場合も、理由が示されたうえで無効になります。インメモリの DuckDB と SQLite、HTTP 経由の libSQL/Turso、SQL Server の Entra サインイン、リレー接続が該当します。DuckDB は 1 つのファイルを同時に 1 つのプログラムしか使えないため、SQLly が DuckDB ファイルを開いている間は、「ターミナルで開く」を選ぶと先に切断するよう求められます。パスワードがまだキーリングにあるプロファイルは、先に解決されます。パスワードがない場合は、クライアントがパスワードの入力を求めます。ブラウザー版ではターミナルを開けません。