View a markdown version of this page

Syntaxe et options de chaîne de connexion pour le pilote ODBC - AWS IoT SiteWise
Connexion proxy

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.

Syntaxe et options de chaîne de connexion pour le pilote ODBC

La syntaxe permettant de spécifier les options de chaîne de connexion pour le pilote ODBC est la suivante :

Driver={AWS IoT SiteWise ODBC Driver};(option)=(value);

Les options disponibles sont les suivantes :

Options de connexion du pilote

  • Driver(obligatoire) — Le pilote utilisé avec ODBC.

    La valeur par défaut est AWS IoT SiteWise.

  • DSN— Le nom de la source de données (DSN) à utiliser pour configurer la connexion.

    La valeur par défaut est NONE.

  • Auth— Le mode d'authentification. Il doit s'agir de l'une des options suivantes :

    • AWS_PROFILE— Utilisez la chaîne d'informations d'identification par défaut.

    • IAM— Utilisez les informations d'identification AWS IAM.

    • AAD— Utilisez le fournisseur d'identité Azure Active Directory (AD).

    • OKTA— Utilisez le fournisseur d'identité Okta.

    La valeur par défaut est AWS_PROFILE.

Options de configuration des terminaux

  • EndpointOverride— Le remplacement du point de terminaison pour le AWS IoT SiteWise service. Il s'agit d'une option avancée qui remplace la région. Par exemple :

    iotsitewise.us-east-1.amazonaws.com

  • Region— La région de signature pour le point de terminaison du AWS IoT SiteWise service.

    La valeur par défaut est us-east-1.

Option de fournisseur d'informations d'identification

  • ProfileName— Le nom du profil dans le fichier de AWS configuration.

    La valeur par défaut est NONE.

AWS Options d'authentification IAM

  • UIDou AccessKeyId — L'identifiant de la clé AWS d'accès de l'utilisateur. Si UID les deux AccessKeyId sont fournis dans la chaîne de connexion, la UID valeur sera utilisée sauf si elle est vide.

    La valeur par défaut est NONE.

  • PWDou SecretKey  : clé d'accès secrète de l'utilisateur AWS. Si PWD les deux SecretKey sont fournis dans la chaîne de connexion, la PWD valeur with sera utilisée sauf si elle est vide.

    La valeur par défaut est NONE.

  • SessionToken— Le jeton de session temporaire requis pour accéder à une base de données avec l'authentification multifacteur (MFA) activée. N'incluez pas de fin = dans la saisie.

    La valeur par défaut est NONE.

SAML-based options d'authentification pour Okta

  • IdPHost— Le nom d'hôte de l'IdP spécifié.

    La valeur par défaut est NONE.

  • UIDou IdPUserName  : nom d'utilisateur pour le compte IdP spécifié. Si UID les deux IdPUserName sont fournis dans la chaîne de connexion, la UID valeur sera utilisée sauf si elle est vide.

    La valeur par défaut est NONE.

  • PWDou IdPPassword  : mot de passe du compte IdP spécifié. Si PWD les deux IdPPassword sont fournis dans la chaîne de connexion, la PWD valeur sera utilisée sauf si elle est vide.

    La valeur par défaut est NONE.

  • OktaApplicationID— L' Okta-provided identifiant unique associé à l' AWS IoT SiteWise application. L'identifiant de l'application (AppId) se trouve dans le entityID champ fourni dans les métadonnées de l'application. Voici un exemple :

    entityID="http://www.okta.com//(IdPAppID)

    La valeur par défaut est NONE.

  • RoleARN— L'Amazon Resource Name (ARN) du rôle assumé par l'appelant.

    La valeur par défaut est NONE.

  • IdPARN— Le nom de ressource Amazon (ARN) du fournisseur SAML dans IAM qui décrit l'IdP.

    La valeur par défaut est NONE.

SAML-based options d'authentification pour Azure Active Directory

  • UIDou IdPUserName  : nom d'utilisateur pour le compte IdP spécifié.

    La valeur par défaut est NONE.

  • PWDou IdPPassword  : mot de passe du compte IdP spécifié.

    La valeur par défaut est NONE.

  • AADApplicationID— L'identifiant unique de l'application enregistrée sur Azure AD.

    La valeur par défaut est NONE.

  • AADClientSecret— Le secret client associé à l'application enregistrée sur Azure AD utilisé pour autoriser la récupération de jetons.

    La valeur par défaut est NONE.

  • AADTenant— L'ID du locataire Azure AD.

    La valeur par défaut est NONE.

  • RoleARN— L'Amazon Resource Name (ARN) du rôle assumé par l'appelant.

    La valeur par défaut est NONE.

  • IdPARN— Le nom de ressource Amazon (ARN) du fournisseur SAML dans IAM qui décrit l'IdP.

    La valeur par défaut est NONE.

AWS Options du SDK (avancées)

  • RequestTimeout— Durée en millisecondes pendant laquelle le AWS SDK attend une demande de requête avant d'expirer. Toute valeur non positive désactive le délai d'expiration de la demande.

    La valeur par défaut est 3000.

  • ConnectionTimeout— Durée en millisecondes pendant laquelle le AWS SDK attend que les données soient transférées via une connexion ouverte avant d'expirer. La valeur 0 désactive le délai de connexion. Cette valeur ne doit pas être négative.

    La valeur par défaut est 1000.

  • MaxRetryCountClient— Nombre maximum de tentatives pour les erreurs réessayables avec des codes d'erreur 5xx dans le SDK. La valeur ne doit pas être négative.

    La valeur par défaut est 0.

  • MaxConnections— Le nombre maximum de connexions HTTP ouvertes simultanément autorisées au AWS IoT SiteWise service. La valeur doit être positive.

    La valeur par défaut est 25.

Options de journalisation du pilote ODBC

  • LogLevel— Le niveau de journalisation pour la journalisation des pilotes. Doit être l'une des valeurs suivantes :

    • 0 (DÉSACTIVÉ).

    • 1 (ERREUR).

    • 2 (AVERTISSEMENT).

    • 3 (INFORMATIONS).

    • 4 (DÉBOGUER).

    La valeur par défaut est 1 (ERROR).

    Avertissement : des informations personnelles peuvent être enregistrées par le conducteur lors de l'utilisation du mode de journalisation DEBUG.

  • LogOutput— Dossier dans lequel stocker le fichier journal.

    La valeur par défaut est la suivante :

    • Windows : %USERPROFILE%, ou s'il n'est pas disponible,%HOMEDRIVE%%HOMEPATH%.

    • macOS et Linux : $HOME, ou s'il n'est pas disponible, le champ pw_dir de la valeur de getpwuid(getuid()) retour de la fonction.

Options de journalisation du SDK

Le niveau de journalisation du AWS SDK est distinct du niveau de journalisation du pilote AWS IoT SiteWise ODBC. Le réglage de l'un n'affecte pas l'autre.

Le niveau de journalisation du SDK est défini à l'aide de la variable SW_AWS_LOG_LEVEL d'environnement. Les valeurs valides sont :

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

S'il n'SW_AWS_LOG_LEVELest pas défini, le niveau de journalisation du SDK est défini sur la valeur par défaut, c'WARNest-à-dire.

Connexion via un proxy

Le pilote ODBC prend en charge la connexion AWS IoT SiteWise via un proxy. Pour utiliser cette fonctionnalité, configurez les variables d'environnement suivantes en fonction de vos paramètres de proxy :

  • SW_PROXY_HOST— l'hôte proxy.

  • SW_PROXY_PORT— Le numéro du port proxy.

  • SW_PROXY_SCHEME— Le schéma de proxy, http soithttps.

  • SW_PROXY_USER— Le nom d'utilisateur pour l'authentification par proxy.

  • SW_PROXY_PASSWORD— Le mot de passe utilisateur pour l'authentification par proxy.

  • SW_PROXY_SSL_CERT_PATH— Le fichier de certificat SSL à utiliser pour se connecter à un proxy HTTPS.

  • SW_PROXY_SSL_CERT_TYPE— Type du certificat SSL du client proxy.

  • SW_PROXY_SSL_KEY_PATH— Fichier de clé privée à utiliser pour se connecter à un proxy HTTPS.

  • SW_PROXY_SSL_KEY_TYPE— Type de fichier de clé privée utilisé pour se connecter à un proxy HTTPS.

  • SW_PROXY_SSL_KEY_PASSWORD— Phrase secrète du fichier de clé privée utilisé pour se connecter à un proxy HTTPS.