Connettiti a un cluster con Amazon Redshift RSQL

Connessione senza un DSN

1. Sulla console Amazon Redshift, scegli il cluster a cui vuoi connetterti e annota l'endpoint, il database e la porta.

2. Al prompt dei comandi, specificate le informazioni di connessione usando i parametri della linea di comando.

   rsql -h <endpoint> -U <username> -d <databasename> -p <port>

   Qui si applicano le seguenti condizioni:

   • <endpoint> è l'endpoint registrato nel passaggio precedente.

   • <username> è il nome di un utente con i permessi per connettersi al cluster.

   • <databasename> è il nome del database registrato nel passaggio precedente.

   • <port> è la porta registrata nel passaggio precedente. <port> è un parametro opzionale.

   Di seguito è riportato un esempio.

   rsql -h testcluster.example.amazonaws.com -U user1 -d dev -p 5439

3. Alla richiesta della password, immettere la password per <username> utente.

   Una risposta di connessione riuscita appare come la seguente.

   % rsql -h testcluster.example.com -d dev -U user1 -p 5349
   Password for user user1:
   DSN-less Connected
   DBMS Name: Amazon Redshift
   Driver Name: Amazon Redshift ODBC Driver
   Driver Version: 1.4.27.1000
   Rsql Version: 1.0.1
   Redshift Version: 1.0.29306
   Type "help" for help.
   
   (testcluster) user1@dev=#

Il comando per connettersi ha gli stessi parametri su Linux, Mac OS e Windows.

Connessione tramite un DSN

Puoi connetterti RSQL ad Amazon Redshift utilizzando un nome di origine dati (DSN) per semplificare l'organizzazione delle proprietà di connessione. Questo argomento include istruzioni per l'installazione di ODBC -driver e descrizioni delle proprietà. DSN

Utilizzo di una connessione con una password DSN

Di seguito viene illustrato un esempio di configurazione DSN -connection che utilizza una password. L'impostazione predefinita <path to driver> per Mac OSX è /opt/amazon/redshift/lib/libamazonredshiftodbc.dylib e per Linux è/opt/amazon/redshiftodbc/lib/64/libamazonredshiftodbc64.so.

[testuser]
Driver=/opt/amazon/redshiftodbc/lib/64/libamazonredshiftodbc64.so
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=<server endpoint>
Port=<database port>
Database=<dbname>
UID=<username>
PWD=<password>
sslmode=prefer

L'output seguente deriva da una connessione riuscita.

% rsql -D testuser
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) user1@dev=#

Utilizzo del Single Sign-On DSN

È possibile configurare un'autenticazione DSN Single Sign-On. Di seguito viene mostrato un esempio di configurazione DSN -connection che utilizza Okta Single Sign-on.

[testokta]
Driver=<path to driver>
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=<server endpoint>
clusterid=<cluster id>
region=<region name>
Database=<dbname>
locale=en-US
iam=1
plugin_name=<plugin name>
uid=<okta username>
pwd=<okta password>
idp_host=<idp endpoint>
app_id=<app id>
app_name=<app name>
preferred_role=<role arn>

Esempio di output da una connessione riuscita.

% rsql -D testokta 
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) user1@dev=#

L'esempio seguente mostra un esempio di configurazione DSN -connection che usa Azure Single Sign-on.

[testazure]
Driver=<path to driver>
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=<server endpoint>
Port=<cluster port>
clusterid=<cluster id>
region=<region name>
Database=<dbname>
locale=en-us
iam=1
plugin_name=<plugin name>
uid=<azure username>
pwd=<azure password>
idp_tenant=<Azure idp tenant uuid>
client_id=<Azure idp client uuid>
client_secret=<Azure idp client secret>

Usare una DSN connessione con un profilo IAM

Puoi connetterti ad Amazon Redshift utilizzando il tuo profilo configuratoIAM. Il IAM profilo deve disporre dei privilegi per effettuare chiamate. GetClusterCredentials L'esempio seguente mostra le DSN proprietà da utilizzare. I parametri ClusterID e Region sono obbligatori solo se il Host non è un endpoint fornito da Amazon come examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com.

[testiam]
Driver=Default
Host=testcluster.example.com
Database=dev
DbUser=testuser
ClusterID=rsqltestcluster
Region=us-east-1
IAM=1
Profile=default

Il valore della Profile chiave è il profilo denominato scelto tra i AWS CLIcredenziali. In questo esempio vengono mostrate le credenziali per il profilo nominato default.

$ cat .aws/credentials
[default]
aws_access_key_id = ASIAIOSFODNN7EXAMPLE 
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Di seguito è illustrata la risposta della connessione.

$ rsql -D testiam
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) testuser@dev=>

Utilizzo di una DSN connessione con un profilo di istanza

Puoi connetterti ad Amazon Redshift utilizzando il tuo profilo di EC2 istanza Amazon. Il profilo dell'istanza deve avere privilegi per chiamare GetClusterCredentials. Vedi l'esempio seguente per le DSN proprietà da utilizzare. I parametri ClusterID e Region sono obbligatori solo se il Host non è un endpoint fornito da Amazon come examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com.

[testinstanceprofile]
Driver=Default
Host=testcluster.example.com
Database=dev
DbUser=testuser
ClusterID=rsqltestcluster
Region=us-east-1
IAM=1
Instanceprofile=1

Di seguito è illustrata la risposta della connessione.

$ rsql -D testinstanceprofile
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) testuser@dev=>

Utilizzo di una DSN connessione con la catena di provider di credenziali predefinita

Per connetterti utilizzando la catena di provider di credenziali predefinita, specifica solo la IAM proprietà e Amazon RSQL Redshift tenterà di acquisire le credenziali nell'ordine descritto in Working with AWS Credenziali in AWS SDKper Java. Almeno uno dei fornitori della catena deve disporre di autorizzazioni GetClusterCredentials. Ciò è utile, ad esempio, per la connessione da ECS contenitori.

[iamcredentials]
Driver=Default
Host=testcluster.example.com
Database=dev
DbUser=testuser
ClusterID=rsqltestcluster
Region=us-east-1
IAM=1