入门¶

体验在线演示¶

第一次体验 Datasette 的最佳方式是通过演示

global-power-plants.datasettes.com 提供了一个全球发电厂的可搜索数据库，使用了来自世界资源研究所的数据，并使用 datasette-cluster-map 插件进行渲染。
fivethirtyeight.datasettes.com 展示了 Datasette 如何处理从 FiveThirtyEight GitHub 仓库导入的 400 多个数据集。

跟随教程¶

Datasette 有几个教程可以帮助您开始使用该工具。请尝试以下之一

使用 Datasette 探索数据库展示了如何使用 Datasette Web 界面探索新数据库。
使用 Datasette 学习 SQL 介绍了 SQL，并展示了如何使用该查询语言来查询您的数据。
使用 sqlite-utils 和 Datasette 清理数据指导您如何使用 sqlite-utils 将 CSV 文件转换为数据库，以便您可以使用 Datasette 进行探索。

使用 Datasette Lite 在浏览器中运行 Datasette¶

Datasette Lite 是使用 WebAssembly 打包的 Datasette，因此它可以在您的浏览器中完全运行，无需 Python Web 应用程序服务器。

您可以直接将 CSV、SQLite 或原始 SQL 文件的 URL 传递给 Datasette Lite，以便在浏览器中探索这些数据。

此示例链接打开 Datasette Lite 并加载来自 Northwestern University Knight Lab 的 SQL Murder Mystery 示例数据库。

使用 Glitch 无需安装即可尝试 Datasette¶

Glitch 是一个免费的在线工具，可以直接从您的 Web 浏览器构建 Web 应用程序。您可以使用 Glitch 试用 Datasette，而无需在自己的计算机上安装任何软件。

这是 Glitch 上的一个演示项目，您可以将其用作自己实验的基础

glitch.com/~datasette-csvs

Glitch 允许您“重混（remix）”任何项目以创建自己的副本并在浏览器中开始编辑。您可以通过单击此按钮来重混 datasette-csvs 项目

找到一个 CSV 文件并将其拖到 Glitch 文件浏览器面板上 - datasette-csvs 将自动将其转换为 SQLite 数据库（使用 sqlite-utils）并允许您使用 Datasette 开始探索它。

如果您的 CSV 文件包含 latitude 和 longitude 列，您可以使用 Glitch 文件编辑器取消 requirements.txt 文件中 datasette-cluster-map 那行的注释，从而在地图上将其可视化。

需要一些数据？尝试西雅图市的 Public Art Data - 点击“导出”并选择“CSV”以下载为 CSV 文件。

有关其工作原理的更多信息，请参阅在 Glitch 上运行 Datasette。

在自己的电脑上使用 Datasette¶

首先，请遵循安装说明。现在您可以使用以下命令在您的计算机上针对 SQLite 文件运行 Datasette

datasette path/to/database.db

这将启动一个在端口 8001 上的 Web 服务器 - 访问 http://localhost:8001/ 以访问 Web 界面。

添加 -o 以便在 Datasette 启动后自动打开浏览器

datasette path/to/database.db -o

在 OS X 上使用 Chrome？您可以像这样针对您的浏览器历史记录运行 Datasette

datasette ~/Library/Application\ Support/Google/Chrome/Default/History --nolock

--nolock 选项会忽略任何文件锁。这是安全的，因为 Datasette 将以只读模式打开文件。

现在访问 http://localhost:8001/History/downloads 将显示一个 Web 界面，供您浏览下载数据

http://localhost:8001/History/downloads.json 将以 JSON 格式返回该数据

{
    "database": "History",
    "columns": [
        "id",
        "current_path",
        "target_path",
        "start_time",
        "received_bytes",
        "total_bytes",
        ...
    ],
    "rows": [
        [
            1,
            "/Users/simonw/Downloads/DropboxInstaller.dmg",
            "/Users/simonw/Downloads/DropboxInstaller.dmg",
            13097290269022132,
            626688,
            0,
            ...
        ]
    ]
}

http://localhost:8001/History/downloads.json?_shape=objects 将以更方便的格式以 JSON 格式返回该数据

{
    ...
    "rows": [
        {
            "start_time": 13097290269022132,
            "interrupt_reason": 0,
            "hash": "",
            "id": 1,
            "site_url": "",
            "referrer": "https://www.dropbox.com/downloading?src=index",
            ...
        }
    ]
}