表统计

每一张打开的表在标签页工具栏中都有一个统计按钮 —— 条形图图标 —— 在可视化模式和 PartiQL 模式下都可用。它会打开一个每张表专属的面板,让你一眼看清表的结构,可以为表建立索引,从而让自动补全知道你的字段,并将推断出的 schema 导出为 TypeScript、Zod 或 JSON Schema。

表统计面板:键和索引、大小估算、索引状态,以及已索引字段列表。
表统计面板:键和索引、大小估算、索引状态,以及已索引字段列表。

概览

面板顶部展示了表的结构:

  • 主键 —— 分区键,以及排序键(如果表有排序键)。
  • 二级索引 —— 每个全局或本地二级索引及其键。即使一张表有很多索引,也能保持紧凑 —— 列表会就地滚动。
  • 条目数 · 大小 · 平均条目 —— DynamoDB 自身的估算值。它们大约每六小时刷新一次,因此请把它们当作大致数字,而非精确计数。将鼠标悬停在 DynamoDB estimate 上可查看相关说明。

为表建立索引

当 DynoTable 知道你的条目实际包含什么内容时,筛选、PartiQLAI 聊天能给出好得多的字段和值补全建议。点击建立表索引,即可对表扫描一次,发现每一个属性及其常见值。

  • 索引会实时运行并带有进度条。大表需要几分钟,并会产生正常的 DynamoDB 读取费用。
  • 完成后,已索引字段列表会显示每一个属性 —— 包括以点分隔路径表示的嵌套属性,例如 commonData.status —— 及其类型,以及它在扫描过的行中是必需还是可选
  • 当字段超过少数几个时,会出现一个筛选框,方便你快速找到某个字段。
  • 数据变化后用重建索引来刷新;用清除索引将其移除。

导出 schema

在一张已索引的表上,打开导出并选择一种格式,即可将你的条目转换为带类型的 schema:

  • TypeScript —— 一个 interface
  • Zod —— 一个 z.object(...) schema(兼容 Standard-Schema)。
  • JSON Schema —— draft 2020-12。

将它复制到剪贴板,或保存到一个文件。每次导出的开头都会有一条说明,表明它是从采样的条目中推断得出的 —— 是一个很好的起点,而非权威约定。可选性反映的是每个属性在索引过程中出现的频率;主键属性始终被标记为必需。

这是关于你数据结构的 schema —— 不同于对数据本身的导出

更新于