

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Sintassi e opzioni della stringa di connessione per il driver ODBC
<a name="query-ODBC-connecting"></a>

La sintassi per specificare le opzioni relative alla stringa di connessione per il driver ODBC è la seguente:

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

Le opzioni disponibili sono riportate di seguito:

**Opzioni di connessione del driver**
+ **`Driver`***(richiesto)* — Il driver utilizzato con ODBC.

  Il valore predefinito è AWS IoT SiteWise.
+ **`DSN`**— Il nome dell'origine dati (DSN) da utilizzare per configurare la connessione.

  Il valore predefinito è `NONE`.
+ **`Auth`**— La modalità di autenticazione. Deve essere una delle seguenti:
  + `AWS_PROFILE`— Utilizza la catena di credenziali predefinita.
  + `IAM`— Utilizza le credenziali AWS IAM.
  + `AAD`— Usa il provider di identità Azure Active Directory (AD).
  + `OKTA`— Usa il provider di identità Okta.

  Il valore predefinito è `AWS_PROFILE`.

**Opzioni di configurazione degli endpoint**
+ **`EndpointOverride`**— L'override dell'endpoint per il servizio. AWS IoT SiteWise Questa è un'opzione avanzata che sostituisce la regione. Esempio:

  ```
  iotsitewise.us-east-1.amazonaws.com
  ```
+ **`Region`**— La regione di firma per l'endpoint del AWS IoT SiteWise servizio.

  Il valore predefinito è `us-east-1`.

**Opzione del fornitore di credenziali**
+ **`ProfileName`**— Il nome del profilo nel file di AWS configurazione.

  Il valore predefinito è `NONE`.

**AWS Opzioni di autenticazione IAM**
+ **`UID`**o **`AccessKeyId`**— L'ID della chiave di accesso AWS dell'utente. Se entrambi `UID` `AccessKeyId` sono forniti nella stringa di connessione, il `UID` valore verrà utilizzato a meno che non sia vuoto.

  Il valore predefinito è `NONE`.
+ **`PWD`**o **`SecretKey`**— La chiave di accesso segreta dell'utente AWS. Se entrambi `PWD` `SecretKey` sono forniti nella stringa di connessione, verrà utilizzato il `PWD` valore with a meno che non sia vuoto.

  Il valore predefinito è `NONE`.
+ **`SessionToken`**— Il token di sessione temporaneo necessario per accedere a un database con autenticazione a più fattori (MFA) abilitata. Non includere un termine finale ` = ` nell'input.

  Il valore predefinito è `NONE`.

**Opzioni di autenticazione basate su SAML per Okta**
+ **`IdPHost`**— Il nome host dell'IdP specificato.

  Il valore predefinito è `NONE`.
+ **`UID`**o **`IdPUserName`**— Il nome utente per l'account IdP specificato. Se entrambi `UID` `IdPUserName` sono forniti nella stringa di connessione, il `UID` valore verrà utilizzato a meno che non sia vuoto.

  Il valore predefinito è `NONE`.
+ **`PWD`**o **`IdPPassword`**— La password per l'account IdP specificato. Se entrambi `PWD` `IdPPassword` sono forniti nella stringa di connessione, il `PWD` valore verrà utilizzato a meno che non sia vuoto.

  Il valore predefinito è `NONE`.
+ **`OktaApplicationID`**— L'ID univoco fornito da OKTA associato all'applicazione. AWS IoT SiteWise Un posto dove trovare l'ID dell'applicazione (AppId) si trova nel `entityID` campo fornito nei metadati dell'applicazione. Un esempio è:

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

  Il valore predefinito è `NONE`.
+ **`RoleARN`**— L'Amazon Resource Name (ARN) del ruolo assunto dal chiamante.

  Il valore predefinito è `NONE`.
+ **`IdPARN`**— L'Amazon Resource Name (ARN) del provider SAML in IAM che descrive l'IdP.

  Il valore predefinito è `NONE`.

**Opzioni di autenticazione basate su SAML per Azure Active Directory**
+ **`UID`**o **`IdPUserName`**— Il nome utente per l'account IdP specificato.

  Il valore predefinito è `NONE`.
+ **`PWD`**o **`IdPPassword`**— La password per l'account IdP specificato.

  Il valore predefinito è `NONE`.
+ **`AADApplicationID`**— L'id univoco dell'applicazione registrata su Azure AD.

  Il valore predefinito è `NONE`.
+ **`AADClientSecret`**— Il segreto del client associato all'applicazione registrata su Azure AD usato per autorizzare il recupero dei token.

  Il valore predefinito è `NONE`.
+ **`AADTenant`**— L'ID del tenant di Azure AD.

  Il valore predefinito è `NONE`.
+ **`RoleARN`**— L'Amazon Resource Name (ARN) del ruolo assunto dal chiamante.

  Il valore predefinito è `NONE`.
+ **`IdPARN`**— L'Amazon Resource Name (ARN) del provider SAML in IAM che descrive l'IdP.

  Il valore predefinito è `NONE`.

**AWS Opzioni SDK (avanzate)**
+ **`RequestTimeout`**— Il tempo in millisecondi in cui l' AWS SDK attende una richiesta di query prima del timeout. Qualsiasi valore non positivo disabilita il timeout della richiesta.

  Il valore predefinito è `3000`.
+ **`ConnectionTimeout`**— Il tempo in millisecondi in cui l' AWS SDK attende il trasferimento dei dati su una connessione aperta prima del timeout. Il valore 0 disattiva il timeout della connessione. Questo valore non deve essere negativo.

  Il valore predefinito è `1000`.
+ **`MaxRetryCountClient`**— Il numero massimo di tentativi per errori ripetibili con codici di errore 5xx nell'SDK. Il valore non deve essere negativo.

  Il valore predefinito è `0`.
+ **`MaxConnections`**— Il numero massimo di connessioni HTTP aperte contemporaneamente al AWS IoT SiteWise servizio. Il valore deve essere positivo.

  Il valore predefinito è `25`.

**Opzioni di registrazione del driver ODBC**
+ **`LogLevel`**— Il livello di registro per la registrazione dei driver. Deve essere un valore tra:
  + **0** (DISATTIVATO).
  + **1** (ERRORE).
  + **2** (AVVERTENZA).
  + **3** (INFORMAZIONI).
  + **4** (DEBUG).

  L'impostazione predefinita è `1` (ERROR).

  **Avviso:** le informazioni personali potrebbero essere registrate dal driver quando si utilizza la modalità di registrazione DEBUG.
+ **`LogOutput`**— Cartella in cui archiviare il file di registro.

  L'impostazione predefinita è:
  + **Windows:**`%USERPROFILE%`, o se non disponibile,`%HOMEDRIVE%%HOMEPATH%`.
  + **macOS e Linux:** o se non disponibile`$HOME`, il campo della funzione `pw_dir` `getpwuid(getuid())` restituisce il valore.

**Opzioni di registrazione SDK**

Il livello di registro AWS SDK è separato dal livello di registro del driver AWS IoT SiteWise ODBC. L'impostazione di uno non influisce sull'altro.

Il livello di registro SDK viene impostato utilizzando la variabile `SW_AWS_LOG_LEVEL` di ambiente. I valori validi sono:
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`

Se non `SW_AWS_LOG_LEVEL` è impostato, il livello di registro SDK viene impostato sul valore predefinito, ovvero. `WARN`

## Connessione tramite un proxy
<a name="query-ODBC-connecting-proxy"></a>

Il driver ODBC supporta la connessione AWS IoT SiteWise tramite un proxy. Per utilizzare questa funzionalità, configura le seguenti variabili di ambiente in base alle impostazioni del proxy:
+ **`SW_PROXY_HOST`**— l'host proxy.
+ **`SW_PROXY_PORT`**— Il numero di porta del proxy.
+ **`SW_PROXY_SCHEME`**— Lo schema proxy, `http` o`https`.
+ **`SW_PROXY_USER`**— Il nome utente per l'autenticazione proxy.
+ **`SW_PROXY_PASSWORD`**— La password utente per l'autenticazione proxy.
+ **`SW_PROXY_SSL_CERT_PATH`**— Il file del certificato SSL da utilizzare per la connessione a un proxy HTTPS.
+ **`SW_PROXY_SSL_CERT_TYPE`**— Il tipo di certificato SSL del client proxy.
+ **`SW_PROXY_SSL_KEY_PATH`**— Il file di chiave privata da utilizzare per la connessione a un proxy HTTPS.
+ **`SW_PROXY_SSL_KEY_TYPE`**— Il tipo di file di chiave privata utilizzato per connettersi a un proxy HTTPS.
+ **`SW_PROXY_SSL_KEY_PASSWORD`**— La passphrase del file di chiave privata utilizzato per connettersi a un proxy HTTPS.