Connexion à un cluster avec Amazon Redshift RSQL - Amazon Redshift
Connexion sans DSNConnexion à l’aide d’un DSN

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connexion à un cluster avec Amazon Redshift RSQL

Connexion sans DSN

  1. Sur la console Amazon Redshift, choisissez le cluster auquel vous souhaitez vous connecter et notez le point de terminaison, la base de données et le port.

  2. A l’invite de commande, spécifiez les informations de connexion à l’aide des paramètres de ligne de commande.

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

    Ici, les éléments suivants s’appliquent :

    • <endpoint> est le Point de terminaison que vous avez enregistré à l’étape précédente.

    • <username> est le nom d’un utilisateur disposant des autorisations permettant de se connecter au cluster.

    • <databasename> est le Nom de base de données que vous avez enregistré à l’étape précédente.

    • <port> est le port que vous avez enregistré à l’étape précédente. <port> est un paramètre facultatif.

    Un exemple suit.

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

  3. À l’invite du mot de passe psql, saisissez le mot de passe de l’utilisateur <username>.

    Une réponse de connexion réussie ressemble à ce qui suit.

    % 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=#

La commande de connexion possède les mêmes paramètres sous Linux, Mac OS et Windows.

Connexion à l’aide d’un DSN

Vous pouvez connecter RSQL à Amazon Redshift à l’aide d’un nom de source de données (DSN) pour simplifier l’organisation des propriétés de la connexion. Pour plus d'informations, consultez Configuration des fonctions de connexion. Cette rubrique contient des instructions pour l’installation du pilote ODBC et des descriptions des propriétés DSN. Par exemple, la section suivante, Installation et configuration du pilote ODBC Amazon Redshift sur Microsoft Windows, montre comment se connecter à un DSN via Windows.

Utilisation d’une connexion DSN avec un mot de passe

L’exemple suivant montre une configuration de connexion DSN utilisant un mot de passe. La valeur par défaut <path to driver> pour Mac OS X est /opt/amazon/redshift/lib/libamazonredshiftodbc.dylib et pour Linux, il s’agit de /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

La sortie suivante résulte d’une connexion réussie.

% 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=#

Utilisation du DSN à authentification unique

Vous pouvez configurer un DSN pour l’authentification unique. L’exemple suivant montre une configuration de connexion DSN utilisant l’authentification unique Okta.

[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>

Exemple de sortie d’une connexion réussie.

% 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’exemple suivant montre une configuration de connexion DSN utilisant l’authentification unique Azure.

[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>

Utilisation d’une connexion DSN avec un profil IAM

Vous pouvez vous connecter à Amazon Redshift à l’aide de votre profil IAM configuré. Le profil IAM doit être autorisé à appeler GetClusterCredentials. L’exemple suivant illustre les propriétés DSN à utiliser. Les paramètres ClusterID et Region ne sont obligatoires que si l’Host n’est pas un point de terminaison fourni par Amazon comme 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

La valeur de la Profile clé est le profil nommé que vous avez choisi parmi les informations d'identification de votre AWS CLI. Cet exemple montre les informations d’identification du profil nommé default.

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

L’exemple de réponse de connexion est le suivant.

$ 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=>

Utilisation d’une connexion DSN avec un profil d’instance

Vous pouvez vous connecter à Amazon Redshift à l’aide de votre profil d’instance Amazon EC2. Le profil d’instance doit être autorisé à appeler GetClusterCredentials. Voir l’exemple ci-dessous pour connaître les propriétés DSN à utiliser. Les paramètres ClusterID et Region ne sont obligatoires que si l’Host n’est pas un point de terminaison fourni par Amazon comme 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

L’exemple de réponse de connexion est le suivant.

$ 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=>

Utilisation d’une connexion DSN avec la chaîne de fournisseurs d’informations d’identification par défaut

Pour vous connecter à l'aide de la chaîne de fournisseurs d'informations d'identification par défaut, spécifiez uniquement la propriété IAM, et Amazon Redshift RSQL tentera d'obtenir les informations d'identification dans l'ordre décrit dans la section Utilisation des informations d'identification dans le AWS SDK for Java. AWS Au moins un des fournisseurs de la chaîne doit disposer de l’autorisation GetClusterCredentials. Cela est utile pour se connecter à partir de conteneurs ECS, par exemple.

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