

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

# NoSQL Workbench per DynamoDB
<a name="workbench"></a>

 NoSQL Workbench per Amazon DynamoDB è un'applicazione GUI lato client multipiattaforma per operazioni e sviluppo di database moderni. È disponibile per Windows, macOS e Linux. NoSQL Workbench consente di progettare modelli di dati DynamoDB, definire i modelli di accesso come operazioni DynamoDB reali e convalidarli utilizzando dati di esempio. Inoltre, puoi organizzare i tuoi modelli di dati in progetti. NoSQL Workbench include DynamoDB local, che consente di testare tabelle e indici prima di trasferire il modello di dati nel cloud. Per ulteriori informazioni sulla versione locale di DynamoDB e i relativi requisiti, consulta [Configurazione di DynamoDB locale (versione scaricabile)](DynamoDBLocal.md).

**Data modeler**  
 Con NoSQL Workbench for DynamoDB, puoi iniziare un nuovo progetto da zero o utilizzare un progetto di esempio che corrisponda al tuo caso d'uso. Quindi, si progettano tabelle e indici secondari globali, si definiscono gli attributi e si configurano dati di esempio. Puoi anche visualizzare i tuoi pattern di accesso come operazioni DynamoDB reali PutItem ( UpdateItem,, Query e altre) ed eseguire queste operazioni sui dati di esempio configurati per verificare che il modello di accesso funzioni come previsto, apportando modifiche al modello di dati in base ai risultati della convalida. Infine, una volta convalidato, affidate il modello a DynamoDB locale o al AWS vostro account per ulteriori test e utilizzo in produzione. Per la collaborazione, puoi importare ed esportare modelli di dati progettati. Per ulteriori informazioni, consulta [Creazione di modelli di dati con NoSQL Workbench](workbench.Modeler.md).

**Operation Builder**  
NoSQL Workbench offre una ricca intergaffia utente grafica per query di sviluppo e test. È possibile utilizzare *Operation builder* per visualizzare, esplorare ed eseguire query sui set di dati in tempo reale. 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. Per ulteriori informazioni, consulta [Esplorazione di set di dati e creazione di operazioni con NoSQL Workbench](workbench.querybuilder.md).

Il video seguente descrive in dettaglio i concetti di modellazione dei dati con NoSQL Workbench.

[![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/p5va6ZX9_o0?si=vqQuf6FjoBuK1phR/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/p5va6ZX9_o0?si=vqQuf6FjoBuK1phR)


**Topics**
+ [

# Download di NoSQL Workbench per DynamoDB
](workbench.settingup.md)
+ [

# Creazione di modelli di dati con NoSQL Workbench
](workbench.Modeler.md)
+ [

# Esplorazione di set di dati e creazione di operazioni con NoSQL Workbench
](workbench.querybuilder.md)
+ [

# Modelli di dati di esempio per NoSQL Workbench
](workbench.SampleModels.md)
+ [

# Cronologia delle versioni di NoSQL Workbench
](WorkbenchDocumentHistory.md)

# Download di NoSQL Workbench per DynamoDB
<a name="workbench.settingup"></a>

Segui queste istruzioni per scaricare NoSQL Workbench e DynamoDB local per Amazon DynamoDB.

**Per scaricare NoSQL Workbench e la versione locale di DynamoDB**
+ Scaricare la versione appropriata di NoSQL Workbench per il sistema operativo in uso.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/amazondynamodb/latest/developerguide/workbench.settingup.html)

**Nota**  
NoSQL Workbench include DynamoDB local come parte del processo di installazione.  
Per eseguire DynamoDB in locale è richiesta la versione 17.x o successiva di Java Runtime Environment (JRE).

**Nota**  
NoSQL Workbench supporta Ubuntu 12.04, Fedora 21 e Debian 8 o qualsiasi versione più recente di queste distribuzioni Linux.  
Sono necessari due software prerequisiti per le installazioni di Ubuntu: e. `libfuse2` `curl`  
A partire da Ubuntu 22.04, libfuse2 non è più installato per impostazione predefinita. Per risolvere questo problema, `sudo add-apt-repository universe && sudo apt install libfuse2` esegui l'installazione della versione più recente di Ubuntu.  
Per cURL, esegui. `sudo apt update && sudo apt upgrade && sudo apt install curl`

# Creazione di modelli di dati con NoSQL Workbench
<a name="workbench.Modeler"></a>

Puoi utilizzare lo strumento di modellazione dei dati in NoSQL Workbench for Amazon DynamoDB per creare nuovi modelli di dati o per progettare modelli basati su modelli di dati esistenti che soddisfino i modelli di accesso ai dati delle applicazioni. Il data modeler include alcuni esempi di modelli di dati che ti aiutano a iniziare.

**Topics**
+ [

# Creazione di un nuovo modello di dati
](workbench.Modeler.CreateNew.md)
+ [

# Importazione di un modello di dati esistente
](workbench.Modeler.ImportExisting.md)
+ [

# Modifica di un modello di dati esistente
](workbench.Modeler.Edit.md)
+ [

# Aggiunta di dati di esempio a un modello di dati
](workbench.Modeler.AddData.md)
+ [

# Aggiungere e convalidare i modelli di accesso
](workbench.Modeler.AccessPatterns.md)
+ [

# Importazione di dati di esempio da un file CSV
](workbench.Modeler.ImportCSV.md)
+ [

# Facet
](workbench.Modeler.Facets.md)
+ [

# Visualizzazione di tutte le tabelle in un modello di dati utilizzando la visualizzazione aggregata
](workbench.Modeler.AggregateView.md)
+ [

# Esportazione di un modello di dati
](workbench.Modeler.ExportModel.md)
+ [

# Commit di un modello di dati su DynamoDB
](workbench.Modeler.Commit.md)

# Creazione di un nuovo modello di dati
<a name="workbench.Modeler.CreateNew"></a>

Per creare un nuovo modello di dati in Amazon DynamoDB utilizzando NoSQL Workbench, seguire queste istruzioni.

**Per creare un nuovo modello di dati**

1.  **Apri NoSQL Workbench e, nella schermata principale, seleziona Crea modello manualmente.** 

    Si aprirà una nuova pagina con una configurazione vuota per la prima tabella. **NoSQL Workbench crea tutti i nuovi modelli di dati con un nome predefinito (ad esempio untitled-2) e li aggiunge alla cartella del progetto Drafts.** 

1.  Nella schermata di configurazione della **tabella, specifica quanto segue**: 
   +  **Nome tabella**: inserire un nome univoco per la tabella. 
   +  **Chiave di partizione**: immettete il nome di una chiave di partizione e specificatene il tipo. Facoltativamente, puoi anche selezionare un formato di tipo di dati più granulare per la generazione di dati di esempio. 
   +  Se desideri aggiungere una chiave di **ordinamento, specifica il nome della chiave** di ordinamento e il relativo tipo. Facoltativamente, puoi selezionare un formato di tipo di dati più granulare per la generazione di dati di esempio. 
**Nota**  
 Per ulteriori informazioni sulla progettazione della chiave primaria, sulla progettazione e sull'uso efficace delle chiavi di partizione e sull'uso delle chiavi di ordinamento, consulta quanto segue:   
 [Chiave primaria](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey) 
 [Best practice per la progettazione delle chiavi di partizione e relativo uso in DynamoDB](bp-partition-key-design.md) 
 [Best practice per l’uso delle chiavi di ordinamento per organizzare i dati in DynamoDB](bp-sort-keys.md) 

1. È possibile aggiungere altri attributi per convalidare più chiaramente il modello e gli schemi di accesso. Per aggiungere altri attributi:
   +  Seleziona **Aggiungi attributo**. 
   +  Specifica il nome e il tipo attributo. 
   +  Facoltativamente, puoi selezionare un formato di tipo di dati più granulare per la generazione di dati di esempio. 

1.  Per aggiungere un indice globale generale, seleziona **Aggiungi indice secondario globale**. Specifica il **Nome indice secondario globale**, l'attributo **Chiave di partizione** e **Tipo di proiezione**. 

   Per ulteriori informazioni sull'utilizzo di indici secondari globali in DynamoDB, consulta [Indici secondari globali](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html).

1.  Facoltativamente, **aggiungi una sfaccettatura**. Un facet è un costrutto virtuale in NoSQL Workbench. Non è un costrutto funzionale in DynamoDB. Le sfaccettature in NoSQL Workbench consentono di visualizzare i diversi modelli di accesso ai dati di un'applicazione per DynamoDB con solo un sottoinsieme di dati in una tabella. 
**Nota**  
 Ti consigliamo di utilizzare [Aggiungere e convalidare i modelli di accesso](workbench.Modeler.AccessPatterns.md) per visualizzare come l'applicazione accederà ai dati in DynamoDB anziché Facets. I modelli di accesso rispecchiano le interazioni effettive del database e consentono di creare il modello di dati corretto per il proprio caso d'uso, mentre i facet sono visualizzazioni non funzionali. 

    Scegliere **Add Facet (Aggiungi facet)**. Specificare le impostazioni seguenti: 
   +  Il **Facet name (Nome facet)**. 
   +  Un **Alias della chiave di partizione** per aiutare a distinguere questa vista del facet. 
   +  Un **alias della chiave Sort** se hai fornito una chiave di **ordinamento** per la tabella. 
   +  Scegliete gli **attributi** che fanno parte di questa sfaccettatura. 

    Ripeti questo passaggio se desideri aggiungere altre sfaccettature. 

1.  Infine, fai clic sul pulsante **Salva** per creare la tabella. 

1.  Se hai bisogno di altre **tabelle** o **indici secondari globali**, fai clic sull'icona **\$1** sopra la tabella che hai appena creato. 

# Importazione di un modello di dati esistente
<a name="workbench.Modeler.ImportExisting"></a>

Ora è possibile utilizzare NoSQL Workbench per Amazon DynamoDB per creare un modello di dati importando e modificando un modello esistente. Adesso è possibile importare i modelli di dati in formato modello NoSQL Workbench o in [Formato modello AWS CloudFormation JSON](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).

**Per importare un modello di dati**

1.  **Apri NoSQL Workbench e, nella schermata principale, seleziona Importa modello.** È possibile importare un formato di modello NoSQL Workbench o un modello JSON. CloudFormation 

1.  È possibile aggiungere il modello importato a un progetto esistente o creare un nuovo progetto. Se non scegli un progetto diverso, il modello verrà aggiunto alla cartella delle bozze del progetto. 

1.  Fate clic su **Sfoglia il desktop** e scegliete un modello da importare dal computer. 

# Modifica di un modello di dati esistente
<a name="workbench.Modeler.Edit"></a>

**Per modificare un modello esistente**

1. Per iniziare ad apportare modifiche a un modello esistente, aprite il modello nella pagina del modellatore.

1. Nel pannello di selezione delle risorse, vedrai l'elenco delle **tabelle** e degli indici **secondari globali**.

1. Per modificare una **tabella** o un **indice secondario globale**, fai prima clic sul suo nome nel pannello di selezione delle risorse, quindi utilizza le icone di azione in alto. **Le azioni disponibili sono **Elimina**, **Duplica** e Modifica.**

1. Se desideri modificare **i dettagli del modello**, fai clic sull'icona a tre punti accanto al nome del modello.

1. Da lì, puoi fare clic su **Modifica dettagli del modello** e modificare le informazioni di conseguenza.

1. Puoi anche **duplicare**, **spostare**, **eliminare** ed **esportare** il modello dallo stesso menu.

1. Per passare a un altro modello, puoi passare nuovamente alla schermata principale o utilizzare il menu a discesa di selezione del modello. 

# Aggiunta di dati di esempio a un modello di dati
<a name="workbench.Modeler.AddData"></a>

**Per generare automaticamente dati di esempio**

1. Apri NoSQL Workbench e, nella schermata principale, fai clic sul nome del modello a cui desideri aggiungere dati di esempio.

1. **Fai clic sulle azioni aggiuntive (icona a tre punti) nella barra degli strumenti del contenuto principale e seleziona Aggiungi dati di esempio.**

1. **Inserisci il numero di elementi di dati di esempio che desideri generare, quindi seleziona Conferma.**

1. La generazione automatica di dati di esempio consente di generare da 1 a 5000 righe di dati per un utilizzo immediato. Puoi specificare un tipo di dati di esempio granulari per creare dati realistici in base alle esigenze di progettazione e test. Per utilizzare la capacità di generare dati realistici, devi specificare il formato del tipo di dati di esempio per gli attributi nel Data modeler. Vedi [Creazione di un nuovo modello di dati](workbench.Modeler.CreateNew.md) per specificare i formati dei tipi di dati di esempio.

**Per aggiungere dati di esempio un elemento alla volta**

1. Apri il modello che desideri modificare, quindi scegli la tabella a cui desideri aggiungere i dati di esempio. Fai clic sulle azioni aggiuntive (icona a tre punti) nella barra degli strumenti del contenuto principale e seleziona **Modifica** dati.

1. Ora puoi aggiungere, eliminare e modificare righe. Dopo aver apportato le modifiche necessarie, fai clic sul pulsante **Salva**.

# Aggiungere e convalidare i modelli di accesso
<a name="workbench.Modeler.AccessPatterns"></a>

*Puoi utilizzare NoSQL Workbench per Amazon DynamoDB per creare, archiviare e convalidare modelli di accesso.*

**Nota**  
 Consulta [Identifica i tuoi modelli di accesso ai dati per maggiori dettagli sull'identificazione dei modelli](https://docs.aws.amazon.com/prescriptive-guidance/latest/dynamodb-data-modeling/step3.html) di accesso corretti. 

**Per creare un modello di accesso**

1.  Apri NoSQL Workbench e, nella schermata principale, fai clic sul nome del modello a cui desideri aggiungere i modelli di accesso. 

1.  **Sul lato sinistro, scegli la scheda **Access patterns** e fai clic sull'icona \$1.** 

1.  Nella schermata successiva, fornisci un **nome**, una **descrizione** opzionale, il **tipo** di modello di accesso e la **tabella** o l'**indice secondario globale** in base al quale testare il modello di accesso. 
**Nota**  
 NoSQL Workbench attualmente supporta le seguenti operazioni per i modelli di accesso`Scan`:`Query`,,,,,`GetItem`. `PutItem` `UpdateItem` `DeleteItem` Amazon DynamoDB supporta un elenco più ampio di operazioni. 

1.  Dopo aver creato un modello di accesso, puoi passare alla scheda **Convalida** per verificare che il modello di dati sia progettato per restituire i risultati previsti per il modello di accesso. Vedi [Aggiunta di dati di esempio a un modello di dati](workbench.Modeler.AddData.md) i dettagli su come generare automaticamente dati di esempio per le tue tabelle. Diversi tipi di modelli di accesso supporteranno diversi parametri di input. 
**Nota**  
Per convalidare i modelli di accesso, NoSQL Workbench avvia un database locale DynamoDB separato `8001` sulla porta (per impostazione predefinita) con tabelle e indici archiviati in memoria.  
NoSQL Workbench aggiunge automaticamente i dati di esempio dal modello alle tabelle temporanee.
Se modifichi i dati di esempio o il modello di dati stesso, NoSQL Workbench aggiornerà le tabelle temporanee.
Questo database temporaneo viene cancellato quando si chiude l'applicazione.

**Per modificare i modelli di accesso**

1.  Apri NoSQL Workbench e, nella schermata principale, fai clic sul nome del modello per cui desideri modificare i modelli di accesso. 

1.  Sul lato sinistro, scegli la scheda **Access** patterns. 

1. Per modificare uno schema di accesso, selezionalo dall'elenco a sinistra.

1. Nella barra in alto, fai clic sul pulsante **Modifica** azione.

# Importazione di dati di esempio da un file CSV
<a name="workbench.Modeler.ImportCSV"></a>

Se disponi di dati di esempio preesistenti in un file CSV, puoi importarli in NoSQL Workbench. Questo consente di popolare rapidamente il modello con dati di esempio senza doverli inserire riga per riga.

I nomi delle colonne nel file CSV devono corrispondere ai nomi degli attributi nel modello di dati, ma non devono necessariamente essere nello stesso ordine. Ad esempio, se il modello di dati contiene attributi chiamati `LoginAlias`, `FirstName` e `LastName`, le colonne del file CSV potrebbero essere `LastName`, `FirstName` e `LoginAlias`.

Puoi importare fino a 150 righe alla volta da un file CSV.

**Per importare dati da un file CSV in NoSQL Workbench**

1. Per importare dati CSV in una **tabella**, fai prima clic sul nome della tabella nel pannello delle risorse, quindi fai clic sulle azioni aggiuntive (icona a tre punti) nella barra degli strumenti del contenuto principale.

1. Seleziona **Importa** dati di esempio.

1. Seleziona il file CSV e scegli **Open** (Apri). I dati CSV vengono aggiunti alla tabella.

# Facet
<a name="workbench.Modeler.Facets"></a>

 In NoSQL Workbench*,* Facets consente di visualizzare un sottoinsieme di dati in una tabella, senza dover visualizzare record che non soddisfano i vincoli del facet. I facet sono considerati uno strumento di modellazione visiva dei dati e non esistono come costrutto utilizzabile in DynamoDB, in quanto sono puramente un aiuto alla modellazione dei modelli di accesso. 

**Nota**  
 Ti consigliamo di utilizzare [Aggiungere e convalidare i modelli di accesso](workbench.Modeler.AccessPatterns.md) per visualizzare come l'applicazione accederà ai dati in DynamoDB anziché Facets. I modelli di accesso rispecchiano le interazioni effettive del database e consentono di creare il modello di dati corretto per il proprio caso d'uso, mentre i facet sono visualizzazioni non funzionali. 

**Per creare una sfaccettatura**

1. Nel pannello di selezione delle risorse, scegli una **tabella** che desideri modificare

1. Nella barra in alto, fai clic sull'icona **Modifica** azione.

1. Scorri verso il basso fino alla sezione **Filtri Facet**.

1.  Scegliere **Add Facet (Aggiungi facet)**. Specificare le impostazioni seguenti: 
   +  Il **Facet name (Nome facet)**. 
   +  Un **Alias della chiave di partizione** per aiutare a distinguere questa vista del facet. 
   +  Un **alias della chiave di ordinamento** se hai fornito una **chiave di ordinamento** per la tabella. 
   +  Scegliete gli **attributi** che fanno parte di questa sfaccettatura. 

    Ripeti questo passaggio se desideri aggiungere altre sfaccettature. 

# Visualizzazione di tutte le tabelle in un modello di dati utilizzando la visualizzazione aggregata
<a name="workbench.Modeler.AggregateView"></a>

La vista aggregata in NoSQL Workbench per Amazon DynamoDB consente di visualizzare tutte le tabelle e gli indici in un modello di dati. Per ogni tabella, vengono visualizzate le seguenti informazioni:
+ Nomi di colonna delle tabelle
+ Dati campione
+ Tutti gli indici secondari globali associati alla tabella. NoSQL Workbench visualizza le seguenti informazioni per ogni indice:
  + Nomi colonna indice
  + Dati campione

**Per visualizzare tutte le informazioni della tabella**

1. Apri NoSQL Workbench e, nella schermata principale, fai clic sul nome del modello che desideri aprire.

1. **Nella barra in alto, fai clic su Visualizzazione aggregata.** Vedrai i dati di tutte le tabelle e gli indici sulla stessa schermata.

**Per esportare la vista aggregata come immagini**

1. **Con la **visualizzazione aggregata** selezionata, fai clic sull'icona a tre punti e scegli Esporta vista aggregata**

1. Un archivio con immagini PNG di tutte le tabelle e gli indici verrà presentato per il download.

# Esportazione di un modello di dati
<a name="workbench.Modeler.ExportModel"></a>

Dopo aver creato un modello utilizzando NoSQL Workbench per Amazon DynamoDB, è possibile salvare ed esportare il modello in formato NoSQL Workbench oppure in [Formato modello AWS CloudFormation JSON](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).

**Per esportare un modello di dati**

1. Apri NoSQL Workbench e, nella schermata principale, fai clic sul nome del modello che desideri modificare.

1. **Fai clic sull'icona a tre punti accanto al nome del modello di dati e seleziona Esporta modello.**

1.  Scegli se esportare il tuo modello di dati nel formato modello NoSQL Workbench o nel formato CloudFormation modello JSON. 
   +  Scegli il formato del modello **NoSQL Workbench** se desideri condividere il tuo modello con altri membri del team utilizzando NoSQL Workbench o importarlo in NoSQL Workbench in un secondo momento. 
   +  Scegli il formato **modello CloudFormation JSON se desideri distribuire il modello** direttamente o integrarlo nel tuo flusso di lavoro. AWS infrastructure-as-code 

# Commit di un modello di dati su DynamoDB
<a name="workbench.Modeler.Commit"></a>

 Una volta soddisfatti del proprio modello di dati, è possibile eseguire il commit del modello su Amazon DynamoDB. 

**Nota**  
Questa azione crea risorse lato server AWS per le tabelle e gli indici secondari globali rappresentati nel modello di dati.
NoSQL Workbench crea tabelle e indici con capacità su richiesta per impostazione predefinita.

**Come eseguire il commit del modello di dati su DynamoDB**

1. Apri NoSQL Workbench e, nella schermata principale, fai clic sul nome del modello di cui desideri eseguire il commit.

1. **Nella barra in alto, fai clic su Commit.**

1. Scegli una connessione esistente o crea una nuova connessione facendo clic sul pulsante **Aggiungi nuova connessione**.
   + Per aggiungere una nuova connessione, specificare le informazioni seguenti:
     + **Account Alias (Alias account)**
     + **AWS Region**
     + **ID chiave di accesso**
     + **Chiave di accesso segreta**

     Per ulteriori informazioni su come ottenere le chiavi di accesso, vedi [Ottenere una chiave di AWS accesso](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. Se preferisci usare [DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) in locale:

   1. Scegli la scheda **Connessione locale.**

   1. Fai clic sul pulsante **Aggiungi nuova connessione**.

   1. Specifica **Nome della connessione** e **Porta**.
**Nota**  
 Per utilizzare DynamoDB in locale, è necessario attivarlo utilizzando l'interruttore locale di **DynamoDB in basso a sinistra nella schermata NoSQL** Workbench. 

1. **Fai clic su Conferma.**

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

# Modelli di dati di esempio per NoSQL Workbench
<a name="workbench.SampleModels"></a>

La home page del modellatore mostra una serie di modelli di esempio forniti con NoSQL Workbench. In questa sezione vengono descritti questi modelli e i loro potenziali utilizzi.

**Topics**
+ [

## Modello di dati del dipendente
](#workbench.SampleModels.EmployeeDataModel)
+ [

## Modello di dati del forum di discussione
](#workbench.SampleModels.DiscussionForumDataModel)
+ [

## Modello di dati della libreria musicale
](#workbench.SampleModels.MusicLibraryDataModel)
+ [

## Modello di dati della stazione sciistica
](#workbench.SampleModels.SkiResortDataModel)
+ [

## Modello di dati delle offerte per carta di credito
](#workbench.SampleModels.CreditCardOffersDataModel)
+ [

## Modello di dati dei segnalibri
](#workbench.SampleModels.BookmarksDataModel)

## Modello di dati del dipendente
<a name="workbench.SampleModels.EmployeeDataModel"></a>

Questo modello di dati è un modello introduttivo. Rappresenta i dettagli di base di un dipendente, ad esempio alias univoco, nome, cognome, designazione, manager e competenze.

Questo modello di dati descrive alcune tecniche come la gestione di attributi complessi per ad esempio più di una competenza. Questo modello è anche un esempio di one-to-many relazione tra il manager e i relativi dipendenti dichiaranti che è stata raggiunta dall'indice secondario. DirectReports

I modelli di accesso agevolati da questo modello di dati sono:
+ Recupero del record di un dipendente utilizzando l'alias di accesso del dipendente, agevolato dalla tabella chiamata `Employee`.
+ Ricerca del dipendente per nome, facilitata dall'indice secondario globale della tabella Employee chiamato `Name`.
+ Recupero di tutti i report diretti di un manager utilizzando l'alias di accesso del manager, agevolato dall'indice secondario globale della tabella Employee chiamato `DirectReports`.

## Modello di dati del forum di discussione
<a name="workbench.SampleModels.DiscussionForumDataModel"></a>

Questo modello di dati rappresenta un forum di discussione. Utilizzando questo modello, i clienti possono interagire con la community degli sviluppatori, porre domande e rispondere ai post degli altri clienti. Ogni servizio AWS ha un forum dedicato. Chiunque può iniziare un nuovo thread di discussione postando un messaggio in un forum e ogni thread può ricevere un numero illimitato di risposte.

I modelli di accesso agevolati da questo modello di dati sono:
+ Recupero di un record del forum utilizzando il nome del forum, agevolato dalla tabella chiamata `Forum`.
+ Recupero di un thread specifico o di tutti i thread per un forum, agevolato dalla tabella chiamata `Thread`.
+ Ricerca delle risposte utilizzando l'indirizzo e-mail dell'utente autore del post, agevolato dall'indice secondario globale della tabella Reply chiamato `PostedBy-Message-Index`.

## Modello di dati della libreria musicale
<a name="workbench.SampleModels.MusicLibraryDataModel"></a>

Questo modello di dati rappresenta una libreria musicale che dispone di una vasta raccolta di canzoni e mostra le canzoni più scaricate in tempo reale.

I modelli di accesso agevolati da questo modello di dati sono:
+ Recupero di un record di canzoni, agevolato dalla tabella denominata `Songs`.
+ Recupero di un record di download specifico o di tutti i record di download per una canzone, agevolato dalla tabella chiamata `Songs`.
+ Recupero di un record di conteggio download mensile specifico o di tutti i record di conteggio download mensili per una canzone, agevolato dalla tabella denominata `Song`.
+ Recupero di tutti i record (inclusi record di canzoni, record di download e record di conteggio download mensili) per una canzone, agevolato dalla tabella chiamata `Songs`.
+ Ricerca delle canzoni più scaricate, agevolata dall'indice secondario globale della tabella Canzoni chiamato `DownloadsByMonth`.

## Modello di dati della stazione sciistica
<a name="workbench.SampleModels.SkiResortDataModel"></a>

Questo modello di dati rappresenta una stazione sciistica che dispone di una vasta raccolta di dati per ogni impianto di risalita acquisiti quotidianamente.

I modelli di accesso agevolati da questo modello di dati sono:
+ Recupero di tutti i dati relativi a un determinato impianto di risalita o complesso turistico, dinamico e statico, facilitato da una tabella denominata `SkiLifts`.
+ Recupero di tutti i dati dinamici (compresi i singoli rider di risalita, la copertura della neve, il pericolo di valanghe e lo stato dell'impianto di risalita) per uno skilift o l'intero resort in una data specifica, agevolato dalla tabella chiamata `SkiLifts`.
+ Recupero di tutti i dati statici (incluso se l'impianto di risalita è solo per rider esperti, i metri verticali risaliti dall'impianto e il tempo di risalita) per uno specifico skilift, agevolato da un tavolo chiamato `SkiLifts`.
+ Recupero della data dei dati registrati per uno specifico impianto di risalita o per l'intera località sciistica, ordinati per numero di ciclisti unici, facilitato dal cosiddetto indice secondario globale della SkiLifts tabella. `SkiLiftsByRiders`

## Modello di dati delle offerte per carta di credito
<a name="workbench.SampleModels.CreditCardOffersDataModel"></a>

Questo modello di dati viene utilizzato da un'applicazione di offerte di carta di credito.

Un fornitore di carte di credito produce offerte nel tempo. Queste offerte includono trasferimenti di denaro senza commissioni, maggiori limiti di credito, tassi di interesse più bassi, cash back e miglia aeree. Dopo che un cliente accetta o rifiuta queste offerte, il rispettivo stato dell'offerta viene aggiornato di conseguenza.

I modelli di accesso agevolati da questo modello di dati sono:
+ Recupero dei record di conto utilizzando `AccountId`, come agevolato dalla tabella principale.
+ Recupero di tutti i conti con poche voci previste, come agevolato dall'indice secondario `AccountIndex`.
+ Recupero dei conti e di tutti i record di offerta associati a tali conti utilizzando `AccountId`, come agevolato dalla tabella principale.
+ Recupero di conti e record di offerta specifici associati a tali conti utilizzando `AccountId` e `OfferId`, come agevolato dalla tabella principale.
+ Recupero di tutti i record di offerta `ACCEPTED/DECLINED` di `OfferType` specifico, associati agli account utilizzando `AccountId`, `OfferType` e `Status`, come agevolato dall'indice secondario `GSI1`.
+ Recupero delle offerte e dei record degli articoli dell'offerta associati utilizzando `OfferId`, come agevolato dalla tabella principale.

## Modello di dati dei segnalibri
<a name="workbench.SampleModels.BookmarksDataModel"></a>

Questo modello di dati viene utilizzato memorizzare i segnalibri per i clienti.

Un cliente può avere molti segnalibri e un segnalibro può appartenere a molti clienti. Questo modello di dati rappresenta una relazione. many-to-many 

I modelli di accesso agevolati da questo modello di dati sono:
+ Una singola query `customerId` può ora restituire i dati dei clienti e i segnalibri.
+ Un indice `ByEmail` di query restituisce i dati dei clienti tramite indirizzo e-mail. Tenere presente che i segnalibri non vengono recuperati da questo indice.
+ Un indice `ByUrl` di query ottiene i dati dei segnalibri in base all'URL. È stata utilizzata la chiave di ordinamento customerId per l'indice perché lo stesso URL può essere il segnalibro per più clienti.
+ Un indice `ByCustomerFolder` di query ottiene segnalibri in base alla cartella per ogni cliente.

# Cronologia delle versioni di NoSQL Workbench
<a name="WorkbenchDocumentHistory"></a>

La tabella seguente descrive le modifiche importanti apportate a ogni versione dello strumento client *NoSQL Workbench*. 


****  

| Versione | Modifica | Descrizione | Data | 
| --- | --- | --- | --- | 
| 3,20,0 | Nuovo Data Modeler per DynamoDB | Data Modeler for DynamoDB offre un'esperienza utente aggiornata. Data Modeler per DynamoDB ora supporta i modelli di accesso. | 16 febbraio 2026 | 
| 3.13.5 | La modalità di capacità per le impostazioni predefinite della tabella è ora on demand | Quando si crea una tabella con impostazioni predefinite, DynamoDB crea una tabella che utilizza la modalità con capacità on demand anziché la modalità con capacità allocata. | 24 febbraio 2025 | 
| 3.13.0 | Miglioramenti a Operation builder di NoSQL Workbench | NoSQL Workbench ora include il supporto nativo per la modalità scura. Sono state migliorate le operazioni su tabelle ed elementi in Operation builder. I risultati degli elementi e le informazioni sulle richieste di Operation Builder sono disponibili in formato JSON. | 24 aprile 2024 | 
| 3.12.0 | Clonazione di tabelle con NoSQL Workbench e restituzione della capacità utilizzata | Ora è possibile clonare le tabelle tra un account del servizio web DynamoDB locale e un account del servizio web DynamoDB o tra account del servizio web DynamoDB per iterazioni di sviluppo più rapide. Ora è possibile visualizzare le RCU o le WCU utilizzate dopo l’esecuzione di un’operazione tramite Operation builder. È stato risolto il problema di sovrascrittura dei dati durante l’importazione da un file CSV. | 26 febbraio 2024  | 
| 3.11.0 |  Miglioramenti di DynamoDB locale  |  Ora è possibile specificare la porta all’avvio dell’istanza di DynamoDB locale integrata. NoSQL Workbench può ora essere installato su Windows senza diritti di amministratore. Sono stati aggiornati i modelli per i modelli di dati.  |  17 gennaio 2024  | 
| 3.10.0 |  Supporto nativo per Apple SIlicon  |   NoSQL Workbench ora include il supporto nativo per Mac con Apple SIlicon. Ora è possibile configurare il formato di generazione dei dati di esempio per gli attributi di tipo `Number`.   |  5 dicembre 2023  | 
| 3.9.0 |  Miglioramenti del Data modeler  |   Il visualizzatore ora supporta il commit di modelli di dati su DynamoDB locale con l'opzione di sovrascrivere le tabelle esistenti.   |  3 novembre 2023  | 
| 3.8.0 |  Generazione di dati di esempio  |  NoSQL Workbench ora supporta la generazione di dati di esempio per i modelli di dati DynamoDB.  |  25 settembre 2023  | 
| 3.6.0 |  Miglioramenti del generatore di operazioni  |  Miglioramenti della gestione delle connessioni nel generatore di operazioni. I nomi degli attributi in Data modeler ora possono essere modificati senza eliminare i dati. Altre correzioni di bug.  |  11 aprile 2023  | 
| 3.5.0 |  Support per nuove AWS regioni  |  NoSQL Workbench ora supporta le regioni ap-south-2, ap-southeast-3, ap-southeast-4, eu-central-2, eu-south-2, me-central-1 e me-west-1.  |  23 febbraio 2023  | 
| 3.4.0 |  Supporto per la versione locale di DynamoDB  |  NoSQL Workbench ora supporta l'installazione della versione locale di DynamoDB come parte del processo di installazione.  |  6 dicembre 2022  | 
| 3.3.0 |  Supporto per operazioni del piano di controllo (control-plane)  |  Operation Builder ora supporta le operazioni del piano di controllo (control-plane).  |  1 giugno 2022  | 
| 3.2.0 |  Importazione ed esportazione di CSV  |  Ora è possibile importare dati di esempio da un file CSV nello strumento Visualizer e anche esportare i risultati di una query di Operation Builder in un file CSV.  |  11 ottobre 2021  | 
| 3.1.0 |  Salvataggio delle operazioni  |  Operation Builder in NoSQL Workbench ora supporta il salvataggio delle operazioni per un utilizzo successivo.  |  12 luglio 2021  | 
| 3.0.0 | Impostazioni della capacità e CloudFormation importazione/esportazione | NoSQL Workbench per Amazon DynamoDB ora supporta la specifica di una modalità di capacità di lettura/scrittura per le tabelle ed è in grado di importare ed esportare modelli di dati in formato CloudFormation . | 21 aprile 2021 | 
| 2.2.0 | Supporto per PartiQL | NoSQL Workbench per Amazon DynamoDB aggiunge il supporto per la creazione di istruzioni PartiQL per DynamoDB. | 4 dicembre 2020 | 
| 1.1.0 | Supporto per Linux. | NoSQL Workbench per Amazon DynamoDB è supportato in Linux-Ubuntu, Fedora e Debian. | 04 maggio 2020 | 
| 1.0.0 | NoSQL Workbench per Amazon DynamoDB – GA. | NoSQL Workbench per Amazon DynamoDB è disponibile al pubblico. | 2 marzo 2020 | 
| 0.4.1 | Supporto per i ruoli IAM e le credenziali di sicurezza temporanee. | NoSQL Workbench per Amazon DynamoDB aggiunge il supporto per i ruoli AWS Identity and Access Management (IAM) e le credenziali di sicurezza temporanee. | 19 dicembre 2019 | 
| 0,31 | Supporto per la [versione locale di DynamoDB (versione scaricabile)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html). | NoSQL Workbench ora supporta la connessione alla [versione locale di DynamoDB (versione scaricabile)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) per progettare, creare, eseguire query e gestire tabelle DynamoDB. | 8 Novembre 2019 | 
| 0,2,1 | Non è stata rilasciata nessuna anteprima di NoSQL Workbench. | Questa è la versione iniziale di NoSQL Workbench per DynamoDB. Utilizza NoSQL Workbench per progettare, creare, interrogare e gestire tabelle DynamoDB. | 16 settembre 2019 | 