

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à.

# Esplorazione di set di dati e creazione di operazioni con NoSQL Workbench
<a name="workbench.querybuilder"></a>

NoSQL Workbench per Amazon DynamoDB offre una ricca interfaccia utente grafica per lo sviluppo e il test di query. È possibile utilizzare l'Operation builder in NoSQL Workbench per visualizzare, esplorare ed eseguire query sui set di dati. Operation builder strutturato supporta espressioni di proiezione, espressioni condizionali e genera codice di esempio in più lingue. È possibile clonare direttamente le tabelle da un account Amazon DynamoDB a un altro in Regioni diverse. È anche possibile clonare direttamente le tabelle tra DynamoDB locale e un account Amazon DynamoDB per copiare più rapidamente lo schema delle chiavi della tabella (e facoltativamente lo schema e gli elementi degli indici secondari globali (GSI) tra gli ambienti di sviluppo. È possibile salvare fino a 50 operazioni sui dati DynamoDB in Operation builder.

**Topics**
+ [Connessione a set di dati in tempo reale](workbench.querybuilder.connect.md)
+ [Creazione di operazioni complesse](workbench.querybuilder.operationbuilder.md)
+ [Clonazione di tabelle con NoSQL Workbench](workbench.querybuilder.cloning-tables.md)
+ [Esportazione di dati in un file CSV](workbench.querybuilder.exportcsv.md)

# Connessione a set di dati in tempo reale
<a name="workbench.querybuilder.connect"></a>

Per connetterti alle tue tabelle Amazon DynamoDB con NoSQL Workbench, devi prima connetterti al tuo account. AWS 

**Per aggiungere una connessione al database**

1. In NoSQL Workbench, nel riquadro di navigazione a sinistra, seleziona l'icona **Operation builder**.

1. Scegli **Aggiungi connessione**.

1. Specificare le seguenti informazioni:
   + **Nome della connessione**
   + **AWS Region**
   + **ID chiave di accesso**
   + **Chiave di accesso segreta**

   [Per ulteriori informazioni su come ottenere le chiavi di accesso, consulta Ottenere una chiave di accesso. AWS](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials)

   Facoltativamente, puoi specificare quanto segue:
   + [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
   + [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)

1. Scegli **Connetti**.

    Se non vuoi sottoscrivere un account per un piano gratuito e preferisci usare [DynamoDB Local (versione scaricabile)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html): 

   1. Scegli la scheda **Local** (Locale) nella schermata di connessione.

   1. Specificare le seguenti informazioni:
      + **Nome della connessione**
      + **Porta**

   1. Scegli il pulsante **Connetti**.
**Nota**  
Per connetterti a DynamoDB locale, avvia manualmente DynamoDB locale usando il terminale (consulta [Distribuzione di DynamoDB in locale sul computer](DynamoDBLocal.DownloadingAndRunning.md)) o avvia DynamoDB locale direttamente utilizzando l’opzione DDB locale nel menu di navigazione di NoSQL Workbench. Assicurati che la porta di connessione sia la stessa della porta di DynamoDB locale.

1. Una volta creata la connessione, seleziona **Apri**.

Dopo aver effettuato la connessione al database DynamoDB, l'elenco di tabelle disponibili viene visualizzato nel riquadro a sinistra. Scegli una delle tabelle per ottenere un esempio di dati memorizzati nella tabella.

Ora è possibile eseguire query sulla tabella selezionata.

Per eseguire query su una tabella, consulta la sezione successiva sulla creazione di operazioni: consulta [Creazione di operazioni complesse](workbench.querybuilder.operationbuilder.md).

# Creazione di operazioni complesse
<a name="workbench.querybuilder.operationbuilder"></a>

L'operation builder in NoSQL Workbench per Amazon DynamoDB offre un'interfaccia visuale in cui è possibile effettuare operazioni complesse del piano dati. Include il supporto per le espressioni di proiezione e di condizione. Una volta creata un'operazione, sarà possibile salvarla per un utilizzo successivo (è possibile salvare fino a 50 operazioni). Sarà quindi possibile sfogliare un elenco delle operazioni del piano dati utilizzate di frequente nel menu **Operazioni salvate** e utilizzarle per popolare e creare automaticamente una nuova operazione. È possibile anche decidere di generare codici di esempio per queste operazioni, in più linguaggi.

NoSQL Workbench supporta la creazione di [PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) per le istruzioni DynamoDB, che consente di interagire con DynamoDB utilizzando un linguaggio di query compatibile con SQL. NoSQL Workbench supporta anche la creazione di operazioni API CRUD di DynamoDB.

Per utilizzare NoSQL Workbench per creare operazioni, nel riquadro di navigazione a sinistra, seleziona l'icona **Operation builder**.

**Topics**
+ [Creazione di istruzioni PartiQL](workbench.querybuilder.partiql.md)
+ [Creazione di operazioni API](workbench.querybuilder.operationbuilder.api.md)

# Creazione di istruzioni PartiQL
<a name="workbench.querybuilder.partiql"></a>

Per utilizzare NoSQL Workbench per creare istruzioni [PartiQL per DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html), seleziona **Editor PartiQL** nella parte in alto dell’interfaccia utente di NoSQL Workbench.

È possibile creare i seguenti tipi di istruzione PartiQL con l'operation builder:

**Topics**
+ [Istruzioni singleton](#workbench.querybuilder.partiql.single)
+ [Transazioni](#workbench.querybuilder.partiql.transaction)
+ [Archiviazione](#workbench.querybuilder.partiql.batch)

## Istruzioni singleton
<a name="workbench.querybuilder.partiql.single"></a>

Per eseguire o generare codice per un'istruzione PartiQL, completare le seguenti operazioni.

1. Seleziona **Editor PartiQL** nella parte superiore della finestra.

1. Immettere una [istruzione PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) valida.

1. Se l'istruzione utilizza parametri:

   1. Scegli **Parametri di richiesta facoltativi**.

   1. Scegli **Aggiungi nuovi parametri**.

   1. Inserire il tipo e il valore dell'attributo.

   1. Se desideri aggiungere altri parametri, ripeti le fasi b e c.

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Selezionare la lingua desiderata dalle schede visualizzate. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. Se desideri salvare questa operazione per un utilizzo successivo, scegli **Save operation** (Salva operazione). Quindi inserisci un nome per l'operazione e scegli **Save** (Salva).

## Transazioni
<a name="workbench.querybuilder.partiql.transaction"></a>

Per eseguire o generare codice per una transazione PartiQL, completare le seguenti operazioni.

1. Scegli **Parti QLTransaction** dal menu a discesa **Altre operazioni**.

1. Scegli **Aggiungi una nuova istruzione**.

1. Immettere una [istruzione PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) valida.
**Nota**  
Le operazioni di lettura e scrittura non sono supportate nella stessa richiesta di transazione PartiQL. Un'istruzione SELECT (SELEZIONA) non può trovarsi nella stessa richiesta con le Istruzioni INSERT (INSERISCI), UPDATE (AGGIORNA) e DELETE (ELIMINA). Consulta [Esecuzione di transazioni con PartiQL per DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html) per maggiori dettagli.

1. Se l'istruzione utilizza parametri

   1. Scegli **Parametri di richiesta facoltativi**.

   1. Scegli **Aggiungi nuovi parametri**.

   1. Inserire il tipo e il valore dell'attributo.

   1. Se desideri aggiungere altri parametri, ripeti le fasi b e c.

1. Se desideri aggiungere altre istruzioni, ripeti le fasi da 2 a 4.

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Selezionare la lingua desiderata dalle schede visualizzate. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. Se desideri salvare questa operazione per un utilizzo successivo, scegli **Save operation** (Salva operazione). Quindi inserisci un nome per l'operazione e scegli **Save** (Salva).

## Archiviazione
<a name="workbench.querybuilder.partiql.batch"></a>

Per eseguire o generare codice per un batch PartiQL, completare le seguenti operazioni.

1. Scegli **Parti QLBatch** dal menu a discesa **Altre operazioni**.

1. Scegli **Aggiungi una nuova istruzione**.

1. Immettere una [istruzione PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) valida.
**Nota**  
 Le operazioni di lettura e scrittura non sono supportate nella stessa richiesta batch PartiQL, il che significa che un'istruzione SELECT (SELEZIONA) non può essere inclusa nella stessa richiesta con istruzioni INSERT (INSERISCI), UPDATE (AGGIORNA) e DELETE (ELIMINA). Le operazioni di scrittura sullo stesso elemento non sono consentite. Come per l' BatchGetItemoperazione, sono supportate solo le operazioni di lettura singleton. Le operazioni di scansione e query non sono supportate. Consulta [Esecuzione di operazioni in batch con PartiQL per DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html) per maggiori dettagli.

1. Se l'istruzione utilizza parametri:

   1. Scegli **Parametri di richiesta facoltativi**.

   1. Scegli **Aggiungi nuovi parametri**.

   1. Inserire il tipo e il valore dell'attributo.

   1. Se desideri aggiungere altri parametri, ripeti le fasi b e c.

1. Se desideri aggiungere altre istruzioni, ripeti le fasi da 2 a 4.

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Selezionare la lingua desiderata dalle schede visualizzate. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. Se desideri salvare questa operazione per un utilizzo successivo, scegli **Save operation** (Salva operazione). Quindi inserisci un nome per l'operazione e scegli **Save** (Salva).

# Creazione di operazioni API
<a name="workbench.querybuilder.operationbuilder.api"></a>

Per utilizzare NoSQL Workbench per creare APIs DynamoDB CRUD, **seleziona Operation** builder dalla sinistra dell'interfaccia utente NoSQL Workbench.

Quindi seleziona **Apri** e seleziona una connessione.

Puoi eseguire le seguenti operazioni con Operation builder:
+ [Delete Table](#workbench.querybuilder.operationbuilder.DeleteTable)
+ [Create Table](#workbench.querybuilder.operationbuilder.CreateTable)
+ [Update Table](#workbench.querybuilder.operationbuilder.UpdateTable)
+ [Put Item](#workbench.querybuilder.operationbuilder.Put)
+ [Update Item](#workbench.querybuilder.operationbuilder.update)
+ [Delete Item](#workbench.querybuilder.operationbuilder.Delete)
+ [Query](#workbench.querybuilder.operationbuilder.Query)
+ [Scan](#workbench.querybuilder.operationbuilder.scan)
+ [Transact Get Items](#workbench.querybuilder.operationbuilder.transactget)
+ [Transact Write Items](#workbench.querybuilder.operationbuilder.transactwrite)

## Delete Table (Elimina tabella)
<a name="workbench.querybuilder.operationbuilder.DeleteTable"></a>

Per eseguire un’operazione `Delete Table`, completa le seguenti operazioni.

1. Trova la tabella che desideri eliminare nella sezione **Tabelle**.

1. Seleziona **Elimina tabella** dal menu con puntini di sospensione orizzontali.

1. Conferma l’eliminazione della tabella inserendo il **Nome della tabella**.

1. Seleziona **Elimina**.

Per ulteriori informazioni su questa operazione, consulta [Delete Table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) (Elimina tabella) nella *Documentazione di riferimento delle API di Amazon DynamoDB*. 

## Eliminazione di un GSI
<a name="workbench.querybuilder.operationbuilder.DeleteGSI"></a>

Per eseguire un’operazione `Delete GSI`, completa le seguenti operazioni.

1. Trova il GSI di una tabella da eliminare nella sezione **Tabelle**.

1. Seleziona **Elimina GSI** dal menu con puntini di sospensione orizzontali.

1. Conferma l’eliminazione inserendo il **Nome del GSI**.

1. Seleziona **Elimina**.

Per ulteriori informazioni su questa operazione, consulta [Delete Table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) (Elimina tabella) nella *Documentazione di riferimento delle API di Amazon DynamoDB*. 

## Crea tabella
<a name="workbench.querybuilder.operationbuilder.CreateTable"></a>

Per eseguire un’operazione `Create Table`, completa le seguenti operazioni.

1. Seleziona l’icona **\$1** accanto alla sezione **Tabelle**.

1. Immettere il nome della tabella desiderato.

1. Creare una chiave di partizione.

1. Facoltativo: crea una chiave di ordinamento.

1. 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 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.
   + Se la tabella è attualmente impostata su On demand, non sarà possibile specificare un throughput allocato.
   + Se passi da On-demand a Provisioned Throughput, la scalabilità automatica verrà applicata automaticamente a tutti gli utenti GSIs con: min: 1, max: 10; obiettivo: 70%.

1. Seleziona **Ignora GSIs 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](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) (Crea tabella) nella *Documentazione di riferimento delle API di Amazon DynamoDB*. 

## Creazione di un GSI
<a name="workbench.querybuilder.operationbuilder.CreateGSI"></a>

Per eseguire un’operazione `Create GSI`, completa le seguenti operazioni.

1. Trova una tabella a cui aggiungere un GSI.

1. Seleziona **Crea GSI** dal menu con puntini di sospensione orizzontali.

1. Assegna un nome al GSI in **Nome indice.**

1. Creare una chiave di partizione.

1. Facoltativo: crea una chiave di ordinamento.

1. Seleziona un’opzione di proiezione dal menu a discesa.

1. Seleziona **Crea GSI**.

Per ulteriori informazioni su questa operazione, consulta [Create Table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) (Crea tabella) nella *Documentazione di riferimento delle API di Amazon DynamoDB*. 

## Update Table (Aggiorna tabella)
<a name="workbench.querybuilder.operationbuilder.UpdateTable"></a>

Per aggiornare le impostazioni di capacità per una tabella con un’operazione `Update Table`, completa le seguenti operazioni.

1. Trova la tabella per la quale aggiornare le impostazioni di capacità.

1. Dal menu con i puntini di sospensione orizzontali, seleziona **Aggiorna impostazioni di capacità**.

1. 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.

1. Selezionare **Update (Aggiorna)**.

Per ulteriori informazioni su questa operazione, consulta [Update Table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) (Aggiorna tabella) nella *Documentazione di riferimento delle API di Amazon DynamoDB*.

## Aggiornamento di un GSI
<a name="workbench.querybuilder.operationbuilder.UpdateGSI"></a>

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](GSI.md#GSI.ThroughputConsiderations).

1. Trova il GSI per il quale aggiornare le impostazioni di capacità.

1. Dal menu con i puntini di sospensione orizzontali, seleziona **Aggiorna impostazioni di capacità**.

1. 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.

1. Selezionare **Update (Aggiorna)**.

Per ulteriori informazioni su questa operazione, consulta [Update Table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) (Aggiorna tabella) nella *Documentazione di riferimento delle API di Amazon DynamoDB*.

## Put Item
<a name="workbench.querybuilder.operationbuilder.Put"></a>

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.

1. Trova la tabella in cui desideri creare un elemento.

1. Dal menu a discesa **Operazioni**, seleziona **Crea elemento**.

1. Immettere il valore della chiave di partizione.

1. Immettere il valore della chiave di ordinamento, se esiste.

1. Se si desidera aggiungere attributi non di chiave, svolgere le seguenti operazioni:

   1. Seleziona **\$1 Aggiungi altri attributi**.

   1. Specifica **Nome attributo**, **Tipo** e **Valore**. 

1. Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione `Put Item`, svolgere le seguenti operazioni:

   1. Selezionare **Condition (Condizioni)**.

   1. Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.

   1. Se sono richieste altre condizioni, selezionare nuovamente **Condition (Condizione)**.

   Per ulteriori informazioni, consulta [Esempio di CLI di espressione condizionale in DynamoDB](Expressions.ConditionExpressions.md).

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Selezionare la lingua desiderata dalle schede visualizzate. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)*Amazon DynamoDB API Reference*. 

## Update Item
<a name="workbench.querybuilder.operationbuilder.update"></a>

Per eseguire o generare codice per un'operazione `Update Item`, svolgere le seguenti operazioni:

1. Trova la tabella in cui desideri aggiornare un elemento.

1. Seleziona l’elemento.

1. Inserisci il nome attributo e il valore attributo per l'espressione selezionata.

1. Se desideri aggiungere altre espressioni, seleziona un’altra espressione nell’elenco a discesa **Aggiorna espressione**, quindi seleziona l’icona **\$1**.

1. Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione `Update Item`, svolgere le seguenti operazioni:

   1. Selezionare **Condition (Condizioni)**.

   1. Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.

   1. Se sono richieste altre condizioni, selezionare nuovamente **Condition (Condizione)**.

   Per ulteriori informazioni, consulta [Esempio di CLI di espressione condizionale in DynamoDB](Expressions.ConditionExpressions.md).

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Seleziona la scheda per la lingua da utilizzare. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)*Amazon DynamoDB API Reference*. 

## Delete Item
<a name="workbench.querybuilder.operationbuilder.Delete"></a>

Per eseguire un’operazione `Delete Item`, completa le seguenti operazioni.

1. Trova la tabella in cui desideri eliminare un elemento. 

1. Seleziona l’elemento.

1. Dal menu a discesa **Operazioni**, seleziona **Elimina voce**.

1. Conferma l’eliminazione dell’elemento selezionando **Elimina**.

Per ulteriori informazioni su questa operazione, consulta [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)*Amazon DynamoDB API Reference*.

## Duplicazione di un elemento
<a name="workbench.querybuilder.operationbuilder.Duplicate"></a>

È possibile duplicare un elemento creando un nuovo elemento con gli stessi attributi. Per duplicare un elemento, completa le seguenti operazioni.

1. Trova la tabella in cui desideri duplicare un elemento.

1. Seleziona l’elemento.

1. Dal menu a discesa **Operazioni**, seleziona **Elemento duplicato**.

1. Specifica una nuova chiave di partizione.

1. Specifica una nuova chiave di ordinamento (se necessario).

1. Seleziona **Esegui**.

Per ulteriori informazioni su questa operazione, consulta [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)*Amazon DynamoDB API Reference*.

## Query
<a name="workbench.querybuilder.operationbuilder.Query"></a>

Per eseguire o generare codice per un'operazione `Query`, completare le seguenti operazioni.

1. Seleziona **Query** nella parte superiore dell’interfaccia utente di NoSQL Workbench.

1. Specificare il valore della chiave di partizione.

1. Se è necessaria una chiave di ordinamento per l'operazione `Query`:

   1. Seleziona **Chiavi di ordinamento**.

   1. Specifica l’operatore di confronto e il valore dell’attributo.

1. 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.

1. Se non tutti gli attributi devono essere restituiti con il risultato dell'operazione, seleziona **Espressione di proiezione**.

1. Scegli l'icona **\$1**.

1. Immettere l'attributo da restituire con i risultati della query.

1. Se sono necessari più attributi, seleziona **\$1**.

1. Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione `Query`, svolgere le seguenti operazioni:

   1. Selezionare **Condition (Condizioni)**.

   1. Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.

   1. Se sono richieste altre condizioni, selezionare nuovamente **Condition (Condizione)**.

   Per ulteriori informazioni, consulta [Esempio di CLI di espressione condizionale in DynamoDB](Expressions.ConditionExpressions.md).

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Seleziona la scheda per la lingua da utilizzare. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html) nella *Documentazione di riferimento delle API di Amazon DynamoDB*. 

## Scan
<a name="workbench.querybuilder.operationbuilder.scan"></a>

Per eseguire o generare codice per un'operazione `Scan`, completare le seguenti operazioni.

1. Seleziona **Scansiona** nella parte superiore dell’interfaccia utente di NoSQL Workbench.

1. 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.

1. Specifica il nome di un attributo per filtrare i risultati della scansione.

1. Se non tutti gli attributi devono essere restituiti con il risultato dell'operazione, seleziona **Espressione di proiezione**.

1. Se un'espressione di condizione deve essere soddisfatta per la riuscita dell'operazione di scansione, svolgere le seguenti operazioni:

   1. Selezionare **Condition (Condizioni)**.

   1. Specificare il nome attributo, l'operatore di confronto, il tipo di attributo e il valore dell'attributo.

   1. Se sono richieste altre condizioni, selezionare nuovamente **Condition (Condizione)**. 

   Per ulteriori informazioni, consulta [Esempio di CLI di espressione condizionale in DynamoDB](Expressions.ConditionExpressions.md).

1. Per generare codice, selezionare **Generate code (Genera codice)**.

   Seleziona la scheda per la lingua da utilizzare. È possibile copiare questo codice e utilizzarlo nell'applicazione.

1. Per eseguire l'operazione immediatamente, seleziona **Esegui**.

1. 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
<a name="workbench.querybuilder.operationbuilder.transactget"></a>

Per eseguire o generare codice per un'operazione `TransactGetItems`, completare le seguenti operazioni.

1. Dal menu a discesa **Altre operazioni** nella parte superiore dell'interfaccia utente di NoSQL Workbench, scegli. **TransactGetItems**

1. **Scegli l'icona \$1 accanto. **TransactGetItem****

1. Specifica una chiave di partizione.

1. Specifica una chiave di ordinamento (se necessario).

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).

## TransactWriteItems
<a name="workbench.querybuilder.operationbuilder.transactwrite"></a>

Per eseguire o generare codice per un'operazione `TransactWriteItems`, completare le seguenti operazioni.

1. Dal menu a discesa **Altre operazioni** nella parte superiore dell'interfaccia utente di NoSQL Workbench, scegli. **TransactWriteItems**

1. Seleziona un’operazione dal menu a discesa **Operazioni**.

1. **Scegli l'icona \$1 accanto. **TransactWriteItem****

1. Dal menu a discesa **Operazioni** seleziona l’operazione desiderata.
   + Per `DeleteItem`, seguire le istruzioni per l'operazione [Delete Item](#workbench.querybuilder.operationbuilder.Delete). 
   + Per `PutItem`, seguire le istruzioni per l'operazione [Put Item](#workbench.querybuilder.operationbuilder.Put). 
   + Per `UpdateItem`, seguire le istruzioni per l'operazione [Update Item](#workbench.querybuilder.operationbuilder.update).

   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). 

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).

# Clonazione di tabelle con NoSQL Workbench
<a name="workbench.querybuilder.cloning-tables"></a>

La clonazione delle tabelle copierà lo schema delle chiavi di una tabella (e facoltativamente lo schema e gli elementi degli indici secondari globali (GSI)) tra gli ambienti di sviluppo. È possibile clonare una tabella tra DynamoDB locale a un account Amazon DynamoDB e persino clonare una tabella da un account all’altro in diverse Regioni per una sperimentazione più rapida.

**Come clonare una tabella**

1. In **Operation builder**, seleziona la connessione e la Regione (la selezione della Regione non è disponibile per DynamoDB locale).

1. Una volta effettuata la connessione a DynamoDB, sfoglia le tabelle e seleziona la tabella da clonare.

1. Dal menu con i puntini di sospensione orizzontali, seleziona l’opzione **Clona**.

1. Inserisci i dettagli della destinazione del clone:

   1. Seleziona una connessione.

   1. Seleziona una Regione (la Regione non è disponibile per DynamoDB locale).

   1. Inserisci un nome per la nuova tabella.

   1. Seleziona un’opzione di clonazione:

      1. **Schema chiave** è selezionato per impostazione predefinita e non può essere deselezionato. Per impostazione predefinita, la clonazione di una tabella copierà la chiave primaria e la chiave di ordinamento, se disponibili.

      1. **Schema GSI** è selezionato per impostazione predefinita se la tabella da clonare ha un GSI. La clonazione di una tabella copierà la chiave primaria e la chiave di ordinamento dei GSI, se disponibili. È possibile deselezionare lo schema dei GSI per saltarne la clonazione. La clonazione di una tabella copierà le impostazioni di capacità della tabella di base come impostazioni di capacità del GSI. È possibile utilizzare l’operazione `UpdateTable` in Operation builder per aggiornare l’impostazione della capacità dei GSI della tabella dopo il completamento della clonazione.

1. Inserisci il numero di elementi da clonare. Per clonare solo lo schema delle chiavi e facoltativamente lo schema dei GSI, è possibile mantenere il valore **Elementi da clonare** su 0. Il numero massimo di elementi che possono essere clonati è 5000.

1. Seleziona una modalità di capacità:

   1. **Modalità on demand** è selezionato per impostazione predefinita. DynamoDB on-demand pay-per-request offre prezzi per le richieste di lettura e scrittura in modo da pagare solo per ciò che si utilizza. Per ulteriori informazioni, consulta [Modalità on demand di DynamoDB](capacity-mode.md#capacity-mode-on-demand).

   1. **Modalità con provisioning** consente di specificare il numero di letture e scritture al secondo necessarie per l’applicazione. È possibile utilizzare il dimensionamento automatico per regolare automaticamente la capacità assegnata della tabella in risposta alle modifiche del traffico. Per ulteriori informazioni, consulta [Modalità con provisioning di DynamoDB](provisioned-capacity-mode.md).

1. Seleziona **Clona** per iniziare la clonazione.

1. Il processo di clonazione verrà eseguito in background. La scheda **Operation builder** mostrerà una notifica in caso di modifica dello stato della tabella di clonazione. È possibile accedere a questo stato selezionando la scheda **Operation builder** e quindi selezionando il pulsante con la freccia. Il pulsante con la freccia si trova sul widget dello stato della clonazione della tabella situato nella parte inferiore della barra laterale del menu.

# Esportazione di dati in un file CSV
<a name="workbench.querybuilder.exportcsv"></a>

Puoi esportare i risultati di una query da Operation Builder in un file CSV. Questa operazione consente di caricare i dati in un foglio di calcolo o di elaborarli utilizzando il linguaggio di programmazione preferito.

**Esportazione in CSV**

1. In Operation Builder, esegui un'operazione a tua scelta, ad esempio una scansione o una query.
**Nota**  
È possibile esportare solo i risultati delle operazioni API di lettura e delle istruzioni PartiQL in un file CSV. Non è possibile esportare i risultati delle istruzioni di lettura delle transazioni.
Attualmente è possibile esportare i risultati una pagina alla volta in un file CSV. Se sono presenti più pagine di risultati, è necessario esportare ogni pagina singolarmente.

1. Seleziona gli elementi che desideri esportare dai risultati.

1. Dal menu a discesa **Operazioni**, seleziona **Esporta come CSV**.

1. Scegli un nome del file e una posizione per il file CSV e seleziona **Save (Salva)**.