DynamoDB API - Amazon DynamoDB

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

DynamoDB API

Amazon DynamoDB を使用するには、アプリケーションでいくつかの簡単な API オペレーションを使用する必要があります。以下に、カテゴリー別にこれらのオペレーションの概要を示します。

コントロールプレーン

コントロールプレーンオペレーションでは、DynamoDB テーブルを作成、管理できます。また、インデックス、ストリーム、およびテーブルに依存する他のオブジェクトを操作できます。

  • CreateTable— 新しいテーブルを作成します。オプションで、1 つ以上のセカンダリインデックスを作成し、テーブルに対して DynamoDB Streams を有効にできます。

  • DescribeTable— プライマリキーのスキーマ、スループット設定、インデックス情報など、テーブルに関する情報を返します。

  • ListTables— リストのすべてのテーブルの名前を返します。

  • UpdateTable— テーブルまたはそのインデックスの設定を変更する、テーブルの新しいインデックスを作成または削除、またはテーブルの DynamoDB Streams 設定を変更します。

  • DeleteTable— テーブルとそのすべての依存オブジェクトを DynamoDB から削除します。

データプレーン

データプレーンオペレーションでは、テーブルのデータで、作成、読み込み、更新、および削除 (CRUD とも呼ばれる) アクションを実行できます。一部のデータプレーンオペレーションでも、セカンダリインデックスからデータを読み込むことができます。

次を使用できます。PartiQL-Amazon DynamoDB 用の SQL 互換クエリ言語を使用してこれらの CRUD 操作を実行するか、DynamoDB の従来の CRUD API を使用して、各操作を個別の API 呼び出しに分割できます。

PartiQL-SQL互換のクエリ言語

  • ExecuteStatement— テーブルから複数の項目を読み取ります。テーブルから単一の項目を書き込む、または更新することもできます。1 つの項目を書き込むか、更新する場合は、プライマリキー属性を指定する必要があります。

  • BatchExecuteStatement— テーブルから複数の項目を書き込み、更新または読み込みます。これは、より効率的ですExecuteStatementアプリケーションでは、項目を書き込むために、1 回のネットワークラウンドトリップのみで済むためです。

Classic API

データの作成

  • PutItem— テーブルに単一の項目を書き込みます。プライマリキー属性を指定する必要がありますが、その他の属性を指定する必要はありません。

  • BatchWriteItem— 最大 25 個の項目をテーブルに書き込みます。これは、PutItem を複数回呼び出すよりも効率的です。アプリケーションで項目を書き込むために、1 回のネットワークラウンドトリップのみで済むためです。また、BatchWriteItem を使用して、1 つ以上のテーブルから複数の項目を削除することもできます。

データの読み取り

  • GetItem— テーブルから単一の項目を取得する 目的の項目のプライマリキーを指定する必要があります。項目全体またはその属性のサブセットのみを取り出すことができます。

  • BatchGetItem— 1 つ以上のテーブルから最大 100 個の項目を取り出します。これは、GetItem を複数回呼び出すよりも効率的です。アプリケーションで項目を読み込むために、1 回のネットワークラウンドトリップのみで済むためです。

  • Query— 特定のパーティションキーがあるすべての項目を取得する パーティションキーの値を指定する必要があります。項目全体またはその属性のサブセットのみを取り出すことができます。オプションで、ソートキーの値に条件を適用し、同じパーティションキーがあるデータのサブセットだけを取り出すことができます。テーブルにパーティションキーとソートキーの両方を持つテーブルがある場合、テーブルでこのオペレーションを使用できます。また、インデックスにパーティションキーとソートキーの両方がある場合、インデックスでこのオペレーションを使用できます。

  • Scan— 指定したテーブルまたはインデックスのすべての項目を取得する 項目全体またはその属性のサブセットのみを取り出すことができます。オプションでフィルタリング条件を適用すると、関心のある値のみを返し、残りは破棄できます。

データの更新

  • UpdateItem— 項目の 1 つ以上の属性を変更します。変更する項目のプライマリキーを指定する必要があります。新しい属性を追加したり、既存の属性を変更または削除したりできます。ユーザー定義の条件を満たす場合にのみ更新が成功するように、条件付きの更新を実行できます。オプションで、アトミックカウンターを実装できます。このカウンタは、他の書き込みリクエストを妨害することなく、数値属性をインクリメントまたはデクリメントします。

データの削除

  • DeleteItem— テーブルから単一の項目を削除します。削除する項目のプライマリキーを指定する必要があります。

  • BatchWriteItem— 1 つ以上のテーブルから最大 25 個の項目を削除します。これは、DeleteItem を複数回呼び出すよりも効率的です。アプリケーションで項目を削除するために、1 回のネットワークラウンドトリップのみで済むためです。また、BatchWriteItem を使用して、1 つ以上のテーブルに複数の項目を追加することもできます。

DynamoDB Streams

DynamoDB Streamsオペレーションでは、テーブルのストリームを有効または無効にし、ストリームに含まれるデータ変更レコードにアクセスすることができます。

  • ListStreams— すべてのストリームのリスト、または特定のテーブルのストリームのみを返します。

  • DescribeStream— Amazon リソースネーム (ARN) およびアプリケーションが最初のいくつかのストリームレコードの読み込みを開始できる場所など、ストリームに関する情報を返します。

  • GetShardIterator— 戻り値はシャードイテレータこれは、ストリームからレコードを取得するためにアプリケーションが使用するデータ構造です。

  • GetRecords— 特定のシャードイテレーターを使用して 1 つ以上のストリームレコードを取得します。

Transactions

トランザクションによって不可分性、一貫性、分離性、耐久性 (ACID) が実現されるため、アプリケーション内でのデータの精度を維持することがさらに容易になります。

次を使用できます。PartiQL-Amazon DynamoDB 用の SQL 互換クエリ言語を使用してトランザクション操作を実行するか、DynamoDB のクラシック CRUD API を使用して、各操作を個別の API 呼び出しに分割できます。

PartiQL-SQL互換のクエリ言語

  • ExecuteTransaction— テーブル内または複数のテーブル間の複数の項目に対して CRUD オペレーションを実行できるバッチオペレーションで、オールオアナッシングの結果が保証されます。

Classic API

  • TransactWriteItems— バッチ操作で、PutUpdate, およびDeleteオペレーションを、テーブル内または複数のテーブル間の複数の項目に適用し、オールオアナッシングの結果が保証されています。

  • TransactGetItems— バッチ操作で、Get1 つ以上のテーブルから複数の項目を取得する