Interrogation d’une table DynamoDB avec des lectures fortement cohérentes à l’aide d’un kit AWS SDK - Amazon DynamoDB

Interrogation d’une table DynamoDB avec des lectures fortement cohérentes à l’aide d’un kit AWS SDK

Les exemples de code suivants montrent comment interroger une table avec des lectures fortement cohérentes.

  • Configuration du niveau de cohérence pour les requêtes DynamoDB.

  • Utilisation de lectures fortement cohérentes pour obtenir les données les plus à jour.

  • Compréhension des compromis entre une cohérence à terme et une forte cohérence.

Java
SDK pour Java 2.x

Interrogation d’une table DynamoDB avec une cohérence de lecture configurable à l’aide du kit AWS SDK for Java 2.x.

import software.amazon.awssdk.services.dynamodb.DynamoDbClient; import software.amazon.awssdk.services.dynamodb.model.AttributeValue; import software.amazon.awssdk.services.dynamodb.model.DynamoDbException; import software.amazon.awssdk.services.dynamodb.model.QueryRequest; import software.amazon.awssdk.services.dynamodb.model.QueryResponse; import software.amazon.awssdk.services.dynamodb.model.ResourceNotFoundException; import java.util.HashMap; import java.util.Map; import java.util.logging.Level; import java.util.logging.Logger; public QueryResponse queryWithConsistentReads( final String tableName, final String partitionKeyName, final String partitionKeyValue, final boolean useConsistentRead) { CodeSampleUtils.validateTableParameters(tableName, partitionKeyName, partitionKeyValue); // Create expression attribute names for the column names final Map<String, String> expressionAttributeNames = new HashMap<>(); expressionAttributeNames.put(EXPRESSION_ATTRIBUTE_NAME_PK, partitionKeyName); // Create expression attribute values for the column values final Map<String, AttributeValue> expressionAttributeValues = new HashMap<>(); expressionAttributeValues.put( EXPRESSION_ATTRIBUTE_VALUE_PK, AttributeValue.builder().s(partitionKeyValue).build()); // Create the query request final QueryRequest queryRequest = QueryRequest.builder() .tableName(tableName) .keyConditionExpression(KEY_CONDITION_EXPRESSION) .expressionAttributeNames(expressionAttributeNames) .expressionAttributeValues(expressionAttributeValues) .consistentRead(useConsistentRead) .build(); try { final QueryResponse response = dynamoDbClient.query(queryRequest); LOGGER.log(Level.INFO, "Query successful. Found {0} items", response.count()); return response; } catch (ResourceNotFoundException e) { LOGGER.log(Level.SEVERE, "Table not found: {0}", tableName); throw e; } catch (DynamoDbException e) { LOGGER.log(Level.SEVERE, "Error querying with consistent reads", e); throw e; } }
  • Pour plus d’informations sur l’API, consultez Requête dans la référence d’API AWS SDK for Java 2.x.

JavaScript
SDK pour JavaScript (v3)

Interrogation d’une table DynamoDB avec une cohérence de lecture configurable à l’aide du kit AWS SDK pour JavaScript.

const { DynamoDBClient, QueryCommand } = require("@aws-sdk/client-dynamodb"); /** * Queries a DynamoDB table with configurable read consistency * * @param {Object} config - AWS SDK configuration object * @param {string} tableName - The name of the DynamoDB table * @param {string} partitionKeyName - The name of the partition key * @param {string} partitionKeyValue - The value of the partition key * @param {boolean} useConsistentRead - Whether to use strongly consistent reads * @returns {Promise<Object>} - The query response */ async function queryWithConsistentRead( config, tableName, partitionKeyName, partitionKeyValue, useConsistentRead = false ) { try { // Create DynamoDB client const client = new DynamoDBClient(config); // Construct the query input const input = { TableName: tableName, KeyConditionExpression: "#pk = :pkValue", ExpressionAttributeNames: { "#pk": partitionKeyName }, ExpressionAttributeValues: { ":pkValue": { S: partitionKeyValue } }, ConsistentRead: useConsistentRead }; // Execute the query const command = new QueryCommand(input); return await client.send(command); } catch (error) { console.error(`Error querying with consistent read: ${error}`); throw error; } }
  • Pour plus d’informations sur l’API, consultez Requête dans la référence d’API AWS SDK pour JavaScript.

Python
SDK pour Python (Boto3)

Interrogation d’une table DynamoDB avec activation de l’option lectures fortement cohérentes à l’aide du kit AWS SDK pour Python (Boto3).

import time import boto3 from boto3.dynamodb.conditions import Key def query_with_consistent_read( table_name, partition_key_name, partition_key_value, sort_key_name=None, sort_key_value=None, consistent_read=True, ): """ Query a DynamoDB table with the option for strongly consistent reads. Args: table_name (str): The name of the DynamoDB table. partition_key_name (str): The name of the partition key attribute. partition_key_value (str): The value of the partition key to query. sort_key_name (str, optional): The name of the sort key attribute. sort_key_value (str, optional): The value of the sort key to query. consistent_read (bool, optional): Whether to use strongly consistent reads. Defaults to True. Returns: dict: The response from DynamoDB containing the query results. """ # Initialize the DynamoDB resource dynamodb = boto3.resource("dynamodb") table = dynamodb.Table(table_name) # Build the key condition expression key_condition = Key(partition_key_name).eq(partition_key_value) if sort_key_name and sort_key_value: key_condition = key_condition & Key(sort_key_name).eq(sort_key_value) # Perform the query with the consistent read option response = table.query(KeyConditionExpression=key_condition, ConsistentRead=consistent_read) return response
  • Pour de plus amples informations sur l’API, consultez Requête dans la référence d’API AWS du kit SDK pour Python (Boto3).

Pour obtenir la liste complète des guides de développement AWS SDK et des exemples de code, consultez Utilisation de DynamoDB avec un kit AWS SDK. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes de SDK.