Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les détails de la fin de vie et des options de migration de Python, consultez le billet de blog
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.
Options du pilote ODBC
Vous pouvez utiliser les options de configuration du pilote pour contrôler le comportement du pilote ODBC Amazon Redshift. Les options du pilote ne sont pas sensibles à la casse.
Sous Microsoft Windows, vous définissez généralement les options du pilote lorsque vous configurez un nom de source de données (DSN). Vous pouvez également définir des options de pilote dans la chaîne de connexion lorsque vous vous connectez par programme, ou en ajoutant ou en modifiant des clés de Registre dans HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\.your_DSN
Sous Linux, vous définissez les options de configuration du pilote dans vos fichiers odbc.ini et amazon.redshiftodbc.ini. Les options de configuration définies dans un fichier amazon.redshiftodbc.ini s’appliquent à toutes les connexions. En revanche, les options de configuration définies dans un fichier odbc.ini sont spécifiques à une connexion. Les options de configuration définies dans odbc.ini ont priorité sur les options de configuration définies dans amazon.redshiftodbc.ini.
Vous trouverez ci-dessous des descriptions des options que vous pouvez spécifier pour le pilote ODBC Amazon Redshift version 2.x :
Rubriques
AccessKeyIDENTIFIANT
-
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 vous définissez ce paramètre, vous devez également spécifier SecretAccessKey.
Ce paramètre est facultatif.
app_id
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le Okta-provided identifiant unique associé à votre application Amazon Redshift.
Ce paramètre est facultatif.
ApplicationName
-
Valeur par défaut – Aucune
-
Type de données — Corde
Nom de l’application client à transmettre à Amazon Redshift à des fins d’audit. Le nom de l’application que vous fournissez apparaît dans la colonne « application_name » de la table SYS_CONNECTION_LOG. Cela permet de suivre et de dépanner les sources de connexion lors des problèmes de débogage.
Ce paramètre est facultatif.
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.
AuthProfile
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le profil d’authentification utilisé pour gérer les paramètres de connexion. Si vous définissez ce paramètre, vous devez également définir AccessKeyIDENTIFIANT et SecretAccessKey.
Ce paramètre est facultatif.
AuthType
-
Valeur par défaut : standard
-
Types de données – Chaîne
Cette option spécifie le mode d’authentification que le pilote utilise lorsque vous configurez un DSN à l’aide de la boîte de dialogue Configuration DSN du pilote ODBC Amazon Redshift :
-
Standard : authentification standard en utilisant votre nom d’utilisateur et votre mot de passe Amazon Redshift.
-
AWS Profil : authentification IAM à l'aide d'un profil.
-
AWS Informations d'identification IAM : authentification IAM à l'aide des informations d'identification IAM.
-
Fournisseur d’identité : AD FS : authentification IAM en utilisant Active Directory Federation Services (AD FS).
-
Identity Provider : Auth Plugin : un plugin d'autorisation qui accepte un AWS Jeton IAM Identity Center ou OpenID Connect (OIDC) JSON-based jetons d'identité (JWT) provenant de n'importe quel fournisseur d'identité Web lié à AWS Centre d'identité IAM.
-
Fournisseur d’identité : Azure AD : authentification IAM en utilisant un portail Azure AD.
-
Fournisseur d’identité : JWT : authentification IAM en utilisant un jeton web JSON (JWT).
-
Fournisseur d’identité : Okta : authentification IAM en utilisant Okta.
-
Fournisseur d'identité : PingFederate: Authentification IAM à l'aide de PingFederate.
Cette option n’est disponible que lorsque vous configurez un DSN en utilisant la boîte de dialogue Configuration DSN du pilote ODBC Amazon Redshift dans le pilote Windows. Lorsque vous configurez une connexion à l'aide d'une chaîne de connexion ou d'un ordinateur non Windows, le pilote détermine automatiquement s'il faut utiliser Standard, AWS Profil, ou AWS Authentification des informations d'identification IAM sur la base des informations d'identification que vous avez spécifiées. Pour utiliser un fournisseur d’identité, vous devez définir la propriété plugin_name.
Ce paramètre est obligatoire.
AutoCreate
-
Valeur par défaut : 0
-
Types de données – Booléen
Une valeur booléenne indiquant si le pilote crée un nouvel utilisateur lorsque l’utilisateur spécifié n’existe pas.
-
1 | TRUE : Si l’utilisateur spécifié par l’UID n’existe pas, le pilote crée un nouvel utilisateur.
-
0 | FALSE : Le pilote ne crée pas de nouvel utilisateur. Si l’utilisateur spécifié n’existe pas, l’authentification échoue.
Ce paramètre est facultatif.
BoolsAsChar
-
Valeur par défaut : 0
-
Types de données – Booléen
Spécifie si le pilote indique les colonnes BOOLÉENNES en tant que type de caractère et non en tant que type de bit.
-
1 | VRAI : Le pilote indique les colonnes BOOLÉENNES sous la forme SQL_VARCHAR avec une taille de colonne de 1. Le pilote renvoie des valeurs booléennes sous forme de chaînes de caractères « 0 » et « 1 ».
-
0 | FALSE : le pilote signale les colonnes BOOLÉENNES sous la forme SQL_BIT. Il s’agit du comportement de par défaut.
Utilisez cette option si votre application repose sur des colonnes booléennes renvoyées sous forme de données de caractères.
Ce paramètre est facultatif. Cette option est disponible dans les versions de pilote 2.2.1 et ultérieures.
CaFile
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Chemin d’accès au fichier de certificat d’autorité de certification utilisé pour certaines formes d’authentification IAM.
Ce paramètre est disponible uniquement sur Linux.
Ce paramètre est facultatif.
client_id
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
ID client associé à votre application Amazon Redshift dans 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
Clé secrète associée à votre application Amazon Redshift dans 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. Il est utilisé dans l’authentification IAM. L’ID du cluster n’est pas spécifié dans le paramètre Server (Serveur).
Ce paramètre est facultatif.
compression
-
Valeur par défaut : désactivé
-
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.
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. -
zstd : définit la méthode de compression utilisée pour les communications par protocole filaire avec Amazon Redshift sur
zstd. -
désactivé : n’utilise pas la compression pour les communications par protocole filaire avec Amazon Redshift.
Ce paramètre est facultatif.
Base de données
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Nom de la base de données Amazon Redshift à laquelle vous souhaitez accéder.
Ce paramètre est obligatoire.
DatabaseMetadataCurrentDbOnly
-
Valeur par défaut : 1
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote renvoie des métadonnées provenant de plusieurs bases de données et clusters.
-
1 | TRUE : Le pilote renvoie uniquement les métadonnées de la base de données actuelle.
-
0 | FALSE. Le pilote renvoie les métadonnées de plusieurs bases de données et clusters Amazon Redshift.
Ce paramètre est facultatif.
dbgroups_filter
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
L'expression régulière que vous pouvez spécifier pour filtrer DbGroups qui sont reçues de la réponse SAML à Amazon Redshift lors de l'utilisation des types d'authentification Azure, Browser Azure et Browser SAML.
Ce paramètre est facultatif.
Pilote
-
Valeur par défaut : Pilote ODBC Amazon Redshift (64 bits)
-
Types de données – Chaîne
Nom du pilote. La seule valeur prise en charge est Pilote ODBC Amazon Redshift (x64).
Ce paramètre est obligatoire si vous ne définissez pas le DSN.
DSN
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Nom de la source de données du pilote. L'application spécifie le DSN dans le SQLDriverConnect API.
Ce paramètre est obligatoire si vous ne définissez pas le Pilote.
EnableTableTypes
-
Valeur par défaut : 1
-
Types de données – Booléen
Spécifie si le pilote reconnaît les informations détaillées de type de table provenant de la source de données lorsqu'une application appelle la fonction de catalogue SQLTables. Par défaut, le pilote reconnaît les types de tableaux détaillés.
-
1 | VRAI : le pilote reconnaît les types de tables suivants : TABLE, VIEW, SYSTEM TABLE, SYSTEM VIEW, EXTERNAL TABLE et LOCAL TEMPORARY.
-
0 | FALSE : Le pilote normalise les informations détaillées sur les types de table dans les types de table génériques TABLE et VIEW.
Ce paramètre est facultatif. Il est disponible dans les versions de pilote 2.2.1 et ultérieures.
EndpointUrl
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Point de terminaison principal utilisé pour communiquer avec le service Coral Amazon Redshift pour l’authentification IAM.
Ce paramètre est facultatif.
Fetch
-
Valeur par défaut — 100
-
Type de données – Entier
Quand Declare/Fetch si le mode est activé, cette option contrôle le nombre de lignes que le conducteur récupère par aller-retour, ce qui vous permet de régler l'équilibre entre l'utilisation de la mémoire et la surcharge réseau en fonction de votre charge de travail. Une valeur plus élevée permet d'extraire plus de lignes à la fois, ce qui réduit le nombre d'allers-retours vers le serveur au prix d'une plus grande quantité de mémoire par extraction. Une valeur inférieure réduit l'utilisation de la mémoire mais augmente la fréquence à laquelle le pilote retourne sur le serveur. Il définit le nombre de lignes que le pilote renvoie à un moment où UseDeclareFetch est activé. Pour plus d’informations, consultez UseDeclareFetch.
Ce paramètre est facultatif.
ForceLowercase
-
Valeur par défaut : 0
-
Types de données – Booléen
Un booléen indiquant si le pilote met tout en minuscules DbGroups envoyé par le fournisseur d'identité à Amazon Redshift lors de l'utilisation de l'authentification unique.
-
1 | VRAI : le pilote met tout en minuscules DbGroups qui sont envoyés par le fournisseur d'identité.
-
0 | FALSE : Le pilote ne change pas DbGroups.
Ce paramètre est facultatif.
group_federation
-
Valeur par défaut : 0
-
Types de données – Booléen
Un booléen spécifiant si l’API getClusterCredentialsWithIAM est utilisée pour obtenir des informations d’identification de cluster temporaires dans les clusters alloués. Cette option permet aux utilisateurs IAM d’intégrer les rôles de base de données Redshift dans les clusters alloués. Notez que cette option ne s’applique pas aux espaces de noms Redshift sans serveur.
-
1 | TRUE : Le pilote utilise l’API
getClusterCredentialsWithIAMpour obtenir les informations d’identification temporaires du cluster dans les clusters alloués. -
0 | FALSE : le pilote utilise l’API
getClusterCredentialspar défaut pour obtenir des informations d’identification de cluster temporaires dans les clusters alloués.
Ce paramètre est facultatif.
https_proxy_host
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Nom d’hôte ou adresse IP du serveur proxy via lequel vous souhaitez transmettre les processus d’authentification IAM.
Ce paramètre est facultatif.
https_proxy_password
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Mot de passe que vous utilisez pour accéder au serveur proxy. Il est utilisé pour l’authentification IAM.
Ce paramètre est facultatif.
https_proxy_port
-
Valeur par défaut – Aucune
-
Type de données – Entier
Numéro du port que le serveur proxy utilise pour écouter les connexions client. Il est utilisé pour l’authentification IAM.
Ce paramètre est facultatif.
https_proxy_username
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le nom d’utilisateur que vous utilisez pour accéder au serveur proxy. Il est utilisé pour l’authentification IAM.
Ce paramètre est facultatif.
IAM
-
Valeur par défaut : 0
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote utilise une méthode d’authentification IAM pour authentifier la connexion.
-
1 | VRAI : Le pilote utilise l’une des méthodes d’authentification IAM (en utilisant une paire clé d’accès et clé secrète, un profil ou un service d’informations d’identification).
-
0 | FALSE. Le pilote utilise l’authentification standard (en utilisant le nom d’utilisateur et le mot de passe de votre base de données).
Ce paramètre est facultatif.
idc_client_display_name
-
Valeur par défaut : pilote ODBC Amazon Redshift
-
Types de données – Chaîne
Le nom d'affichage à utiliser pour le client qui utilise BrowserIdcAuthPlugin.
Ce paramètre est facultatif.
idc_region
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le AWS région où le AWS L'instance IAM Identity Center est localisée.
Ce paramètre est requis uniquement lors de l’authentification à l’aide de BrowserIdcAuthPlugin dans l’option de configuration plugin_name.
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.
Ce paramètre est facultatif.
idp_port
-
Valeur par défaut – Aucune
-
Type de données – Entier
Port pour un IdP (fournisseur d’identité) que vous utilisez pour vous authentifier dans Amazon Redshift. 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_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 plug-in de navigateur.
Ce paramètre est facultatif.
idp_tenant
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
ID de locataire Azure AD associé à votre application Amazon Redshift.
Ce paramètre est obligatoire si vous vous authentifiez via le service Azure AD.
idp_partition
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Spécifie la partition cloud sur laquelle votre fournisseur d'identité (IdP) est configuré. Cela détermine à quel point de terminaison d'authentification IdP le pilote se connecte.
Si ce paramètre est laissé vide, le pilote utilise par défaut la partition commerciale. Les valeurs possibles sont :
-
us-gov: utilisez cette valeur si votre IdP est configuré dans Azure Government. Par exemple, Azure AD Government utilise le point de terminaisonlogin.microsoftonline.us. -
cn: utilisez cette valeur si votre IdP est configuré dans la partition cloud chinoise. Par exemple, Azure AD China utilise le point de terminaisonlogin.chinacloudapi.cn.
Ce paramètre est facultatif.
idp_use_https_proxy
-
Valeur par défaut : 0
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote transmet les processus d’authentification pour les fournisseurs d’identité (IdP) par un serveur proxy.
-
1 | TRUE : Le pilote transmet les processus d’authentification IdP par un serveur proxy.
-
0 | FALSE. Le pilote ne transmet pas les processus d’authentification IdP par un serveur proxy.
Ce paramètre est facultatif.
InstanceProfile
-
Valeur par défaut : 0
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote utilise le profil d’instance Amazon EC2, lorsqu’il est configuré pour utiliser un profil pour l’authentification.
-
1 | TRUE : Le pilote utilise le profil d’instance Amazon EC2.
-
0 | FALSE. Le pilote utilise le profil des rôles reliés par chaîne spécifié par l’option Nom du profil (Profil) à la place.
Ce paramètre est facultatif.
issuer_url
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Pointe vers le AWS Point de terminaison de l'instance du serveur IAM Identity Center.
Ce paramètre est requis uniquement lors de l’authentification à l’aide de BrowserIdcAuthPlugin dans l’option de configuration plugin_name.
KeepAlive
-
Valeur par défaut : 1
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote utilise les keepalives TCP pour empêcher les connexions de s’interrompre.
-
1 | TRUE : Le pilote utilise les keepalives TCP pour empêcher les connexions de s’interrompre.
-
0 | FALSE. Le pilote n’utilise pas les keepalives TCP.
Ce paramètre est facultatif.
KeepAliveCount
-
Valeur par défaut : 0
-
Type de données – Entier
Nombre de paquets TCP keepalive qui peuvent être perdus avant que la connexion soit considérée comme interrompue. Lorsque ce paramètre est défini sur 0, le pilote utilise la valeur par défaut du système pour ce paramètre.
Ce paramètre est facultatif.
KeepAliveInterval
-
Valeur par défaut : 0
-
Type de données – Entier
Nombre de secondes entre chaque retransmission de paquet TCP keepalive. Lorsque ce paramètre est défini sur 0, le pilote utilise la valeur par défaut du système pour ce paramètre.
Ce paramètre est facultatif.
KeepAliveIdle
-
Valeur par défaut : 0
-
Type de données – Entier
Nombre de secondes d’inactivité avant que le pilote envoie un paquet TCP keepalive. Lorsque ce paramètre est défini sur 0, le pilote utilise la valeur par défaut du système pour ce paramètre.
Ce paramètre est facultatif.
listen_port
-
Valeur par défaut : 7890
-
Type de données – Entier
Le port que le pilote utilise pour recevoir la réponse SAML du fournisseur d'identité ou le code d'autorisation lorsqu'il utilise SAML, Azure AD ou AWS Services IAM Identity Center via un plug-in de navigateur.
Ce paramètre est facultatif.
login_url
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
URL de la ressource sur le site web du fournisseur d’identité lors de l’utilisation du plug-in générique du Navigateur SAML.
Ce paramètre est requis si vous vous authentifiez avec les services SAML ou Azure AD via un plugin de navigateur.
connexionToRp
-
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.
Cette chaîne est facultative.
LogLevel
-
Valeur par défaut : 0
-
Type de données – Entier
LogLevel et LogPath sont des paramètres globaux. Le conducteur les lit dans l'ordre de priorité suivant :
-
Chaîne de connexion (
LogLevel=6;LogPath=/path;) — priorité la plus élevée, remplace tous les autres paramètres au moment de la connexion. -
Sur Windows : La boîte de dialogue de configuration DSN (onglet Avancé).
Sur Linux et macOS :
[ODBC]section de votreodbc.inidossier. -
[DRIVER]section dans leamazon.redshiftodbc.inifichier : utilisé comme solution de secours si la journalisation n'est pas activée à partir de la source ci-dessus.
Réglage LogLevel ou LogPath dans une section DSN individuelle (par exemple, [MyDSN]) n'a aucun effet. Ces options ne sont pas lues à partir des sections spécifiques au DSN.
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. Nous vous recommandons d’activer la journalisation juste assez longtemps pour capturer un problème, car elle diminue les performances et peut consommer une grande quantité d’espace disque.
Définissez la propriété sur l’une des valeurs suivantes :
-
0 : OFF. Désactiver toute la journalisation.
-
1 : FATAL. Réservé aux erreurs fatales.
-
2 : ERREUR. Enregistre les événements d'erreur tels que les échecs de connexion et les erreurs d'authentification.
-
3 : PRÉVENIR. Enregistre les avertissements et les situations inattendues en plus des erreurs.
-
4 : INFORMATIONS. Enregistre les informations générales relatives à la progression, telles que l'état de la connexion et les paramètres du serveur.
-
5 : DEBUG. Enregistre toutes les activités du pilote, y compris les appels de fonction de l'API ODBC avec des arguments et des valeurs de retour.
-
6 : TRACE. Enregistre toutes les activités du conducteur, y compris le protocole de bas niveau supplémentaire et les détails de l'état interne.
Le niveau de journalisation 5 (DEBUG) ou supérieur capture toutes les activités du conducteur, qui peuvent inclure des informations sensibles telles que les informations d'identification de connexion et les données de requête. N'activez ces niveaux de journalisation que temporairement pour détecter un problème et assurez-vous que toutes les informations sensibles sont supprimées avant de partager les journaux avec le support ou un tiers.
Lorsque vous activez la journalisation, le pilote enregistre toutes les activités du conducteur dans un redshift_odbc.log fichier à l'emplacement que vous avez indiqué dans LogPath propriété.
À partir de la version 2.3.0 du pilote, le redshift_odbc.log.1 le journal des prises de contact de connexion est obsolète et le pilote ne le crée plus.
Ce paramètre est facultatif.
LogPath
-
Valeur par défaut — Les OS-specific Répertoire TEMP
-
Types de données – Chaîne
LogLevel et LogPath sont des paramètres globaux. Le conducteur les lit dans l'ordre de priorité suivant :
-
Chaîne de connexion (
LogLevel=6;LogPath=/path;) — priorité la plus élevée, remplace tous les autres paramètres au moment de la connexion. -
Sur Windows : La boîte de dialogue de configuration DSN (onglet Avancé).
Sur Linux et macOS :
[ODBC]section de votreodbc.inidossier. -
[DRIVER]section dans leamazon.redshiftodbc.inifichier : utilisé comme solution de secours si la journalisation n'est pas activée à partir de la source ci-dessus.
Réglage LogLevel ou LogPath dans une section DSN individuelle (par exemple, [MyDSN]) n'a aucun effet. Ces options ne sont pas lues à partir des sections spécifiques au DSN.
Le chemin complet vers le dossier dans lequel le pilote enregistre les fichiers journaux lorsque LogLevel est supérieur à 0.
Ce paramètre est facultatif.
LoginTimeout
-
Valeur par défaut : 0
-
Type de données – Entier
Le nombre de secondes pendant lesquelles le pilote attend qu'une connexion au serveur soit établie avant d'arriver à expiration. Une valeur de 0 signifie qu'il n'y a pas de délai d'attente (le pilote attend indéfiniment).
Vous pouvez définir cette option dans la chaîne de connexion (en utilisant LoginTimeout ou le pseudonyme abrégé LT), dans la configuration DSN, ou par programmation à l'aide de SQLSetConnectAttr avec SQL_ATTR_LOGIN_TIMEOUT. Sous Windows, cette option est également disponible dans la boîte de dialogue de configuration DSN (onglet Avancé).
Ce paramètre est facultatif.
MaxLongVarcharSize
-
Valeur par défaut — 65535
-
Type de données – Entier
La taille de colonne indiquée par le pilote pour les colonnes reclassées en tant que texte de grande taille (SQL_LONGVARCHAR) par MaxVarcharSize. Cette valeur remplace la taille réelle déclarée de la colonne dans les réponses aux métadonnées.
La valeur par défaut de 65 535 est recommandée car certaines couches intergicielles, telles que MSDASQL, rejettent les colonnes de texte volumineux dont la taille signalée est comprise entre 8 001 et 32 768 octets. En signalant 65 535, le pilote s'assure que les colonnes reclassées sont acceptées sans erreur. La plupart des utilisateurs n'ont pas besoin de modifier cette valeur.
Ce paramètre n'a aucun effet lorsque MaxVarcharSize est réglé sur 0 (reclassement désactivé).
Ce paramètre est facultatif. Il est disponible dans les versions de pilote 2.1.16 et ultérieures.
MaxVarcharSize
-
Valeur par défaut — 255
-
Type de données – Entier
La taille de colonne maximale que le pilote indique en tant que colonne de texte normale (SQL_VARCHAR). Le conducteur reclasse tout CHAR et VARCHAR colonne plus grande que cette valeur en tant que texte de grande taille (SQL_LONGVARCHAR ou SQL_WLONGVARCHAR quand UseUnicode est activé).
Cette reclassification permet d'éviter les erreurs dans les applications ou les couches intergicielles qui ne peuvent pas traiter les colonnes de texte normal au-delà d'une certaine taille. Par exemple, les serveurs liés à SQL Server qui accèdent à Amazon Redshift via MSDASQL (OLE DB) ne peuvent pas traiter SQL_VARCHAR colonnes de plus de 8 000 octets environ. Le reclassement des colonnes surdimensionnées en tant que texte volumineux évite les échecs de conversion.
-
255(par défaut) : les colonnes de plus de 255 caractères sont signalées commeSQL_LONGVARCHAR. -
0: désactive le reclassement. Toutes les colonnes sont signalées commeSQL_VARCHARquelle que soit la taille. -
Valeur personnalisée : n'importe quel entier positif. Les colonnes dont la taille est supérieure à la valeur spécifiée sont signalées comme
SQL_LONGVARCHAR.
Lorsqu'une colonne est reclassée, le pilote indique sa taille en utilisant la valeur spécifiée dans MaxLongVarcharSize.
Ce paramètre est facultatif. Il est disponible dans les versions de pilote 2.1.16 et ultérieures.
Min_TLS
-
Valeur par défaut — 1,2
-
Types de données – Chaîne
La version minimale de TLS/SSL que le pilote autorise le magasin de données à utiliser pour chiffrer les connexions. Par exemple, si TLS 1.2 est spécifié, TLS 1.1 ne peut pas être utilisé pour chiffrer les connexions.
Min_TLS accepte les valeurs suivantes :
-
1.0 : La connexion doit utiliser au moins TLS 1.0.
-
1.1 : La connexion doit utiliser au moins TLS 1.1.
-
1.2 : La connexion doit utiliser au moins TLS 1.2.
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 | PWD
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Mot de passe correspondant au nom d’utilisateur de la base de données que vous avez fourni dans le champ Utilisateur (UID | Utilisateur | LogonID).
Ce paramètre est facultatif.
plugin_name
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le nom du plug-in du fournisseur d’informations d’identification que vous souhaitez utiliser pour l’authentification.
Les valeurs suivantes sont prises en charge :
-
ADFS: utilisez Active Directory Federation Services pour l’authentification. -
AzureAD: utilisez le service Microsoft Azure Active Directory (AD) pour l’authentification. -
BrowserAzureAD: utilisez un plug-in de navigateur pour le service Microsoft Azure Active Directory (AD) pour l’authentification. -
BrowserIdcAuthPlugin: un plugin d’autorisation utilisant AWS IAM Identity Center. -
BrowserSAML: utilisez un plug-in de navigateur pour les services SAML tels qu’Okta ou Ping pour l’authentification. -
IdpTokenAuthPlugin: Un plugin d'autorisation qui accepte un AWS Jeton IAM Identity Center ou OpenID Connect (OIDC) JSON-based jetons d'identité (JWT) provenant de n'importe quel fournisseur d'identité Web lié à AWS Centre d'identité IAM. -
JWT: utilisez un jeton web JSON (JWT) pour l’authentification. -
Ping: Utilisez le PingFederate service d'authentification. -
Okta: utilisez le service Okta pour l’authentification.
Ce paramètre est facultatif.
Port | PortNumber
-
Valeur par défaut : 5439
-
Type de données – Entier
Numéro du port TCP que le serveur Amazon Redshift utilise pour écouter les connexions client.
Ce paramètre est facultatif.
Prefer_PQ
-
Valeur par défaut : 1
-
Types de données – Booléen
Spécifie si le pilote annonce des groupes d'échange de clés hybrides post-quantiques dans le TLS 1.3 ClientHello. Lorsque des groupes post-quantiques sont proposés et que le serveur les prend également en charge, le serveur en sélectionne un. Sinon, la poignée de main revient à l'échange de clés classique de manière transparente.
-
1 | VRAI : Le pilote annonce des groupes d'échange de clés TLS hybrides post-quantiques.
-
0 | FAUX : Le pilote ne fait pas de publicité pour les groupes post-quantiques. Utilisez ce paramètre si un boîtier intermédiaire réseau bloque les prises de contact TLS car il ne reconnaît pas les groupes d'échange de clés post-quantiques proposés par le pilote.
Ce paramètre est facultatif. Il est disponible dans les versions de pilote 2.2.1 et ultérieures.
preferred_role
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le rôle que vous souhaitez endosser lors de la connexion à Amazon Redshift. Il est utilisé pour l’authentification IAM.
Ce paramètre est facultatif.
Profil
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le nom de l'utilisateur AWS profil utilisé pour s'authentifier auprès d'Amazon Redshift.
-
Si le paramètre Utiliser le profil d'instance (le InstanceProfile property) est défini sur 1 | TRUE, ce paramètre est prioritaire et le pilote utilise le profil d'instance Amazon EC2 à la place.
-
L’emplacement par défaut du fichier d’informations d’identification qui contient des profils est
~/.aws/Credentials. La variable d’environnementAWS_SHARED_CREDENTIALS_FILEpeut être utilisée pour désigner un autre fichier d’informations d’identification.
Ce paramètre est facultatif.
provider_name
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Fournisseur d’authentification créé par l’utilisateur à l’aide de la requête CREATE IDENTITY PROVIDER. Il est utilisé dans l’authentification native Amazon Redshift.
Ce paramètre est facultatif.
ProxyHost
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Nom d’hôte ou adresse IP du serveur proxy via lequel vous souhaitez vous connecter.
Ce paramètre est facultatif.
ProxyPort
-
Valeur par défaut – Aucune
-
Type de données – Entier
Numéro du port que le serveur proxy utilise pour écouter les connexions client.
Ce paramètre est facultatif.
ProxyPwd
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Mot de passe que vous utilisez pour accéder au serveur proxy.
Ce paramètre est facultatif.
ProxyUid
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le nom d’utilisateur que vous utilisez pour accéder au serveur proxy.
Ce paramètre est facultatif.
ReadOnly
-
Valeur par défaut : 0
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote est en mode lecture seule.
-
1 | TRUE : La connexion est en mode lecture seule et ne peut pas écrire dans le magasin de données.
-
0 | FALSE : La connexion n’est pas en mode lecture seule et peut écrire dans le magasin de données.
Ce paramètre est facultatif.
region
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Le AWS région dans laquelle se trouve votre cluster.
Ce paramètre est facultatif.
SecretAccessKey
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
La clé de secret IAM pour l’utilisateur ou le rôle. Si vous définissez ce paramètre, vous devez également définir AccessKeyIDENTIFIANT.
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.
Ce paramètre est facultatif.
Serveur | HostName | Hôte
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Serveur de point de terminaison auquel se connecter.
Ce paramètre est obligatoire.
ssl_insecure
-
Valeur par défaut : 0
-
Types de données – Booléen
Valeur booléenne indiquant si le pilote vérifie l’authenticité du certificat du serveur IdP.
-
1 | TRUE : Le pilote ne vérifie pas l’authenticité du certificat du serveur IdP.
-
0 | FALSE : Le pilote vérifie l’authenticité du certificat du serveur IdP.
Ce paramètre est facultatif.
SSLMode
-
Valeur par défaut :
verify-full -
Types de données – Chaîne
Mode de vérification du certificat SSL à utiliser lors de la connexion à Amazon Redshift. Les valeurs suivantes sont possibles :
-
verify-full: connectez-vous uniquement en utilisant un protocole SSL, une autorité de certification de confiance et un nom de serveur qui correspond au certificat. -
verify-ca: connectez-vous uniquement en utilisant le protocole SSL et une autorité de certification de confiance. -
require: connectez-vous uniquement en utilisant le protocole SSL. -
prefer: connectez-vous en utilisant le protocole SSL s’il est disponible. Sinon, connectez-vous sans utiliser le protocole SSL. -
allow: par défaut, connectez-vous sans utiliser le protocole SSL. Si le serveur nécessite des connexions SSL, utilisez le protocole SSL. -
disable: connectez-vous sans utiliser le protocole SSL.
Nous vous recommandons d'utiliser verify-full pour les connexions SSL dans la mesure du possible.
Dans les versions 2.3.0 et ultérieures du pilote, la valeur par défaut est verify-full. Dans les versions précédentes, la valeur par défaut était verify-ca. Si vous ne définissez pas SSLMode et que le certificat du serveur ne correspond pas au nom d'hôte, le pilote enregistre un avertissement et se connecte. Si vous définissez SSLMode, le pilote applique le mode que vous avez défini.
Ce paramètre est facultatif.
StreamingCursorRows
-
Valeur par défaut : 0
-
Type de données – Entier
Limite le nombre de lignes que le pilote garde en mémoire à la fois pour un curseur orienté uniquement vers l'avant, afin que les grands ensembles de résultats n'aient pas à être chargés en mémoire en une seule fois.
Définissez la propriété sur l’une des valeurs suivantes :
-
0 : Le pilote charge l'ensemble des résultats en mémoire avant de renvoyer les lignes à l'application (par défaut). Les très grands ensembles de résultats peuvent consommer une grande quantité de mémoire.
-
Nombre entier positif : pour un curseur orienté uniquement vers l'avant, le pilote ne conserve en mémoire que ce nombre de lignes à la fois. Il renvoie ces lignes à l'application, les libère, puis récupère le lot suivant une fois que l'application a consommé le lot en cours.
Cette option n'a aucun effet sur les curseurs défilants, qui utilisent toujours le comportement en mémoire. Notez que sous Windows, la boîte de dialogue de configuration DSN du pilote ODBC Amazon Redshift préremplit ce champ avec une valeur de 100.
Le mode curseur de diffusion nécessite un curseur orienté uniquement vers l'avant. Si l'option Curseur côté client (CSC) est activée, elle est prioritaire et le mode curseur de diffusion est désactivé.
StreamingCursorRows et UseDeclareFetch les deux résultats par lots au lieu de charger l'ensemble des résultats en mémoire. UseDeclareFetch utilise un curseur côté serveur et fournit généralement un débit nettement plus élevé. Préférez-le donc lorsque les performances de récupération sont votre principale préoccupation. StreamingCursorRows ne nécessite pas d'encapsulation des transactions ni de curseur côté serveur ; choisissez-le lorsque ces propriétés sont plus importantes que la vitesse de pointe, c'est-à-dire un flux direct uniquement avec une empreinte mémoire limitée. Si UseDeclareFetch est activé, il prend la priorité et force StreamingCursorRows à 0. Pour plus d’informations, consultez UseDeclareFetch.
Ce paramètre est facultatif.
StsConnectionTimeout
-
Valeur par défaut : 0
-
Type de données – Entier
Durée d’attente maximale pour les connexions IAM, en secondes. S'il est réglé sur 0 ou s'il n'est pas spécifié, le pilote attend 60 secondes pour chaque AWS STS appel.
Ce paramètre est facultatif.
StsEndpointUrl
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Cette option spécifie le point de terminaison principal utilisé pour communiquer avec AWS Security Token Service (AWS STS).
Ce paramètre est facultatif.
jeton
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Un AWS IAM Identity Center a fourni un jeton d'accès ou un jeton Web JSON (JWT) OpenID Connect (OIDC) fourni par un fournisseur d'identité Web lié à AWS Centre d'identité IAM. Votre application doit générer ce jeton en authentifiant l'utilisateur de votre application avec AWS IAM Identity Center ou un fournisseur d'identité lié à AWS Centre d'identité IAM.
Ce paramètre fonctionne avec IdpTokenAuthPlugin.
token_type
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Type de jeton utilisé dans IdpTokenAuthPlugin.
Vous pouvez spécifier les valeurs suivantes :
- ACCESS_TOKEN
-
Entrez ceci si vous utilisez un AWS IAM Identity Center a fourni un jeton d'accès.
- EXT_JWT
-
Entrez cette valeur si vous utilisez un jeton Web JSON (JWT) OpenID Connect (OIDC) fourni par un fournisseur d’identité Web intégré à AWS IAM Identity Center.
Ce paramètre fonctionne avec IdpTokenAuthPlugin.
UID | Utilisateur | LogonID
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Nom d’utilisateur que vous utilisez pour accéder au serveur Amazon Redshift.
Ce paramètre est obligatoire si vous utilisez l’authentification de base de données.
UseDeclareFetch
-
Valeur par défaut : 0
-
Types de données – Booléen
Lorsqu'une requête renvoie un jeu de résultats trop volumineux pour être conservé en mémoire, l'activation de cette option permet au pilote de le traiter par lots de taille fixe au lieu de mettre en mémoire tampon l'intégralité du résultat en une seule fois, ce qui permet de limiter et de prévoir l'empreinte mémoire du client quel que soit le nombre de lignes renvoyées par la requête. Il s'agit d'un booléen qui indique si le pilote utilise Declare/Fetch mode, renvoyant un nombre défini de lignes à la fois. Pour définir le nombre de lignes renvoyées par lot, utilisez Fetch option. Pour plus d’informations, consultez Fetch.
-
1 | VRAI : Le conducteur utilise Declare/Fetch mode et renvoie le nombre de lignes spécifié par
Fetchoption à la fois. -
0 | FALSE : Le pilote renvoie le résultat complet de la requête en une seule fois.
Ce paramètre est facultatif.
Si UseDeclareFetch est activé, le pilote désactive le mode curseur de diffusion en continu et remplace StreamingCursorRows à 0, quelle que soit la valeur définie dans votre DSN ou votre chaîne de connexion. Pour plus d’informations, consultez StreamingCursorRows.
UseUnicode
-
Valeur par défaut : 0
-
Types de données – Booléen
Un booléen indiquant si le pilote renvoie les données Redshift au format Unicode ou SQL normal.
-
1 | VRAI : Le pilote renvoie un type SQL étendu pour le type de données de caractère.
-
SQL_WCHAR est renvoyé à la place de SQL_CHAR.
-
SQL_WVARCHAR est renvoyé à la place de SQL_VARCHAR.
-
SQL_WLONGVARCHAR est renvoyé à la place de SQL_LONGVARCHAR.
-
-
0 | FALSE : Le pilote renvoie le type SQL normal pour le type de données de caractère.
-
SQL_CHAR est renvoyé au lieu de SQL_WCHAR.
-
SQL_VARCHAR est renvoyé à la place de SQL_WVARCHAR.
-
SQL_LONGVARCHAR est renvoyé à la place de SQL_WLONGVARCHAR.
-
Ce paramètre est facultatif. Il est disponible dans les versions de pilote 2.1.15 et ultérieures.
web_identity_token
-
Valeur par défaut – Aucune
-
Types de données – Chaîne
Jeton OAUTH fourni par le fournisseur d’identité. Il est utilisé dans le plug-in JWT.
Ce paramètre est obligatoire si vous définissez le nom_module paramètre pour BasicJwtCredentialsProvider.