テーブル統計

開いているすべてのテーブルには、Visual モードでも PartiQL モードでも、タブツールバーに Stats ボタン — 棒グラフのアイコン — があります。これはテーブルごとのパネルを開き、テーブルの形状をひと目で確認でき、テーブルをインデックス化してオートコンプリートにフィールドを教え、推論したスキーマを TypeScript、Zod、 JSON Schema としてエクスポートできます。

概要

パネルの上部にはテーブルの構造がレイアウトされています:

プライマリキー — パーティションキー、そしてテーブルにソートキーがあればそれも表示されます。
セカンダリインデックス — 各グローバルまたはローカルセカンダリインデックスとそのキー。多くのインデックスを持つテーブルでもコンパクトなまま — 一覧はその場でスクロールします。
Items · Size · Avg item — DynamoDB 自身の見積もりです。おおよそ 6 時間ごとに更新されるため、正確な数ではなく概算値として扱ってください。DynamoDB estimate にホバーすると注意書きが表示されます。

Indexing your table

インデックス化されたフィールドがないと、Workbench と PartiQL のクエリエディタはフィールドや値の候補を出しません。キーワード、関数、演算子の補完は引き続き機能します。

インデックスは次の機能にデータを供給します:

クエリエディタ: Workbench と PartiQL のフィールド・値の候補、および Workbench の未知の列のチェック。
アイテムエディタ: キー以外のフィールド名の候補と、すべての値の候補はインデックスのデータから来ます。PK、SK、GSI、LSI のキー名はテーブル定義に由来し、インデックスは不要です。
ビジュアルなテーブルツール: 列セレクタ、ビジュアルなクエリ・スキャンのフィルター、Smart Table のノード、リレーションシップの属性ピッカー。
AI: アクティブなテーブルの @column の候補、スキーマツール、両方のクエリエディタでのゴーストテキストとインライン編集へのスキーマヒント、そして結合された Smart Table の列の正規化。
統計と共有: Indexed fields の一覧、推論スキーマのエクスポート、そして Team Workspace へのインデックスの公開。

インデックスによる補完と AI のゴーストテキストは別物です。Workbench と PartiQL のインデックス候補にゲートはありません。AI のゴーストテキストは既定でオフで、有効なライセンスが必要です。

アイテムエディタでは、DynamoDB JSON モードのときインデックスによる値の補完は抑制されます。フィールド名の補完はそこでも機能します。

インデックスができる、または大きくなる経路は 5 つあります:

手動スキャン: Index table は既定で最大 10,000 アイテムをスキャンします。 Reindex は現在のインデックスをクリアしてから、同じ上限までスキャンします。幅の広いテーブルやロングテールのテーブルでは、上限を超えて初めて現れる属性は欠けたままになります。
取得したページ: テーブルのページを取得すると、DynoTable はインデックスをクリアせずにそれらのアイテムを追加します。
Smart Table: 最初に取得したページがインデックスの起点になります。
Team Workspace: チームメイトが公開したインデックスは、ローカルでのスキャンなしにインポートできます。インポートが何を置き換えるかは Team Workspaceを参照してください。
AI による起動: スキーマが見つからないとき、AI は回答の前にベストエフォートで約 100 アイテムのインデックスを作ります。既存のインデックスには追加されます。

手動スキャンは進捗をライブで表示し、DynamoDB の読み取りを消費します。インデックス化の後、Indexed fields には見つかった属性が、commonData.status のようなドット区切りのネストしたパスも含めて一覧表示されます。

各フィールドには、観測された型と、サンプリングしたアイテム全体で必須だったか任意だったかが表示されます。フィールドがいくつかを超えると、素早く見つけられるようフィルターボックスが表示されます。Clear index はローカルのインデックスを削除します。

スキーマのエクスポート

インデックス化されたテーブルから、Export を開いて形式を選ぶと、アイテムを型付きのスキーマに変換できます:

TypeScript — interface。
Zod — z.object(...) スキーマ（Standard-Schema 互換）。
JSON Schema — draft 2020-12。

クリップボードにコピーするか、ファイルに保存します。すべてのエクスポートは、それが サンプリングしたアイテムから推論された ものだという注記とともに開始されます — 有力な出発点であって、権威ある契約ではありません。任意かどうかは、インデックス化の際に各属性がどれくらいの頻度で出現したかを反映します。プライマリキー属性は常に必須としてマークされます。

これはあなたのデータの形状のスキーマであり — データそのもののエクスポートとは別物です。