# Accesso ad Amazon RDS tramite il AWS Toolkit for JetBrains
Utilizzando Amazon Relational Database Service (Amazon RDS), è possibile eseguire il provisioning e gestire sistemi di database relazionali SQL nel cloud. Utilizzando il AWS Toolkit for JetBrains, è possibile connettersi ai seguenti motori di database Amazon RDS e interagire con essi:
+ Aurora: è un database relazionale compatibile con MySQL e PostgreSQL creato per il cloud. Per ulteriori informazioni, consulta la [https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html).
+ MySQL: Amazon RDS supporta diverse versioni principali del database relazionale open source. Per ulteriori informazioni, consulta la pagina [MySQL su Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html) della *Guida per l'utente di Amazon RDS*.
+ PostgreSQL: Amazon RDS supporta diverse versioni principali del database relazionale a oggetti open source. Per ulteriori informazioni, consulta la pagina [PostgreSQL su Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html) della *Guida per l'utente di Amazon RDS*.
Negli argomenti seguenti vengono descritti i prerequisiti per accedere ai database RDS e come utilizzare il AWS Toolkit for JetBrains per connettersi a un'istanza di database.
**Topics**
+ [Prerequisiti per l'accesso ai database Amazon RDS](rds-access-prerequisities.md)
+ [Connessione a un database Amazon RDS](rds-connection.md)
# Prerequisiti per l'accesso ai database Amazon RDS
Prima di poter effettuare la connessione a un database Amazon RDS utilizzando AWS Toolkit for JetBrains, è necessario completare le seguenti attività:
+ [Creazione di un'istanza di database e configurazione del relativo metodo di autenticazione](#db-authentication)
+ [Download e installazione di DataGrip](#datagrip-info)
## Creazione di un'istanza di database Amazon RDS e configurazione del relativo metodo di autenticazione
AWS Toolkit for JetBrains consente di connettersi a un'istanza di database Amazon RDS già creata e configurata in AWS. Un'istanza di database è un ambiente di database isolato in esecuzione nel cloud che può contenere database multipli creati dall'utente. Per informazioni sulla creazione di istanze di database per i database supportati, consulta la pagina [Getting started with Amazon RDS resources](Amazon RDS User GuideCHAP_GettingStarted.html) nella *Guida per l'utente di Amazon RDS*.
Quando ci si connette a un cluster tramite il AWS Toolkit for JetBrains, gli utenti possono scegliere di autenticarsi utilizzando le credenziali IAM oppure Secrets Manager. La tabella seguente descrive le funzionalità e le risorse informative principali per entrambe le opzioni:
****
| Metodi di autenticazione | Come funziona | Ulteriori informazioni |
| --- | --- | --- |
| Connessione con le credenziali IAM | Con l'autenticazione del database IAM, non occorre archiviare le credenziali dell'utente nel database, perché l'autenticazione è gestita esternamente utilizzando le credenziali AWS Identity and Access Management (IAM).Per impostazione predefinita, l'autenticazione al database mediante IAM è disabilitata nelle istanze di database. Puoi abilitare l'autenticazione database IAM (o disabilitarla di nuovo) tramite la Console di gestione AWS, l'AWS CLI o l'API. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html) |
| Connessione con Gestione dei segreti AWS | Un amministratore database può memorizzare le credenziali per un database come segreto in Secrets Manager. Secrets Manager crittografa e archivia le credenziali all'interno del segreto come *testo segreto protetto*. Quando un'applicazione dotata di autorizzazioni accede al database, Secrets Manager decripta il testo segreto protetto e lo restituisce su un canale protetto. Il client analizza le credenziali restituite, la stringa di connessione e qualsiasi altra informazione richiesta e utilizza tali informazioni per accedere al database. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html) |
## Utilizzo dei database Amazon RDS con DataGrip
Dopo aver eseguito la connessione a un'origine dati Amazon RDS, puoi iniziare a interagire con essa. Utilizzando DataGrip di JetBrains, è possibile eseguire attività di database come la scrittura di SQL, l'esecuzione di query e l'importazione/esportazione di dati. Le funzionalità fornite da DataGrip sono disponibili anche nel plug-in del database per una serie di IDE JetBrains. Per informazioni su DataGrip, consulta la pagina [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).
# Connessione a un database Amazon RDS
Con l'**Esploratore AWS**, puoi selezionare un database Amazon RDS, scegliere un metodo di autenticazione e quindi configurare le impostazioni di connessione. Dopo aver verificato che la connessione funziona, puoi iniziare a interagire con l'origine dati utilizzando JetBrains DataGrip.
**Importante**
Assicurati di aver completato i [prerequisiti](rds-access-prerequisities.md) affinché gli utenti possano accedere ai database Amazon RDS e interagire con essi.
Seleziona una scheda per le istruzioni sulla connessione a un'istanza di database utilizzando il metodo di autenticazione preferito.
------
#### [ Connect with IAM credentials ]
1. Aprire AWS Explorer, se non è già aperto.
1. Fai clic sul nodo **Amazon RDS** per espandere l'elenco dei motori di database supportati.
1. Fai clic su un nodo del motore di database supportato (Aurora, MySQL o PostgreSQL) per espandere l'elenco delle istanze di database disponibili.
**Nota**
Se si seleziona Aurora, è possibile scegliere tra espandere un cluster MySQL e un cluster PostgreSQL.
1. Fai clic con il pulsante destro del mouse su un database e scegli **Connettiti tramite credenziali IAM**.
**Nota**
È anche possibile scegliere **Copia ARN** per aggiungere il nome della risorsa Amazon (ARN) del database agli appunti.
1. Nella finestra di dialogo **Origini dati e driver**, esegui le operazioni seguenti per verificare che sia possibile stabilire una connessione al database:
+ Nel riquadro **Origini dati importati**, verifica che sia selezionata l'origine dati corretta.
+ Se appare il messaggio **Scarica i file dei driver mancanti**, scegli **Vai al driver** (l'icona a forma di chiave inglese) per scaricare i file richiesti.
1. Nella scheda **Generale** del riquadro **Impostazioni**, verifica che i seguenti campi visualizzino i valori corretti:
+ **Host/Porta**: l'endpoint e la porta utilizzati per le connessioni al database. Per i database Amazon RDS ospitati nel cloud AWS, gli endpoint terminano sempre con `rds.amazon.com`. Se ti connetti a un'istanza di database tramite un proxy, utilizza questi campi per specificare i dettagli di connessione del proxy.
+ **Autenticazione**: **AWS IAM** (autenticazione tramite credenziali IAM).
+ **Utente**: il nome dell'account dell'utente del database.
+ **Credenziali**: le credenziali utilizzate per accedere all'account AWS.
+ **Regione**: la regione AWS in cui è ospitato il database.
+ **Host/Porta RDS**: l'endpoint e la porta per il database come elencati nel Console di gestione AWS. Se utilizzi un endpoint diverso per connetterti a un'istanza di database, specifica i dettagli di connessione del proxy nei campi **Host/Porta** (descritti in precedenza).
+ **Database**: il nome del database.
+ **URL**: l'URL che l'IDE JetBrains utilizzerà per la connessione al database.
![\[Impostazioni di connessione per un database Amazon RDS utilizzando le credenziali IAM per l'autenticazione.\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/rds-auth-iam.png)
**Nota**
Per una descrizione completa delle impostazioni di connessione che puoi configurare dalla finestra di dialogo **Origini dati e driver**, consulta la [documentazione relativa all'IDE JetBrains](https://www.jetbrains.com/help/) che stai utilizzando.
1. Per verificare che le impostazioni di connessione siano corrette, scegli **Testa la connessione**.
Un segno di spunta verde indica che il test è andato a buon fine.
1. Scegli **Applica** per applicare le impostazioni, quindi seleziona **OK** per iniziare a utilizzare l'origine dati.
Si apre la finestra degli strumenti **Database**. Le origini dati disponibili vengono visualizzate sotto forma di albero con nodi che rappresentano elementi del database come schemi, tabelle e chiavi.
**Importante**
Per utilizzare la finestra degli strumenti **Database**, devi prima scaricare e installare DataGrip da JetBrains. Per ulteriori informazioni, consulta la pagina [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).
------
#### [ Connect with Secrets Manager ]
1. Aprire AWS Explorer, se non è già aperto.
1. Fai clic sul nodo **Amazon RDS** per espandere l'elenco dei motori di database supportati.
1. Fai clic su un nodo del motore di database supportato (Aurora, MySQL o PostgreSQL) per espandere l'elenco delle istanze di database disponibili.
**Nota**
Se si seleziona Aurora, è possibile scegliere tra espandere un cluster MySQL e un cluster PostgreSQL.
1. Fai clic con il pulsante destro del mouse su un database e scegli **Connettiti tramite Secrets Manager**.
**Nota**
È anche possibile scegliere **Copia ARN** per aggiungere il nome della risorsa Amazon (ARN) del database agli appunti.
1. Nella finestra di dialogo **Seleziona un segreto del database**, utilizza il campo a discesa per selezionare le credenziali per il database, quindi scegli **Crea**.
1. Nella finestra di dialogo **Origini dati e driver**, esegui le operazioni seguenti per verificare che sia possibile stabilire una connessione al database:
+ Nel riquadro **Origini dati importati**, verifica che sia selezionata l'origine dati corretta.
+ Se appare il messaggio **Scarica i file dei driver mancanti**, scegli **Vai al driver** (l'icona a forma di chiave inglese) per scaricare i file richiesti.
1. Nella scheda **Generale** del riquadro **Impostazioni**, verifica che i seguenti campi visualizzino i valori corretti:
+ **Host/Porta**: l'endpoint e la porta utilizzati per le connessioni al database. Per i database Amazon RDS ospitati nel cloud AWS, gli endpoint terminano sempre con `rds.amazon.com`. Se ti connetti a un database tramite un proxy, utilizza questi campi per specificare i dettagli di connessione del proxy.
+ **Autenticazione**: **SecretsManager Auth (autenticazione tramite **Gestione dei segreti AWS).
+ **Credenziali**: le credenziali utilizzate per accedere all'account AWS.
+ **Regione**: la regione AWS in cui è ospitato il database.
+ **Nome/ARN del segreto**: il nome e l'ARN del segreto contenente le credenziali di autenticazione. Per sovrascrivere le impostazioni di connessione nei campi **Host/Porta**, seleziona la casella di controllo **Utilizza l'URL e la porta del segreto**.
+ **Database**: il nome dell'istanza di database selezionata dall'**Esploratore AWS**.
+ **URL**: l'URL che l'IDE JetBrains utilizzerà per la connessione al database.
**Nota**
Se utilizzi Secrets Manager per l'autenticazione, non sono presenti campi per il nome utente e la password per il database. Queste informazioni sono contenute nella parte relativa ai dati segreti crittografati di un segreto.
![\[Impostazioni di connessione utilizzando le credenziali IAM per l'autenticazione.\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/rds-auth-asm.png)
**Nota**
Per una descrizione completa delle impostazioni di connessione che puoi configurare dalla finestra di dialogo **Origini dati e driver**, consulta la [documentazione relativa all'IDE JetBrains](https://www.jetbrains.com/help/) che stai utilizzando.
1. Per verificare che le impostazioni di connessione siano corrette, scegli **Testa la connessione**.
Un segno di spunta verde indica che il test è andato a buon fine.
1. Scegli **Applica** per applicare le impostazioni, quindi seleziona **OK** per iniziare a utilizzare l'origine dati.
Si apre la finestra degli strumenti **Database**. Le origini dati disponibili vengono visualizzate sotto forma di albero con nodi che rappresentano elementi del database come schemi, tabelle e chiavi.
**Importante**
Per utilizzare la finestra degli strumenti **Database**, devi prima scaricare e installare DataGrip da JetBrains. Per ulteriori informazioni, consulta la pagina [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).
------