Sintaxis de la cadena de conexión y opciones del controlador de ODBC - Amazon Timestream
Conexión de proxy

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

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.

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

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