Turso・libSQL クライアント
URL とトークンで Turso データベースに接続するか、libSQL ファイルを開き、SQLite の構文でクエリできます。
概要
- クエリ言語
- SQL
- ドライバー
- 初回使用時にダウンロードlibSQL と共有
- 接続方法
- サービスの API
Turso に接続
Connection Mode で Remote (Turso) を選び、データベースの HTTPS URL と API Token を貼り付けます。トークンは macOS Keychain に保存します。どちらも Turso のダッシュボードか CLI で取得できます。
インポートした libsql:// URL は HTTPS のリモート接続になり、各 URL は一つのデータベースを指します。平文の HTTP URL は暗号化されず、SSH トンネルは使えません。
クエリと編集
libSQL は SQLite の構文を使うため、閲覧、EXPLAIN QUERY PLAN の図、エクスポートは SQLite と同じように動作します。
リモート接続ではトランザクションを使えません。各文は独立した HTTP リクエストで個別にコミットし、BEGIN は「Transactions are not supported in this mode」で失敗します。トランザクションには libSQL として開いたローカルファイルが必要です。Turso データベースはサーバーに組み込まれた拡張を使うため、リモートモードでは SQLite 拡張を読み込みません。制限されたリクエストのエラーには、待機すべき秒数が表示されます。
テーブル、インデックス、トリガー
Structure タブはテーブルの作成、列とインデックスの追加と削除、トリガーの作成、編集、削除を行います。サイドバーからテーブルの名前は変更できますが、ビューはできません。
TablePro は別々の HTTP リクエストを一つのトランザクションにまとめられないため、リモートでの列の並べ替えや外部キーの変更では、確認して実行する再構築スクリプトを生成します。
このページでは Turso 固有の内容を扱います。Safe Mode、AI アシスタント、MCP サーバーなど TablePro のその他の機能は機能ページで紹介しています。
libSQL
自前の sqld サーバー(Hrana v2 pipeline エンドポイント経由)や、Local File モードでこの Mac 上のファイルを開くには libSQL を選びます。ローカルファイルはトランザクションを使え、SQLite 拡張を読み込み、確認後に再構築スクリプトを実行します。Backup Dump と Restore Dump はファイルに対して sqlite3 を実行します。
実行中のアプリが Turso の埋め込みレプリカとして同期しているファイルは、決して開かないでください。二つのプログラムから同時にアクセスすると破損する可能性があります。
- 制限
- Backup Dump はローカルの libSQL ファイルのみ対応し、リモートデータベースは非対応です。
その他
データの移動
テーブルやクエリ結果を CSV、JSON、SQL、XLSX、Markdown、HTML と XML でエクスポートできます。データの読み込みには Turso CLI か sqld サーバーのインポートを使ってください。
制限
- 各接続は 1 つのデータベースです。データベースの切り替えとブランチは非対応です。
- 埋め込みレプリカは非対応です。ローカルファイルは独立して開き、同期しません。
Remote と Local File のどちらを選ぶべきですか?
URL でアクセスする Turso データベースや sqld サーバーには Remote を選びます。この Mac 上の libSQL ファイルには Local File を選び、トランザクション、SQLite 拡張、バックアップも使えます。
Turso CLI のインストールは必要ですか?
不要です。Turso のダッシュボードでもデータベースの URL を確認し、トークンを作成できます。CLI はターミナルからデータを読み込むときに便利です。