DynoTable

テーブルの概要とインデックス作成

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

ダイアログの左側のレールには 5 つのセクションがあります:

  • 概要 — テーブルの構造と見積もり。下で説明します。
  • インデックス — オートコンプリートを支えるローカルのフィールドインデックスと、 スキーマのエクスポート。
  • テーブルのインデックス — テーブルのグローバルおよびローカルセカンダリ インデックス。ここで GSI を追加・削除できます。
  • 設定 — TTL、キャパシティモード、削除保護。
  • AI コンテキスト — AI がこのテーブルを扱うときに読むノート。

これらのうち 2 つのセクションは、どちらも「インデックス」と呼ばれる別々のもの を管理しており、その違いは重要です。インデックス はフィールド名と値のローカル インデックスを構築し、これは Team Workspace への公開を あなたが選ばない限りマシンに留まります。一方 テーブルのインデックス は、あなたのアカウントに実際の DynamoDB GSI を作成・削除 します。

DynamoDB テーブルに対する DynoTable のテーブルダイアログ：セクションのレール、キーとインデックス、アイテム数とサイズの推定値、そしてテーブルのステータス、キャパシティ、リージョン、TTL、削除保護。
DynamoDB テーブルに対する DynoTable のテーブルダイアログ：セクションのレール、キーとインデックス、アイテム数とサイズの推定値、そしてテーブルのステータス、キャパシティ、リージョン、TTL、削除保護。

概要

概要セクションにはテーブルの構造がレイアウトされています:

  • プライマリキー — パーティションキー、そしてテーブルにソートキーがあれば それも表示されます。
  • セカンダリインデックス — 各グローバルまたはローカルセカンダリインデックスと そのキー。多くのインデックスを持つテーブルでもコンパクトなまま — 一覧はその場で スクロールします。管理 をクリックすると テーブルのインデックス セクションが開きます。
  • Status · Capacity · Region · TTL · Deletion protection — テーブルの現在の 構成です。キャパシティ、TTL、削除保護の変更は 設定セクションから行います。
  • Items · Size · Avg item — DynamoDB 自身の見積もりです。おおよそ 6 時間ごとに 更新されるため、正確な数ではなく概算値として扱ってください。DynamoDB の推定値 にホバーすると注意書きが表示されます。サンプルのアイテムを アイテムサイズ計算ツールに貼り付ければ、正確な バイト数と、us-east-1 のオンデマンドで読み取りが何 RCU を消費するかが分かります。

Indexing your table

これはダイアログの インデックス セクションです — ローカルのフィールド インデックスであって、DynamoDB のセカンダリインデックスではありません。

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

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

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

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

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

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

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

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

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

スキーマのエクスポート

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

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

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

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

更新日