View a markdown version of this page

Syntax und Optionen für die Verbindungszeichenfolge für den ODBC-Treiber - AWS IoT SiteWise
Proxy-Verbindung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Syntax und Optionen für die Verbindungszeichenfolge für den ODBC-Treiber

Die Syntax für die Angabe von Verbindungszeichenfolgenoptionen für den ODBC-Treiber lautet wie folgt:

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

Die verfügbaren Optionen lauten wie folgt:

Verbindungsoptionen für den Treiber

  • Driver(erforderlich) — Der Treiber, der mit ODBC verwendet wird.

    Der Standardwert ist AWS IoT SiteWise.

  • DSN— Der Datenquellenname (DSN), der für die Konfiguration der Verbindung verwendet werden soll.

    Der Standardwert ist NONE.

  • Auth— Der Authentifizierungsmodus. Dies muss einer der folgenden sein:

    • AWS_PROFILE— Verwenden Sie die Standard-Anmeldeinformationskette.

    • IAM— Verwenden Sie AWS IAM-Anmeldeinformationen.

    • AAD— Verwenden Sie den Azure Active Directory (AD) -Identitätsanbieter.

    • OKTA— Verwenden Sie den Okta-Identitätsanbieter.

    Der Standardwert ist AWS_PROFILE.

Optionen für die Endpunkt-Konfiguration

  • EndpointOverride— Die Endpunktüberschreibung für den AWS IoT SiteWise Dienst. Dies ist eine erweiterte Option, die die Region außer Kraft setzt. Beispiel:

    iotsitewise.us-east-1.amazonaws.com

  • Region— Die Signierregion für den AWS IoT SiteWise Service-Endpunkt.

    Der Standardwert ist us-east-1.

Option „Anbieter von Anmeldeinformationen“

  • ProfileName— Der Profilname in der AWS Konfigurationsdatei.

    Der Standardwert ist NONE.

AWS IAM-Authentifizierungsoptionen

  • UIDoder AccessKeyId — Die ID des AWS Benutzerzugriffsschlüssels. Wenn beide UID und in der Verbindungszeichenfolge angegeben AccessKeyId sind, wird der UID Wert verwendet, sofern er nicht leer ist.

    Der Standardwert ist NONE.

  • PWDoder SecretKey — Der geheime Zugriffsschlüssel des AWS-Benutzers. Wenn beide PWD und in der Verbindungszeichenfolge angegeben SecretKey sind, wird der PWD Wert mit verwendet, sofern er nicht leer ist.

    Der Standardwert ist NONE.

  • SessionToken— Das temporäre Sitzungstoken, das für den Zugriff auf eine Datenbank mit aktivierter Multifaktor-Authentifizierung (MFA) erforderlich ist. Fügen Sie der Eingabe kein Ende hinzu = .

    Der Standardwert ist NONE.

SAML-based Authentifizierungsoptionen für Okta

  • IdPHost— Der Hostname des angegebenen IdP.

    Der Standardwert ist NONE.

  • UIDoder IdPUserName — Der Benutzername für das angegebene IdP-Konto. Wenn beide UID in der Verbindungszeichenfolge angegeben IdPUserName sind, wird der UID Wert verwendet, sofern er nicht leer ist.

    Der Standardwert ist NONE.

  • PWDoder IdPPassword — Das Passwort für das angegebene IdP-Konto. Wenn beide PWD und in der Verbindungszeichenfolge angegeben IdPPassword sind, wird der PWD Wert verwendet, sofern er nicht leer ist.

    Der Standardwert ist NONE.

  • OktaApplicationID— Die der AWS IoT SiteWise Anwendung zugeordnete eindeutige Okta-provided ID. Die Anwendungs-ID (AppId) finden Sie in dem entityID Feld, das in den Anwendungsmetadaten angegeben ist. Ein Beispiel dafür ist:

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

    Der Standardwert ist NONE.

  • RoleARN— Der Amazon-Ressourcenname (ARN) der Rolle, die der Anrufer annimmt.

    Der Standardwert ist NONE.

  • IdPARN— Der Amazon-Ressourcenname (ARN) des SAML-Anbieters in IAM, der den IdP beschreibt.

    Der Standardwert ist NONE.

SAML-based Authentifizierungsoptionen für Azure Active Directory

  • UIDoder IdPUserName — Der Benutzername für das angegebene IdP-Konto..

    Der Standardwert ist NONE.

  • PWDoder IdPPassword — Das Passwort für das angegebene IdP-Konto.

    Der Standardwert ist NONE.

  • AADApplicationID— Die eindeutige ID der registrierten Anwendung in Azure AD.

    Der Standardwert ist NONE.

  • AADClientSecret— Das Client-Geheimnis, das der registrierten Anwendung in Azure AD zugeordnet ist und zur Autorisierung des Abrufs von Token verwendet wird.

    Der Standardwert ist NONE.

  • AADTenant— Die Azure AD-Mandanten-ID.

    Der Standardwert ist NONE.

  • RoleARN— Der Amazon-Ressourcenname (ARN) der Rolle, die der Anrufer annimmt.

    Der Standardwert ist NONE.

  • IdPARN— Der Amazon-Ressourcenname (ARN) des SAML-Anbieters in IAM, der den IdP beschreibt.

    Der Standardwert ist NONE.

AWS SDK-Optionen (erweitert)

  • RequestTimeout— Die Zeit in Millisekunden, die das AWS SDK auf eine Abfrageanforderung wartet, bevor ein Timeout eintritt. Jeder nicht positive Wert deaktiviert das Anforderungs-Timeout.

    Der Standardwert ist 3000.

  • ConnectionTimeout— Die Zeit in Millisekunden, die das AWS SDK auf die Übertragung von Daten über eine offene Verbindung wartet, bevor ein Timeout eintritt. Ein Wert von 0 deaktiviert das Verbindungs-Timeout. Dieser Wert darf nicht negativ sein.

    Der Standardwert ist 1000.

  • MaxRetryCountClient— Die maximale Anzahl von Wiederholungsversuchen bei wiederholbaren Fehlern mit 5xx-Fehlercodes im SDK. Der Wert darf nicht negativ sein.

    Der Standardwert ist 0.

  • MaxConnections— Die maximale Anzahl erlaubter gleichzeitig offener HTTP-Verbindungen zum AWS IoT SiteWise Dienst. Der Wert muss positiv sein.

    Der Standardwert ist 25.

Optionen für die ODBC-Treiberprotokollierung

  • LogLevel— Die Protokollebene für die Treiberprotokollierung. Zulässige Werte sind:

    • 0 (AUS).

    • 1 (FEHLER).

    • 2 (WARNUNG).

    • 3 (INFORMATION).

    • 4 (DEBUGGEN).

    Die Standardeinstellung ist 1 (ERROR).

    Warnung: Persönliche Informationen könnten vom Treiber protokolliert werden, wenn der DEBUG-Protokollierungsmodus verwendet wird.

  • LogOutput— Ordner, in dem die Protokolldatei gespeichert werden soll.

    Die Standardeinstellung ist:

    • Windows: %USERPROFILE%, oder falls nicht verfügbar,%HOMEDRIVE%%HOMEPATH%.

    • macOS und Linux: $HOME oder falls nicht verfügbar, das Feld pw_dir aus dem getpwuid(getuid()) Rückgabewert der Funktion.

SDK-Protokollierungsoptionen

Die AWS SDK-Protokollebene ist von der AWS IoT SiteWise ODBC-Treiberprotokollebene getrennt. Die Einstellung einer Einstellung wirkt sich nicht auf die andere aus.

Das SDK-Log Level wird mithilfe der Umgebungsvariablen festgelegtSW_AWS_LOG_LEVEL. Folgende sind gültige Werte:

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

Wenn sie nicht gesetzt SW_AWS_LOG_LEVEL ist, wird die SDK-Protokollebene auf die Standardeinstellung gesetzt, die lautetWARN.

Verbindung über einen Proxy herstellen

Der ODBC-Treiber unterstützt die Verbindung AWS IoT SiteWise über einen Proxy. Um diese Funktion zu verwenden, konfigurieren Sie die folgenden Umgebungsvariablen auf der Grundlage Ihrer Proxyeinstellung:

  • SW_PROXY_HOST— der Proxy-Host.

  • SW_PROXY_PORT— Die Proxy-Portnummer.

  • SW_PROXY_SCHEME— Das Proxyschema, entweder http oderhttps.

  • SW_PROXY_USER— Der Benutzername für die Proxyauthentifizierung.

  • SW_PROXY_PASSWORD— Das Benutzerkennwort für die Proxyauthentifizierung.

  • SW_PROXY_SSL_CERT_PATH— Die SSL-Zertifikatsdatei, die für die Verbindung zu einem HTTPS-Proxy verwendet werden soll.

  • SW_PROXY_SSL_CERT_TYPE— Der Typ des SSL-Zertifikats für den Proxy-Client.

  • SW_PROXY_SSL_KEY_PATH— Die private Schlüsseldatei, die für die Verbindung zu einem HTTPS-Proxy verwendet werden soll.

  • SW_PROXY_SSL_KEY_TYPE— Der Typ der privaten Schlüsseldatei, die für die Verbindung zu einem HTTPS-Proxy verwendet wird.

  • SW_PROXY_SSL_KEY_PASSWORD— Die Passphrase für die private Schlüsseldatei, die für die Verbindung zu einem HTTPS-Proxy verwendet wird.