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à.
DynamoDB API
Per lavorare con Amazon DynamoDB, l'applicazione deve utilizzare alcune semplici operazioni. API Di seguito è riportato un riepilogo delle operazioni organizzate per categoria.
Nota
Per un elenco completo delle API operazioni, consulta Amazon DynamoDB Reference API.
Piano di controllo (control-plane)
Le operazioni del piano di controllo consentono di creare e gestire le tabelle DynamoDB. Ti permettono anche di utilizzare indici, flussi e altri oggetti che dipendono dalle tabelle.
-
CreateTable
: crea una nuova tabella. Se si desidera, è possibile creare uno o più indici secondari e abilitare DynamoDB Streams per la tabella. -
DescribeTable
: restituisce informazioni su una tabella, come lo schema della chiave primaria, le impostazioni di velocità effettiva e le informazioni sugli indici. -
ListTables
: restituisce i nomi di tutte le tabelle in un elenco. -
UpdateTable
: modifica le impostazioni di una tabella o dei relativi indici, crea o rimuove nuovi indici su una tabella o modifica le impostazioni di DynamoDB Streams per una tabella. -
DeleteTable
: rimuove una tabella e tutti i relativi oggetti dipendenti da DynamoDB.
Piano dati
Le operazioni sul piano dati consentono di eseguire azioni di creazione, lettura, aggiornamento ed eliminazione (chiamate anche CRUD) sui dati in una tabella. Alcune operazioni del piano dati consentono inoltre di leggere i dati da un indice secondario.
È possibile utilizzarePartiQL: un linguaggio di query compatibile con SQL per Amazon DynamoDB, per eseguire queste CRUD operazioni oppure è possibile utilizzare la versione classica di DynamoDB CRUD APIs che separa ogni operazione in una chiamata distinta. API
PartiQL - Un linguaggio di SQL interrogazione compatibile
-
ExecuteStatement
: legge più elementi da una tabella. È inoltre possibile scrivere o aggiornare un singolo elemento da una tabella. Quando si scrive o si aggiorna un singolo elemento, è necessario specificare gli attributi della chiave primaria. -
BatchExecuteStatement
: scrive, aggiorna o legge più elementi da una tabella. Questa operazione è più efficiente diExecuteStatement
perché l'applicazione ha bisogno solo di un singolo viaggio di andata e ritorno sulla rete per scrivere o leggere gli elementi.
Classico APIs
Creazione dei dati
-
PutItem
: scrive un singolo elemento in una tabella. È necessario specificare gli attributi della chiave primaria, ma non è necessario specificare altri attributi. -
BatchWriteItem
: scrive fino a 25 elementi in una tabella. Questa operazione è più efficiente della chiamata ripetuta diPutItem
perché la tua applicazione ha bisogno solo di un singolo round trip di rete per scrivere gli elementi.
Lettura dei dati
-
GetItem
: recupera un singolo elemento da una tabella. È necessario specificare la chiave primaria per l'item desiderato. Puoi recuperare l'intero item o solo un sottoinsieme dei suoi attributi. -
BatchGetItem
: richiama fino a 100 elementi da una o più tabelle. Questa operazione è più efficiente della chiamata ripetuta diGetItem
perché la tua applicazione ha bisogno solo di un singolo round trip di rete per leggere gli elementi. -
Query
: recupera tutti gli elementi che hanno una chiave di partizione specifica. È necessario specificare il valore della chiave di partizione. Puoi recuperare gli interi item o solo un sottoinsieme dei loro attributi. Facoltativamente, puoi applicare una condizione ai valori delle chiavi di ordinamento, in modo da recuperare solo un sottoinsieme di dati con la stessa chiave di partizione. Puoi utilizzare questa operazione su una tabella, a condizione che la tabella abbia sia una chiave di partizione che una chiave di ordinamento. Puoi anche utilizzare questa operazione su un indice, a condizione che l'indice abbia sia una chiave di partizione che una chiave di ordinamento. -
Scan
: recupera tutti gli elementi nella tabella o nell'indice specificati. Puoi recuperare gli interi item o solo un sottoinsieme dei loro attributi. Facoltativamente, puoi applicare una condizione di filtro per restituire solo i valori che ti interessano e scartare il resto.
Aggiornamento dei dati
-
UpdateItem
: modifica uno o più attributi in un elemento. Dovrai specificare la chiave primaria per l'item che vuoi modificare. Puoi aggiungere nuovi attributi e modificare o rimuovere gli attributi esistenti. Puoi inoltre eseguire aggiornamenti condizionali, in modo che l'aggiornamento abbia esito positivo solo quando viene soddisfatta una condizione definita dall'utente. Facoltativamente, puoi implementare un contatore atomico che incrementa o decrementa un attributo numerico senza interferire con altre richieste di scrittura.
Eliminazione di dati
-
DeleteItem
: elimina un singolo elemento da una tabella. Dovrai specificare la chiave primaria per l'item che vuoi eliminare. -
BatchWriteItem
: elimina fino a 25 elementi da una o più tabelle. Questa operazione è più efficiente della chiamata ripetuta diDeleteItem
perché la tua applicazione ha bisogno solo di un singolo round trip di rete per eliminare gli elementi.Nota
È possibile utilizzare
BatchWriteItem
sia per creare che per eliminare i dati.
DynamoDB Streams
Le operazioni di DynamoDB Streams consentono di abilitare o disabilitare un flusso su una tabella e consentire l'accesso ai record di modifica dei dati contenuti in un flusso.
-
ListStreams
: restituisce un elenco di tutti i flussi o solo il flusso per una tabella specifica. -
DescribeStream
— Restituisce informazioni su uno stream, ad esempio il relativo Amazon Resource Name (ARN) e dove l'applicazione può iniziare a leggere i primi record di stream. -
GetShardIterator
: restituisce un iteratore di partizioni che è una struttura dati che l'applicazione utilizza per recuperare i record dal flusso. -
GetRecords
: recupera uno o più record di flusso, utilizzando un determinato iteratore di partizioni.
Transazioni
Le transazioni forniscono atomicità, coerenza, isolamento e durabilità (ACID), consentendoti di mantenere più facilmente la correttezza dei dati nelle tue applicazioni.
Puoi utilizzarePartiQL: un linguaggio di query compatibile con SQL per Amazon DynamoDB, per eseguire operazioni transazionali oppure puoi utilizzare la versione classica di DynamoDB CRUD APIs che separa ogni operazione in una chiamata distinta. API
PartiQL - Un linguaggio di SQL interrogazione compatibile
-
ExecuteTransaction
— Un'operazione in batch che consente di CRUD eseguire operazioni su più elementi sia all'interno che tra tabelle diverse con un risultato garantito all-or-nothing.
Classico APIs
-
TransactWriteItems
— Un'operazione in batch che consente diPut
Delete
eseguire operazioni su più elementi sia all'interno che tra tabelle diverse con un all-or-nothing risultato garantito.Update
-
TransactGetItems
: un'operazione in batch che consente alle operazioniGet
di recuperare più elementi da una o più tabelle.