View a markdown version of this page

Sintassi e opzioni della stringa di connessione per il driver ODBC - AWS IoT SiteWise
Connessione proxy

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

La sintassi per specificare le opzioni della 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(obbligatorio): 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— Usa le credenziali AWS IAM.

    • AAD— Usa il provider di identità di Azure Active Directory (AD).

    • OKTA— Usa il provider di identità Okta.

    Il valore predefinito è AWS_PROFILE.

Opzioni di configurazione degli endpoint

  • EndpointOverride— L'override degli endpoint per il servizio. AWS IoT SiteWise Si tratta di un'opzione avanzata che sostituisce la regione. Ad 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

  • UIDo AccessKeyId — L'ID della chiave di accesso AWS dell'utente. Se nella stringa di connessione AccessKeyId vengono forniti entrambi UID e, il UID valore verrà utilizzato a meno che non sia vuoto.

    Il valore predefinito è NONE.

  • PWDoppure 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 richiesto per accedere a un database con l'autenticazione a più fattori (MFA) abilitata. Non includere un valore finale = nell'input.

    Il valore predefinito è NONE.

SAML-based opzioni di autenticazione per Okta

  • IdPHost— Il nome host dell'IdP specificato.

    Il valore predefinito è NONE.

  • UIDo IdPUserName — Il nome utente per l'account IdP specificato. Se nella stringa di connessione IdPUserName vengono forniti entrambi UID e, il UID valore verrà utilizzato a meno che non sia vuoto.

    Il valore predefinito è NONE.

  • PWDo IdPPassword — La password per l'account IdP specificato. Se nella stringa di connessione IdPPassword vengono forniti entrambi PWD e, il PWD valore verrà utilizzato a meno che non sia vuoto.

    Il valore predefinito è NONE.

  • OktaApplicationID— L' Okta-provided ID univoco associato all' AWS IoT SiteWise applicazione. 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 che il chiamante sta assumendo.

    Il valore predefinito è NONE.

  • IdPARN— L'Amazon Resource Name (ARN) del provider SAML in IAM che descrive l'IdP.

    Il valore predefinito è NONE.

SAML-based opzioni di autenticazione per Azure Active Directory

  • UIDo IdPUserName: il nome utente per l'account IdP specificato..

    Il valore predefinito è NONE.

  • PWDo IdPPassword — La password per l'account IdP specificato.

    Il valore predefinito è NONE.

  • AADApplicationID— L'ID univoco dell'applicazione registrata in Azure AD.

    Il valore predefinito è NONE.

  • AADClientSecret— Il segreto del client associato all'applicazione registrata su Azure AD utilizzato 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 che il chiamante sta assumendo.

    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. Un valore pari a 0 disabilita il timeout della connessione. Questo valore non deve essere negativo.

    Il valore predefinito è 1000.

  • MaxRetryCountClient— Il numero massimo di tentativi per gli errori rieseguibili 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 consentite al AWS IoT SiteWise servizio. Il valore deve essere positivo.

    Il valore predefinito è 25.

Opzioni di registrazione dei driver ODBC

  • LogLevel— Il livello di registro per la registrazione dei driver. Deve essere un valore tra:

    • 0 (OFF).

    • 1 (ERRORE).

    • 2 (AVVERTENZA).

    • 3 (INFORMAZIONI).

    • 4 (DEBUG).

    L'impostazione predefinita è 1 (ERROR).

    Avvertenza: 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 $HOME, se non disponibile, il campo pw_dir della funzione 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 dell'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 è 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 della porta del proxy.

  • SW_PROXY_SCHEME— Lo schema proxy, http ohttps.

  • SW_PROXY_USER— Il nome utente per l'autenticazione tramite proxy.

  • SW_PROXY_PASSWORD— La password utente per l'autenticazione tramite 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.