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à.
Questo cheat sheet fornisce un riferimento rapido per lavorare con Amazon DynamoDB e le sue varie applicazioni. AWS SDKs
Configurazione iniziale
Iscriviti per. AWS
Ottenimento di una chiave di accesso AWS per accedere a DynamoDB in modo programmatico.
Consulta anche:
SDK o CLI
Scegli l'SDK preferito o configurare l'AWS CLI.
Nota
Quando usi Windows, una barra rovesciata (\) che non è contenuta in un preventivo viene considerata una restituzione. AWS CLI 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à, vedere Guida introduttiva a DynamoDB e. AWS SDKs
Creare una tabella
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 \
--billing-mode PAY_PER_REQUEST \
--table-class STANDARD
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 in 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 ad elevata consistenza di lettura al secondo o due letture a consistenza finale 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 ogni AWS account, esiste una quota iniziale di 2.500 tabelle per regione. AWS
-
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. LSIs sono 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 UTF-8.
-
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 di un elemento in DynamoDB è 400 KB, che include sia la lunghezza binaria del nome dell'attributo (lunghezza UTF-8) che le lunghezze binarie dei valori dell'attributo (lunghezza UTF-8). 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.