

# Accesso ad Amazon Redshift tramite il AWS Toolkit for JetBrains
<a name="accessing-redshift"></a>

Un data warehouse di Amazon Redshift è un sistema di query e gestione di database relazionali di livello aziendale. Con il AWS Toolkit for JetBrains, è possibile connettersi ai cluster Amazon Redshift e interagire con essi. Un cluster Amazon Redshift è costituito da una raccolta di nodi che consente ai client di interrogare i database ospitati su quel cluster. 

Negli argomenti seguenti vengono descritti i prerequisiti per accedere ai cluster Amazon Redshift e come utilizzare il AWS Toolkit for JetBrains per connettersi a un database in un cluster.

**Topics**
+ [Prerequisiti per l'accesso ai cluster Amazon Redshift](redshift-access-prerequisities.md)
+ [Connessione a un cluster Amazon Redshift](redshift-connection.md)

# Prerequisiti per l'accesso ai cluster Amazon Redshift
<a name="redshift-access-prerequisities"></a>

Prima di iniziare a interagire con un cluster Amazon Redshift utilizzando AWS Toolkit for JetBrains, è necessario completare le seguenti attività: 
+ [Creazione di un cluster Amazon Redshift e configurazione del relativo metodo di autenticazione](#cluster-authentication)
+ [Download e installazione di DataGrip](#datagrip-info-rs)

## Creazione di un cluster Amazon Redshift e configurazione del relativo metodo di autenticazione
<a name="cluster-authentication"></a>

 AWS Toolkit for JetBrains consente di connettersi a un cluster Amazon Redshift già creato e configurato in AWS. Ciascun cluster contiene uno o più database. Per informazioni sulla creazione e sulla configurazione di cluster Amazon Redshift, consulta la pagina [Nozioni di base su Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/gsg/getting-started.html) della *Guida alle operazioni di base di Amazon Redshift*.

Quando ci si connette a un cluster tramite il AWS Toolkit for JetBrains, gli utenti possono scegliere di autenticarsi utilizzando le credenziali IAM oppure Gestione dei segreti AWS. 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/redshift-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/redshift-access-prerequisities.html)  | 

## Utilizzo dei database Amazon RDS con DataGrip
<a name="datagrip-info-rs"></a>

Dopo aver eseguito la connessione a un database nel cluster Amazon Redshift, puoi iniziare a interagire con esso. 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 cluster Amazon Redshift
<a name="redshift-connection"></a>

Con l'**Esploratore AWS**, puoi selezionare un cluster Amazon Redshift, 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](redshift-access-prerequisities.md) affinché gli utenti possano accedere ai cluster Amazon Redshift e interagire con essi.

Seleziona una scheda per ottenere istruzioni sulla connessione a un cluster utilizzando il tuo metodo di autenticazione preferito.

------
#### [ Connect with IAM credentials ]

1. Aprire AWS Explorer, se non è già aperto.

1. Fai clic sul nodo **Amazon Redshift** per espandere l'elenco dei cluster disponibili.

1. Fai clic con il pulsante destro del mouse su un cluster e scegli **Connettiti tramite credenziali IAM**.
**Nota**  
È anche possibile scegliere **Copia ARN** per aggiungere il nome della risorsa Amazon (ARN) del cluster 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 cluster. Per i cluster Amazon Redshift ospitati nel cloud AWS, gli endpoint terminano sempre con `redshift.amazon.com`.
   + **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. 
   + **ID del cluster**: l'ID del cluster in cui hai selezionato l'**Esploratore AWS**. 
   + **Database**: il nome del database nel cluster al quale ti connetterai. 
   + **URL**: l'URL che l'IDE JetBrains utilizzerà per la connessione al database del cluster.  
![\[Impostazioni di connessione per un cluster Amazon Redshift utilizzando le credenziali IAM per l'autenticazione.\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/redshift-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 Redshift** per espandere l'elenco dei cluster disponibili.

1. Fai clic con il pulsante destro del mouse su un cluster e scegli **Connettiti tramite Secrets Manager**.
**Nota**  
È anche possibile scegliere **Copia ARN** per aggiungere il nome della risorsa Amazon (ARN) del cluster 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 nella finestra di dialogo viene visualizzato un messaggio per **Scaricare 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 cluster. Per i cluster Amazon Redshift ospitati nel cloud AWS, gli endpoint terminano sempre con `redshift.amazon.com`.
   + **Autenticazione**: **SecretsManager Auth (autenticazione tramite **Gestione dei segreti AWS). 
   + **Credenziali**: le credenziali utilizzate per effettuare la connessione all'account AWS. 
   + **Regione**: la regione AWS in cui è ospitato il cluster. 
   + **Nome/ARN del segreto**: il nome e l'ARN del segreto contenente le credenziali di autenticazione. Se desideri 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 del database nel cluster al quale ti connetterai. 
   + **URL**: l'URL che l'IDE JetBrains utilizzerà per la connessione al database.
**Nota**  
Se utilizzi Gestione dei segreti AWS per l'autenticazione, non sono presenti campi per specificare il nome utente e la password per il cluster. Queste informazioni sono contenute nella parte relativa ai dati segreti crittografati di un segreto.  
![\[Impostazioni di connessione per un cluster Amazon Redshift utilizzando Secrets Manager per l'autenticazione.\]](http://docs.aws.amazon.com/it_it/toolkit-for-jetbrains/latest/userguide/images/redshift-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/). 

------