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à.
# Utilizzo dell’editor di query Aurora
L’editor di query Aurora consente di eseguire le istruzioni SQL sul cluster di database Aurora tramite la Console di gestione AWS. È possibile eseguire query SQL, istruzioni di manipolazione dei dati (DML) e istruzioni di definizione dei dati (DDL). L’utilizzo dell’interfaccia della console consente di eseguire la manutenzione del database, produrre report e condurre esperimenti SQL. È possibile evitare di configurare la configurazione di rete per la connessione al cluster DB da un sistema client separato, EC2 ad esempio un'istanza o un computer portatile.
L’editor di query richiede un cluster di database Aurora con l’API dati in RDS (API dati) abilitata. Per informazioni sui cluster di database che supportano l’API dati e su come abilitarla, consulta [Utilizzo dell’API dati di Amazon RDS](data-api.md). Il codice SQL che è possibile eseguire è soggetto alle limitazioni dell’API dati. Per ulteriori informazioni, consulta [Limitazioni dell’API dati di Amazon RDS](data-api.limitations.md).
## Disponibilità dell'editor di query
L'editor di query è disponibile per i cluster Aurora DB che utilizzano le versioni dei motori Aurora MySQL e Aurora PostgreSQL che supportano Data API e dove Data API è disponibile. Regioni AWS Per ulteriori informazioni, consulta [Regioni e motori di database Aurora supportati per l’API dati RDS](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md).
## Autorizzazione di accesso all'editor della query
Un utente deve essere autorizzato a eseguire query nell'editor della query. È possibile autorizzare un utente a eseguire query nell'editor di query aggiungendo la policy, una `AmazonRDSDataFullAccess` policy predefinita (IAM), a quell'utente. AWS Identity and Access Management
**Nota**
Assicurarsi di utilizzare lo stesso nome utente e password utilizzati per l’utente del database, ad esempio il nome utente e la password amministrativi, quando si crea l’utente IAM. Per ulteriori informazioni, consulta [Creazione di un utente IAM nell'Account AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) nella *Guida per l'utente di AWS Identity and Access Management*.
Puoi anche creare una policy IAM che concede l'accesso all'editor della query. Dopo aver creato la policy, aggiungila a ciascun utente che richiede l'accesso all'editor della query.
La seguente policy fornisce le autorizzazioni minime richieste per un utente per accedere all'editor della query.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryEditor0",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue",
"secretsmanager:PutResourcePolicy",
"secretsmanager:PutSecretValue",
"secretsmanager:DeleteSecret",
"secretsmanager:DescribeSecret",
"secretsmanager:TagResource"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*"
},
{
"Sid": "QueryEditor1",
"Effect": "Allow",
"Action": [
"secretsmanager:GetRandomPassword",
"tag:GetResources",
"secretsmanager:CreateSecret",
"secretsmanager:ListSecrets",
"dbqms:CreateFavoriteQuery",
"dbqms:DescribeFavoriteQueries",
"dbqms:UpdateFavoriteQuery",
"dbqms:DeleteFavoriteQueries",
"dbqms:GetQueryString",
"dbqms:CreateQueryHistory",
"dbqms:UpdateQueryHistory",
"dbqms:DeleteQueryHistory",
"dbqms:DescribeQueryHistory",
"rds-data:BatchExecuteStatement",
"rds-data:BeginTransaction",
"rds-data:CommitTransaction",
"rds-data:ExecuteStatement",
"rds-data:RollbackTransaction"
],
"Resource": "*"
}
]
}
```
------
Per informazioni sulla creazione di una policy IAM, consulta [Creazione di policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) nella *Guida per l'utente di AWS Identity and Access Management*.
Per informazioni sull'aggiunta di una policy IAM a un utente, consulta [Aggiunta e rimozione di autorizzazioni per identità IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) nella *Guida per l'utente di AWS Identity and Access Management*.
## Esecuzione di query nell'editor della query
È possibile eseguire le istruzioni SQL in un cluster di database Aurora nell’editor di query. Il codice SQL che è possibile eseguire è soggetto alle limitazioni dell’API dati. Per ulteriori informazioni, consulta [Limitazioni dell’API dati di Amazon RDS](data-api.limitations.md).
**Per eseguire una query nell'editor della query**
1. Accedi a Console di gestione AWS e apri la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Nell'angolo superiore destro diConsole di gestione AWS, scegli il cluster Regione AWS in cui hai creato i cluster Aurora DB su cui desideri interrogare.
1. Nel pannello di navigazione, seleziona **Database**.
1. Scegliere il cluster di database Aurora su cui eseguire le query SQL.
1. In **Actions (Operazioni)**, scegliere **Query**. Se è la prima volta che si esegue la connessione al database, viene visualizzata la pagina **Connect to database (Connetti al database)**.
![\[Pagina Editor della query - Connetti al database\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png)
1. Immetti le seguenti informazioni:
1. Per l’**istanza o il cluster di database**, scegliere il cluster di database Aurora su cui eseguire le query SQL.
1. In **Database username (Nome utente del database)**, scegliere il nome utente dell'utente del database a cui connettersi o selezionare **Add new database credentials (Aggiungi nuove credenziali del database**. Se si sceglie **Add new database credentials (Aggiungi nuove credenziali del database)**, immettere il nome utente per le nuove credenziali del database in **Enter database username (Immetti il nome utente database)**.
1. In **Enter database password (Immetti la password database)**, immettere la password per l'utente del database scelto.
1. Nell'ultima casella, immettere il nome del database o dello schema da utilizzare per il cluster database Aurora.
1. Scegliere **Connect to database (Connetti al database)**.
**Nota**
Se la connessione ha esito positivo, le informazioni relative a connessione e autenticazione vengono archiviate in Gestione dei segreti AWS. Non è necessario inserire nuovamente le informazioni di connessione.
1. Nell'editor della query, immettere la query SQL che si desidera eseguire sul database.
![\[Editor di query con un’istruzione SQL nell’area di testo\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png)
Ogni istruzione SQL è sottoposta automaticamente a commit o è possibile eseguire istruzioni SQL in uno script come parte di una transazione. Per controllare questo comportamento, scegliere l'icona a forma di ingranaggio sopra la finestra di query.
![\[icona a forma di ingranaggio nell'editor della query\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png)
Viene visualizzata la finestra **Query Editor Settings (Impostazioni editor della query)**.
![\[Query Editor Settings (Impostazioni editor della query)\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png)
Se si sceglie **Auto-commit (Commit automatico)**, viene eseguito automaticamente il commit di ogni istruzione SQL. Se si sceglie **Transazione**, è possibile eseguire un gruppo di istruzioni in uno script. Alla fine dello script viene eseguito automaticamente il commit delle istruzioni a meno che prima non sia stato eseguito esplicitamente il commit o il rollback. Inoltre, è possibile scegliere di interrompere uno script in esecuzione se si verifica un errore abilitando **Stop on error (Interrompi in caso di errore)**.
**Nota**
In un gruppo di istruzioni, le istruzioni DDL (Data Definition Language) possono causare il commit di istruzioni DML (Data Manipulation Language) precedenti. È possibile anche includere istruzioni `COMMIT` e `ROLLBACK` in un gruppo di istruzioni in uno script.
Dopo aver effettuato le scelte nella finestra **Query Editor Settings (Impostazioni editor della query)**, scegliere **Save (Salva)**.
1. Scegliere **Run (Esegui)** o premere Ctrl\$1Invio. L'editor della query visualizza i risultati della query.
Dopo aver eseguito la query, salvarla in **Saved queries (Query salvate)** scegliendo **Save As (Salva con nome)**.
Esportare i risultati della query in formato foglio di calcolo scegliendo **Export to csv (Esporta in formato .csv)**.
Puoi trovare, modificare ed eseguire nuovamente query precedenti. A tale scopo, seleziona la scheda **Recent (Recente)** o **Saved queries (Query salvate)**, scegli il testo della query, quindi seleziona **Run (Esegui)**.
Per cambiare il database, scegli **Change database (Cambia database)**.
# Riferimento all’API DBQMS (Database Query Metadata Service)
Il Database Query Metadata Service (`dbqms`) è un servizio solo interno. Fornisce le query recenti e salvate per l'editor di query nella Console di gestione AWS per più servizi AWS, tra cui Amazon RDS.
**Topics**
+ [CreateFavoriteQuery](#CreateFavoriteQuery)
+ [CreateQueryHistory](#CreateQueryHistory)
+ [CreateTab](#CreateTab)
+ [DeleteFavoriteQueries](#DeleteFavoriteQueries)
+ [DeleteQueryHistory](#DeleteQueryHistory)
+ [DeleteTab](#DeleteTab)
+ [DescribeFavoriteQueries](#DescribeFavoriteQueries)
+ [DescribeQueryHistory](#DescribeQueryHistory)
+ [DescribeTabs](#DescribeTabs)
+ [GetQueryString](#GetQueryString)
+ [UpdateFavoriteQuery](#UpdateFavoriteQuery)
+ [UpdateQueryHistory](#UpdateQueryHistory)
+ [UpdateTab](#UpdateTab)
## CreateFavoriteQuery
Salva una nuova query preferita. Ogni utente può creare fino a 1000 query salvate. Questo limite è soggetto a modifiche in futuro.
## CreateQueryHistory
Salva una nuova voce della cronologia delle query.
## CreateTab
Salva una nuova scheda della query. Ogni utente può creare fino a 10 schede di query.
## DeleteFavoriteQueries
Elimina una o più query salvate.
## DeleteQueryHistory
Elimina le voci della cronologia delle query.
## DeleteTab
Elimina le voci della scheda di query.
## DescribeFavoriteQueries
Elenca le query salvate create da un utente in un determinato account.
## DescribeQueryHistory
Elenca le voci della cronologia delle query.
## DescribeTabs
Elenca le schede delle query create da un utente in un determinato account.
## GetQueryString
Recupera il testo completo della query da un ID di query.
## UpdateFavoriteQuery
Aggiorna la stringa di query, la descrizione, il nome o la data di scadenza.
## UpdateQueryHistory
Aggiorna lo stato della cronologia delle query.
## UpdateTab
Aggiorna il nome della scheda di query e la stringa di query.