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

# Inizia a usare Aurora DSQL Query Editor
<a name="getting-started-query-editor"></a>

Con Aurora DSQL Query Editor, puoi connetterti in modo sicuro ai tuoi cluster Aurora DSQL ed eseguire query SQL direttamente dalla console di gestione senza installare o configurare client esterni. AWS Fornisce uno spazio di lavoro intuitivo con evidenziazione della sintassi integrata, completamento automatico e assistenza intelligente del codice. È possibile esplorare rapidamente gli oggetti dello schema, sviluppare ed eseguire query SQL e visualizzare i risultati, il tutto all'interno di un'unica interfaccia.

Questo argomento illustra i passaggi per connettersi a un cluster, eseguire query, visualizzare i risultati ed esplorare funzionalità avanzate come i piani di esecuzione.

**Nota**  
L'editor di query è disponibile in tutte le regioni in cui è supportato Aurora DSQL. Per ulteriori dettagli sulla disponibilità regionale, consulta Servizi [AWS regionali](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).

## Prerequisiti
<a name="query-editor-prerequisites"></a>

Prima di iniziare, verifica che siano soddisfatti i seguenti requisiti preliminari:
+ È disponibile almeno un cluster Aurora DSQL. Per ulteriori dettagli sulla creazione di cluster, consulta. [Passo 1: Creazione di cluster Aurora DSQL a Regione singola](getting-started.md#getting-started-create-cluster)
+ L'endpoint del cluster è accessibile pubblicamente. L'editor di query non supporta i cluster con accesso pubblico bloccato da policy basate su risorse o cluster gestiti tramite endpoint VPC. Per ulteriori dettagli sulle restrizioni di accesso, consulta e. [Blocco dell'accesso pubblico con politiche basate sulle risorse in Aurora DSQL](rbp-block-public-access.md) [Gestione e connessione ai cluster SQL di Amazon Aurora tramite AWS PrivateLink](privatelink-managing-clusters.md)
+ Il tuo utente o ruolo IAM dispone delle autorizzazioni necessarie per accedere e connettersi al cluster. Per maggiori dettagli sulle autorizzazioni, consulta. [Utilizzo dei ruoli del database e dell’autenticazione IAM](using-database-and-iam-roles.md)

## Utilizzo del Query Editor
<a name="query-editor-working"></a>

### Aprire il Query Editor
<a name="query-editor-open"></a>

**Per aprire il Query Editor**

1. Apri la console [Aurora DSQL](https://console.aws.amazon.com/dsql).

1. Nel pannello di navigazione, scegliere **Editor della query**.

In alternativa, dalla pagina **Cluster**, seleziona il cluster su cui desideri interrogare e scegli **Connect with Query editor** per avviare direttamente l'editor.

**Nota**  
Lo stato di lavoro e di connessione non vengono salvati. Se si esce dalla console Aurora DSQL, si chiude la scheda del browser o si esce, le connessioni, il testo della query e i risultati vengono persi.

### Connessione a un cluster
<a name="query-editor-connect"></a>

**Per connettersi a un cluster**

1. Se non esiste alcuna connessione al cluster, l'editor visualizza **Nessun cluster è stato connesso**. Scegli **Connetti** o seleziona **\$1** (Aggiungi) nel riquadro **Cluster Explorer** per connetterti a un cluster esistente.

1. (Facoltativo) Connettiti a più cluster o allo stesso cluster utilizzando ruoli diversi.

### Esplora gli oggetti del cluster
<a name="query-editor-explore"></a>

Cluster Explorer visualizza tutte le connessioni al cluster disponibili e consente di sfogliare oggetti come database, schemi, tabelle e viste. Fornisce inoltre azioni comuni come **Aggiorna**, **Crea tabella** e altre opzioni specifiche del contesto.

### Esecuzione di query
<a name="query-editor-run-queries"></a>

**Per eseguire una query**

1. Nel riquadro della scheda dell'editor di query, inserisci l'istruzione SQL. Esempio:

   ```
   SELECT * FROM public.orders LIMIT 10;
   ```

1. Verifica il **contesto del cluster attivo** visualizzato nella parte superiore destra della scheda di interrogazione. Ciò indica la connessione al cluster associata alla scheda di interrogazione corrente.

1. (Facoltativo) Utilizza il menu a discesa delle **connessioni** per esaminare tutte le connessioni disponibili o passare a un cluster diverso. La modifica della connessione aggiorna il punto in cui vengono eseguite le query in quella scheda.

1. Per eseguire la query, scegli **Esegui**.

**Nota**  
Ogni query può restituire fino a 10.000 righe nel riquadro dei risultati. Per set di dati più grandi, perfeziona la tua query con filtri o limiti.

### Rivedi i risultati e i piani di esecuzione
<a name="query-editor-view-results"></a>

Dopo l'esecuzione della query, esaminate l'output nel **pannello Risultati** nella parte inferiore dell'editor. Per impostazione predefinita, a ogni esecuzione di query viene visualizzata la scheda **Risultati (tabella)**, che mostra l'output delle query in formato tabulare.

Per ottenere il piano di esecuzione delle query, esegui `EXPLAIN ANALYZE` o `EXPLAIN ANALYZE VERBOSE` per ottenere ulteriori informazioni sulle prestazioni delle query. Per ulteriori dettagli sui piani di esecuzione, vedere[Leggere i piani di Aurora DSQL EXPLAIN](reading-dsql-explain-plans.md).

**Suggerimento**  
Il `EXPLAIN ANALYZE VERBOSE` comando visualizza le stime sull'utilizzo della DPU, inclusi i valori Compute, Read, Write e Total DPU, fornendo una visibilità immediata delle risorse utilizzate dalle singole istruzioni SQL.