mcpField
T
Turso CLI

Turso CLI

官方
docs.turso.tech数据库与数据326turso3 周前更新
代码仓库访问官网

关于 Turso CLI

turso 是 Turso（基于 LibSQL 的分布式 SQLite 服务）的官方命令行工具。可以创建数据库和地理位置副本、管理组织和认证令牌、启动交互式 SQL shell。支持嵌入式副本工作流，便于在边缘计算和离线场景中使用 SQLite。

主要功能

  1. 01创建、列举和删除数据库及其地理位置副本
  2. 02生成和管理长期认证令牌用于应用连接
  3. 03启动交互式 SQL shell 执行查询和浏览数据
  4. 04管理数据库组和访问权限

适用场景

  1. 01为全球应用设置分布式 SQLite 副本以降低延迟
  2. 02为开发和测试环境生成临时数据库访问令牌
  3. 03直接通过命令行探索和调试数据库内容

安装

选择你的系统或包管理器，复制命令到终端运行。

$
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 Shell 补全。

要升级现有的 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 Shell

你可以通过以下命令启动一个类似于 sqlite3 的交互式 SQL Shell：

turso db shell <database name>
不使用交互式 Shell 运行 SQL 命令

你也可以不使用交互式 SQL Shell，直接运行命令：

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

评论

支持 Markdown