// 無料のツール

libSQL 接続文字列ビルダー

TypeScript、Python、Go、環境変数向けに、認証トークン付きの Turso または libSQL データベース URL を作成するか、URL を貼り付けて、ホスト、TLS が有効かどうか、トークンの有効期限を確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。

SQLly でこの接続を開く

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 を利用できます。