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

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.

Utilisation du modèle de document .NET dans DynamoDB

AWS SDK for .NET Il fournit des classes de modèles de documents qui englobent certaines des opérations Amazon DynamoDB de bas niveau, simplifiant ainsi 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, octet []

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 collections (liste et tableau) HashSet Type BS (ensemble de binaires), type SS (ensemble de chaînes) ou type NS (ensemble de nombres).

AWS SDK for .NET définit les types pour mapper les types booléens, nuls, de liste et de mappage de DynamoDB à l'API du 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.