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à.
# ODBC
Il [driver ODBC](https://github.com/awslabs/aws-iotsitewise-odbc-driver) open source AWS IoT SiteWise fornisce un'interfaccia relazionale SQL AWS IoT SiteWise per gli sviluppatori e consente la connettività da strumenti di business intelligence (BI) come Power BI Desktop e Microsoft Excel. Il driver AWS IoT SiteWise ODBC è attualmente disponibile su [Windows](https://github.com/awslabs/aws-iotsitewise-odbc-driver/releases) e supporta l'SSO con Okta e Microsoft Azure Active Directory (AD).
Per ulteriori informazioni, consulta la documentazione del driver [AWS IoT SiteWise ODBC su](https://github.com/awslabs/aws-iotsitewise-odbc-driver/blob/main/docs/markdown/index.md). GitHub
**Topics**
+ [
# Sintassi e opzioni della stringa di connessione per il driver ODBC
](query-ODBC-connecting.md)
+ [
# Esempi di stringhe di connessione per il driver ODBC AWS IoT SiteWise
](query-ODBC-connecting-examples.md)
+ [
# Risoluzione dei problemi di connessione con il driver ODBC
](query-ODBC-connecting-troubleshooting.md)
# Sintassi e opzioni della stringa di connessione per il driver ODBC
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
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.
# Esempi di stringhe di connessione per il driver ODBC AWS IoT SiteWise
## Esempio di connessione al driver ODBC con credenziali IAM
```
Driver={AWS IoT SiteWise ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);SecretKey=(your secret key);SessionToken=(your session token);Region=us-east-1;
```
## Esempio di connessione al driver ODBC con un profilo
```
Driver={AWS IoT SiteWise ODBC Driver};ProfileName=(the profile name);region=us-east-1;
```
Il driver tenterà di connettersi utilizzando le credenziali fornite in o`~/.aws/credentials`, se un file è specificato nella variabile di ambiente`AWS_SHARED_CREDENTIALS_FILE`, utilizzando le credenziali in quel file.
## Esempio di connessione al driver ODBC con Okta
```
Driver={AWS IoT SiteWise ODBC Driver};Auth=OKTA;region=us-east-1;idPHost=(your host at Okta);idPUsername=(your user name);idPPassword=(your password);OktaApplicationID=(your Okta AppId);roleARN=(your role ARN);idPARN=(your Idp ARN);
```
## Esempio di connessione al driver ODBC con Azure Active Directory (AAD)
```
Driver={AWS IoT SiteWise ODBC Driver};Auth=AAD;region=us-east-1;idPUsername=(your user name);idPPassword=(your password);aadApplicationID=(your AAD AppId);aadClientSecret=(your AAD client secret);aadTenant=(your AAD tenant);roleARN=(your role ARN);idPARN=(your idP ARN);
```
## Esempio di connessione al driver ODBC con un endpoint specificato e un livello di registro pari a 2 (AVVISO)
```
Driver={AWS IoT SiteWise ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);SecretKey=(your secret key);EndpointOverride=iotsitewise.us-east-1.amazonaws.com;Region=us-east-1;LogLevel=2;
```
# Risoluzione dei problemi di connessione con il driver ODBC
**Nota**
Se il nome utente e la password sono già specificati nel DSN, non specificarli nuovamente quando il gestore dei driver ODBC li richiede.
Un codice di errore `01S02` con un messaggio `Re-writing (connection string option) (have you specified it several times?)` si verifica quando un'opzione di stringa di connessione viene passata più di una volta nella stringa di connessione. Se si specifica un'opzione più di una volta, viene generato un errore. Quando si effettua una connessione con un DSN e una stringa di connessione, se un'opzione di connessione è già specificata nel DSN, non specificarla nuovamente nella stringa di connessione.