Mac 用 Turso・libSQL クライアント

接続の種類で Turso を選び、Connection Mode は Remote (Turso) のままにします。.turso.io で終わるデータベースの HTTPS URL を貼り付け、API Token 欄にトークンを入れます。トークンは macOS キーチェーンに保存します。両方とも Turso ダッシュボードや turso db show my-db --url と turso db tokens create my-db で取得できます。

libsql:// URL は HTTPS に書き換え、インポートするとリモート接続を作成します。URL が一つのデータベースを指すため、ホスト、ポート、データベース欄はありません。平文 HTTP ではなく HTTPS の URL を使う場合に暗号化し、SSH トンネルはありません。

libSQL は SQLite 構文を使うため、閲覧、EXPLAIN QUERY PLAN の図、Preview SQL 付きの編集保留、エクスポートは SQLite と同じように動作します。

リモート接続ではトランザクションを使えません。各文は独立した HTTP リクエストで個別にコミットし、BEGIN は「Transactions are not supported in this mode」で失敗します。トランザクションには libSQL の節で説明するローカル libSQL ファイルが必要です。

リモートモードでは SQLite 拡張を読み込みません。Turso データベースはサーバーに組み込まれたものを使います。Turso が接続を制限すると、エラーで再試行までの待機秒数を表示します。

Structure タブ はテーブルの作成、カラムとインデックスの追加・削除、トリガーの作成・編集・削除を行います。サイドバーではテーブルを名前変更できますが、ビューはできません。

リモートデータベースのカラム順や外部キーの変更では、TablePro が再構築スクリプトを生成し、自分で確認・実行します。別々の HTTP リクエストを一つのトランザクションにまとめる必要があるため、代わりに実行することはできません。

TablePro は Turso や libSQL のインポートに対応しません。Turso CLI や sqld サーバーのインポートで読み込んでください。取り出すにはテーブルやクエリ結果を CSV、JSON、SQL、XLSX、Markdown、HTMLとXML に エクスポート できます。

iPhone と iPad アプリには Turso ドライバーがありません。Mac から同期した Turso 接続は一覧に表示しますが、開けません。

初回使用時にダウンロードiPhone と iPad: 開けない

自前の sqld サーバーや Mac 上のファイルには libSQL を選びます。Remote モードは Hrana v2 pipeline エンドポイントを提供する任意の sqld に接続でき、この Mac 上で既定ポート 8080 を使うものにも対応します。--auth-jwt-key-file なしで起動したサーバーはトークンを空欄にし、それ以外はサーバーの鍵と一致する JWT を入力します。

Local File モードはドライバー同梱の SQLite で libSQL ファイルを開き、存在しないパスならフォルダも含めて作成します。ローカルファイルはトランザクションを使い、接続の Extensions リストから SQLite 拡張を読み込み、確認後にカラム順や外部キーの再構築を実行します。

ALTER TABLE … ALTER COLUMN など libSQL だけが理解する文は、SQLite エンジンが受け取るためローカルファイルで失敗します。暗号化 libSQL ファイルは開けません。別の実行中アプリが Turso 埋め込みレプリカとして同期しているファイルは、二つのプログラムの同時アクセスで破損する可能性があるため、決して開かないでください。

Backup Dump と Restore Dump は、ローカル libSQL ファイルに sqlite3 を実行します。

libSQL セットアップガイド （英語）↗