Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. [Scopri](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) di più qui. 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/amazon-timestream-odbc-driver/tree/main) open source per Amazon Timestream for fornisce un'interfaccia relazionale SQL a Timestream LiveAnalytics LiveAnalytics per gli sviluppatori e consente la connettività da strumenti di business intelligence (BI) come Power BI Desktop e Microsoft Excel. Il driver Timestream per LiveAnalytics ODBC è attualmente disponibile su Windows[, macOS e Linux e](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) supporta anche SSO con Okta e Microsoft Azure Active Directory (AD). Per ulteriori informazioni, consulta la documentazione del [driver Amazon Timestream LiveAnalytics for ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md) su. GitHub **Topics** + [Configurazione del driver Timestream for ODBC LiveAnalytics](ODBC-setup.md) + [Sintassi e opzioni della stringa di connessione per il driver ODBC](ODBC-connecting.md) + [Esempi di stringhe di connessione per il driver Timestream for ODBC LiveAnalytics](ODBC-connecting-examples.md) + [Risoluzione dei problemi di connessione con il driver ODBC](ODBC-connecting-troubleshooting.md) # Configurazione del driver Timestream for ODBC LiveAnalytics ## Configura l'accesso a Timestream nel tuo account LiveAnalytics AWS Se non hai ancora configurato il tuo AWS account per utilizzarlo con Timestream LiveAnalytics, segui le istruzioni riportate in. [Accesso a Timestream per LiveAnalytics](accessing.md) ## Installa il driver ODBC sul tuo sistema Scarica il programma di installazione del driver ODBC Timestream appropriato per il tuo sistema dal [ GitHubrepository ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/releases), e segui le istruzioni di installazione relative al tuo sistema:. + [Guida all'installazione di Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md) + [Guida all'installazione di macOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md) + [Guida all'installazione di Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md) ## Imposta un nome di origine dati (DSN) per il driver ODBC Segui le istruzioni contenute nella guida alla configurazione DSN per il tuo sistema: + [Configurazione DSN di Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md) + [Configurazione DSN macOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md) + [Configurazione DSN Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md) ## Configura la tua applicazione di business intelligence (BI) in modo che funzioni con il driver ODBC Di seguito sono riportate le istruzioni per impostare diverse applicazioni di BI comuni in modo che funzionino con il driver ODBC: + [Configurazione di Microsoft Power BI.](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md) + [Configurazione di Microsoft Excel](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md) + [Configurazione di Tableau](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md) Per altre applicazioni # 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={Amazon Timestream ODBC Driver};(option)=(value); ``` Le opzioni disponibili sono riportate di seguito: **Opzioni di connessione del driver** + **`Driver`***(richiesto)* — Il driver utilizzato con ODBC. L'impostazione predefinita è Amazon Timestream. + **`DSN`**— Il nome della fonte di 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 Timestream for. LiveAnalytics Questa è un'opzione avanzata che sostituisce la regione. Esempio: ``` query-cell2.timestream.us-east-1.amazonaws.com ``` + **`Region`**— La regione di firma per l'endpoint Timestream for service. LiveAnalytics 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 al Timestream for application. LiveAnalytics 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 servizio Timestream. 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 Timestream for LiveAnalytics ODBC. L'impostazione di uno non influisce sull'altro. Il livello di registro SDK viene impostato utilizzando la variabile `TS_AWS_LOG_LEVEL` di ambiente. I valori validi sono: + `OFF` + `ERROR` + `WARN` + `INFO` + `DEBUG` + `TRACE` + `FATAL` Se non `TS_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 ad Amazon LiveAnalytics Timestream tramite un proxy. Per utilizzare questa funzionalità, configura le seguenti variabili di ambiente in base alle impostazioni del proxy: + **`TS_PROXY_HOST`**— l'host proxy. + **`TS_PROXY_PORT`**— Il numero di porta del proxy. + **`TS_PROXY_SCHEME`**— Lo schema proxy, `http` o`https`. + **`TS_PROXY_USER`**— Il nome utente per l'autenticazione proxy. + **`TS_PROXY_PASSWORD`**— La password utente per l'autenticazione proxy. + **`TS_PROXY_SSL_CERT_PATH`**— Il file del certificato SSL da utilizzare per la connessione a un proxy HTTPS. + **`TS_PROXY_SSL_CERT_TYPE`**— Il tipo di certificato SSL del client proxy. + **`TS_PROXY_SSL_KEY_PATH`**— Il file di chiave privata da utilizzare per la connessione a un proxy HTTPS. + **`TS_PROXY_SSL_KEY_TYPE`**— Il tipo di file di chiave privata utilizzato per connettersi a un proxy HTTPS. + **`TS_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 Timestream for ODBC LiveAnalytics ## Esempio di connessione al driver ODBC con credenziali IAM ``` Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);SessionToken=(your session token);Region=us-east-2; ``` ## Esempio di connessione al driver ODBC con un profilo ``` Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2; ``` 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={Amazon Timestream ODBC Driver};auth=okta;region=us-west-2;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={Amazon Timestream ODBC Driver};auth=aad;region=us-west-2;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={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);EndpointOverride=ingest.timestream.us-west-2.amazonaws.com;Region=us-east-2;LogLevel=2; ``` # Risoluzione dei problemi di connessione con il driver ODBC **Nota** Quando il nome utente e la password sono già specificati nel DSN, non è necessario specificarli nuovamente quando il gestore dei driver ODBC li richiede. Un codice di errore relativo `01S02` a 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.