Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información [aquí](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# ODBC
El [controlador ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/tree/main) de código abierto para Amazon Timestream proporciona una interfaz relacional de SQL con Timestream LiveAnalytics LiveAnalytics para desarrolladores y permite la conectividad desde herramientas de inteligencia empresarial (BI) como Power BI Desktop y Microsoft Excel. El controlador Timestream para LiveAnalytics ODBC está disponible actualmente en Windows[, macOS y Linux, y](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) también admite el inicio de sesión único con Okta y Microsoft Azure Active Directory (AD).
Para obtener más información, consulte la documentación del [controlador Amazon Timestream LiveAnalytics para ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md) en. GitHub
**Topics**
+ [Configuración del controlador Timestream para ODBC LiveAnalytics](ODBC-setup.md)
+ [Sintaxis de la cadena de conexión y opciones del controlador de ODBC](ODBC-connecting.md)
+ [Ejemplos de cadenas de conexión para el controlador Timestream para ODBC LiveAnalytics](ODBC-connecting-examples.md)
+ [Solución de problemas de conexión con el controlador de ODBC](ODBC-connecting-troubleshooting.md)
# Configuración del controlador Timestream para ODBC LiveAnalytics
## Configure el acceso a Timestream desde su cuenta LiveAnalytics AWS
Si aún no has configurado tu AWS cuenta para que funcione con Timestream LiveAnalytics, sigue las instrucciones que se indican en. [Acceder a Timestream para LiveAnalytics](accessing.md)
## Instale el controlador ODBC en el sistema
Descargue el instalador del controlador ODBC de Timestream adecuado para su sistema desde el [ GitHubrepositorio de ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) y siga las instrucciones de instalación correspondientes a su sistema:.
+ [Guía de instalación de Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md)
+ [Guía de instalación de MacOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md)
+ [Guía de instalación de Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md)
## Configure un nombre de origen de datos (DSN) para el controlador de ODBC.
Siga las instrucciones de la guía de configuración de DSN para su sistema:
+ [Configuración de DSN de Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md)
+ [Configuración de DSN de MacOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md)
+ [Configuración de DSN de Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md)
## Configure su aplicación de inteligencia empresarial (BI) para que funcione con el controlador de ODBC
Estas son las instrucciones para configurar varias aplicaciones de inteligencia empresarial habituales para que funcionen con el controlador ODBC:
+ [Configuración de inteligencia empresarial de Microsoft Power.](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md)
+ [Configuración de Microsoft Excel](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md)
+ [Configuración de Tableau](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md)
Para otras aplicaciones
# Sintaxis de la cadena de conexión y opciones del controlador de ODBC
La sintaxis para especificar las opciones de cadena de conexión para el controlador de ODBC es la siguiente:
```
DRIVER={Amazon Timestream ODBC Driver};(option)=(value);
```
Las opciones disponibles son las siguientes:
**Opciones de conexión del controlador**
+ **`Driver`** *(obligatorio)*: el controlador que se utiliza con ODBC.
El valor predeterminado es Amazon Timestream.
+ **`DSN`** – El nombre del origen de datos (DSN) que se utilizará para configurar la conexión.
El valor predeterminado es `NONE`.
+ **`Auth`** – Modo de autenticación. Este debe ser uno de los siguientes:
+ `AWS_PROFILE`: utilice la cadena de credenciales predeterminada.
+ `IAM`— Utilice las credenciales de IAM. AWS
+ `AAD`: utilice el proveedor de identidades de Azure Active Directory (AD).
+ `OKTA`: utilice el proveedor de identidades Okta.
El valor predeterminado es `AWS_PROFILE`.
**Opciones de configuración de puntos de conexión**
+ **`EndpointOverride`**— La anulación del punto final del Timestream for Service. LiveAnalytics Se trata de una opción avanzada que anula la región. Por ejemplo:
```
query-cell2.timestream.us-east-1.amazonaws.com
```
+ **`Region`**— La región de firma del Timestream for Service Endpoint. LiveAnalytics
El valor predeterminado es `us-east-1`.
**Opción de proveedores de credenciales**
+ **`ProfileName`**— El nombre del perfil en el AWS archivo de configuración.
El valor predeterminado es `NONE`.
**AWS Opciones de autenticación de IAM**
+ **`UID`**o **`AccessKeyId`**: el identificador de la clave AWS de acceso del usuario. Si `UID` y `AccessKeyId` se proporcionan en la cadena de conexión, se utilizará el valor `UID` a menos que esté vacío.
El valor predeterminado es `NONE`.
+ **`PWD`** o **`SecretKey`** – La clave de acceso secreta del usuario de AWS. Si `PWD` y `SecretKey` se proporcionan en la cadena de conexión, se utilizará el valor `PWD` a menos que esté vacío.
El valor predeterminado es `NONE`.
+ **`SessionToken`** – El token de sesión temporal necesario para acceder a una base de datos con la autenticación multifactor (MFA) habilitada. No incluya un ` = ` final en la entrada.
El valor predeterminado es `NONE`.
**Opciones de autenticación basadas en SAML para Okta**
+ **`IdPHost`** – El nombre de host del IdP especificado.
El valor predeterminado es `NONE`.
+ **`UID`** o **`IdPUserName`** – El nombre de usuario de la cuenta de IdP especificada. Si `UID` y `IdPUserName` se proporcionan en la cadena de conexión, se utilizará el valor `UID` a menos que esté vacío.
El valor predeterminado es `NONE`.
+ **`PWD`** o **`IdPPassword`** – La contraseña de la cuenta de IdP especificada. Si `PWD` y `IdPPassword` se proporcionan en la cadena de conexión, se utilizará el valor `PWD` a menos que esté vacío.
El valor predeterminado es `NONE`.
+ **`OktaApplicationID`**— El identificador único proporcionado por Okta y asociado al Timestream de la solicitud. LiveAnalytics El identificador de la aplicación (AppId) se encuentra en el `entityID` campo proporcionado en los metadatos de la aplicación. Un ejemplo es:
```
entityID="http://www.okta.com//(IdPAppID)
```
El valor predeterminado es `NONE`.
+ **`RoleARN`** – El nombre de recurso de Amazon (ARN) del rol que la persona que llama va a tomar.
El valor predeterminado es `NONE`.
+ **`IdPARN`** – El nombre de recurso de Amazon (ARN) del proveedor de SAML en IAM que describe el IdP.
El valor predeterminado es `NONE`.
**Opciones de autenticación basadas en SAML para Azure Active Directory**
+ **`UID`** o **`IdPUserName`** – El nombre de usuario de la cuenta de IdP especificada.
El valor predeterminado es `NONE`.
+ **`PWD`** o **`IdPPassword`** – La contraseña de la cuenta de IdP especificada.
El valor predeterminado es `NONE`.
+ **`AADApplicationID`** – El identificador único de la aplicación registrada en Azure AD.
El valor predeterminado es `NONE`.
+ **`AADClientSecret`** – El secreto del cliente asociado a la aplicación registrada en Azure AD que se utiliza para autorizar la obtención de los tokens.
El valor predeterminado es `NONE`.
+ **`AADTenant`** – El ID de inquilino de Azure AD.
El valor predeterminado es `NONE`.
+ **`RoleARN`** – El nombre de recurso de Amazon (ARN) del rol que la persona que llama va a tomar.
El valor predeterminado es `NONE`.
+ **`IdPARN`** – El nombre de recurso de Amazon (ARN) del proveedor de SAML en IAM que describe el IdP.
El valor predeterminado es `NONE`.
**AWS Opciones del SDK (avanzadas)**
+ **`RequestTimeout`**— El tiempo en milisegundos que el AWS SDK espera una solicitud de consulta antes de que se agote el tiempo de espera. Cualquier valor no positivo desactiva el tiempo de espera de la solicitud.
El valor predeterminado es `3000`.
+ **`ConnectionTimeout`**— El tiempo en milisegundos que el AWS SDK espera a que los datos se transfieran a través de una conexión abierta antes de que se agote el tiempo de espera. Un valor de 0 deshabilita el tiempo de espera de conexión. Este valor no debe ser negativo.
El valor predeterminado es `1000`.
+ **`MaxRetryCountClient`** – El número máximo de intentos de reintento en el caso de errores reintentables con códigos de error de 5xx en el SDK. El valor no debe ser negativo.
El valor predeterminado es `0`.
+ **`MaxConnections`** – El número máximo de conexiones HTTP abiertas simultáneamente al servicio de Timestream. El valor debe ser un número positivo.
El valor predeterminado es `25`.
**Opciones de registro del controlador de ODBC**
+ **`LogLevel`** – El nivel de registro para el registro de los controladores. Debe ser uno de los siguientes:
+ **0** (APAGADO).
+ **1** (ERROR).
+ **2** (ADVERTENCIA).
+ **3** (INFORMACIÓN).
+ **4** (DEPURACIÓN).
El valor predeterminado es `1` (ERROR).
**Advertencia:** El controlador puede registrar información personal al utilizar el modo de registro de DEPURACIÓN.
+ **`LogOutput`** – Carpeta en la que almacenar el archivo de registro.
El valor predeterminado es:
+ **Windows:** `%USERPROFILE%` o si no está disponible, `%HOMEDRIVE%%HOMEPATH%`.
+ **macOS y Linux:** `$HOME` o si no está disponible, el campo `pw_dir` del valor devuelto `getpwuid(getuid())` por la función.
**Opciones de registro de SDK**
El nivel de registro del AWS SDK es independiente del nivel de registro de Timestream para el controlador LiveAnalytics ODBC. Configurar uno no afecta al otro.
El nivel de registro del SDK se establece mediante la variable de entorno `TS_AWS_LOG_LEVEL`. Los valores válidos son:
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`
Si `TS_AWS_LOG_LEVEL` no está establecido, el nivel de registro del SDK se establece en el valor predeterminado, que es `WARN`.
## Conexión a través de un proxy
El controlador ODBC admite la conexión a Amazon LiveAnalytics Timestream a través de un proxy. Para utilizar esta característica, configure las siguientes variables de entorno en función de la configuración del proxy:
+ **`TS_PROXY_HOST`** – el host del proxy.
+ **`TS_PROXY_PORT`** – Número de puerto del proxy.
+ **`TS_PROXY_SCHEME`** – El esquema de proxy, ya sea `http` o `https`.
+ **`TS_PROXY_USER`** – Nombre de usuario que se utilizará para la autenticación del proxy.
+ **`TS_PROXY_PASSWORD`** – Contraseña de usuario que se utilizará para la autenticación del proxy.
+ **`TS_PROXY_SSL_CERT_PATH`** – El archivo de certificado SSL que se utilizará para conectarse a un proxy HTTPS.
+ **`TS_PROXY_SSL_CERT_TYPE`** – El tipo de certificado SSL del cliente proxy.
+ **`TS_PROXY_SSL_KEY_PATH`** – El archivo de clave privada que se utilizará para conectarse a un proxy HTTPS.
+ **`TS_PROXY_SSL_KEY_TYPE`** – El tipo de archivo de clave privada que se utilizará para conectarse a un proxy HTTPS.
+ **`TS_PROXY_SSL_KEY_PASSWORD`** – La frase de contraseña para el archivo de clave privada que se utilizará para conectarse a un proxy HTTPS.
# Ejemplos de cadenas de conexión para el controlador Timestream para ODBC LiveAnalytics
## Ejemplo de conexión al controlador de ODBC con credenciales de 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;
```
## Ejemplo de conexión al controlador de ODBC con un perfil
```
Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2;
```
El controlador intentará conectarse con las credenciales proporcionadas en `~/.aws/credentials`, o si se especifica un archivo en la variable de entorno `AWS_SHARED_CREDENTIALS_FILE`, con las credenciales de ese archivo.
## Ejemplo de conexión al controlador de ODBC con 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);
```
## Ejemplo de conexión al controlador ODBC con 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);
```
## Ejemplo de conexión al controlador ODBC con un punto de conexión específico y un nivel de registro de 2 (ADVERTENCIA)
```
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;
```
# Solución de problemas de conexión con el controlador de ODBC
**nota**
Si el nombre de usuario y la contraseña ya están especificados en el DSN, no es necesario volver a especificarlos cuando el administrador de controladores ODBC los solicite.
Se produce un código de error de `01S02` con un mensaje, `Re-writing (connection string option) (have you specified it several times?` ocurre cuando se pasa una opción de cadena de conexión más de una vez en la cadena de conexión. Si se especifica una opción más de una vez, se produce un error. Al realizar una conexión con un DSN y una cadena de conexión, si una opción de conexión ya está especificada en el DSN, no la vuelva a especificar en la cadena de conexión.