翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # のバージョン 1 とバージョン 2 の API の違いを文書化する AWS SDK for Java ドキュメント API は、DynamoDB テーブルでの単一項目としての JSON 形式ドキュメントの使用をサポートしています。V1 の ドキュメント API に対応する API が V2 にありますが、V1 のようにドキュメント API に別のクライアントを使用するのではなく、V2 には DynamoDB 拡張クライアントにドキュメント API 機能が組み込まれています。 V1 では、 [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Item.html) クラスは DynamoDB テーブルからの非構造化レコードを表します。V2 では、非構造化レコードは [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/EnhancedDocument.html) クラスのインスタンスによって表されます。プライマリキーは V2 ではテーブルスキーマで定義され、V1 では項目自体で定義されます。 次の表は、V1 と V2 のドキュメント API の違いを比較したものです。 | ユースケース | V1 | V2 | | --- |--- |--- | | Create a document client | 
AmazonDynamoDB client = ... //Create a client.
DynamoDB documentClient = new DynamoDB(client);
| 
// The V2 Document API uses the same DynamoDbEnhancedClient
// that is used for mapping POJOs.
DynamoDbClient standardClient = ... //Create a standard client.
DynamoDbEnhancedClient enhancedClient = ... // Create an enhanced client.
| | Reference a table | 
Table documentTable = docClient.documentClient("Person");
| 
DynamoDbTable documentTable = enhancedClient.table("Person",  
        TableSchema.documentSchemaBuilder()
              .addIndexPartitionKey(TableMetadata.primaryIndexName(),"id", AttributeValueType.S)
              .attributeConverterProviders(AttributeConverterProvider.defaultProvider())
              .build());
| | **Work with semi-structured data** | | --- | | Put item | 
Item item = new Item()
      .withPrimaryKey("id", 50)
      .withString("firstName", "Shirley");
PutItemOutcome outcome = documentTable.putItem(item);
| 
EnhancedDocument personDocument = EnhancedDocument.builder()
        .putNumber("id", 50)
        .putString("firstName", "Shirley")
        .build();
documentTable.putItem(personDocument);
| | Get item | 
GetItemOutcome outcome = documentTable.getItemOutcome( "id", 50);
Item personDocFromDb = outcome.getItem();
String firstName = personDocFromDb.getString("firstName");
| 
EnhancedDocument personDocFromDb = documentTable
        .getItem(Key.builder()
            .partitionValue(50)
            .build()); 
String firstName = personDocFromDb.getString("firstName");
| | **Work with JSON items** | | --- | | Convert a JSON structure to use it with the Document API | 
// The 'jsonPerson' identifier is a JSON string. 
Item item = new Item().fromJSON(jsonPerson);
| 
// The 'jsonPerson' identifier is a JSON string.
EnhancedDocument document = EnhancedDocument.builder()
        .json(jsonPerson).build());
| | Put JSON | 
documentTable.putItem(item)
| 
documentTable.putItem(document);
| | Read JSON | 
GetItemOutcome outcome = //Get item.
String jsonPerson = outcome.getItem().toJSON();
| 
String jsonPerson = documentTable.getItem(Key.builder()
        .partitionValue(50).build())
        .fromJson();
| ## ドキュメント API の API リファレンスとガイド | | V1 | V2 | | --- | --- | --- | | API リファレンス | [API リファレンス](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/package-summary.html) | [API リファレンス](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/document/package-summary.html) | | ドキュメントガイド | [Amazon DynamoDB デベロッパーガイド](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/JavaDocumentAPIItemCRUD.html) | [拡張ドキュメント API](ddb-en-client-doc-api.md) (本ガイド) | # V1 の式仕様 API から V2 の式 API ドキュメント指向データを操作するための式の作成に役立つ、V1 で利用可能な式仕様 (Xspec) API は、V2 では使用できません。V2 は 式 API を使用します。この API は、ドキュメント指向データと、オブジェクトから項目にマッピングされたデータの両方で動作します。 **** | | V1 | V2 | | --- | --- | --- | | API 名 | 式仕様 (Xspec) API | 式 API | | 動作可能 | [updateItem](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#updateItem-java.lang.String-java.lang.Object-com.amazonaws.services.dynamodbv2.xspec.UpdateItemExpressionSpec-) や [scan](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html#scan-com.amazonaws.services.dynamodbv2.xspec.ScanExpressionSpec-) などのドキュメント API [テーブル](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/dynamodbv2/document/Table.html)クラスのメソッド | DynamoDB 拡張クライアントの両方の API [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) どちらのタイプの API でも、[https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/DynamoDbTable.html) インスタンスを次から取得した場合 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) リクエストオブジェクトを作成するときに、`DynamoDbTable` メソッドで式を使用します。たとえば、[https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/enhanced/dynamodb/model/QueryEnhancedRequest.Builder.html) の `filterExpression` メソッドで使用します。 | | リソース | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sdk-for-java/latest/developer-guide/ddb-v1-xspec-migrate.html) | この Java デベロッパーガイドの[式の情報](ddb-en-client-expressions.md) |