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** + **`UID`**oder **`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`. + **`PWD`**oder **`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`. + **`UID`**oder **`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`. + **`PWD`**oder **`IdPPassword`**— Das Passwort für das angegebene IdP-Konto. Wenn beide `PWD` und 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 . Die Anwendungs-ID (AppId) finden Sie 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** + **`UID`**oder **`IdPUserName`**— Der Benutzername für das angegebene IdP-Konto.. Der Standardwert ist `NONE`. + **`PWD`**oder **`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 festgelegt`SW_AWS_LOG_LEVEL`. Folgende sind gültige Werte: + `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` oder`https`. + **`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.