Cheat sheet per DynamoDB - Amazon DynamoDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Cheat sheet per DynamoDB

Questo cheat sheet fornisce un riferimento rapido per lavorare con Amazon DynamoDB e le sue varie applicazioni. AWS SDKs.

Configurazione iniziale

Consulta anche:

SDKo CLI

Scegli il tuo preferito SDKo configura il AWS CLI.

Nota

Quando si utilizza il AWS CLI in Windows, una barra rovesciata (\) che non si trova all'interno di un preventivo viene considerata una restituzione. Inoltre, è necessario evitare le virgolette e le parentesi tra virgolette all'interno di altre virgolette. Per un esempio, consulta la scheda Windows in "Creazione di una tabella" nella sezione seguente.

Consulta anche:

Operazioni di base

Questa sezione fornisce il codice per le attività di base di DynamoDB. Per ulteriori informazioni su queste attività, consulta Guida introduttiva a DynamoDB e AWS SDKs.

Creare una tabella

Default
aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema \ AttributeName=Artist,KeyType=HASH \ AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5
Windows
aws dynamodb create-table ^ --table-name Music ^ --attribute-definitions ^ AttributeName=Artist,AttributeType=S ^ AttributeName=SongTitle,AttributeType=S ^ --key-schema ^ AttributeName=Artist,KeyType=HASH ^ AttributeName=SongTitle,KeyType=RANGE ^ --provisioned-throughput ^ ReadCapacityUnits=10,WriteCapacityUnits=5

Scrittura di elementi su una tabella

aws dynamodb put-item \ --table-name Music \ --item file://item.json

Lettura di elementi da una tabella

aws dynamodb get-item \ --table-name Music \ --item file://item.json

Eliminazione di elementi da una tabella

aws dynamodb delete-item --table-name Music --key file://key.json

Esecuzione di una query su una tabella

aws dynamodb query --table-name Music --key-condition-expression "ArtistName=:Artist and SongName=:Songtitle"

Eliminazione di una tabella

aws dynamodb delete-table --table-name Music

Elenco dei nomi delle tabelle

aws dynamodb list-tables

Regole di denominazione

  • Tutti i nomi devono essere codificati utilizzando UTF -8 e fanno distinzione tra maiuscole e minuscole.

  • I nomi delle tabelle e i nomi degli indici devono avere una lunghezza compresa tra 3 e 255 caratteri e possono contenere solo i seguenti caratteri:

    • a-z

    • A-Z

    • 0-9

    • _ (carattere di sottolineatura)

    • - (trattino)

    • . (punto)

  • I nomi degli attributi devono contenere almeno un carattere e non devono superare i 64 KB.

Per ulteriori informazioni, consulta Regole di denominazione.

Nozioni di base sulle quote del servizio

Unità di lettura e scrittura

  • Unità di capacità di lettura (RCU): una lettura estremamente coerente al secondo, o due letture eventualmente coerenti al secondo, per elementi di dimensioni fino a 4 KB.

  • Unità di capacità di scrittura (WCU): una scrittura al secondo, per elementi di dimensioni fino a 1 KB.

Limiti della tabella

  • Dimensioni della tabella: non vi è un limite pratico sulle dimensioni della tabella. Le tabelle non hanno restrizioni in termini di numero di item o di byte.

  • Numero di tabelle: per qualsiasi AWS account, è prevista una quota iniziale di 2.500 tavoli per account AWS Regione.

  • Limite di dimensione della pagina per query e scansione: esiste un limite di 1 MB per pagina, per query o scansione. Se i parametri della query o l'operazione di scansione su una tabella generano più di 1 MB di dati, DynamoDB restituisce gli elementi corrispondenti iniziali. Restituisce anche una proprietà LastEvaluatedKey che è possibile utilizzare in una nuova richiesta per leggere la pagina successiva.

Indici

  • Indici secondari locali (LSIs): è possibile definire un massimo di cinque indici secondari locali. LSIssono utili principalmente quando un indice deve avere una forte coerenza con la tabella di base.

  • Indici secondari globali (GSIs): esiste una quota predefinita di 20 indici secondari globali per tabella.

  • Attributi degli indici secondari globali proiettati per tabella: è possibile proiettare un massimo di 100 attributi in tutti gli indici secondari locali e globali di una tabella. Tale approccio si applica solo agli attributi proiettati specificati dall'utente.

Chiavi di partizione

  • La lunghezza minima del valore di una chiave di partizione è di 1 byte. La lunghezza massima è 2048 byte.

  • Non vi è un limite pratico relativo al numero dei valori di chiavi di partizione distinte, sia per le tabelle che per gli indici secondari.

  • La lunghezza minima del valore di una chiave di ordinamento è di 1 byte. La lunghezza massima è 1024 byte.

  • In generale, non vi è un limite pratico relativo al numero dei valori delle chiavi di ordinamento distinte per ogni valore della chiave di partizione. Fanno eccezione le tabelle con indici secondari.

Per ulteriori informazioni sugli indici secondari, sulla progettazione delle chiavi di partizione e delle chiavi di ordinamento, consulta Best practice.

Limiti per i tipi di dati di uso comune

  • Stringa: la lunghezza di una stringa è vincolata dal limite massimo della dimensione dell'elemento, che è di 400 KB. Le stringhe sono Unicode con codifica binaria -8. UTF

  • Numero: un numero può avere fino a 38 cifre di precisione e può essere positivo, negativo o zero.

  • Binario: la lunghezza di un dato binario è vincolata dal limite massimo della dimensione dell'elemento, che è di 400 KB. Le applicazioni che funzionano con gli attributi di tipo binario devono codificare i dati nel formato Base64 prima di inviarli a DynamoDB.

Per un elenco completo dei tipi di dati supportati, consulta Tipi di dati. Per ulteriori informazioni, consulta anche Service Quotas.

Elementi, attributi e parametri di espressione

La dimensione massima dell'elemento in DynamoDB è di 400 KB, che include sia la lunghezza binaria del nome dell'attributo UTF (-8 lunghezza) che la lunghezza binaria del valore dell'attributo (-8 lunghezzaUTF). Il nome attributo viene conteggiato per il limite di dimensione.

Non vi è alcun limite al numero di valori in un attributo List, Map o Set purché l'elemento contenente i valori rientri nel limite di dimensione dell'elemento di 400 KB.

Per i parametri di espressione, la lunghezza massima di qualsiasi stringa di espressione è di 4 KB.

Per ulteriori informazioni sulle dimensioni degli elementi, sugli attributi e sui parametri di espressione, consulta Service Quotas.

Ulteriori informazioni