Sintaxe da string de conexão e opções para o driver ODBC - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Sintaxe da string de conexão e opções para o driver ODBC

A sintaxe para especificar as opções de cadeia de conexão para o driver ODBC é a seguinte:

Driver={AWS IoT SiteWise ODBC Driver};(option)=(value);

As opções disponíveis são as seguintes:

Opções de conexão do driver
  • Driver   (obrigatório)   –   O driver que está sendo usado com o ODBC.

    O padrão é AWS IoT SiteWise.

  • DSN   –   O nome da fonte de dados (DSN) a ser usado para configurar a conexão.

    O padrão é NONE.

  • Auth   –   Modo de autenticação. Este valor deve ser um dos seguintes:

    • AWS_PROFILE — Use a cadeia de credenciais padrão.

    • IAM— Use as credenciais AWS do IAM.

    • AAD – Use o provedor de identidade do Azure Active Directory (AD).

    • OKTA – Use o provedor de identidade Okta.

    O padrão é AWS_PROFILE.

Opções de configuração do endpoint
  • EndpointOverride— A substituição do endpoint para o AWS IoT SiteWise serviço. Essa é uma opção avançada que substitui a região. Por exemplo:

    iotsitewise.us-east-1.amazonaws.com
  • Region— A região de assinatura do endpoint do AWS IoT SiteWise serviço.

    O padrão é us-east-1.

Opção do provedor de credencial
  • ProfileName— O nome do perfil no arquivo de AWS configuração.

    O padrão é NONE.

AWS Opções de autenticação do IAM
  • UIDou AccessKeyId— O ID da chave de acesso do AWS usuário. Se ambos UID e AccessKeyId forem fornecidos na cadeia de conexão, o UID valor será usado, a menos que esteja vazio.

    O padrão é NONE.

  • PWD ou SecretKey   –   A chave de acesso secreta do usuário da AWS. Se ambos PWD e SecretKey forem fornecidos na string de conexão, o valor PWD será usado, a menos que esteja vazio.

    O padrão é NONE.

  • SessionToken   –   O token de sessão temporário necessário para acessar um banco de dados com a autenticação multifator (MFA) habilitada. Não inclua um = no final da entrada.

    O padrão é NONE.

Opções de autenticação baseadas em SAML para Okta
  • IdPHost   –   O nome do host do IdP especificado.

    O padrão é NONE.

  • UID ou IdPUserName   –   O nome de usuário da conta IdP especificada. Se ambos UID e IdPUserName forem fornecidos na string de conexão, o valor UID será usado, a menos que esteja vazio.

    O padrão é NONE.

  • PWD ou IdPPassword   –  A senha da conta IdP especificada. Se ambos PWD e IdPPassword forem fornecidos na string de conexão, o valor PWD será usado, a menos que esteja vazio.

    O padrão é NONE.

  • OktaApplicationID— O ID exclusivo fornecido pela Okta associado ao AWS IoT SiteWise aplicativo. Um local para encontrar o ID do aplicativo (AppId) está no entityID campo fornecido nos metadados do aplicativo. Um exemplo é:

    entityID="http://www.okta.com//(IdPAppID)

    O padrão é NONE.

  • RoleARN   –   O nome do recurso da Amazon (ARN) da função que o autor da chamada deve assumir.

    O padrão é NONE.

  • IdPARN   –   O nome do recurso da Amazon (ARN) do provedor SAML do IAM que descreve o IdP.

    O padrão é NONE.

Opções de autenticação baseada em SAML para Azure Active Directory
  • UID ou IdPUserName   –   O nome de usuário da conta IdP especificada.

    O padrão é NONE.

  • PWD ou IdPPassword   –  A senha da conta IdP especificada.

    O padrão é NONE.

  • AADApplicationID   –   O ID exclusivo do aplicativo registrado no Azure AD.

    O padrão é NONE.

  • AADClientSecret   –   O segredo do cliente associado ao aplicativo registrado no Azure AD usado para autorizar a busca de tokens.

    O padrão é NONE.

  • AADTenant   –   O ID do locatário do Azure AD.

    O padrão é NONE.

  • RoleARN   –   O nome do recurso da Amazon (ARN) da função que o autor da chamada deve assumir.

    O padrão é NONE.

  • IdPARN   –   O nome do recurso da Amazon (ARN) do provedor SAML do IAM que descreve o IdP.

    O padrão é NONE.

AWS Opções do SDK (avançado)
  • RequestTimeout— O tempo em milissegundos em que o AWS SDK espera por uma solicitação de consulta antes de atingir o tempo limite. Qualquer valor não positivo desativa o tempo limite da solicitação.

    O padrão é 3000.

  • ConnectionTimeout— O tempo em milissegundos em que o AWS SDK espera que os dados sejam transferidos por uma conexão aberta antes de atingir o tempo limite. Um valor de 0 desativa o tempo limite da conexão. Esse valor deve ser não negativo.

    O padrão é 1000.

  • MaxRetryCountClient   –   O número máximo de tentativas para erros que podem ser repetidos com códigos de erro 5xx no SDK. O valor não deve ser negativo.

    O padrão é 0.

  • MaxConnections— O número máximo de conexões HTTP abertas simultaneamente com o AWS IoT SiteWise serviço. O valor deve ser positivo.

    O padrão é 25.

Opções de log do driver ODBC
  • LogLevel   –   O nível de registro para registro do driver. Deve ser um dos seguintes:

    • 0   (OFF)

    • 1   (ERROR)

    • 2   (AVISO)

    • 3   (INFO.

    • 4   (DEBUG).

    O padrão é 1 (ERRO).

    Aviso: informações pessoais podem ser registradas pelo driver ao usar o modo de registro DEBUG.

  • LogOutput   –   Pasta na qual armazenar o arquivo de log.

    O padrão é:

    • Windows:%USERPROFILE%, ou se não estiver disponível, %HOMEDRIVE%%HOMEPATH%.

    • macOS e Linux:$HOME, ou se não estiver disponível, o campo do valor pw_dir de getpwuid(getuid()) retorno da função.

Opções de registro em log do SDK

O nível de registro do AWS SDK é separado do nível de registro do driver AWS IoT SiteWise ODBC. Configurar um não afeta o outro.

O nível de log do SDK é definido usando a variável SW_AWS_LOG_LEVEL de ambiente. Os valores válidos são:

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

Se SW_AWS_LOG_LEVEL não estiver definido, o nível de log do SDK será definido como padrão, que é WARN.

Conectar-se por meio de um proxy

O driver ODBC oferece suporte à conexão AWS IoT SiteWise por meio de um proxy. Para usar esse atributo, configure as seguintes variáveis de ambiente com base na sua configuração de proxy:

  • SW_PROXY_HOST   –   o host proxy.

  • SW_PROXY_PORT   –   o número da porta do proxy.

  • SW_PROXY_SCHEME   –   O esquema de proxy, http ou https.

  • SW_PROXY_USER   –   O nome de usuário a ser usado para a autenticação de proxy.

  • SW_PROXY_PASSWORD   –  A senha a ser usada para autenticação de proxy.

  • SW_PROXY_SSL_CERT_PATH   –  O arquivo de certificado SSL a ser usado para se conectar a um proxy HTTPS.

  • SW_PROXY_SSL_CERT_TYPE   –   O tipo do certificado SSL do cliente proxy.

  • SW_PROXY_SSL_KEY_PATH   –   O arquivo de chave privada a ser usado para se conectar a um proxy HTTPS.

  • SW_PROXY_SSL_KEY_TYPE   –  O tipo do arquivo de chave privada usado para se conectar a um proxy HTTPS.

  • SW_PROXY_SSL_KEY_PASSWORD   –   A frase secreta do arquivo de chave privada usado para se conectar a um proxy HTTPS.