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 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 standardmäßige 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 Konfiguration von Endpunkten

  • EndpointOverride— Die Endpunkt-Überschreibung für den AWS IoT SiteWise Dienst. Dies ist eine erweiterte Option, die die Region überschreibt. Beispiel:

    iotsitewise.us-east-1.amazonaws.com

  • Region— Die Signaturregion für den AWS IoT SiteWise Dienstendpunkt.

    Der Standardwert ist us-east-1.

Option für den 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 UID sowohl als auch in der Verbindungszeichenfolge angegeben AccessKeyId werden, wird der UID Wert verwendet, sofern er nicht leer ist.

    Der Standardwert ist NONE.

  • PWDoder SecretKey— Der geheime AWS-Benutzerzugriffsschlüssel. Wenn PWD sowohl als auch in der Verbindungszeichenfolge angegeben SecretKey werden, wird der PWD Wert with 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 Multi-Faktor-Authentifizierung (MFA) erforderlich ist. Fügen Sie kein abschließendes Zeichen = in die Eingabe ein.

    Der Standardwert ist NONE.

SAML-basierte 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 und in der Verbindungszeichenfolge angegeben IdPUserName werden, 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 PWD sowohl als auch in der Verbindungszeichenfolge angegeben IdPPassword werden, wird der PWD Wert verwendet, sofern er nicht leer ist.

    Der Standardwert ist NONE.

  • OktaApplicationID— Die eindeutige, von Okta bereitgestellte ID, die der Anwendung zugeordnet ist AWS IoT SiteWise . Eine Stelle, an der Sie die Anwendungs-ID (AppId) finden können, befindet sich in dem entityID Feld, das in den Anwendungsmetadaten angegeben ist. Ein Beispiel ist:

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

    Der Standardwert ist NONE.

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

    Der Standardwert ist NONE.

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

    Der Standardwert ist NONE.

SAML-basierte 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 zum Autorisieren 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 Aufrufer 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 es zu einem Timeout kommt. Jeder nicht positive Wert deaktiviert das Anforderungs-Timeout.

    Der Standardwert ist 3000.

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

    Der Standardwert ist 1000.

  • MaxRetryCountClient— Die maximale Anzahl von Wiederholungsversuchen für Fehler, die wiederholt werden können, mit 5xx Fehlercodes im SDK. Der Wert darf nicht negativ sein.

    Der Standardwert ist 0.

  • MaxConnections— Die maximale Anzahl von erlaubten, gleichzeitig geöffneten HTTP-Verbindungen zu dem 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 Protokollebene des AWS IoT SiteWise ODBC-Treibers getrennt. Die Einstellung des einen hat keinen Einfluss auf das andere.

Die SDK-Protokollebene wird mithilfe der Umgebungsvariablen festgelegtSW_AWS_LOG_LEVEL. Gültige Werte sind:

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

Wenn nicht festgelegt, SW_AWS_LOG_LEVEL wird die SDK-Protokollebene auf die Standardeinstellung gesetzt, d. WARN h.

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 basierend auf 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 Proxy-Client-SSL-Zertifikats.

  • 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.