Creazione di operazioni API
Per utilizzare NoSQL Workbench per creare API CRUD DynamoDB, seleziona Operation builder dalla parte a sinistra dell’interfaccia utente di NoSQL Workbench.
Quindi seleziona Apri e seleziona una connessione.
Puoi eseguire le seguenti operazioni con Operation builder:
Delete Table (Elimina tabella)
Per eseguire un’operazione Delete Table, completa le seguenti operazioni.
-
Trova la tabella che desideri eliminare nella sezione Tabelle.
-
Seleziona Elimina tabella dal menu con puntini di sospensione orizzontali.
-
Conferma l’eliminazione della tabella inserendo il Nome della tabella.
-
Seleziona Elimina.
Per ulteriori informazioni su questa operazione, consulta Delete Table (Elimina tabella) nella Documentazione di riferimento delle API di Amazon DynamoDB.
Eliminazione di un GSI
Per eseguire un’operazione Delete GSI, completa le seguenti operazioni.
-
Trova il GSI di una tabella da eliminare nella sezione Tabelle.
-
Seleziona Elimina GSI dal menu con puntini di sospensione orizzontali.
-
Conferma l’eliminazione inserendo il Nome del GSI.
-
Seleziona Elimina.
Per ulteriori informazioni su questa operazione, consulta Delete Table (Elimina tabella) nella Documentazione di riferimento delle API di Amazon DynamoDB.
Create table (Crea tabella)
Per eseguire un’operazione Create Table, completa le seguenti operazioni.
-
Seleziona l’icona + accanto alla sezione Tabelle.
-
Immettere il nome della tabella desiderato.
-
Creare una chiave di partizione.
-
Facoltativo: crea una chiave di ordinamento.
-
Per personalizzare le impostazioni di capacità, deseleziona la casella accanto a Utilizza impostazioni di capacità predefinite.
-
Ora è possibile selezionare sia Provisioned (Con provisioning) che On-demand capacity (Capacità on-demand).
Con Provisioned (Con provisioning) selezionato, è possibile impostare unità di capacità di lettura e scrittura minima e massima. È inoltre possibile abilitare o disabilitare il dimensionamento automatico.
-
Se la tabella è attualmente impostata su On demand, non sarà possibile specificare un throughput allocato.
-
Se si passa da Throughput on demand a Con provisioning, il dimensionamento automatico verrà automaticamente applicato a tutti i GSI con: min: 1, max: 10; destinazione: 70%.
-
-
Seleziona Ignora GSI e crea per creare questa tabella senza un GSI. Facoltativamente, è possibile selezionare Successivo per creare un GSI con questa nuova tabella.
Per ulteriori informazioni su questa operazione, consulta Create Table (Crea tabella) nella Documentazione di riferimento delle API di Amazon DynamoDB.
Creazione di un GSI
Per eseguire un’operazione Create GSI, completa le seguenti operazioni.
-
Trova una tabella a cui aggiungere un GSI.
-
Seleziona Crea GSI dal menu con puntini di sospensione orizzontali.
-
Assegna un nome al GSI in Nome indice.
-
Creare una chiave di partizione.
-
Facoltativo: crea una chiave di ordinamento.
-
Seleziona un’opzione di proiezione dal menu a discesa.
-
Seleziona Crea GSI.
Per ulteriori informazioni su questa operazione, consulta Create Table (Crea tabella) nella Documentazione di riferimento delle API di Amazon DynamoDB.
Update Table (Aggiorna tabella)
Per aggiornare le impostazioni di capacità per una tabella con un’operazione Update Table, completa le seguenti operazioni.
-
Trova la tabella per la quale aggiornare le impostazioni di capacità.
-
Dal menu con i puntini di sospensione orizzontali, seleziona Aggiorna impostazioni di capacità.
-
Seleziona Con provisioning o Capacità on demand.
Con l’opzione Con provisioning selezionata è possibile impostare unità di capacità di lettura e scrittura minima e massima. È inoltre possibile abilitare o disabilitare il dimensionamento automatico.
-
Selezionare Update (Aggiorna).
Per ulteriori informazioni su questa operazione, consulta Update Table (Aggiorna tabella) nella Documentazione di riferimento delle API di Amazon DynamoDB.
Aggiornamento di un GSI
Per aggiornare le impostazioni di capacità per un indice secondario globale con un’operazione Update Table, completa le seguenti operazioni.
Nota
Per impostazione predefinita, gli indici secondari globali ereditano le impostazioni di capacità della tabella di base. Gli indici secondari globali possono avere una modalità di capacità diversa solo quando la tabella di base è in modalità con capacità allocata. Quando si crea un indice secondario globale su una tabella con modalità assegnata, è necessario specificare le unità di capacità di lettura e scrittura per il carico di lavoro previsto sull'indice. Per ulteriori informazioni, consulta Considerazioni sulla velocità di trasmissione effettiva assegnata per indici secondari globali.
-
Trova il GSI per il quale aggiornare le impostazioni di capacità.
-
Dal menu con i puntini di sospensione orizzontali, seleziona Aggiorna impostazioni di capacità.
-
Ora è possibile selezionare sia Provisioned (Con provisioning) che On-demand capacity (Capacità on-demand).
Con l’opzione Con provisioning selezionata è possibile impostare unità di capacità di lettura e scrittura minima e massima. È inoltre possibile abilitare o disabilitare il dimensionamento automatico.
-
Selezionare Update (Aggiorna).
Per ulteriori informazioni su questa operazione, consulta Update Table (Aggiorna tabella) nella Documentazione di riferimento delle API di Amazon DynamoDB.
Put Item
Per la creazione di un elemento viene utilizzata l’operazione Put Item. Per eseguire o generare codice per un'operazione Put Item, completare le seguenti operazioni.
-
Trova la tabella in cui desideri creare un elemento.
-
Dal menu a discesa Operazioni, seleziona Crea elemento.
-
Immettere il valore della chiave di partizione.
-
Immettere il valore della chiave di ordinamento, se esiste.
-
Se si desidera aggiungere attributi non di chiave, svolgere le seguenti operazioni:
-
Seleziona + Aggiungi altri attributi.
-
Specifica Nome attributo, Tipo e Valore.
-
-
Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione
Put Item, svolgere le seguenti operazioni:-
Selezionare Condition (Condizioni).
-
Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.
-
Se sono richieste altre condizioni, selezionare nuovamente Condition (Condizione).
Per ulteriori informazioni, consulta Esempio di CLI di espressione condizionale in DynamoDB.
-
-
Per generare codice, selezionare Generate code (Genera codice).
Selezionare la lingua desiderata dalle schede visualizzate. È possibile copiare questo codice e utilizzarlo nell'applicazione.
-
Per eseguire l'operazione immediatamente, seleziona Esegui.
-
Se desideri salvare questa operazione per un utilizzo successivo, scegli Save operation (Salva operazione), quindi specifica un nome per l'operazione e scegli Save (Salva).
Per ulteriori informazioni su questa operazione, consulta PutItem nella Documentazione di riferimento delle API di Amazon DynamoDB.
Update Item
Per eseguire o generare codice per un'operazione Update Item, svolgere le seguenti operazioni:
-
Trova la tabella in cui desideri aggiornare un elemento.
-
Seleziona l’elemento.
-
Inserisci il nome attributo e il valore attributo per l'espressione selezionata.
-
Se desideri aggiungere altre espressioni, seleziona un’altra espressione nell’elenco a discesa Aggiorna espressione, quindi seleziona l’icona +.
-
Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione
Update Item, svolgere le seguenti operazioni:-
Selezionare Condition (Condizioni).
-
Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.
-
Se sono richieste altre condizioni, selezionare nuovamente Condition (Condizione).
Per ulteriori informazioni, consulta Esempio di CLI di espressione condizionale in DynamoDB.
-
-
Per generare codice, selezionare Generate code (Genera codice).
Seleziona la scheda per la lingua da utilizzare. È possibile copiare questo codice e utilizzarlo nell'applicazione.
-
Per eseguire l'operazione immediatamente, seleziona Esegui.
-
Se desideri salvare questa operazione per un utilizzo successivo, scegli Save operation (Salva operazione), quindi specifica un nome per l'operazione e scegli Save (Salva).
Per ulteriori informazioni su questa operazione, consulta UpdateItem nella Documentazione di riferimento delle API di Amazon DynamoDB.
Delete Item
Per eseguire un’operazione Delete Item, completa le seguenti operazioni.
-
Trova la tabella in cui desideri eliminare un elemento.
-
Seleziona l’elemento.
-
Dal menu a discesa Operazioni, seleziona Elimina voce.
-
Conferma l’eliminazione dell’elemento selezionando Elimina.
Per ulteriori informazioni su questa operazione, consulta DeleteItem nella Documentazione di riferimento delle API di Amazon DynamoDB.
Duplicazione di un elemento
È possibile duplicare un elemento creando un nuovo elemento con gli stessi attributi. Per duplicare un elemento, completa le seguenti operazioni.
-
Trova la tabella in cui desideri duplicare un elemento.
-
Seleziona l’elemento.
-
Dal menu a discesa Operazioni, seleziona Elemento duplicato.
-
Specifica una nuova chiave di partizione.
-
Specifica una nuova chiave di ordinamento (se necessario).
-
Seleziona Esegui.
Per ulteriori informazioni su questa operazione, consulta DeleteItem nella Documentazione di riferimento delle API di Amazon DynamoDB.
Query
Per eseguire o generare codice per un'operazione Query, completare le seguenti operazioni.
-
Seleziona Query nella parte superiore dell’interfaccia utente di NoSQL Workbench.
-
Specificare il valore della chiave di partizione.
-
Se è necessaria una chiave di ordinamento per l'operazione
Query:-
Seleziona Chiavi di ordinamento.
-
Specifica l’operatore di confronto e il valore dell’attributo.
-
-
Seleziona Query per eseguire l’operazione relativa. Se sono necessarie altre opzioni, seleziona la casella di spunta Altre opzioni e continua con la procedura seguente.
-
Se non tutti gli attributi devono essere restituiti con il risultato dell'operazione, seleziona Espressione di proiezione.
-
Scegli l'icona +.
-
Immettere l'attributo da restituire con i risultati della query.
-
Se sono necessari più attributi, seleziona +.
-
Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione
Query, svolgere le seguenti operazioni:-
Selezionare Condition (Condizioni).
-
Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.
-
Se sono richieste altre condizioni, selezionare nuovamente Condition (Condizione).
Per ulteriori informazioni, consulta Esempio di CLI di espressione condizionale in DynamoDB.
-
-
Per generare codice, selezionare Generate code (Genera codice).
Seleziona la scheda per la lingua da utilizzare. È possibile copiare questo codice e utilizzarlo nell'applicazione.
-
Per eseguire l'operazione immediatamente, seleziona Esegui.
-
Se desideri salvare questa operazione per un utilizzo successivo, scegli Save operation (Salva operazione), quindi specifica un nome per l'operazione e scegli Save (Salva).
Per ulteriori informazioni su questa operazione, consulta Query nella Documentazione di riferimento delle API di Amazon DynamoDB.
Scan
Per eseguire o generare codice per un'operazione Scan, completare le seguenti operazioni.
-
Seleziona Scansiona nella parte superiore dell’interfaccia utente di NoSQL Workbench.
-
Seleziona il pulsante Scansiona per eseguire questa operazione di scansione di base. Se sono necessarie altre opzioni, seleziona la casella di spunta Altre opzioni e continua con la procedura seguente.
-
Specifica il nome di un attributo per filtrare i risultati della scansione.
-
Se non tutti gli attributi devono essere restituiti con il risultato dell'operazione, seleziona Espressione di proiezione.
-
Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione di scansione, svolgere le seguenti operazioni:
-
Selezionare Condition (Condizioni).
-
Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.
-
Se sono richieste altre condizioni, selezionare nuovamente Condition (Condizione).
Per ulteriori informazioni, consulta Esempio di CLI di espressione condizionale in DynamoDB.
-
-
Per generare codice, selezionare Generate code (Genera codice).
Seleziona la scheda per la lingua da utilizzare. È possibile copiare questo codice e utilizzarlo nell'applicazione.
-
Per eseguire l'operazione immediatamente, seleziona Esegui.
-
Se desideri salvare questa operazione per un utilizzo successivo, scegli Save operation (Salva operazione), quindi specifica un nome per l'operazione e scegli Save (Salva).
TransactGetItems
Per eseguire o generare codice per un'operazione TransactGetItems, completare le seguenti operazioni.
-
Dal menu a discesa Altre operazioni nella parte superiore dell’interfaccia utente di NoSQL Workbench, seleziona TransactGetItems.
-
Seleziona l’icona + accanto a TransactGetItem.
-
Specifica una chiave di partizione.
-
Specifica una chiave di ordinamento (se necessario).
-
Seleziona Esegui per eseguire l’operazione, Salva operazione per salvarla o Genera codice per generare il codice corrispondente.
Per ulteriori informazioni sulle transazioni, consulta Transazioni Amazon DynamoDB.
TransactWriteItems
Per eseguire o generare codice per un'operazione TransactWriteItems, completare le seguenti operazioni.
-
Dal menu a discesa Altre operazioni nella parte superiore dell’interfaccia utente di NoSQL Workbench, seleziona TransactWriteItems.
-
Seleziona un’operazione dal menu a discesa Operazioni.
-
Seleziona l’icona + accanto a TransactWriteItem.
-
Dal menu a discesa Operazioni seleziona l’operazione desiderata.
-
Per
DeleteItem, seguire le istruzioni per l'operazione Delete Item. -
Per
PutItem, seguire le istruzioni per l'operazione Put Item. -
Per
UpdateItem, seguire le istruzioni per l'operazione Update Item.
Per modificare l'ordine delle operazioni, selezionare un'operazione nell'elenco a sinistra, quindi selezionare le frecce verso l'alto e verso il basso per spostarsi nell'elenco a discesa.
Per eliminare un'operazione, selezionare l'operazione dall'elenco, quindi selezionare l'icona Delete (Elimina) (raffigurata dal cestino).
-
-
Seleziona Esegui per eseguire l’operazione, Salva operazione per salvarla o Genera codice per generare il codice corrispondente.
Per ulteriori informazioni sulle transazioni, consulta Transazioni Amazon DynamoDB.