Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

JSONsupport dans Amazon DynamoDB

Les JSON données de AWS SDK for .NET support lorsque vous travaillez avec Amazon DynamoDB. Cela vous permet d'obtenir plus facilement des données JSON mises en forme à partir de tables DynamoDB et d'y insérer JSON des documents.

Obtenir les données d'une table DynamoDB au format JSON

L'exemple suivant montre comment obtenir des données au format d'une table DynamoDB : JSON

// using Amazon.DynamoDBv2;
// using Amazon.DynamoDBv2.DocumentModel;

var client = new AmazonDynamoDBClient();
var table = Table.LoadTable(client, "AnimalsInventory");
var item = table.GetItem(3, "Horse");

var jsonText = item.ToJson();
Console.Write(jsonText);
      
// Output:
//   {"Name":"Shadow","Type":"Horse","Id":3}

var jsonPrettyText = item.ToJsonPretty();
Console.WriteLine(jsonPrettyText);
      
// Output:
//   {
//     "Name" : "Shadow",
//     "Type" : "Horse",
//     "Id"   : 3
//   }

Dans l'exemple précédent, la ToJson méthode de la Document classe convertit un élément du tableau en une chaîne JSON formatée. La méthode GetItem de la classe Table permet de récupérer cet élément. Pour déterminer l'élément à obtenir, dans cet exemple, la GetItem méthode utilise la clé hash-and-range primaire de l'élément cible. Pour déterminer la table à partir de laquelle obtenir l'élément, la LoadTable méthode de la Table classe utilise une instance de la AmazonDynamoDBClient classe et le nom de la table cible dans DynamoDB.

Insérer des données de JSON format dans une table DynamoDB

L'exemple suivant montre comment utiliser le JSON format pour insérer un élément dans une table DynamoDB :

// using Amazon.DynamoDBv2;
// using Amazon.DynamoDBv2.DocumentModel;

var client = new AmazonDynamoDBClient();
var table = Table.LoadTable(client, "AnimalsInventory");
var jsonText = "{\"Id\":6,\"Type\":\"Bird\",\"Name\":\"Tweety\"}";
var item = Document.FromJson(jsonText);

table.PutItem(item);

Dans l'exemple précédent, la FromJson méthode de la Document classe convertit une chaîne JSON formatée en élément. L'élément est inséré dans la table par l'intermédiaire de la méthode PutItem de la classe Table, qui utilise l'instance de la classe Document contenant l'élément. Pour déterminer la table dans laquelle insérer l'élément, la LoadTable méthode de la Table classe est appelée, en spécifiant une instance de la AmazonDynamoDBClient classe et le nom de la table cible dans DynamoDB.

Conversions des types de données DynamoDB vers JSON

Chaque fois que vous appelez la ToJson méthode de la Document classe, puis que, sur les JSON données obtenues, vous appelez la FromJson méthode pour reconvertir les JSON données en instance de Document classe, certains types de données DynamoDB ne sont pas convertis comme prévu. En particulier :

Plus d'informations

Pour plus d'informations et des exemples de programmation JSON avec DynamoDB avec AWS SDK for .NET le, voir :