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: uso de credenciales de AWS IAM.

    • 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 de conexión del servicio Timestream para 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 para el punto de conexión del servicio Timestream para LiveAnalytics.

    El valor predeterminado es us-east-1.

Opción de proveedores de credenciales

  • ProfileName   –   El nombre del perfil en el archivo de configuración de AWS.

    El valor predeterminado es NONE.

Opciones de autenticación de AWS IAM

  • UID o AccessKeyId   –   ID de clave de acceso del usuario de AWS. 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 a la aplicación Timestream para LiveAnalytics. Un lugar para encontrar el ID de la aplicación (AppID) se encuentra en el campo entityID 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.

Opciones (avanzadas) de AWS SDK

  • 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 se transfieran los datos 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 del controlador ODBC de Timestream para LiveAnalytics. 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 Timestream para LiveAnalytics 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.