Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
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.
# ODBC
Le [pilote ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/tree/main) open source pour Amazon Timestream for fournit une interface SQL relationnelle à Timestream LiveAnalytics pour les développeurs et permet la connectivité à partir d'outils LiveAnalytics de business intelligence (BI) tels que Power BI Desktop et Microsoft Excel. Le pilote Timestream pour LiveAnalytics ODBC est actuellement disponible sous Windows[, macOS et Linux, et](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) prend également en charge l'authentification unique avec Okta et Microsoft Azure Active Directory (AD).
Pour plus d'informations, consultez la documentation [Amazon Timestream LiveAnalytics pour le pilote ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md) sur. GitHub
**Topics**
+ [Configuration du pilote Timestream pour ODBC LiveAnalytics](ODBC-setup.md)
+ [Syntaxe et options de la chaîne de connexion pour le pilote ODBC](ODBC-connecting.md)
+ [Exemples de chaînes de connexion pour le pilote Timestream pour ODBC LiveAnalytics](ODBC-connecting-examples.md)
+ [Résolution des problèmes de connexion avec le pilote ODBC](ODBC-connecting-troubleshooting.md)
# Configuration du pilote Timestream pour ODBC LiveAnalytics
## Configurer l'accès à Timestream depuis votre LiveAnalytics compte AWS
Si vous n'avez pas encore configuré votre AWS compte pour qu'il fonctionne avec Timestream for LiveAnalytics, suivez les instructions figurant dans. [Accès à Timestream pour LiveAnalytics](accessing.md)
## Installez le pilote ODBC sur votre système
Téléchargez le programme d'installation du pilote ODBC Timestream approprié pour votre système à partir du [ GitHubréférentiel ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/releases), et suivez les instructions d'installation qui s'appliquent à votre système :.
+ [Guide d'installation de Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md)
+ [Guide d'installation de macOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md)
+ [Guide d'installation de Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md)
## Configurer un nom de source de données (DSN) pour le pilote ODBC
Suivez les instructions du guide de configuration DSN pour votre système :
+ [Configuration du DSN Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md)
+ [Configuration du DSN de macOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md)
+ [Configuration du DSN Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md)
## Configurez votre application Business Intelligence (BI) pour qu'elle fonctionne avec le pilote ODBC
Voici les instructions pour configurer plusieurs applications BI courantes pour qu'elles fonctionnent avec le pilote ODBC :
+ [Configuration de Microsoft Power BI.](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md)
+ [Configuration de Microsoft Excel](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md)
+ [Configuration de Tableau](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md)
Pour d'autres applications
# Syntaxe et options de la 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={Amazon Timestream 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 Amazon Timestream.
+ **`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'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`**— La dérogation du point de terminaison pour le service Timestream. LiveAnalytics Il s'agit d'une option avancée qui remplace la région. Par exemple :
```
query-cell2.timestream.us-east-1.amazonaws.com
```
+ **`Region`**— La région de signature pour le Timestream pour le point de terminaison de LiveAnalytics 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**
+ **`UID`**ou **`AccessKeyId`**— L'identifiant de la clé d'accès AWS 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`.
+ **`PWD`**ou **`SecretKey`**— La 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 multifactorielle (MFA) activée. N'incluez pas de traînée ` = ` dans l'entrée.
La valeur par défaut est `NONE`.
**Options d'authentification basées sur SAML pour Okta**
+ **`IdPHost`**— Le nom d'hôte de l'IdP spécifié.
La valeur par défaut est `NONE`.
+ **`UID`**ou **`IdPUserName`**— Le nom d'utilisateur du 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`.
+ **`PWD`**ou **`IdPPassword`**— Le 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'identifiant unique fourni par Okta associé au Timestream de l'application. LiveAnalytics 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`**— Le nom de ressource Amazon (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`.
**Options d'authentification basées sur SAML pour Azure Active Directory**
+ **`UID`**ou **`IdPUserName`**— Le nom d'utilisateur du compte IdP spécifié.
La valeur par défaut est `NONE`.
+ **`PWD`**ou **`IdPPassword`**— Le 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 est utilisé pour autoriser l'extraction de jetons.
La valeur par défaut est `NONE`.
+ **`AADTenant`**— L'identifiant du locataire Azure AD.
La valeur par défaut est `NONE`.
+ **`RoleARN`**— Le nom de ressource Amazon (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 d'expiration de la connexion. Cette valeur ne doit pas être négative.
La valeur par défaut est `1000`.
+ **`MaxRetryCountClient`**— Le nombre maximal de tentatives pour les erreurs réessayables avec 5xx codes d'erreur 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 au service Timestream. 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 du pilote. Doit être l'une des valeurs suivantes :
+ **0** (DÉSACTIVÉ).
+ **1** (ERREUR).
+ **2** (AVERTISSEMENT).
+ **3** (INFORMATIONS).
+ **4** (DÉBOGAGE).
La valeur par défaut est `1` (ERROR).
**Avertissement :** des informations personnelles peuvent être enregistrées par le pilote lors de l'utilisation du mode de journalisation DEBUG.
+ **`LogOutput`**— Dossier dans lequel enregistrer le fichier journal.
La valeur par défaut est :
+ **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 fonction `getpwuid(getuid())` renvoie la valeur.
**Options de journalisation du SDK**
Le niveau de journal du AWS SDK est distinct du niveau de journal Timestream pour le pilote LiveAnalytics ODBC. Le réglage de l'un n'a aucune incidence sur l'autre.
Le niveau de journalisation du SDK est défini à l'aide de la variable `TS_AWS_LOG_LEVEL` d'environnement. Les valeurs valides sont :
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`
Si `TS_AWS_LOG_LEVEL` ce n'est pas le cas, le niveau de journalisation du SDK est défini sur la valeur par défaut, qui est`WARN`.
## Connexion via un proxy
Le pilote ODBC prend en charge la connexion à Amazon LiveAnalytics Timestream via un proxy. Pour utiliser cette fonctionnalité, configurez les variables d'environnement suivantes en fonction des paramètres de votre proxy :
+ **`TS_PROXY_HOST`**— l'hôte proxy.
+ **`TS_PROXY_PORT`**— Le numéro de port du proxy.
+ **`TS_PROXY_SCHEME`**— Le schéma de proxy, `http` soit`https`.
+ **`TS_PROXY_USER`**— Le nom d'utilisateur pour l'authentification par proxy.
+ **`TS_PROXY_PASSWORD`**— Le mot de passe utilisateur pour l'authentification par proxy.
+ **`TS_PROXY_SSL_CERT_PATH`**— Le fichier de certificat SSL à utiliser pour se connecter à un proxy HTTPS.
+ **`TS_PROXY_SSL_CERT_TYPE`**— Type de certificat SSL du client proxy.
+ **`TS_PROXY_SSL_KEY_PATH`**— Le fichier de clé privée à utiliser pour se connecter à un proxy HTTPS.
+ **`TS_PROXY_SSL_KEY_TYPE`**— Type de fichier de clé privée utilisé pour se connecter à un proxy HTTPS.
+ **`TS_PROXY_SSL_KEY_PASSWORD`**— Phrase secrète du fichier de clé privée utilisé pour se connecter à un proxy HTTPS.
# Exemples de chaînes de connexion pour le pilote Timestream pour ODBC LiveAnalytics
## Exemple de connexion au pilote ODBC avec des informations d'identification IAM
```
Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);SessionToken=(your session token);Region=us-east-2;
```
## Exemple de connexion au pilote ODBC avec un profil
```
Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2;
```
Le pilote tentera de se connecter en utilisant les informations d'identification fournies dans`~/.aws/credentials`, ou si un fichier est spécifié dans la variable d'environnement`AWS_SHARED_CREDENTIALS_FILE`, en utilisant les informations d'identification contenues dans ce fichier.
## Exemple de connexion au pilote ODBC avec 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);
```
## Exemple de connexion au pilote ODBC avec 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);
```
## Exemple de connexion au pilote ODBC avec un point de terminaison spécifié et un niveau de journalisation de 2 (AVERTISSEMENT)
```
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;
```
# Résolution des problèmes de connexion avec le pilote ODBC
**Note**
Lorsque le nom d'utilisateur et le mot de passe sont déjà spécifiés dans le DSN, il n'est pas nécessaire de les spécifier à nouveau lorsque le gestionnaire de pilotes ODBC les demande.
Un code d'erreur, `01S02` avec un message, `Re-writing (connection string option) (have you specified it several times?` se produit lorsqu'une option de chaîne de connexion est passée plusieurs fois dans la chaîne de connexion. Le fait de spécifier une option plusieurs fois génère une erreur. Lorsque vous établissez une connexion avec un DSN et une chaîne de connexion, si une option de connexion est déjà spécifiée dans le DSN, ne la spécifiez pas à nouveau dans la chaîne de connexion.