

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 name="query-ODBC-connecting"></a>

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**
+ **`UID`**ou **`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
<a name="query-ODBC-connecting-proxy"></a>

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.