关于 Datasette
Datasette 是一个命令行工具,用于探索 SQLite 数据库和其他结构化数据。它生成可交互的 Web 界面供数据检查和查询,同时支持通过命令行进行脚本化操作和数据导出。
主要功能
- 01通过 Web 界面交互式查询和过滤 SQLite 数据库中的数据
- 02使用 inspect 命令检查数据库架构、大小和统计信息
- 03导出查询结果为 JSON、CSV 等多种格式
适用场景
- 01编码 Agent 需要理解和验证数据库内容时快速检查数据
- 02发布和共享结构化数据集供团队访问和分析
- 03自动化数据探索工作流中集成数据检查步骤
安装
选择你的系统或包管理器,复制命令到终端运行。
安装完成后运行datasette --version确认安装成功。
命令示例
常用命令按使用顺序排列。
详细介绍
用于探索和发布数据的开源多功能工具
Datasette 是一款用于探索和发布数据的工具。它能帮助人们将各种形态和规模的数据发布为交互式、可探索的网站,并提供配套 API。
Datasette 面向数据记者、博物馆策展人、档案管理员、地方政府、科学家、研究人员,以及所有希望与世界分享数据的人。
探索演示,观看项目介绍视频,或通过 GitHub Codespaces 试用。
- datasette.io 是项目官方网站
- 最新的 Datasette 新闻
- 完整文档:https://docs.datasette.io/
- 示例:https://datasette.io/examples
- 当前
main分支的在线演示:https://latest.datasette.io/ - 有疑问、反馈,或想聊聊这个项目?加入我们的 Discord
想要及时了解项目动态?订阅 Datasette 新闻通讯,获取 Datasette 生态系统的最新动态、技巧和窍门。
安装
如果你使用 Mac,通过 Homebrew 安装 Datasette 是最简单的方式:
brew install datasette
你也可以使用 pip 或 pipx 安装:
pip install datasette
Datasette 要求 Python 3.11 或更高版本。我们还提供了详细的安装说明,介绍 Docker 等其他选项。
基本用法
datasette serve path/to/database.db
这将在端口 8001 上启动 Web 服务——访问 http://localhost:8001/ 即可使用 Web 界面。
serve 是默认子命令,你也可以省略它。
在 OS X 上使用 Chrome?你可以这样让 datasette 读取浏览器历史记录:
datasette ~/Library/Application\ Support/Google/Chrome/Default/History --nolock
现在访问 http://localhost:8001/History/downloads,即可通过 Web 界面浏览下载记录:

metadata.json
如果想在生成的 datasette 网站中包含许可和来源信息,可以使用类似下面的 JSON 文件:
{
"title": "Five Thirty Eight",
"license": "CC Attribution 4.0 License",
"license_url": "http://creativecommons.org/licenses/by/4.0/",
"source": "fivethirtyeight/data on GitHub",
"source_url": "https://github.com/fivethirtyeight/data"
}
将其保存为 metadata.json,然后像这样运行 Datasette:
datasette serve fivethirtyeight.db -m metadata.json
许可和来源信息会显示在索引页和页脚中,也会包含在 API 生成的 JSON 中。
datasette publish
如果已配置 Heroku 或 Google Cloud Run,Datasette 可以通过一条命令将一个或多个 SQLite 数据库部署到互联网:
datasette publish heroku database.db
或者:
datasette publish cloudrun database.db
这会创建一个同时包含 datasette 应用和指定 SQLite 数据库文件的 docker 镜像。随后,它会将该镜像部署到 Heroku 或 Cloud Run,并提供一个 URL,供你访问生成的网站和 API。
详情请参阅文档中的发布数据。
Datasette Lite
Datasette Lite 是使用 WebAssembly 打包的 Datasette,因此可以完全在浏览器中运行,无需 Python Web 应用服务端。请阅读 Datasette Lite 文档了解更多信息。