Utilisation du modèle de document .NET dans DynamoDB - Amazon DynamoDB
Types de données pris en charge

Utilisation du modèle de document .NET dans DynamoDB

AWS SDK pour .NET fournit des classes de modèle de document qui encapsulent certaines opérations Amazon DynamoDB de bas niveau pour simplifier davantage votre codage. Dans le modèle de document, les classes principales sont Table et Document. La classe Table fournit des méthodes d’opération de données telles que PutItem, GetItem et DeleteItem. Elle fournit aussi les méthodes Query et Scan. La classe Document représente un seul élément d’une table.

Les classes de modèle de document précédentes sont disponibles dans l’espace de noms Amazon.DynamoDBv2.DocumentModel.

Note

Vous ne pouvez pas utiliser les classes de modèle de document pour créer, mettre à jour et supprimer des tables. Cependant, le modèle de document ne prend pas en charge les opérations de données les plus courantes.

Types de données pris en charge

Le modèle de document prend en charge un ensemble de types de données .NET primitifs et de types de données de collections. Le modèle prend en charge les types de données primitifs suivants.

  • bool

  • byte

  • char

  • DateTime

  • decimal

  • double

  • float

  • Guid

  • Int16

  • Int32

  • Int64

  • SByte

  • string

  • UInt16

  • UInt32

  • UInt64

Le tableau suivant résume le mappage des types .NET précédents aux types DynamoDB.

Type primitif .NET Type DynamoDB

Tous les types de numéro

N (type Number)

Tous types de chaînes

S (type String)

MemoryStream, byte[]

B (type Binary)

bool N (type de nombre). 0 représente false et 1 représente true.
DateTime S (type String). Les valeurs DateTime sont stockées comme chaînes de format ISO-8601.
Guid S (type String).
Types de collection (liste, HashSet et tableau) Type BS (ensemble de binaires), type SS (ensemble de chaînes) ou type NS (ensemble de nombres).

AWS SDK pour .NET définit les types de mappages (boolean (booléen), null (nul), list (liste) et map (mappage) de DynamoDB à l’API de modèle de document .NET :

  • Utilisez DynamoDBBool pour le type booléen.

  • Utilisez DynamoDBNull pour le type null.

  • Utilisez DynamoDBList pour le type list.

  • Utilisez Document pour le type map.

Note

  • Les valeurs binaires vides sont prises en charge.

  • La lecture des valeurs de chaîne vides est prise en charge. Les valeurs d’attribut de chaîne vides sont prises en charge dans les valeurs d’attribut de type de chaîne Set lors de l’écriture dans DynamoDB. Les valeurs d’attribut de chaîne vides de type String et les valeurs de chaîne vides contenues dans le type List ou Map sont supprimées des demandes d’écriture.