Amazon Redshift non supporterà più la creazione di nuove UDF Python a partire dal 1º novembre 2025. Se desideri utilizzare le UDF Python, creale prima di tale data. Le UDF Python esistenti continueranno a funzionare normalmente. Per ulteriori informazioni, consulta il post del blog.

Opzioni di configurazione per il connettore Amazon Redshift Python

Di seguito è possibile trovare le descrizioni per le opzioni che è possibile specificare per il connettore Python di Amazon Redshift. Le opzioni seguenti si applicano all’ultima versione disponibile del connettore, salvo diversamente specificato.

id_chiave_accesso

La chiave di accesso per il ruolo IAM o l'utente IAM configurato per l'autenticazione database IAM.

Questo parametro è facoltativo.

allow_db_user_override

Questo parametro è facoltativo.

Nome_App

Il nome dell'applicazione del provider di identità (IdP) utilizzata per l'autenticazione.

Questo parametro è facoltativo.

application_name

Il nome dell’applicazione client da trasmettere ad Amazon Redshift a scopo di verifica. Il nome dell’applicazione fornito viene visualizzato nella colonna 'application_name' della tabella SYS_CONNECTION_LOG. Ciò consente di tenere traccia e risolvere i problemi delle origini di connessione durante il debug.

Questo parametro è facoltativo.

auth_profile

Il nome di un profilo di autenticazione Amazon Redshift con proprietà di connessione come JSON. Per maggiori informazioni sulla denominazione dei parametri di connessione, vedere la classe RedshiftProperty. La classe RedshiftProperty memorizza i parametri di connessione forniti dall'utente finale e, se applicabile, generati durante il processo di autenticazione IAM (per esempio, credenziali IAM temporanee). Per ulteriori informazioni, consultare la Classe RedshiftProperty.

Questo parametro è facoltativo.

auto_create

Un valore che indica se creare l'utente se l'utente non esiste.

Questo parametro è facoltativo.

client_id

L'ID client da Azure IdP.

Questo parametro è facoltativo.

client_secret

Il client segreto da Azure IdP.

Questo parametro è facoltativo.

cluster_identifier

L'identificatore del cluster del cluster Amazon Redshift.

Questo parametro è facoltativo.

credentials_provider

L'IdP utilizzato per l'autenticazione con Amazon Redshift. I seguenti valori sono validi:

Questo parametro è facoltativo.

database

Scegliere il nome del database a cui connettersi.

Questo parametro è obbligatorio.

database_metadata_current_db_only

Un valore che indica se un'applicazione supporta cataloghi multidatabase di condivisione dati. Il valore predefinito di True indica che l'applicazione non supporta i cataloghi multidatabase di condivisione dati per la compatibilità con le versioni precedenti.

Questo parametro è facoltativo.

db_groups

Un elenco separato da virgole di nomi di gruppi di database esistenti a cui l'utente indicato da DbUser si unisce per la sessione corrente.

Questo parametro è facoltativo.

db_user

L'ID utente da utilizzare con Amazon Redshift.

Questo parametro è facoltativo.

endpoint_url

L'URL dell'endpoint Amazon Redshift. Questa opzione è solo per l'uso interno di AWS.

Questo parametro è facoltativo.

group_federation

Questa opzione specifica se utilizzare i gruppi IDP di Amazon Redshift.

Questo parametro è facoltativo.

host

Nome host del cluster Amazon Redshift.

Questo parametro è facoltativo.

iam

L'autenticazione IAM è abilitata.

Questo parametro è obbligatorio.

iam_disable_cache

Questa opzione specifica se le credenziali IAM vengono memorizzate nella cache. Per impostazione predefinita, le credenziali IAM sono memorizzate nella cache. Questo migliora le prestazioni quando le richieste al gateway API sono strozzate.

Questo parametro è facoltativo.

idc_client_display_name

Il nome visualizzato da utilizzare per il client che utilizza BrowserIdcAuthPlugin.

Questo parametro è facoltativo.

idc_region

La Regione AWS in cui si trova l’istanza di Centro identità AWS IAM.

Questo parametro è obbligatorio solo per l’autenticazione tramite BrowserIdcAuthPlugin nell’opzione di configurazione credentials_provider.

idp_partition

La partizione in cui è configurato il gestore dell’identità digitale. Una partizione è un gruppo di Regioni AWS. Per ulteriori informazioni sulle partizioni, consulta partizione nel Glossario AWS.

Se questo parametro viene lasciato vuoto, Amazon Redshift utilizza per impostazione predefinita la partizione AWS standard, che include tutte le Regioni AWS commerciali. I valori possibili sono i seguenti:

Questo parametro è facoltativo.

idpPort

La porta di ascolto a cui IdP invia l'asserzione SAML.

Questo parametro è obbligatorio.

idP_Response_Timeout

Il timeout per il recupero dell'asserzione SAML da IdP.

Questo parametro è obbligatorio.

idp_tenant

Il tenant IdP.

Questo parametro è facoltativo.

issuer_url

Punta all’endpoint dell’istanza del server Centro identità AWS IAM.

Questo parametro è obbligatorio solo per l’autenticazione tramite BrowserIdcAuthPlugin nell’opzione di configurazione credentials_provider.

listen_port

La porta utilizzata dal driver per ricevere la risposta SAML dal provider di identità o dal codice di autorizzazione quando utilizzi i servizi SAML, Azure AD o Centro identità AWS IAM tramite un plugin del browser.

Questo parametro è facoltativo.

login_url

L'URL Single Sign-On per l'IdP.

Questo parametro è facoltativo.

max_prepared_statement

Il numero massimo di istruzioni preparate che possono essere memorizzate nella cache per connessione. Impostando questo parametro su 0, puoi disabilitare il meccanismo di memorizzazione nella cache. Se inserisci un numero negativo per questo parametro, viene impostato il valore predefinito.

Questo parametro è facoltativo.

numeric_to_float

Questa opzione specifica se il connettore converte i valori del tipo di dati numerici da decimal.Decimal in float. Per impostazione predefinita, il connettore riceve i valori del tipo di dati numerici come decimal.Decimal e non li converte.

Non è consigliabile abilitare numeric_to_float per casi d'uso che richiedono precisione, poiché i risultati potrebbero essere arrotondati.

Per ulteriori informazioni su decimal.Decimal e i compromessi tra esso e float, consulta decimal — Decimal fixed point and floating point arithmetic (decimal — Decimale a punto fisso e aritmetica a virgola mobile) sul sito Web Python.

Questo parametro è facoltativo.

partner_sp_id

L'ID SP partner utilizzato per l'autenticazione con Ping.

Questo parametro è facoltativo.

password

La password da utilizzare per l'autenticazione.

Questo parametro è facoltativo.

port

Il numero della porta del cluster Amazon Redshift.

Questo parametro è obbligatorio.

preferred_role

Il ruolo IAM preferito per la connessione corrente.

Questo parametro è facoltativo.

principal_arn

Il nome della risorsa Amazon (ARN) dell'utente o del ruolo IAM per il quale si genera la policy. Si consiglia di collegare una policy a un ruolo e assegnare il ruolo all'utente per l'accesso.

Questo parametro è facoltativo.

profile

Il nome di un profilo in un file di credenziali AWS che contiene le credenziali AWS.

Questo parametro è facoltativo.

provider_name

Il nome del Redshift Native Authentication Provider.

Questo parametro è facoltativo.

region

La Regione AWS dove si trova il cluster.

Questo parametro è facoltativo.

role_arn

L'Amazon Resource Name (ARN) del ruolo che il chiamante sta assumendo. Questo parametro viene utilizzato dal provider indicato da JwtCredentialsProvider.

Per il provider JwtCredentialsProvider, questo parametro è obbligatorio. Questo parametro è facoltativo.

role_session_name

Un identificatore della sessione del ruolo assunto. In genere, si passa il nome o l'identificatore associato all'utente che sta utilizzando l'applicazione. Le credenziali di sicurezza temporanee utilizzate dall'applicazione sono associate a tale utente. Questo parametro viene utilizzato dal provider indicato da JwtCredentialsProvider.

Questo parametro è facoltativo.

scope

Un elenco separato da spazi contenente ambiti a cui l'utente può acconsentire. È possibile specificare questo parametro in modo che l'applicazione possa ottenere il consenso per le API che si desidera chiamare. Puoi impostare questo parametro quando specifichi BrowserAzureOAuth2CredentialsProvider per l’opzione credentials_provider.

Questo parametro è obbligatorio per il plug-in BrowserAzureOAuth2CredentialsProvider.

secret_access_key_id

La chiave di accesso segreta per il ruolo IAM o l'utente configurato per l'autenticazione database IAM.

Questo parametro è facoltativo.

session_token

La chiave di accesso per il ruolo IAM o l'utente IAM configurato per l'autenticazione database IAM. Questo parametro è richiesto se si stanno usando credenziali temporanee AWS.

Questo parametro è facoltativo.

serverless_acct_id

L'ID account di Amazon Redshift Serverless.

Questo parametro è facoltativo.

serverless_work_group

Il nome del gruppo di lavoro di Amazon Redshift Serverless.

Questo parametro è facoltativo.

ssl

Secure Sockets Layer (SSL) è abilitato.

Questo parametro è obbligatorio.

ssl_insecure

Un valore che specifica se disabilitare o meno la verifica del certificato SSL del server dell’host del gestore dell’identità digitale. Se imposti questo parametro su True, disabiliti la verifica del certificato SSL del server dell’host del gestore dell’identità digitale. Consigliamo di mantenere il valore predefinito False negli ambienti di produzione.

Questo parametro è facoltativo.

sslmode

La sicurezza della connessione ad Amazon Redshift. Puoi specificare uno dei seguenti:

Questo parametro è obbligatorio.

tcp_keepalive

Se utilizzare keepalive TCP al fine di impedire il timeout delle connessioni. Puoi specificare le seguenti valori:

Questo parametro è facoltativo.

tcp_keepalive_count

Il numero di sonde non riconosciute da inviare prima di considerare la connessione inattiva. Ad esempio, se imposti il valore su 3, significa che il driver invia tre pacchetti keepalive senza risposta prima di determinare che la connessione non è più attiva.

Se questo parametro non è specificato, Amazon Redshift utilizza il valore predefinito del sistema.

Questo parametro è facoltativo.

tcp_keepalive_interval

L’intervallo, in secondi, tra le sonde keepalive successive se il driver non ha ricevuto la conferma della sonda precedente. Se specifichi questo parametro, deve essere un numero intero positivo.

Se questo parametro non è specificato, Amazon Redshift utilizza il valore predefinito del sistema.

Questo parametro è facoltativo.

tcp_keepalive_idle

La durata dell’inattività, in secondi, dopo la quale il driver invia la prima sonda keepalive. Ad esempio, se imposti il valore su 120, significa che il driver aspetta due minuti di inattività prima di inviare il primo pacchetto keepalive. Se specifichi questo parametro, deve essere un numero intero positivo.

Se questo parametro non è specificato, Amazon Redshift utilizza il valore predefinito del sistema.

Questo parametro è facoltativo.

timeout

Il numero di secondi prima del timeout della connessione al server.

Questo parametro è facoltativo.

token

Un token di accesso fornito da Centro identità AWS IAM o un JSON Web Token (JWT) OpenID Connect (OIDC) fornito da un provider di identità web collegato con Centro identità AWS IAM. L’applicazione deve generare questo token autenticando l’utente dell’applicazione con Centro identità AWS IAM o un provider di identità collegato a Centro identità AWS IAM.

Questo parametro funziona con IdpTokenAuthPlugin.

token_type

Il tipo di token che viene utilizzato in IdpTokenAuthPlugin.

Puoi specificare le seguenti valori:

Questo parametro funziona con IdpTokenAuthPlugin.

user

Il nome utente da utilizzare per l'autorizzazione.

Questo parametro è facoltativo.

web_identity_token

Il token di accesso OAuth 2.0 o un token ID OpenID Connect fornito dal provider di identità. Assicurarsi che l'applicazione ottenga questo token autenticando l'utente dell'applicazione con un provider di identità Web. Il provider indicato da JwtCredentialsProvider utilizza questo parametro.

Per il provider JwtCredentialsProvider, questo parametro è obbligatorio. Questo parametro è facoltativo.