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à.
Nelle sezioni seguenti sono descritti i parametri di connessione avanzati per il driver JDBC 3.x.
Argomenti
Parametri di crittografia dei risultati
Notare i seguenti punti:
-
La AWS KMS chiave deve essere specificata quando
EncryptionOptionèSSE_KMSoCSE_KMS. -
La AWS KMS chiave non può essere specificata quando non
EncryptionOptionè specificata o quando loEncryptionOptionèSSE_S3.
Opzione di crittografia
Il tipo di crittografia da utilizzare per i risultati delle query quando vengono archiviati in Amazon S3. Per informazioni sulla crittografia dei risultati delle query, EncryptionConfigurationconsulta Amazon Athena API Reference.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito | Valori possibili |
|---|---|---|---|---|
| EncryptionOption | S3 OutputEncOption (obsoleto) | Facoltativo | nessuno | SSE_S3, SSE_KMS, CSE_KMS |
Chiave KMS
L'ARN o l'ID della chiave KMS, se SSE_KMS o CSE_KMS viene scelto come opzione di crittografia. Per ulteriori informazioni, consulta EncryptionConfigurationAmazon Athena API Reference.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| KmsKey | S3 OutputEnc KMSKey (obsoleto) | Facoltativo | nessuno |
Parametri di recupero dei risultati
Sistema di recupero (fetcher) dei risultati
Il fetcher che verrà utilizzato per scaricare i risultati delle query.
Il programma di recupero dei risultati predefinito scarica auto i risultati delle query direttamente da Amazon S3 senza utilizzare Athena. APIs Quando il download diretto da S3 non è possibile, ad esempio quando i risultati delle query sono crittografati con l'CSE_KMSopzione, ritorna automaticamente a utilizzare l'API. GetQueryResultsStream
L'uso del auto fetcher è consigliato nella maggior parte delle situazioni. Se le tue policy IAM o le policy dei bucket S3 utilizzano le richieste s3: CalledVia condition to limit access to limit access to S3 objects provenienti da Athena, il auto fetcher tenta prima di scaricare i risultati da S3 e poi torna a utilizzare l'API. GetQueryResultsStream In questa situazione, puoi impostare to ResultFetcher per GetQueryResultsStream evitare una chiamata API aggiuntiva.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito | Valori possibili |
|---|---|---|---|---|
| ResultFetcher | nessuno | Facoltativo | auto | auto, S3, GetQueryResults GetQueryResultsStream |
Dimensioni di recupero
Il valore di questo parametro viene utilizzato come valore minimo per i buffer interni e come dimensione della pagina di destinazione durante il recupero dei risultati. Il valore 0 (zero) indica che il driver deve utilizzare i propri valori predefiniti come descritto di seguito. Il valore massimo è 1.000.000.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| FetchSize | RowsToFetchPerBlock (obsoleto) | Facoltativo | 0 |
-
Il fetcher
GetQueryResultsutilizzerà sempre una dimensione di pagina pari a 1.000, che è il valore massimo supportato dalla chiamata API. Quando la dimensione di recupero è superiore a 1.000, vengono effettuate più chiamate API successive per riempire il buffer al di sopra del minimo. -
Il fetcher
GetQueryResultsStreamutilizzerà la dimensione di recupero configurata come dimensione della pagina, o 10.000 per impostazione predefinita. -
Il fetcher
S3utilizzerà la dimensione di recupero configurata come dimensione della pagina, o 10.000 per impostazione predefinita.
Parametri di riutilizzo dei risultati della query
Come abilitare il riutilizzo dei risultati
Specifica se i risultati della query precedente possono essere riutilizzati quando la query viene eseguita. Per informazioni sul riutilizzo dei risultati delle query, vedere. ResultReuseByAgeConfiguration
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| EnableResultReuseByAge | nessuno | Facoltativo | FALSE |
Età massima per il riutilizzo di risultati
L'età massima, in minuti, dei risultati di una query precedente che Athena dovrebbe considerare per il riutilizzo. Per informazioni sull'età massima per il riutilizzo dei risultati, vedere. ResultReuseByAgeConfiguration
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| MaxResultReuseAgeInMinutes | nessuno | Facoltativo | 60 |
Parametri di polling per l'esecuzione delle query
Intervallo minimo di polling per l'esecuzione delle query
Il tempo minimo, in millisecondi, da attendere prima di eseguire il polling di Athena per verificare lo stato di esecuzione della query.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| MinQueryExecutionPollingIntervalMillis | MinQueryExecutionPollingInterval (obsoleto) | Facoltativo | 100 |
Intervallo massimo di polling per l'esecuzione delle query
Il tempo massimo, in millisecondi, da attendere prima di eseguire il polling di Athena per verificare lo stato di esecuzione della query.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| MaxQueryExecutionPollingIntervalMillis | MaxQueryExecutionPollingInterval (obsoleto) | Facoltativo | 5000 |
Moltiplicatore dell'intervallo di polling per l'esecuzione delle query
Il fattore di incremento del periodo di polling. Per impostazione predefinita, il polling inizierà con il valore per MinQueryExecutionPollingIntervalMillis e raddoppierà con ogni polling fino a raggiungere il valore per MaxQueryExecutionPollingIntervalMillis.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| QueryExecutionPollingIntervalMultiplier | nessuno | Facoltativo | 2 |
Parametri di sovrascrittura dell'endpoint
Sovrascrizione degli endpoint Athena
L'endpoint che il driver utilizzerà per effettuare chiamate API verso Athena.
Notare i seguenti punti:
-
Se i protocolli
https://ohttp://non sono specificati nell'URL fornito, il driver inserisce il prefissohttps://. -
Se questo parametro non è specificato, il driver utilizza un endpoint predefinito.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| AthenaEndpoint | EndpointOverride (obsoleto) | Facoltativo | nessuno |
Sostituzione degli endpoint di streaming Athena
L'endpoint che il driver utilizzerà per scaricare i risultati delle query quando utilizza il servizio di streaming Athena. Il servizio di streaming Athena è disponibile tramite la porta 444.
Notare i seguenti punti:
-
Se i protocolli
https://ohttp://non sono specificati nell'URL fornito, il driver inserisce il prefissohttps://. -
Se una porta non è specificata nell'URL fornito, il driver inserisce la porta 444 del servizio di streaming.
-
Se il
AthenaStreamingEndpointparametro non è specificato, il driver utilizza la sovrascrittura diAthenaEndpoint. Se non viene specificata né la sovrascritturaAthenaStreamingEndpointnéAthenaEndpoint, il driver utilizzerà un endpoint di streaming predefinito.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| AthenaStreamingEndpoint | StreamingEndpointOverride (obsoleto) | Facoltativo | nessuno |
LakeFormation sovrascrittura dell'endpoint
L'endpoint che il driver utilizzerà per il servizio Lake Formation quando utilizza l'API AWS Lake Formation AssumeDecoratedRoleWithSAML per recuperare le credenziali temporanee. Se questo parametro non viene specificato, il driver utilizza un endpoint predefinito.
Notare i seguenti punti:
-
Se i protocolli
https://ohttp://non sono specificati nell'URL fornito, il driver inserisce il prefissohttps://.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| LakeFormationEndpoint |
LfEndpointOverride (obsoleto) |
Facoltativo | nessuno |
Sovrascrittura endpoint S3
L'endpoint che il driver utilizzerà per scaricare i risultati delle query quando utilizza il fetcher Amazon S3. Se questo parametro non viene specificato, il driver utilizzerà un endpoint Amazon S3 predefinito.
Notare i seguenti punti:
-
Se i protocolli
https://ohttp://non sono specificati nell'URL fornito, il driver inserisce il prefissohttps://.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| S3Endpoint | Nessuno | Facoltativo | nessuno |
Sovrascrittura di endpoint STS
L'endpoint che il driver utilizzerà per il AWS STS servizio quando utilizza l'API AWS STS AssumeRoleWithSAML per recuperare credenziali temporanee. Se questo parametro non è specificato, il driver utilizza un endpoint predefinito. AWS STS
Notare i seguenti punti:
-
Se i protocolli
https://ohttp://non sono specificati nell'URL fornito, il driver inserisce il prefissohttps://.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| StsEndpoint | StsEndpointOverride(obsoleto) | Facoltativo | nessuno |
Parametri di configurazione proxy
Host proxy
L'URL dell'host proxy. Utilizza questo parametro se desideri che le richieste Athena passino attraverso un proxy.
Nota
Assicurati di includere il protocollo https:// o http:// all'inizio dell'URL per ProxyHost.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ProxyHost | nessuno | Facoltativo | nessuno |
Porta proxy
La porta da utilizzare sull'host proxy. Utilizza questo parametro se desideri che le richieste Athena passino attraverso un proxy.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ProxyPort | nessuno | Facoltativo | nessuno |
Nome utente proxy
Il nome utente per eseguire l'autenticazione con il server proxy. Utilizza questo parametro se desideri che le richieste Athena passino attraverso un proxy.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ProxyUsername | ProxyUID (obsoleto) | Facoltativo | nessuno |
Password proxy
La password per eseguire l'autenticazione con il server proxy. Utilizza questo parametro se desideri che le richieste Athena passino attraverso un proxy.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ProxyPassword | ProxyPWD (obsoleto) | Facoltativo | nessuno |
Host esenti da proxy
Un set di nomi host a cui il driver si connette senza utilizzare un proxy quando il proxy è abilitato (ovvero quando sono impostati i parametri di connessione ProxyHost e ProxyPort). Gli host devono essere separati con una barra verticale (|), ad esempio, host1.com|host2.com.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ProxyExemptHosts | NonProxyHosts | Facoltativo | nessuno |
Proxy abilitato per i gestori delle identità
Speciifica se deve essere utilizzato un proxy quando il driver si connette a un gestore delle identità.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ProxyEnabledForIdP | UseProxyForIdP | Facoltativo | FALSE |
Parametri di registrazione
In questa sezione sono descritti i parametri relativi alla registrazione.
Livello di log
Specifica il livello di registrazione del driver. Non viene registrato nulla a meno che non sia impostato anche il parametro LogPath.
Nota
Si consiglia di impostare solo il parametro LogPath, a meno che non si abbiano requisiti speciali. L'impostazione del solo parametro LogPath abilita la registrazione e utilizza il livello di log TRACE predefinito. Il livello di log TRACE fornisce la registrazione più dettagliata.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito | Valori possibili |
|---|---|---|---|---|
| LogLevel | nessuno | Facoltativo | TRACE | OFF, ERROR, WARN, INFO, DEBUG, TRACE |
Log Path (Percorso log)
Il percorso di una directory sul computer che esegue il driver in cui verranno archiviati i log dei driver. Verrà creato un file di log con un nome univoco all'interno della directory specificata. Se impostato, abilita la registrazione del driver.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| LogPath | nessuno | Facoltativo | nessuno |
Nome applicazione
Il nome dell'applicazione che utilizza il driver. Se viene specificato un valore per questo parametro, il valore sarà incluso nella stringa dell'agente utente o delle chiamate API che il driver effettua ad Athena.
Nota
È inoltre possibile impostare il nome dell'applicazione richiamando setApplicationName sull'oggetto DataSource.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ApplicationName | nessuno | Facoltativo | nessuno |
Test di connessione
Se impostato su TRUE, il driver esegue un test di connessione ogni volta che viene creata una connessione JDBC, anche se non viene eseguita alcuna query sulla connessione.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| ConnectionTest | nessuno | Facoltativo | TRUE |
Nota
Un test di connessione invia una query SELECT 1 ad Athena per verificare che la connessione sia stata configurata correttamente. Ciò significa che due file verranno archiviati in Amazon S3 (il set di risultati e i metadati) e potranno essere applicati costi aggiuntivi in base alla policy dei prezzi di Amazon Athena
Numero di tentativi
Il numero massimo di volte in cui il driver deve inviare nuovamente una richiesta recuperabile ad Athena.
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
| NumRetries | MaxErrorRetry (obsoleto) | Facoltativo | nessuno |
Timeout di rete
Il timeout di rete controlla la quantità di tempo in cui il driver attende che venga stabilita una connessione di rete. Ciò include il tempo necessario per inviare le richieste API. In rare circostanze, può essere utile modificare il timeout di rete. Ad esempio, potresti voler aumentare il timeout per le lunghe pause di raccolta dei rifiuti. L'impostazione di questo parametro di connessione equivale all'utilizzo del setNetworkTimeout metodo su un oggetto. Connection
| Nome del parametro | Alias | Tipo parametro | Valore predefinito |
|---|---|---|---|
|
NetworkTimeoutMillis |
nessuno | Facoltativo | nessuno |
