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à.

# Parametri di connessione avanzati
<a name="jdbc-v3-driver-advanced-connection-parameters"></a>

Nelle sezioni seguenti sono descritti i parametri di connessione avanzati per il driver JDBC 3.x.

**Topics**
+ [Parametri di crittografia dei risultati](#jdbc-v3-driver-result-encryption-parameters)
+ [Parametri di recupero dei risultati](#jdbc-v3-driver-result-fetching-parameters)
+ [Parametri di configurazione](#jdbc-v3-driver-result-config)
+ [Parametri di riutilizzo dei risultati della query](#jdbc-v3-driver-query-result-reuse-parameters)
+ [Parametri di polling per l'esecuzione delle query](#jdbc-v3-driver-query-execution-polling-parameters)
+ [Parametri di sovrascrittura dell'endpoint](#jdbc-v3-driver-endpoint-override-parameters)
+ [Parametri di configurazione proxy](#jdbc-v3-driver-proxy-configuration-parameters)
+ [Parametri di registrazione](#jdbc-v3-driver-logging-parameters)
+ [Application name (Nome applicazione)](#jdbc-v3-driver-application-name)
+ [Test di connessione](#jdbc-v3-driver-connection-test)
+ [Numero di tentativi](#jdbc-v3-driver-number-of-retries)
+ [Timeout di rete](#jdbc-v3-driver-networktimeoutmillis)

## Parametri di crittografia dei risultati
<a name="jdbc-v3-driver-result-encryption-parameters"></a>

Notare i seguenti punti:
+ La AWS KMS chiave deve essere specificata quando `EncryptionOption` è `SSE_KMS` o`CSE_KMS`.
+ La AWS KMS chiave non può essere specificata quando non `EncryptionOption` è specificata o quando lo `EncryptionOption` è`SSE_S3`.

### Opzione di crittografia
<a name="jdbc-v3-driver-encryption-option"></a>

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, [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)consulta *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
<a name="jdbc-v3-driver-kms-key"></a>

L'ARN o l'ID della chiave KMS, se `SSE_KMS` o `CSE_KMS` viene scelto come opzione di crittografia. Per ulteriori informazioni, consulta [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)*Amazon Athena API* Reference.


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| KmsKey | S3 OutputEnc KMSKey (obsoleto) | Facoltativo | nessuno | 

## Parametri di recupero dei risultati
<a name="jdbc-v3-driver-result-fetching-parameters"></a>

### Sistema di recupero (fetcher) dei risultati
<a name="jdbc-v3-driver-result-fetcher"></a>

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’opzione `CSE_KMS`, torna automaticamente a utilizzare l’API `GetQueryResultsStream`.

L’uso del fetcher `auto` è consigliato nella maggior parte delle situazioni. Se le tue policy IAM o le policy dei bucket S3 utilizzano le richieste [s3: CalledVia](security-iam-athena-calledvia.md) 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
<a name="jdbc-v3-driver-fetch-size"></a>

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 `GetQueryResults` utilizzerà 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 `GetQueryResultsStream` utilizzerà la dimensione di recupero configurata come dimensione della pagina, o 10.000 per impostazione predefinita.
+ Il fetcher `S3` utilizzerà la dimensione di recupero configurata come dimensione della pagina, o 10.000 per impostazione predefinita.

## Parametri di configurazione
<a name="jdbc-v3-driver-result-config"></a>

### Proprietario previsto del bucket
<a name="jdbc-v3-driver-exp-bucket-owner"></a>

L'ID dell'account del proprietario previsto del bucket s3. Se l’ID dell’account fornito non corrisponde al proprietario effettivo del bucket, la richiesta ha esito negativo. [Per ulteriori informazioni sulla verifica del proprietario del bucket s3, consulta Verifica della proprietà del bucket.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use)


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| ExpectedBucketOwner | nessuno | Facoltativo | nessuno | 

### Opzione ACL
<a name="jdbc-v3-driver-acl"></a>

Indica che è necessario impostare un ACL predefinito di Amazon S3 per controllare la proprietà dei risultati delle query archiviate. Per ulteriori informazioni su `AclOption`, consultare [AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html).


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | Valori possibili | 
| --- | --- | --- | --- | --- | 
| AclOption | nessuno | Facoltativo | nessuno | BUCKET\_OWNER\_FULL\_CONTROL | 

## Parametri di riutilizzo dei risultati della query
<a name="jdbc-v3-driver-query-result-reuse-parameters"></a>

### Come abilitare il riutilizzo dei risultati
<a name="jdbc-v3-driver-enable-result-reuse"></a>

Specifica se i risultati della query precedente possono essere riutilizzati quando la query viene eseguita. Per informazioni sul riutilizzo dei risultati delle query, consulta. [ResultReuseByAgeConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html)


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| EnableResultReuseByAge | nessuno | Facoltativo | FALSE | 

### Età massima per il riutilizzo di risultati
<a name="jdbc-v3-driver-result-reuse-max-age"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html)


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| MaxResultReuseAgeInMinutes | nessuno | Facoltativo | 60 | 

## Parametri di polling per l'esecuzione delle query
<a name="jdbc-v3-driver-query-execution-polling-parameters"></a>

### Intervallo minimo di polling per l'esecuzione delle query
<a name="jdbc-v3-driver-minimum-query-execution-polling-interval"></a>

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
<a name="jdbc-v3-driver-maximum-query-execution-polling-interval"></a>

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
<a name="jdbc-v3-driver-query-execution-polling-interval-multiplier"></a>

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
<a name="jdbc-v3-driver-endpoint-override-parameters"></a>

### Sovrascrizione degli endpoint Athena
<a name="jdbc-v3-driver-athena-endpoint-override"></a>

L'endpoint che il driver utilizzerà per effettuare chiamate API verso Athena.

Notare i seguenti punti:
+ Se i protocolli `https://` o `http://` non sono specificati nell'URL fornito, il driver inserisce il prefisso `https://`.
+ 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
<a name="jdbc-v3-driver-athena-streaming-service-endpoint-override"></a>

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://` o `http://` non sono specificati nell'URL fornito, il driver inserisce il prefisso `https://`.
+ Se una porta non è specificata nell'URL fornito, il driver inserisce la porta 444 del servizio di streaming.
+ Se il `AthenaStreamingEndpoint` parametro non è specificato, il driver utilizza la sovrascrittura di `AthenaEndpoint`. Se non viene specificata né la sovrascrittura `AthenaStreamingEndpoint` né `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
<a name="jdbc-v3-driver-athena-lake-formation-endpoint-override"></a>

L'endpoint che il driver utilizzerà per il servizio Lake Formation quando utilizza l'API AWS Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) 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://` o `http://` non sono specificati nell'URL fornito, il driver inserisce il prefisso `https://`.


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| LakeFormationEndpoint | LfEndpointOverride (obsoleto) | Facoltativo | nessuno | 

### Sovrascrittura endpoint S3
<a name="jdbc-v3-driver-athena-s3-endpoint-override"></a>

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://` o `http://` non sono specificati nell'URL fornito, il driver inserisce il prefisso `https://`.


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| S3Endpoint | Nessuno | Facoltativo | nessuno | 

### Sovrascrittura di endpoint STS
<a name="jdbc-v3-driver-athena-sts-endpoint-override"></a>

L'endpoint che il driver utilizzerà per il AWS STS servizio quando utilizza l'API AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) 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://` o `http://` non sono specificati nell'URL fornito, il driver inserisce il prefisso `https://`.


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| StsEndpoint | StsEndpointOverride(obsoleto) | Facoltativo | nessuno | 

### Sovrascrittura degli endpoint OIDC SSO
<a name="jdbc-v3-driver-athena-sso-oidc-endpoint-override"></a>

L’endpoint che il driver utilizzerà `ClientConfiguration.endpointOverride` per sovrascrivere l’endpoint HTTP predefinito per il client OIDC SSO. Per ulteriori informazioni, consulta [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| SSOOIDCEndpointSostituisci |  | Facoltativo | nessuno | 

### Sovrascrittura degli endpoint admin SSO
<a name="jdbc-v3-driver-athena-sso-admin-endpoint-override"></a>

L’endpoint che il driver utilizzerà `ClientConfiguration.endpointOverride` per sovrascrivere l’endpoint HTTP predefinito per il client di amministrazione SSO. Per ulteriori informazioni, consulta [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| SSOAdminEndpointOverride |  | Facoltativo | nessuno | 

## Parametri di configurazione proxy
<a name="jdbc-v3-driver-proxy-configuration-parameters"></a>

### Host proxy
<a name="jdbc-v3-driver-proxy-host"></a>

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
<a name="jdbc-v3-driver-proxy-port"></a>

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
<a name="jdbc-v3-driver-proxy-username"></a>

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
<a name="jdbc-v3-driver-proxy-password"></a>

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
<a name="jdbc-v3-driver-proxy-exempt-hosts"></a>

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à
<a name="jdbc-v3-driver-proxy-enabled-for-identity-providers"></a>

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
<a name="jdbc-v3-driver-logging-parameters"></a>

In questa sezione sono descritti i parametri relativi alla registrazione.

### Livello di log
<a name="jdbc-v3-driver-logging-parameters-log-level"></a>

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)
<a name="jdbc-v3-driver-logging-parameters-log-path"></a>

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 | 

## Application name (Nome applicazione)
<a name="jdbc-v3-driver-application-name"></a>

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
<a name="jdbc-v3-driver-connection-test"></a>

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](https://aws.amazon.com/athena/pricing).

## Numero di tentativi
<a name="jdbc-v3-driver-number-of-retries"></a>

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
<a name="jdbc-v3-driver-networktimeoutmillis"></a>

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, si potrebbe aumentare il timeout per le lunghe pause di rimozione di oggetti inutili (garbage collection). L’impostazione di questo parametro di connessione equivale all’utilizzo del metodo `setNetworkTimeout` su un oggetto `Connection`.


****  

| Nome del parametro | Alias | Tipo parametro | Valore predefinito | 
| --- | --- | --- | --- | 
| NetworkTimeoutMillis | nessuno | Facoltativo | nessuno |