

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
<a name="sagemaker-sql-extension-connection-properties"></a>

Le tabelle seguenti descrivono in dettaglio le proprietà Python supportate per le AWS Glue connessioni per archivio dati.

## Parametri di connessione per Amazon Redshift
<a name="sagemaker-sql-extension-connection-properties-redshift"></a>

I seguenti parametri di connessione Python sono supportati dalle AWS Glue connessioni ad Amazon Redshift.


| Chiave | Tipo | Description | Vincoli | Richiesto | 
| --- | --- | --- | --- | --- | 
| auto\_create | Tipo: boolean | Indica se l’utente deve essere creato, se non esiste. L’impostazione predefinita è false. | true, false | No | 
| aws\_secret\_arn | Tipo: string | L’ARN del segreto utilizzato per recuperare i parametri aggiuntivi per la connessione. | ARN valido. | No | 
| cluster\_identifier | Tipo: string - maxLength: 63 | L'identificatore del cluster del cluster Amazon Redshift. | ^(?\!.\*—)[a-z][a-z0-9-]{0,61}[a-z0-9]$ | No | 
| database | Tipo: string - maxLength: 127 | Il nome del database a cui connettersi. |  | No | 
| database\_metadata\_current\_db\_only | Tipo: boolean | Indica se l’applicazione supporta i cataloghi delle unità di condivisione dati in più database. Il valore predefinito true indica che l’applicazione non supporta i cataloghi delle unità di condivisione dati in più database per la compatibilità con le versioni precedenti. | true, false | No | 
| db\_groups | Tipo: string | Un elenco separato da virgole di nomi di gruppi di database esistenti di cui db\_user esegue il join per la sessione corrente. |  | No | 
| db\_user | Tipo: string | L'ID utente da utilizzare con Amazon Redshift. |  | No | 
| host | Tipo: string - maxLength: 256 | Nome host del cluster Amazon Redshift. |  | No | 
| iam | Tipo: boolean | Contrassegna per abilitare o disabilitare l’autenticazione basata su IAM per una connessione. L’impostazione predefinita è false. | true, false | No | 
| iam\_disable\_cache | Tipo: boolean | Questa opzione specifica se le credenziali IAM vengono memorizzate nella cache. L’impostazione predefinita è true. Questo migliora le prestazioni quando le richieste al gateway API sono strozzate. | true, false | No | 
| max\_prepared\_statements | Tipo: integer | Il numero massimo di istruzioni preparate che possono essere aperte contemporaneamente. |  | No | 
| numeric\_to\_float | Da decimale a virgola mobile | Specifica se i valori dei tipi di dati NUMERIC verranno convertiti da decimali. Per impostazione predefinita, i valori NUMERIC vengono ricevuti come oggetti decimal.Decimal di Python. L’abilitazione di questa opzione non è consigliata per i casi d’uso che richiedono la massima precisione perché i risultati potrebbero essere arrotondati. Consulta la documentazione di Python su [https://docs.python.org/3/library/decimal.html#decimal-objects](https://docs.python.org/3/library/decimal.html#decimal-objects) per un confronto tra decimal.Decimal e float prima di abilitare questa opzione. L’impostazione predefinita è false. | true, false | No | 
| port | Tipo: integer | Il numero della porta del cluster Amazon Redshift. | Intervallo 1150-65535. | No | 
| profile | Tipo: string - maxLength: 256 | Il nome del profilo che contiene le credenziali e l’impostazione utilizzate dalla AWS CLI. |  | No | 
| region | Tipo: string | La AWS regione in cui si trova il cluster. |  AWS Regione valida | No | 
| serverless\_acct\_id | Tipo: string - maxLength: 256 | L'ID AWS dell'account associato alla risorsa serverless Amazon Redshift. |  | No | 
| serverless\_work\_group | Tipo: string - maxLength: 256 | Il nome del gruppo di lavoro per l’endpoint di Amazon Redshift serverless. |  | No | 
| ssl | Tipo: boolean | true se SSL è abilitato. | true, false | No | 
| ssl\_mode | Tipo: enum[verify-ca, verify-full, null]) | La sicurezza della connessione ad Amazon Redshift. Sono supportati verify-ca (è necessario utilizzare SSL e verificare il certificato del server) e verify-full (è necessario utilizzare SSL, verificare il certificato del server e il nome host del server deve corrispondere all’attributo hostname sul certificato). Per ulteriori informazioni, consulta [Configurazione delle opzioni di sicurezza per le connessioni](https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-ssl-support.html) nella documentazione di Amazon Redshift. L’impostazione predefinita è verify-ca. | verify-ca, verify-full | No | 
| timeout | Tipo: integer | Il numero di secondi prima del timeout della connessione al server. | 0 | No | 

## Parametri di connessione per Athena
<a name="sagemaker-sql-extension-connection-properties-athena"></a>

I seguenti parametri di connessione Python sono supportati dalle AWS Glue connessioni ad Athena.


| Chiave | Tipo | Description | Vincoli | Richiesto | 
| --- | --- | --- | --- | --- | 
| aws\_access\_key\_id | Tipo: string - maxLength: 256 | Specifica una chiave di AWS accesso associata a un account IAM. Consigliamo di archiviare queste informazioni in aws\_secret. | Lunghezza: 16-128. | No | 
| aws\_secret\_access\_key | Tipo: string - maxLength: 256 | Parte segreta di una chiave di AWS accesso. Consigliamo di archiviare queste informazioni in aws\_secret. |  | No | 
| aws\_secret\_arn | Tipo: string | L’ARN del segreto utilizzato per recuperare i parametri aggiuntivi per la connessione. | ARN valido. | No | 
| catalog\_name | Tipo: string - maxLength: 256 | Il catalogo che contiene i database e le tabelle a cui si accederà tramite il driver. Per informazioni sui cataloghi, vedere [DataCatalog](https://docs.aws.amazon.com/athena/latest/APIReference/API_DataCatalog.html). |  | No | 
| duration\_seconds | Tipo: number | La durata, in secondi, della sessione dei ruoli. Questa impostazione può avere un valore compreso tra 1 ora e 12 ore. Per impostazione predefinita, la durata è impostata su 3600 secondi (1 ora).  | Intervallo tra 900 secondi (15 minuti) e l’impostazione della durata massima della sessione per il ruolo. | No | 
| encryption\_option | Tipo: enum[SSE\_S3, SSE\_KMS, CSE\_KMS, null]) | Crittografia a riposo per Amazon S3. Consulta la sezione Crittografia a riposo nella [guida di Athena](https://docs.aws.amazon.com/athena/latest/ug/encryption.html). | SSE\_S3, SSE\_KMS, CSE\_KMS | No | 
| kms\_key | Tipo: string - maxLength: 256 | AWS KMS chiave se si utilizza CSE\_KMS inencrytion\_option. |  | No | 
| poll\_interval | Tipo: number | Intervallo in secondi per verificare lo stato dei risultati della query in Athena. |  | No | 
| profile\_name | Tipo: string - maxLength: 256 | Il nome del profilo di AWS configurazione le cui credenziali devono essere utilizzate per autenticare la richiesta ad Athena. |  | No | 
| region\_name | Tipo: string | La AWS regione in cui vengono eseguite le query. | Regione valida AWS  | No | 
| result\_reuse\_enable | Tipo: boolean | Abilita il riutilizzo dei risultati della query precedente. | true, false | No | 
| result\_reuse\_minutes | Tipo: integer | Specifica, in minuti, l'età massima dei risultati di una query precedente che Athena debba considerare per il riutilizzo. Il valore predefinito è 60. | >=1 | No | 
| role\_arn | Tipo: string | Ruolo da utilizzare per eseguire le query. | ARN valido. | No | 
| schema\_name | Tipo: string - maxLength: 256 | Nome dello schema predefinito da utilizzare per il database. |  | No | 
| s3\_staging\_dir | Tipo: string - maxLength: 1024 | Il percorso in Amazon S3 in cui sono archiviati i risultati della query. |  | Nota: è necessario immettere s3\_staging\_dir o work\_group. | 
| work\_group | Tipo: string | Il gruppo di lavoro in cui verranno eseguite le query. Per informazioni sui gruppi di lavoro, vedere [WorkGroup](https://docs.aws.amazon.com/athena/latest/APIReference/API_WorkGroup.html). | ^[a-zA-Z0-9.\_-]{1.128} $ | Nota: è necessario immettere s3\_staging\_dir o work\_group. | 

## Parametri di connessione per Snowflake
<a name="sagemaker-sql-extension-connection-properties-snowflake"></a>

I seguenti parametri di connessione Python sono supportati dalle AWS Glue connessioni a Snowflake.

Parametri di connessione per Snowflake


| Chiave | Tipo | Description | Vincoli | Richiesto | 
| --- | --- | --- | --- | --- | 
| account | Tipo: string - maxLength: 256 | L’identificatore dell’account Snowflake. L’identificatore dell’account non include il suffisso snowflakecomputing.com. |  | Sì | 
| arrow\_number\_to\_decimal | Tipo: boolean | False per impostazione predefinita, il che significa che i valori delle colonne NUMBER vengono restituiti come numeri in virgola mobile a precisione doppia (float64). Imposta questo valore su True per restituire i valori delle colonne DECIMAL come numeri decimali (decimal.Decimal) quando vengono chiamati i metodi fetch\_pandas\_all() e fetch\_pandas\_batches(). | true, false | No | 
| autocommit | Tipo: boolean | Il valore predefinito è false, che rispetta il parametro AUTOCOMMIT di Snowflake. Imposta il valore su true o false per abilitare o disabilitare rispettivamente la modalità autocommit nella sessione. | true, false | No | 
| aws\_secret\_arn | Tipo: string | L’ARN del segreto utilizzato per recuperare i parametri aggiuntivi per la connessione. | ARN valido. | No | 
| client\_prefetch\_threads | Tipo: integer | Numero di thread utilizzati per scaricare i set di risultati (4 per impostazione predefinita). Un valore maggiore migliora le prestazioni di recupero ma richiede più memoria. |  | No | 
| database | Tipo: string - maxLength: 256 | Il nome del database predefinito da utilizzare. |  | No | 
| login\_timeout | Tipo: integer | Timeout in secondi per la richiesta di accesso. Il valore predefinito è 60 secondi. La richiesta di accesso scade al termine del timeout se la risposta HTTP non è success. |  | No | 
| network\_timeout | Tipo: integer | Il timeout in secondi di tutte le altre operazioni. Il valore predefinito è none (infinito). Una richiesta generale scade al termine del timeout se la risposta HTTP non è success. |  | No | 
| paramstyle | Tipo: string - maxLength: 256 | Sintassi segnaposto utilizzate per la sostituzione dei parametri durante l’esecuzione di query SQL dal codice Python. L’impostazione predefinita è pyformat per l’associazione lato client. Specifica qmark o numeric per modificare i formati delle variabili di associazione per l’associazione lato server. |  | No | 
| role | Tipo: string - maxLength: 256 | Il nome del ruolo predefinito da utilizzare. |  | No | 
| schema | Tipo: string - maxLength: 256 | Il nome dello schema predefinito da utilizzare per il database. |  | No | 
| timezone | Tipo: string - maxLength: 128 | L’impostazione predefinita è nessun valore, che rispetta il parametro TIMEZONE di Snowflake. Imposta un fuso orario valido (ad esempio America/Los\_Angeles) per impostare il fuso orario della sessione. | Fuso orario in un formato simile a America/Los\_Angeles. | No | 
| validate\_default\_parameters | Tipo: boolean | Imposta su true per sollevare un’eccezione se il database, lo schema o il warehouse specificato non esiste. L’impostazione predefinita è false. |  | No | 
| warehouse | Tipo: string - maxLength: 256 | Il nome del warehouse predefinito da utilizzare. |  | No | 