libSQL 接続文字列ビルダー
TypeScript、Python、Go、環境変数向けに、認証トークン付きの Turso または libSQL データベース URL を作成するか、URL を貼り付けて、ホスト、TLS が有効かどうか、トークンの有効期限を確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
libSQL 接続文字列の形式
Turso データベースは、次によってアドレス指定されます libsql://<database>-<organization>.turso.io URL に認証トークン(JWT)を組み合わせます。 libsql:// TLS を意味します。自分のマシンでセルフホストしている sqld は通常、平文の http://127.0.0.1:8080.
デコーダーは、このブラウザー内でトークンのペイロードを読み取り、有効期限と読み取り専用かどうかを表示します。署名の検証は行わず、トークンをどこにも送信しません。
データベースの URL Turso CLI、あらゆる libSQL SDK
libsql://mydb-myorg.turso.io
認証トークン付きの URL Go database/sql、@libsql/client、SQLly
libsql://mydb-myorg.turso.io?authToken=your_auth_token
ローカル sqld セルフホストの libSQL サーバー
http://127.0.0.1:8080
次のようなプレースホルダー your_password 例にすぎません。実際の文字列は上のフォームで組み立ててください。SQLlyをlibSQLに接続する方法の詳細: libSQL 向け SQLly.
libSQL URL のスキームとオプション
@libsql/client のソースと、Turso の SDK リファレンスから。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
libsql:// |
- | - | TLS。クライアントが HTTPS またはセキュア WebSocket を選びます。 |
https:// / wss:// |
- | - | 特定のトランスポート上の TLS。 |
http:// / ws:// |
- | - | ローカルの sqld 向けのプレーンテキスト。 |
file: |
- | - | ローカルの libSQL/SQLite ファイル(埋め込み)。 |
authToken |
- | - | 認証トークンを渡すクエリパラメーター。または次を渡します authToken / auth_token クライアントオプションで。 |
tls |
- | 1 | ?tls=0 の TLS をオフにします libsql://; 明示的なポート番号が必要です。 |
TURSO_DATABASE_URL / TURSO_AUTH_TOKEN |
- | - | Turso のクイックスタートで使われる環境変数名。 |
よくある libSQL の接続エラー
401 Unauthorized
理由: 認証トークンが存在しない、期限切れ、失効している、または別のデータベースや組織のものです。
修正: 新しいトークンは turso db tokens create <database> デコーダーに貼り付けて、有効期限を確認します。
Connection refused on 127.0.0.1:8080
理由: ローカルの sqld が実行されていないか、別のポートで待ち受けています。
修正: sqld を起動します。(例: turso dev はローカル開発サーバー向けの例です)。表示される URL を使用します。
libSQL 接続文字列 FAQ
Turso データベース URL とは何ですか?
libsql://<database>-<organization>.turso.io、次で表示されます turso db show <database>。次で取得した認証トークンとペアリングします turso db tokens create <database>.
認証トークンを URL に含めても安全ですか?
動作します(?authToken=)。ただしこの場合、URL が機密情報となってログやシェル履歴に残ります。トークンは別に渡すことをお勧めします。たとえば TURSO_AUTH_TOKEN 環境変数。
このツールはトークンをチェックしますか?
ブラウザー内でトークンのペイロードをデコードし、有効期限と読み取り専用かどうかを表示します。署名は検証せず、トークンをどこにも送信しません。
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、libSQL などでスキーマ対応の IntelliSense を利用できます。