Für ähnliche Funktionen wie Amazon Timestream für sollten Sie Amazon Timestream for LiveAnalytics InfluxDB in Betracht ziehen. Es bietet eine vereinfachte Datenaufnahme und Antwortzeiten im einstelligen Millisekundenbereich für Analysen in Echtzeit. [Erfahren](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) Sie hier mehr.
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.
# ODBC
Der [Open-Source-ODBC-Treiber](https://github.com/awslabs/amazon-timestream-odbc-driver/tree/main) für Amazon Timestream for LiveAnalytics bietet Entwicklern eine SQL-relationale Schnittstelle zu Timestream und ermöglicht Konnektivität über Business Intelligence (BI) -Tools wie Power BI Desktop und Microsoft Excel. LiveAnalytics Der Timestream for LiveAnalytics ODBC-Treiber ist derzeit unter [Windows, MacOS und Linux verfügbar und](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) unterstützt auch SSO mit Okta und Microsoft Azure Active Directory (AD).
Weitere Informationen finden Sie in der [Dokumentation zu Amazon Timestream for LiveAnalytics ODBC-Treibern](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md) unter. GitHub
**Topics**
+ [Den Timestream for ODBC-Treiber einrichten LiveAnalytics](ODBC-setup.md)
+ [Syntax und Optionen der Verbindungszeichenfolge für den ODBC-Treiber](ODBC-connecting.md)
+ [Beispiele für Verbindungszeichenfolgen für den Timestream for ODBC-Treiber LiveAnalytics](ODBC-connecting-examples.md)
+ [Problembehandlung bei der Verbindung mit dem ODBC-Treiber](ODBC-connecting-troubleshooting.md)
# Den Timestream for ODBC-Treiber einrichten LiveAnalytics
## Richten Sie den Zugriff auf Timestream für LiveAnalytics in Ihrem Konto ein AWS
Wenn Sie Ihr AWS Konto noch nicht für die Arbeit mit Timestream eingerichtet haben LiveAnalytics, folgen Sie den Anweisungen unter. [Zugreifen auf Timestream für LiveAnalytics](accessing.md)
## Installieren Sie den ODBC-Treiber auf Ihrem System
Laden Sie das entsprechende Timestream-ODBC-Treiber-Installationsprogramm für Ihr System aus dem [ GitHubODBC-Repository](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) herunter und folgen Sie den Installationsanweisungen, die für Ihr System gelten:.
+ [Windows-Installationsanleitung](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md)
+ [macOS-Installationsanleitung](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md)
+ [Installationsanleitung für Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md)
## Richten Sie einen Datenquellennamen (DSN) für den ODBC-Treiber ein
Folgen Sie den Anweisungen im DSN-Konfigurationsleitfaden für Ihr System:
+ [Windows-DSN-Konfiguration](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md)
+ [macOS DSN-Konfiguration](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md)
+ [Linux-DSN-Konfiguration](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md)
## Richten Sie Ihre Business Intelligence (BI) -Anwendung so ein, dass sie mit dem ODBC-Treiber funktioniert
Im Folgenden finden Sie Anweisungen zum Einrichten mehrerer gängiger BI-Anwendungen für die Verwendung mit dem ODBC-Treiber:
+ [Microsoft Power BI einrichten.](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md)
+ [Microsoft Excel einrichten](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md)
+ [Tableau einrichten](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md)
Für andere Anwendungen
# Syntax und Optionen der Verbindungszeichenfolge für den ODBC-Treiber
Die Syntax für die Angabe von Verbindungszeichenfolgenoptionen für den ODBC-Treiber lautet wie folgt:
```
DRIVER={Amazon Timestream 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.
Die Standardeinstellung ist Amazon Timestream.
+ **`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 Timestream for LiveAnalytics Service. Dies ist eine erweiterte Option, die die Region überschreibt. Beispiel:
```
query-cell2.timestream.us-east-1.amazonaws.com
```
+ **`Region`**— Die Signaturregion für den Timestream for LiveAnalytics Service-Endpunkt.
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 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 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 dem Timestream für die Anwendung zugeordnet ist. LiveAnalytics 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 zum Timestream-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 LiveAnalytics Timestream-fürODBC-Treibers getrennt. Die Einstellung des einen hat keinen Einfluss auf das andere.
Die SDK-Protokollebene wird mithilfe der Umgebungsvariablen festgelegt`TS_AWS_LOG_LEVEL`. Folgende sind gültige Werte:
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`
Wenn nicht festgelegt, `TS_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 zu Amazon Timestream LiveAnalytics über einen Proxy. Um diese Funktion zu verwenden, konfigurieren Sie die folgenden Umgebungsvariablen basierend auf Ihrer Proxyeinstellung:
+ **`TS_PROXY_HOST`**— der Proxy-Host.
+ **`TS_PROXY_PORT`**— Die Proxy-Portnummer.
+ **`TS_PROXY_SCHEME`**— Das Proxyschema, entweder `http` oder`https`.
+ **`TS_PROXY_USER`**— Der Benutzername für die Proxyauthentifizierung.
+ **`TS_PROXY_PASSWORD`**— Das Benutzerkennwort für die Proxyauthentifizierung.
+ **`TS_PROXY_SSL_CERT_PATH`**— Die SSL-Zertifikatsdatei, die für die Verbindung zu einem HTTPS-Proxy verwendet werden soll.
+ **`TS_PROXY_SSL_CERT_TYPE`**— Der Typ des Proxy-Client-SSL-Zertifikats.
+ **`TS_PROXY_SSL_KEY_PATH`**— Die private Schlüsseldatei, die für die Verbindung zu einem HTTPS-Proxy verwendet werden soll.
+ **`TS_PROXY_SSL_KEY_TYPE`**— Der Typ der privaten Schlüsseldatei, die für die Verbindung zu einem HTTPS-Proxy verwendet wird.
+ **`TS_PROXY_SSL_KEY_PASSWORD`**— Die Passphrase für die private Schlüsseldatei, die für die Verbindung zu einem HTTPS-Proxy verwendet wird.
# Beispiele für Verbindungszeichenfolgen für den Timestream for ODBC-Treiber LiveAnalytics
## Beispiel für eine Verbindung zum ODBC-Treiber mit IAM-Anmeldeinformationen
```
Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);SessionToken=(your session token);Region=us-east-2;
```
## Beispiel für eine Verbindung zum ODBC-Treiber mit einem Profil
```
Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2;
```
Der Treiber versucht, mit den in der Umgebungsvariablen angegebenen Anmeldeinformationen oder`~/.aws/credentials`, falls eine Datei in der Umgebungsvariablen angegeben ist`AWS_SHARED_CREDENTIALS_FILE`, mithilfe der Anmeldeinformationen in dieser Datei eine Verbindung herzustellen.
## Beispiel für eine Verbindung zum ODBC-Treiber mit Okta
```
driver={Amazon Timestream ODBC Driver};auth=okta;region=us-west-2;idPHost=(your host at Okta);idPUsername=(your user name);idPPassword=(your password);OktaApplicationID=(your Okta AppId);roleARN=(your role ARN);idPARN=(your Idp ARN);
```
## Beispiel für eine Verbindung zum ODBC-Treiber mit Azure Active Directory (AAD)
```
driver={Amazon Timestream ODBC Driver};auth=aad;region=us-west-2;idPUsername=(your user name);idPPassword=(your password);aadApplicationID=(your AAD AppId);aadClientSecret=(your AAD client secret);aadTenant=(your AAD tenant);roleARN=(your role ARN);idPARN=(your idP ARN);
```
## Beispiel für eine Verbindung zum ODBC-Treiber mit einem angegebenen Endpunkt und einer Protokollebene von 2 (WARNUNG)
```
Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);EndpointOverride=ingest.timestream.us-west-2.amazonaws.com;Region=us-east-2;LogLevel=2;
```
# Problembehandlung bei der Verbindung mit dem ODBC-Treiber
**Anmerkung**
Wenn der Benutzername und das Passwort bereits im DSN angegeben sind, müssen sie nicht erneut angegeben werden, wenn der ODBC-Treibermanager danach fragt.
Der Fehlercode `01S02` mit einer Meldung `Re-writing (connection string option) (have you specified it several times?` tritt auf, wenn eine Verbindungszeichenfolgenoption mehr als einmal in der Verbindungszeichenfolge übergeben wird. Wenn Sie eine Option mehr als einmal angeben, wird ein Fehler ausgelöst. Wenn Sie eine Verbindung mit einem DSN und einer Verbindungszeichenfolge herstellen und eine Verbindungsoption bereits im DSN angegeben ist, geben Sie sie nicht erneut in der Verbindungszeichenfolge an.