页面和 API 端点

Datasette Web 应用程序提供了许多不同的页面,可以用来探索相关数据,每个页面都附带一个等效的 JSON API。

顶级索引

任何 Datasette 安装的根页面都是一个索引页,列出了所有当前附加的数据库。一些示例:

在 URL 末尾添加 /.json 以获取底层数据的 JSON 版本

数据库

每个数据库都有一个页面,列出了该数据库中可用的表、视图和预设查询。如果 执行 SQL 权限已启用(默认开启),则还有一个接口用于对数据执行任意 SQL select 查询。

示例

此页面的 JSON 版本提供了对底层数据的程序化访问

表页面是 Datasette 的核心:它允许用户交互式地探索数据库表的内容,包括排序、过滤、全文搜索和应用分面

HTML 界面值得花一些时间探索。与其他页面一样,您可以通过在 URL 路径末尾、任何 ? 查询字符串参数之前附加 .json 来获取 JSON 数据。

此处更详细地描述了查询字符串参数:表参数

您还可以使用表页面交互式地构建 SQL 查询——例如通过应用不同的过滤器和排序顺序——然后点击“查看和编辑 SQL”链接来查看页面使用的 SQL 查询,并进行编辑和重新提交。

一些示例

Datasette 中每个表的每一行都有自己的 URL。这意味着可以直接链接到单个记录。

包含极长文本内容的表格单元格在表格视图中会根据 截断单元格 HTML 设置进行截断。如果单元格已被截断,该单元格的完整内容将在行页面上提供。

作为其他表外键引用的目标的行将显示一个链接,指向过滤搜索所有引用该行的记录。这是来自成员利益登记数据库的一个示例:

../people/uk.org.publicwhip%2Fperson%2F10001

请注意,此 URL 包含记录的编码主键。

这是同一页面的 JSON 版本

../people/uk.org.publicwhip%2Fperson%2F10001.json