mcpField
T
Turso CLI

Turso CLI

公式
docs.turso.techデータベース・データ326turso3 週間前に更新
リポジトリ公式サイト

Turso CLI について

turso は LibSQL ベースの分散 SQLite サービス Turso の公式 CLI です。データベースと地理的レプリカの作成、組織と認証トークンの管理、対話型 SQL シェルの起動ができます。エッジコンピューティングとオフライン環境での SQLite 利用に対応しています。

主な機能

  1. 01データベースと地理的レプリカの作成、一覧表示、削除
  2. 02アプリケーション接続用の長期認証トークンの生成と管理
  3. 03対話型 SQL シェルを起動してクエリを実行しデータを参照
  4. 04データベースグループとアクセス権限の管理

活用シーン

  1. 01グローバル分散 SQLite レプリカをセットアップしてアプリケーション遅延を低減
  2. 02開発およびテスト環境向けに一時的なデータベースアクセストークンを生成
  3. 03コマンドラインからデータベースコンテンツを直接探索してデバッグ

インストール

OS またはパッケージマネージャーを選び、コマンドをターミナルで実行します。

$
brew install tursodatabase/tap/turso

インストール後にturso --versionを実行して確認します。

コマンド例

よく使うコマンドを使う順に並べています。

01
turso auth login
02
turso db create my-db
03
turso db shell my-db

詳細

Turso CLI

Go License

これは Turso のコマンドラインインターフェイス(CLI)です。

ドキュメント

リファレンスドキュメントを ご利用いただけます。

ガイド付きの説明については、 Turso クイックスタートドキュメントをご覧ください。

インストール

パッケージマネージャー
Homebrew(macOS、Linux、WSL)
brew install tursodatabase/tap/turso

まだ設定していない場合は、homebrew の シェル補完も設定してください。

CLI の既存のインストールをアップグレードするには、次のコマンドを実行します。

brew upgrade turso
インストールスクリプト
curl -sSfL https://get.tur.so/install.sh | bash
Go
go install github.com/tursodatabase/turso-cli/cmd/turso@latest
ソースからビルドする
cd cmd/turso && go install

使用方法

認証

新規ユーザーの場合は、次のコマンドでサインアップできます。

turso auth signup

すでにアカウントをお持ちの場合は、次のコマンドで認証します。

turso auth login

デフォルトのブラウザーでウェブページが開き、GitHub を使って認証できます。 認証に成功すると、turso auth login はアクセストークンを受け取り、設定ファイルに保存します。

データベースを作成する

生成された名前でデータベースを作成するには、次のコマンドを実行します。

turso db create

または、次のようにデータベース名を指定できます。

turso db create <database name>

既存のデータベースからブランチを作成するには、次のコマンドを実行します。

turso db branch <source-database> <target-database>
SQL シェルを起動する

sqlite3 に似た対話型 SQL シェルを起動するには、次のコマンドを実行します。

turso db shell <database name>
対話型シェルを使わずに SQL コマンドを実行する

対話型 SQL シェルを使わずにコマンドを実行することもできます。

turso db shell <database name> <sql query>
データベースをレプリケートする

まず、利用可能なロケーションを一覧表示し、レプリケート先のロケーションを選択します。

turso db locations

次に、データベースをレプリケートするには、次のコマンドを実行します。

turso db replicate <database name> <location>
データベースを一覧表示する

データベースを一覧表示するには、次のコマンドを実行します。

turso db list
データベースを削除する
turso db destroy <database name>

設定

turso プログラムは、ローカルマシン上の次のベースディレクトリにある turso/settings.json ファイルに設定を保存します。

OS設定ディレクトリ
Linux$XDG_CONFIG_HOME または $HOME/.config
macOS$HOME/Library/Application Support/turso

コメント