Options de configuration du pilote JDBC version 2.1

Vous trouverez ci-dessous des descriptions des options que vous pouvez spécifier pour la version 2.1 du pilote JDBC Amazon Redshift. Les options de configuration ne sont pas sensibles à la casse.

Vous pouvez définir les propriétés de configuration à l’aide de l’URL de connexion. Pour plus d’informations, consultez Création de l’URL de connexion.

AccessKeyID

• Valeur par défaut – Aucune

• Types de données – Chaîne

Vous pouvez spécifier ce paramètre pour entrer la clé d’accès IAM pour l’utilisateur ou le rôle. Vous pouvez généralement localiser la clé en consultant une chaîne ou un profil utilisateur existant. Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre SecretAccessKey. S'il est transmis dans l'URL JDBC, l' AccessKeyID doit être codé en URL.

Ce paramètre est facultatif.

Autoriser DB UserOverride

• Valeur par défaut : 0

• Types de données – Chaîne

Cette option spécifie si le pilote utilise la valeur de l’assertion SAML ou la valeur DbUser spécifiée dans la propriété de connexion DbUser dans l’URL de connexion.

Ce paramètre est facultatif.

1

Le pilote utilise la valeur DbUser de l’assertion SAML.

Si l’assertion SAML ne spécifie pas de valeur pour DBUser, le pilote utilise la valeur spécifiée dans la propriété de connexion DBUser. Si la propriété de connexion ne spécifie pas non plus de valeur, le pilote utilise la valeur spécifiée dans le profil de connexion.

0

Le pilote utilise la valeur DBUser spécifiée dans la propriété de connexion DBUser.

Si la propriété de connexion DBUser ne spécifie pas de valeur, le pilote utilise la valeur spécifiée dans le profil de connexion. Si le profil de connexion ne spécifie pas non plus de valeur, le pilote utilise la valeur de l’assertion SAML.

App_ID

• Valeur par défaut – Aucune

• Types de données – Chaîne

L’ID unique fourni par Okta associé à votre application Amazon Redshift.

Ce paramètre est obligatoire si vous vous authentifiez via le service Okta.

App_Name

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom de l’application Okta que vous utilisez pour authentifier la connexion à Amazon Redshift.

Ce paramètre est facultatif.

ApplicationName

• Valeur par défaut – null

• Types de données – Chaîne

Nom de l’application à transmettre à Amazon Redshift à des fins d’audit.

Ce paramètre est facultatif.

AuthProfile

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom du profil d’authentification à utiliser pour la connexion à Amazon Redshift.

Ce paramètre est facultatif.

AutoCreate

• Valeur par défaut — false

• Types de données – Booléen

Cette option spécifie si le pilote provoque la création d’un nouvel utilisateur lorsque l’utilisateur spécifié n’existe pas.

Ce paramètre est facultatif.

true

Si l’utilisateur spécifié par DBUser ou l’ID unique (UID) n’existe pas, un nouvel utilisateur portant ce nom est créé.

false

Le pilote ne crée pas de nouveaux utilisateurs. Si l’utilisateur spécifié n’existe pas, l’authentification échoue.

Client_ID

• Valeur par défaut – Aucune

• Types de données – Chaîne

L’ID client à utiliser lors de l’authentification de la connexion à l’aide du service Azure AD.

Ce paramètre est obligatoire si vous vous authentifiez via le service Azure AD.

Client_Secret

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le secret client à utiliser lors de l’authentification de la connexion à l’aide du service Azure AD.

Ce paramètre est obligatoire si vous vous authentifiez via le service Azure AD.

ClusterID

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom du cluster Amazon Redshift auquel vous souhaitez vous connecter. Le pilote tente de détecter ce paramètre à partir de l’hôte donné. Si vous utilisez un Network Load Balancer (NLB) et que vous vous connectez via IAM, le pilote ne le détectera pas. Vous pouvez donc le définir à l’aide de cette option de connexion.

Ce paramètre est facultatif.

Compression

• Valeur par défaut : désactivée

• Types de données – Chaîne

Méthode de compression utilisée pour les communications par protocole filaire entre le serveur Amazon Redshift et le client ou le pilote.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

• lz4

  Définit la méthode de compression utilisée pour les communications par protocole filaire avec Amazon Redshift sur lz4.

• off

  N’utilise pas la compression pour les communications par protocole filaire avec Amazon Redshift.

connectTimeout

• Valeur par défaut – 10

• Type de données – Entier

Valeur de délai d’expiration à utiliser pour les opérations de connexion de socket. Si le temps nécessaire à l’établissement d’une connexion Amazon Redshift dépasse cette valeur, la connexion est considérée comme non disponible. Le délai d’expiration est spécifié en secondes. Une valeur de 0 signifie qu’aucun délai d’expiration n’est spécifié.

Ce paramètre est facultatif.

connectionTimezone

• Valeur par défaut : LOCAL

• Types de données – Chaîne

Fuseau horaire au niveau de la session.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

LOCAL

Configure le fuseau horaire au niveau de la session sur le fuseau horaire de la JVM LOCAL.

SERVER

Configure le fuseau horaire au niveau de la session sur le fuseau horaire défini pour l’utilisateur sur le serveur Amazon Redshift. Vous pouvez configurer les fuseaux horaires au niveau de la session pour les utilisateurs à l’aide de la commande suivante :

ALTER USER
[...]
SET TIMEZONE TO [...];

base de données MetadataCurrent DbOnly

• Valeur par défaut – true

• Types de données – Booléen

Cette option spécifie si l’API de métadonnées récupère les données de toutes les bases de données accessibles ou uniquement de la base de données connectée.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

true

L’application récupère les métadonnées d’une seule base de données.

false

L'application récupère les métadonnées de toutes les bases de données accessibles.

DbUser

• Valeur par défaut – Aucune

• Types de données – Chaîne

L’ID utilisateur à utiliser avec votre compte Amazon Redshift. Vous pouvez utiliser un identifiant qui n'existe pas actuellement si vous avez activé la AutoCreate propriété.

Ce paramètre est facultatif.

DbGroups

• Valeur par défaut – PUBLIC

• Types de données – Chaîne

Une liste séparée par des virgules des noms de groupes de bases de données existants auxquels DBUser se joint pour la séance en cours.

Ce paramètre est facultatif.

DBNAME

• Valeur par défaut – null

• Types de données – Chaîne

Le nom de la base de données à laquelle se connecter. Vous pouvez utiliser cette option pour spécifier le nom de la base de données dans l’URL de connexion JDBC.

Ce paramètre est obligatoire. Vous devez spécifier le nom de la base de données, soit dans l’URL de connexion, soit dans les propriétés de connexion de l’application cliente.

RowFetchTaille par défaut

• Valeur par défaut : 0

• Type de données – Entier

Cette option spécifie une valeur par défaut pour getFetchSize.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

0

Récupérez toutes les lignes en une seule opération.

Nombre entier positif

Nombre de lignes à extraire de la base de données pour chaque itération de récupération du. ResultSet

DisableIsValidQuery

• Valeur par défaut – False

• Types de données – Booléen

Cette option spécifie si le pilote soumet une nouvelle requête de base de données lors de l’utilisation de la méthode Connection.isValid() pour déterminer si la connexion à la base de données est active.

Ce paramètre est facultatif.

true

Le pilote ne soumet pas de requête lors de l’utilisation de Connection.isValid() pour déterminer si la connexion à la base de données est active. Cela peut amener le pilote à identifier de manière incorrecte la connexion à la base de données comme étant active si le serveur de base de données s’est arrêté de manière inattendue.

false

Le pilote soumet une requête lors de l’utilisation de Connection.isValid() pour déterminer si la connexion à la base de données est active.

activer FetchRing Buffer

• Valeur par défaut – true

• Types de données – Booléen

Cette option spécifie que le pilote récupère les lignes à l’aide d’un tampon en anneau sur un thread séparé. Le paramètre fetchRingBuffer Size indique la taille de la mémoire tampon en anneau.

Si une transaction détecte une instruction contenant plusieurs commandes SQL séparées par des points-virgules, la mémoire tampon de l'anneau de récupération pour cette transaction est définie sur false. enableFetchRingLa valeur du tampon ne change pas.

Ce paramètre est facultatif.

activer le MultiSql Support

• Valeur par défaut – true

• Types de données – Booléen

Cette option spécifie s’il faut traiter plusieurs commandes SQL séparées par des points-virgules dans une instruction.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

true

Le pilote traite plusieurs commandes SQL, séparées par des points-virgules, dans un objet Statement.

false

Le pilote renvoie une erreur pour plusieurs commandes SQL dans une seule instruction.

taille de récupération RingBuffer

• Valeur par défaut – 1G

• Types de données – Chaîne

Cette option spécifie la taille de la mémoire tampon en anneau utilisée lors de la récupération du jeu de résultats. Vous pouvez spécifier une taille en octets, par exemple 1K pour 1 Ko, 5000 pour 5 000 octets, 1M pour 1 Mo, 1G pour 1 Go, etc. Vous pouvez également spécifier un pourcentage de mémoire de segment. Le pilote arrête de récupérer les lignes lorsqu’il atteint la limite. L’extraction reprend lorsque l’application lit les lignes et libère de l’espace dans la mémoire tampon en anneau.

Ce paramètre est facultatif.

ForceLowercase

• Valeur par défaut — false

• Types de données – Booléen

Cette option indique si le pilote met en minuscules tous les groupes de bases de données (DbGroups) envoyés par le fournisseur d'identité à Amazon Redshift lors de l'utilisation de l'authentification unique.

Ce paramètre est facultatif.

true

Le pilote met en minuscules tous les groupes de bases de données envoyés par le fournisseur d’identité.

false

Le pilote ne modifie pas les groupes de bases de données.

groupFederation

• Valeur par défaut — false

• Types de données – Booléen

Cette option spécifie si les groupes d’IDP Amazon Redshift doivent être utilisés. Ceci est pris en charge par l'API GetClusterCredentials V2.

Ce paramètre est facultatif.

true

Utilisez les groupes Amazon Redshift Identity Provider (IDP).

false

Utilisez l'API STS et GetClusterCredentials pour la fédération d'utilisateurs et spécifiez DbGroups explicitement la connexion.

HOST

• Valeur par défaut – null

• Types de données – Chaîne

Le nom d’hôte du serveur Amazon Redshift auquel se connecter. Vous pouvez utiliser cette option pour spécifier le nom d’hôte dans l’URL de connexion JDBC.

Ce paramètre est obligatoire. Vous devez spécifier le nom d’hôte, soit dans l’URL de connexion, soit dans les propriétés de connexion de l’application cliente.

IAM DisableCache

• Valeur par défaut — false

• Types de données – Booléen

Cette option spécifie si les informations d’identification IAM sont mises en cache.

Ce paramètre est facultatif.

true

Les informations d’identification IAM ne sont pas mises en cache.

false

Les informations d’identification IAM sont mises en cache. Cela améliore les performances lorsque les demandes envoyées à API Gateway sont limitées, par exemple.

IAMDuration

• Valeur par défaut – 900

• Type de données – Entier

La durée, en secondes, jusqu’au moment de l’expiration des informations d’identification IAM temporaires.

• Valeur minimale – 900

• Valeur maximale – 3 600

Ce paramètre est facultatif.

Identity_Namespace

• Valeur par défaut – Aucune

• Types de données – Chaîne

L'espace de noms d'identité à utiliser lors de l'authentification à l'aide du. IdpTokenAuthPlugin Cela aide Redshift à déterminer l’instance IAM Identity Center à utiliser.

S’il existe une seule instance IAM Identity Center ou si l’espace de noms d’identité par défaut est défini, ce paramètre est facultatif ; sinon, il est obligatoire.

IdP_Host

• Valeur par défaut – Aucune

• Types de données – Chaîne

L’hôte IdP (fournisseur d’identité) que vous utilisez pour vous authentifier dans Amazon Redshift. Cela peut être spécifié dans la chaîne de connexion ou dans un profil.

Ce paramètre est facultatif.

IdP_Port

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le port utilisé par un IdP (fournisseur d’identité). Vous pouvez spécifier le port soit dans la chaîne de connexion, soit dans un profil. La valeur par défaut du port est 5439. En fonction du port que vous avez sélectionné lors de la création, de la modification ou de la migration du cluster, autorisez l’accès au port sélectionné.

Ce paramètre est facultatif.

IdP_Tenant

• Valeur par défaut – Aucune

• Types de données – Chaîne

ID de locataire Azure AD pour votre application Amazon Redshift.

Ce paramètre est obligatoire si vous vous authentifiez via le service Azure AD.

IdP_Response_Timeout

• Valeur par défaut – 120

• Type de données – Entier

La durée, en secondes, pendant laquelle le pilote attend la réponse SAML du fournisseur d’identité lors de l’utilisation des services SAML ou Azure AD via un plugin de navigateur.

Ce paramètre est facultatif.

IniFile

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le chemin complet du fichier .ini, y compris le nom du fichier. Par exemple :

IniFile="C:\tools\rsjdbc.ini"

Pour plus d’informations concernant le fichier .ini, consultez Création de fichiers d’initialisation (.ini) pour le pilote JDBC version 2.1.

Ce paramètre est facultatif.

IniSection

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom d’une section du fichier .ini contenant les options de configuration. Pour plus d’informations concernant le fichier .ini, consultez Création de fichiers d’initialisation (.ini) pour le pilote JDBC version 2.1.

L’exemple suivant spécifie la section [Prod] du fichier .ini :

IniSection="Prod"

Ce paramètre est facultatif.

isServerless

• Valeur par défaut — false

• Types de données – Booléen

Cette option indique si l’hôte du point de terminaison Amazon Redshift est une instance sans serveur. Le pilote tente de détecter ce paramètre à partir de l’hôte donné. Si vous utilisez un Network Load Balancer (NLB), le pilote ne le détectera pas. Vous pouvez donc le définir ici.

Ce paramètre est facultatif.

true

L’hôte du point de terminaison Amazon Redshift est une instance sans serveur.

false

L’hôte du point de terminaison Amazon Redshift est un cluster provisionné.

Login_URL

• Valeur par défaut – Aucune

• Types de données – Chaîne

L’URL de la ressource sur le site Web du fournisseur d’identité lors de l’utilisation des services SAML ou Azure AD via un plugin de navigateur.

Ce paramètre est requis si vous vous authentifiez avec les services SAML ou Azure AD via un plugin de navigateur.

loginTimeout

• Valeur par défaut : 0

• Type de données – Entier

Le nombre de secondes à attendre avant d’interrompre la connexion et l’authentification au serveur. Si l’établissement de la connexion dépasse ce seuil, la connexion est abandonnée.

Lorsque cette propriété est définie sur 0, les connexions ne sont pas interrompues.

Ce paramètre est facultatif.

se connecter ToRp

• Valeur par défaut : urn:amazon:webservices

• Types de données – Chaîne

L’approbation des parties utilisatrices que vous souhaitez utiliser pour le type d’authentification AD FS.

Ce paramètre est facultatif.

LogLevel

• Valeur par défaut : 0

• Type de données – Entier

Utilisez cette propriété pour activer ou désactiver la journalisation dans le pilote et pour spécifier la quantité de détails inclus dans les fichiers journaux.

Activez la journalisation juste assez longtemps pour capturer un problème. La journalisation diminue performances et peut consommer une grande quantité d’espace disque.

Ce paramètre est facultatif.

Définissez le paramètre sur l’une des valeurs suivantes :

0

Désactiver toute la journalisation.

1

Activez la journalisation au niveau FATAL, qui enregistre les événements d’erreur très graves qui conduiront le pilote à abandonner les opérations.

2

Activez la journalisation au niveau ERROR, qui consigne les événements d’erreur qui peuvent tout de même permettre au pilote de poursuivre son exécution.

3

Activez la journalisation au niveau WARNING, qui consigne les événements susceptibles d’entraîner une erreur si aucune action n’est entreprise.

4

Activez la journalisation au niveau INFO, qui consigne les informations générales décrivant la progression du pilote.

5

Activez la journalisation au niveau DEBUG, qui enregistre des informations détaillées utiles pour le débogage du pilote.

6

Activez la journalisation au niveau TRACE, qui enregistre toute l’activité du pilote.

Lorsque la journalisation est activée, le pilote produit les fichiers journaux suivants à l’emplacement spécifié dans la propriété LogPath :

• redshift_jdbc.log : fichier qui enregistre l’activité du pilote qui n’est pas spécifique à une connexion.

• redshift_jdbc_connection_[Number].log : – Fichier pour chaque connexion établie à la base de données, où[Number] est un numéro qui distingue chaque fichier journal des autres. Ce fichier enregistre l’activité du pilote spécifique à la connexion.

Si la LogPath valeur n'est pas valide, le pilote envoie les informations enregistrées au flux de sortie standard,System.out.

LogPath

• Valeur par défaut – Le répertoire de travail actuel.

• Types de données – Chaîne

Le chemin complet du dossier dans lequel le pilote enregistre les fichiers journaux lorsque la LogLevel propriété DSI est activée.

Pour avoir la garantie que l’URL de connexion est compatible avec toutes les applications JDBC, nous vous recommandons de traiter les barres obliques inverses (\) dans le chemin d’accès de votre fichier en saisissant une autre barre oblique inverse.

Ce paramètre est facultatif.

OverrideSchemaPatternType

• Valeur par défaut – null

• Type de données – Entier

Cette option indique si le type de requête utilisé dans les appels getTables doit être remplacé.

0

Requête universelle sans schéma

1

Requête à schéma local

2

Requête à schéma externe

Ce paramètre est facultatif.

Partner_SPID

• Valeur par défaut – Aucune

• Types de données – Chaîne

La valeur SPID (ID du fournisseur de services) du partenaire à utiliser lors de l'authentification de la connexion à l'aide du PingFederate service.

Ce paramètre est facultatif.

Mot de passe

• Valeur par défaut – Aucune

• Types de données – Chaîne

Lors de la connexion à l’aide de l’authentification IAM via un fournisseur d’identité, il s’agit du mot de passe du serveur IDP_Host. Lors de l’utilisation de l’authentification standard, celle-ci peut être utilisée pour le mot de passe de la base de données Amazon Redshift au lieu de PWD.

Ce paramètre est facultatif.

Plugin_Name

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom de classe entièrement qualifié pour mettre en œuvre un plugin de fournisseur d’informations d’identification spécifique.

Ce paramètre est facultatif.

Les options de fournisseur suivantes sont prises en charge :

• AdfsCredentialsProvider— Service de fédération Active Directory.

• AzureCredentialsProvider— Service Microsoft Azure Active Directory (AD).

• BasicJwtCredentialsProvider— Service de jetons Web JSON (JWT).

• BasicSamlCredentialsProvider – informations d’identification SAML (Security Assertion Markup Language) que vous pouvez utiliser avec de nombreux fournisseurs de services SAML.

• BrowserAzureCredentialsProvider— Service Microsoft Azure Active Directory (AD) du navigateur.

• BrowserAzureOAuth2CredentialsProvider— Service Microsoft Azure Active Directory (AD) du navigateur pour l'authentification native.

• BrowserSamlCredentialsProvider— Navigateur SAML pour les services SAML tels qu'Okta, Ping ou ADFS.

• IdpTokenAuthPlugin— Un plugin d'autorisation qui accepte un jeton IAM Identity Center ou des jetons d'identité basés sur le JSON OpenID Connect (OIDC) (JWT) provenant de n'importe quel fournisseur d'identité Web lié à IAM Identity Center.

• OktaCredentialsProvider— Service Okta.

• PingCredentialsProvider— PingFederate Un service.

PORT

• Valeur par défaut – null

• Type de données – Entier

Le port du serveur Amazon Redshift auquel se connecter. Vous pouvez utiliser cette option pour spécifier le port dans l’URL de connexion JDBC.

Ce paramètre est facultatif.

Preferred_Role

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le rôle IAM que vous souhaitez endosser lors de la connexion à Amazon Redshift.

Ce paramètre est facultatif.

Profil

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom du profil à utiliser pour l’authentification IAM. Ce profil contient toutes les propriétés de connexion supplémentaires non spécifiées dans la chaîne de connexion.

Ce paramètre est facultatif.

PWD

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le mot de passe correspondant au nom d’utilisateur Amazon Redshift que vous avez fourni à l’aide de l’UID de propriété.

Ce paramètre est facultatif.

queryGroup

• Valeur par défaut – null

• Types de données – Chaîne

Cette option permet d’affecter une requête à une file d’attente au moment de l’exécution en assignant votre requête au groupe de requêtes approprié. Le groupe de requêtes est défini pour la séance. Toutes les requêtes qui s’exécutent sur la connexion appartiennent à ce groupe de requêtes.

Ce paramètre est facultatif.

readOnly

• Valeur par défaut — false

• Types de données – Booléen

Cette propriété spécifie si le pilote est en mode lecture seule.

Ce paramètre est facultatif.

true

La connexion est en mode lecture seule et ne peut pas écrire dans le magasin de données.

false

La connexion n’est pas en mode lecture seule et peut écrire dans le magasin de données.

Région

• Valeur par défaut – null

• Types de données – Chaîne

Cette option indique la AWS région dans laquelle se trouve le cluster. Si vous spécifiez l' StsEndPoint option, l'option Région est ignorée. L’opération de l’API GetClusterCredentials Redshift utilise également l’option Region.

Ce paramètre est facultatif.

WriteBatchedEncarts rouges

• Valeur par défaut — false

• Types de données – Booléen

Cette option permet d’optimiser la réécriture et la combinaison des instructions INSERT compatibles en lots.

Ce paramètre est facultatif.

re WriteBatched InsertsSize

• Valeur par défaut – 128

• Type de données – Entier

Cette option permet d’optimiser la réécriture et la combinaison des instructions INSERT compatibles en lots. Cette valeur doit augmenter de façon exponentielle par puissance 2.

Ce paramètre est facultatif.

roleArn

• Valeur par défaut – Aucune

• Types de données – Chaîne

Amazon Resource Name (ARN) du rôle. Assurez-vous de spécifier ce paramètre lorsque vous spécifiez BasicJwtCredentialsProvider l'option Plugin_Name. Spécifiez l’ARN au format suivant :

arn:partition:service:region:account-id:resource-id

Ce paramètre est obligatoire si vous spécifiez BasicJwtCredentialsProvider l'option Plugin_Name.

rôle SessionName

• Valeur par défaut : jwt_redshift_session

• Types de données – Chaîne

Un identifiant pour la séance de rôle assumé. En règle générale, vous transmettez le nom ou l’identifiant associé à l’utilisateur de votre application. Les informations d’identification de sécurité temporaires utilisées par votre application sont associées à cet utilisateur. Vous pouvez spécifier ce paramètre lorsque vous spécifiez BasicJwtCredentialsProvider l'option Plugin_Name.

Ce paramètre est facultatif.

scope

• Valeur par défaut – Aucune

• Types de données – Chaîne

Une liste des portées, séparées par des espaces, auxquels l’utilisateur peut consentir. Vous spécifiez ce paramètre afin que votre application Microsoft Azure puisse obtenir le consentement des API que vous souhaitez appeler. Vous pouvez spécifier ce paramètre lorsque vous spécifiez BrowserAzure OAuth2 CredentialsProvider pour l'option Plugin_Name.

Ce paramètre est obligatoire pour le plug-in BrowserAzure OAuth2. CredentialsProvider

SecretAccessClé

• Valeur par défaut – Aucune

• Types de données – Chaîne

La clé d’accès IAM pour l’utilisateur ou le rôle. Si cela est spécifié, l' AccessKeyID doit également être spécifié. Si l'URL JDBC est transmise, elle SecretAccessKey doit être codée en URL.

Ce paramètre est facultatif.

SessionToken

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le jeton de séance IAM temporaire associé au rôle IAM que vous utilisez pour vous authentifier. S’il est transmis dans l’URL JDBC, le jeton de session IAM temporaire doit être encodé en URL.

Ce paramètre est facultatif.

sans serveur AcctId

• Valeur par défaut – null

• Types de données – Chaîne

ID du compte Amazon Redshift sans serveur. Le pilote tente de détecter ce paramètre à partir de l’hôte donné. Si vous utilisez un Network Load Balancer (NLB), le pilote ne le détectera pas. Vous pouvez donc le définir ici.

Ce paramètre est facultatif.

sans serveur WorkGroup

• Valeur par défaut – null

• Types de données – Chaîne

Nom du groupe de travail Amazon Redshift sans serveur. Le pilote tente de détecter ce paramètre à partir de l’hôte donné. Si vous utilisez un Network Load Balancer (NLB), le pilote ne le détectera pas. Vous pouvez donc le définir ici.

Ce paramètre est facultatif.

socketFactory

• Valeur par défaut – null

• Types de données – Chaîne

Cette option spécifie une fabrique de sockets pour la création de sockets.

Ce paramètre est facultatif.

socketTimeout

• Valeur par défaut : 0

• Type de données – Entier

Nombre de secondes à attendre pendant les opérations de lecture de socket avant expiration. Si l’opération prend plus de temps que ce seuil, alors la connexion est fermée. Lorsque cette propriété est définie sur 0, la connexion ne s’interrompt pas.

Ce paramètre est facultatif.

SSL

• Valeur par défaut – TRUE

• Types de données – Chaîne

Utilisez cette propriété pour activer ou désactiver SSL pour la connexion.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

TRUE

Le pilote se connecte au serveur via SSL.

FALSE

Le pilote se connecte au serveur sans utiliser SSL. Cette option n’est pas prise en charge avec l’authentification IAM.

Vous pouvez également configurer la AuthMech propriété.

SSL_Insecure

• Valeur par défaut – true

• Types de données – Chaîne

Cette propriété indique si le certificat du serveur des hôtes IdP doit être vérifié.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

true

Le pilote ne vérifie pas l’authenticité du certificat du serveur IdP.

false

Le pilote vérifie l’authenticité du certificat du serveur IdP.

SSLCert

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le chemin d’accès complet d’un fichier .pem ou .crt contenant des certificats d’autorité de certification approuvés supplémentaires pour vérifier l’instance de serveur Amazon Redshift lors de l’utilisation de SSL.

Ce paramètre est requis si SSLKey est spécifié.

SSLFactory

• Valeur par défaut – Aucune

• Types de données – Chaîne

La fabrique SSL à utiliser lors de la connexion au serveur via TLS/SSL sans utiliser de certificat de serveur.

SSLKey

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le chemin d’accès complet du fichier .der contenant le fichier de clé PKCS8 pour vérifier les certificats spécifiés dans SSLCert.

Ce paramètre est requis si SSLCert est spécifié.

SSLMode

• Valeur par défaut : verify-ca

• Types de données – Chaîne

Utilisez cette propriété pour spécifier comment le pilote valide les certificats lorsque TLS/SSL est activé.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

verify-ca

Le pilote vérifie que le certificat provient d’une autorité de certification approuvée.

verify-full

Le pilote vérifie que le certificat provient d’une autorité de certification approuvée et que le nom d’hôte dans le certificat correspond à celui spécifié dans l’URL de connexion.

SSLPassword

• Valeur par défaut : 0

• Types de données – Chaîne

Le mot de passe du fichier de clé crypté spécifié dans SSLKey.

Ce paramètre est obligatoire si SSLKey est spécifié et que le fichier de clé est chiffré.

SSL RootCert

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le chemin complet d’un fichier .pem ou .crt contenant le certificat d’autorité de certification racine (root CA certificate) pour vérifier l’instance Amazon Redshift Server lors de l’utilisation de SSL.

StsEndpointURL

• Valeur par défaut – null

• Types de données – Chaîne

Vous pouvez spécifier un point de terminaison AWS Security Token Service (AWS STS). Si vous spécifiez cette option, l’option Region est ignorée. Vous pouvez uniquement spécifier un protocole sécurisé (HTTPS) pour ce point de terminaison.

tcp KeepAlive

• Valeur par défaut – TRUE

• Types de données – Chaîne

Utilisez cette propriété pour activer ou désactiver les keepalives TCP.

Ce paramètre est facultatif.

Vous pouvez spécifier les valeurs suivantes :

TRUE

Le pilote utilise les keepalives TCP pour empêcher les connexions de s’interrompre.

FALSE

Le pilote n’utilise pas les keepalives TCP.

jeton

• Valeur par défaut – Aucune

• Types de données – Chaîne

Un jeton d'accès fourni par IAM Identity Center ou un jeton Web JSON (JWT) OpenID Connect (OIDC) fourni par un fournisseur d'identité Web lié à IAM Identity Center. Votre application doit générer ce jeton en authentifiant l'utilisateur de votre application auprès d'IAM Identity Center ou d'un fournisseur d'identité lié à IAM Identity Center.

Ce paramètre fonctionne avecIdpTokenAuthPlugin.

type_jeton

• Valeur par défaut – Aucune

• Types de données – Chaîne

Type de jeton utilisé dansIdpTokenAuthPlugin.

Vous pouvez spécifier les valeurs suivantes :

JETON D'ACCÈS

Entrez cette valeur si vous utilisez un jeton d'accès fourni par IAM Identity Center.

EXT_JET

Entrez cette valeur si vous utilisez un jeton Web JSON (JWT) OpenID Connect (OIDC) fourni par un fournisseur d'identité Web intégré à IAM Identity Center.

Ce paramètre fonctionne avecIdpTokenAuthPlugin.

UID

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le nom d’utilisateur de base de données que vous utilisez pour accéder à la base de données.

Ce paramètre est obligatoire.

Utilisateur

• Valeur par défaut – Aucune

• Types de données – Chaîne

Lors de la connexion à l’aide de l’authentification IAM via un IdP, il s’agit du nom d’utilisateur du serveur idp_host. Lors de l’utilisation de l’authentification standard, celui-ci peut être utilisé comme nom d’utilisateur de la base de données Amazon Redshift.

Ce paramètre est facultatif.

web IdentityToken

• Valeur par défaut – Aucune

• Types de données – Chaîne

Le jeton d’accès OAuth 2.1 ou le jeton d’identification OpenID Connect qui est fourni par le fournisseur d’identité. Votre application doit obtenir ce jeton en authentifiant l’utilisateur de votre application auprès d’un fournisseur d’identité web. Assurez-vous de spécifier ce paramètre lorsque vous spécifiez BasicJwtCredentialsProvider l'option Plugin_Name.

Ce paramètre est obligatoire si vous spécifiez BasicJwtCredentialsProvider l'option Plugin_Name.