页面和 API 端点¶
Datasette Web 应用程序提供了许多不同的页面,可以用来探索相关数据,每个页面都附带一个等效的 JSON API。
顶级索引¶
任何 Datasette 安装的根页面都是一个索引页,列出了所有当前附加的数据库。一些示例:
在 URL 末尾添加 /.json
以获取底层数据的 JSON 版本
数据库¶
每个数据库都有一个页面,列出了该数据库中可用的表、视图和预设查询。如果 执行 SQL 权限已启用(默认开启),则还有一个接口用于对数据执行任意 SQL select 查询。
示例
此页面的 JSON 版本提供了对底层数据的程序化访问
表¶
表页面是 Datasette 的核心:它允许用户交互式地探索数据库表的内容,包括排序、过滤、全文搜索和应用分面。
HTML 界面值得花一些时间探索。与其他页面一样,您可以通过在 URL 路径末尾、任何 ? 查询字符串参数之前附加 .json
来获取 JSON 数据。
此处更详细地描述了查询字符串参数:表参数
您还可以使用表页面交互式地构建 SQL 查询——例如通过应用不同的过滤器和排序顺序——然后点击“查看和编辑 SQL”链接来查看页面使用的 SQL 查询,并进行编辑和重新提交。
一些示例
../antiquities-act%2Factions_under_antiquities_act 是一个用于探索 FiveThirtyEight 发布的“古物法下的行动”数据表的界面。
../global-power-plants?country_long=United+Kingdom&primary_fuel=Gas 是一个过滤后的表页面,显示联合王国的所有燃气发电厂。它包含一些默认分面(使用其 metadata.json 配置)并使用 datasette-cluster-map 插件显示结果的地图。
行¶
Datasette 中每个表的每一行都有自己的 URL。这意味着可以直接链接到单个记录。
包含极长文本内容的表格单元格在表格视图中会根据 截断单元格 HTML 设置进行截断。如果单元格已被截断,该单元格的完整内容将在行页面上提供。
作为其他表外键引用的目标的行将显示一个链接,指向过滤搜索所有引用该行的记录。这是来自成员利益登记数据库的一个示例:
../people/uk.org.publicwhip%2Fperson%2F10001
请注意,此 URL 包含记录的编码主键。
这是同一页面的 JSON 版本