Sintaxis de la cadena de conexión y opciones del controlador ODBC - AWS IoT SiteWise
Conexión proxy

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 ODBC

La sintaxis para especificar las opciones de cadena de conexión para el controlador ODBC es la siguiente:

Driver={AWS IoT SiteWise 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 AWS IoT SiteWise.

  • DSN— El nombre de la fuente de datos (DSN) que se utilizará para configurar la conexión.

    El valor predeterminado es NONE.

  • Auth— El modo de autenticación. Este debe ser uno de los siguientes:

    • AWS_PROFILE— Utilice la cadena de credenciales predeterminada.

    • IAM— Usa 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 del punto final

  • EndpointOverride— La anulación del punto final del AWS IoT SiteWise servicio. Se trata de una opción avanzada que anula la región. Por ejemplo:

    iotsitewise.us-east-1.amazonaws.com

  • Region— La región de firma del punto final del AWS IoT SiteWise servicio.

    El valor predeterminado es us-east-1.

Opción de proveedor de credenciales

  • ProfileName— El nombre del perfil en el archivo de AWS 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 AccessKeyId se proporcionan ambos UID y en la cadena de conexión, se utilizará el UID valor a menos que esté vacío.

    El valor predeterminado es NONE.

  • PWDo SecretKey— La clave de acceso secreta del usuario de AWS. Si SecretKey se proporcionan ambas PWD y en la cadena de conexión, se utilizará el PWD valor con, 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.

  • UIDo IdPUserName: el nombre de usuario de la cuenta de IdP especificada. Si IdPUserName se proporcionan ambos UID y en la cadena de conexión, se utilizará el UID valor a menos que esté vacío.

    El valor predeterminado es NONE.

  • PWDo IdPPassword— La contraseña de la cuenta de IdP especificada. Si IdPPassword se proporcionan ambos PWD y en la cadena de conexión, se utilizará el PWD valor a menos que esté vacío.

    El valor predeterminado es NONE.

  • OktaApplicationID— El identificador único proporcionado por Okta y asociado a la AWS IoT SiteWise aplicación. 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 del recurso de Amazon (ARN) del rol que asume la persona que llama.

    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

  • UIDo IdPUserName: el nombre de usuario de la cuenta de IdP especificada.

    El valor predeterminado es NONE.

  • PWDo 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 del recurso de Amazon (ARN) del rol que asume la persona que llama.

    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 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 desactiva el tiempo de espera de la conexión. Este valor no debe ser negativo.

    El valor predeterminado es 1000.

  • MaxRetryCountClient— El número máximo de reintentos para los 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 AWS IoT SiteWise servicio. El valor debe ser positivo.

    El valor predeterminado es 25.

Opciones de registro del controlador ODBC

  • LogLevel— El nivel de registro para el registro de los controladores. Debe ser uno de los siguientes:

    • 0 (DESACTIVADO).

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

  • 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 getpwuid(getuid()) devuelto por la función.

Opciones de registro del SDK

El nivel de registro del AWS SDK es independiente del nivel de registro del controlador AWS IoT SiteWise ODBC. La configuración de uno no afecta al otro.

El nivel de registro del SDK se establece mediante la variable de entornoSW_AWS_LOG_LEVEL. Los valores válidos son:

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

Si no SW_AWS_LOG_LEVEL está establecido, el nivel de registro del SDK se establece en el valor predeterminado, que esWARN.

Conexión a través de un proxy

El controlador ODBC admite la conexión a AWS IoT SiteWise través de un proxy. Para utilizar esta función, configure las siguientes variables de entorno en función de la configuración del proxy:

  • SW_PROXY_HOST— el host del proxy.

  • SW_PROXY_PORT— El número de puerto del proxy.

  • SW_PROXY_SCHEME— El esquema de proxy, ya sea http ohttps.

  • SW_PROXY_USER— El nombre de usuario para la autenticación mediante proxy.

  • SW_PROXY_PASSWORD— La contraseña de usuario para la autenticación mediante proxy.

  • SW_PROXY_SSL_CERT_PATH— El archivo de certificado SSL que se utilizará para conectarse a un proxy HTTPS.

  • SW_PROXY_SSL_CERT_TYPE— El tipo de certificado SSL del cliente proxy.

  • SW_PROXY_SSL_KEY_PATH— El archivo de clave privada que se utilizará para conectarse a un proxy HTTPS.

  • SW_PROXY_SSL_KEY_TYPE— El tipo de archivo de clave privada utilizado para conectarse a un proxy HTTPS.

  • SW_PROXY_SSL_KEY_PASSWORD— La contraseña del archivo de clave privada que se utiliza para conectarse a un proxy HTTPS.