Utilizzo del modello documentale .NET in DynamoDB - Amazon DynamoDB
Tipi di dati supportati

Utilizzo del modello documentale .NET in DynamoDB

AWS SDK per .NET fornisce classi di modelli di documenti che includono alcune operazioni di Amazon DynamoDB di basso livello che semplificano ulteriormente la codifica. Nel modello di documento, le classi primarie sono Table e Document. La classe Table fornisce metodi di operazioni di dati come PutItem, GetItem e DeleteItem. Essa inoltre fornisce i metodi Query e Scan. La classe Document rappresenta un singolo item in una tabella.

Le classi precedenti di modello del documento sono disponibili nello spazio dei nomi Amazon.DynamoDBv2.DocumentModel.

Nota

Non puoi utilizzare le classi del modello di documento per creare, aggiornare ed eliminare tabelle. Tuttavia, il modello di documento supporta la maggior parte delle operazioni sui dati comuni.

Tipi di dati supportati

Il modello di documento supporta un insieme di tipi di dati .NET primitivi e tipi di raccolte dati. Il modello attualmente supporta i seguenti tipi di dati primitivi:

  • bool

  • byte

  • char

  • DateTime

  • decimal

  • double

  • float

  • Guid

  • Int16

  • Int32

  • Int64

  • SByte

  • string

  • UInt16

  • UInt32

  • UInt64

Nella tabella seguente viene riepilogata la mappatura dei tipi .NET precedenti ai tipi DynamoDB.

Tipo primitivo .NET Tipo DynamoDB

Tutti i tipi di numeri

N (tipo numero)

Tutti i tipi stringa

S (tipo stringa)

MemoryStream, byte[]

B (tipo binario)

bool N (tipo di numero). 0 rappresenta false e 1 rappresenta true.
DateTime S (tipo stringa). I valori DateTime vengono archiviati come stringhe in formato ISO-8601.
Guid S (tipo stringa).
Tipi di raccolta (List, HashSet e array) Tipo BS (set binario), tipo SS (set stringa) o tipo NS (set numerico)

AWS SDK per .NET definisce i tipi per la mappatura dei tipi booleani, null, list e map di DynamoDB all'API del modello di documento di .NET:

  • Utilizza DynamoDBBool per il tipo Boolean.

  • Utilizza DynamoDBNull per il tipo null.

  • Utilizza DynamoDBList per il tipo list.

  • Utilizza Document per il tipo map.

Nota

  • Sono supportati valori Binary vuoti.

  • È supportata la lettura dei valori String vuoti. I valori degli attributi String vuoti sono supportati all'interno dei valori degli attributi di stringa del tipo Set durante la scrittura su DynamoDB. I valori degli attributi String vuoti del tipo String e i valori String vuoti contenuti nel tipo List o Map vengono eliminati dalle richieste di scrittura