Dynamodb-api-interface

提供:Dev Guides
移動先:案内検索

DynamoDB-APIインターフェイス

DynamoDBは、テーブル操作、データ読み取り、データ変更のための強力なAPIツールの幅広いセットを提供します。

Amazonは、低レベルAPIを呼び出すのではなく、 AWS SDK (Java SDKなど)を使用することをお勧めします。 ライブラリにより、低レベルAPIとの対話が直接不要になります。 ライブラリは、認証、シリアル化、接続などの一般的なタスクを簡素化します。

テーブルを操作する

DynamoDBは、テーブル管理用に5つの低レベルアクションを提供します-

  • CreateTable -これによりテーブルが生成され、ユーザーが設定したスループットが含まれます。 複合または単純にかかわらず、主キーを設定する必要があります。 また、1つまたは複数のセカンダリインデックスを許可します。
  • ListTables -これは、現在のAWSユーザーのアカウント内のすべてのテーブルのリストを提供し、エンドポイントに関連付けられています。
  • UpdateTable -これはスループットとグローバルセカンダリインデックスのスループットを変更します。
  • DescribeTable -これはテーブルのメタデータを提供します。たとえば、状態、サイズ、インデックス。
  • DeleteTable -これは単にテーブルとそのインデックスを消去します。

データを読む

DynamoDBは、データ読み取り用に4つの低レベルアクションを提供します-

  • GetItem -主キーを受け入れ、関連するアイテムの属性を返します。 デフォルトの最終的に一貫した読み取り設定の変更を許可します。
  • BatchGetItem -1つまたは複数のテーブルのオプションを使用して、主キーを介して複数のアイテムで複数のGetItem要求を実行します。 その返品は100アイテム以下であり、16MB未満でなければなりません。 最終的に一貫した読み取りと強い一貫性のある読み取りが可能になります。
  • スキャン-すべてのテーブル項目を読み取り、最終的に一貫した結果セットを生成します。 条件によって結果をフィルタリングできます。 インデックスの使用を避け、テーブル全体をスキャンするため、予測可能性が必要なクエリには使用しないでください。
  • クエリ-単一または複数のテーブルアイテムまたはセカンダリインデックスアイテムを返します。 パーティションキーに指定された値を使用し、比較演算子を使用して範囲を絞り込むことができます。 両方のタイプの一貫性のサポートが含まれており、各応答はサイズが1MBの制限に従います。

データを修正する

DynamoDBは、データ変更のために4つの低レベルアクションを提供します-

  • PutItem -これは、新しいアイテムを生成するか、既存のアイテムを置き換えます。 同一のプライマリキーが検出されると、デフォルトでアイテムが置き換えられます。 条件演算子を使用すると、デフォルトを回避し、特定の条件下でのみアイテムを置換できます。
  • BatchWriteItem -これは、複数のPutItem要求とDeleteItem要求の両方を実行し、複数のテーブルで実行します。 1つの要求が失敗しても、操作全体には影響しません。 キャップのサイズは25アイテム、サイズは16MBです。
  • UpdateItem -既存のアイテム属性を変更し、特定の条件下でのみ更新を実行する条件演算子の使用を許可します。
  • DeleteItem -主キーを使用してアイテムを消去し、条件演算子を使用して削除条件を指定することもできます。