Opzioni per la configurazione del driver JDBC versione 2.1

Di seguito è possibile trovare le descrizioni per le opzioni che è possibile specificare per la versione 2.1 del driver JDBC di Amazon Redshift. Le opzioni di configurazione non fanno distinzione tra maiuscole e minuscole.

È possibile impostare le proprietà di configurazione utilizzando l'URL di connessione. Per ulteriori informazioni, consulta Creazione dell'URL di connessione.

AccessKeyID

• Valore predefinito: nessuno

• Tipo di dati: stringa

È possibile specificare questo parametro per immettere la chiave di accesso IAM per l'utente o il ruolo. Di solito è possibile individuare la chiave guardando una stringa o un profilo utente esistente. Se si specifica questo parametro, è necessario specificare anche il parametro SecretAccessKey. Se passato nell'URL JDBC, l' AccessKeyID deve essere codificato come URL.

Questo parametro è facoltativo.

AllowDB UserOverride

• Valore predefinito: 0

• Tipo di dati: stringa

Questa opzione specifica se il driver utilizza l'opzioneDbUser dall'asserzione SAML o il valore specificato nella proprietà di connessione DbUser nell'URL di connessione.

Questo parametro è facoltativo.

1

Il driver utilizza il valore DbUser dall'asserzione SAML.

Se l'asserzione SAML non specifica un valore per DBUser, il driver utilizzerà il valore specificato nella proprietà di connessione DBUser. Se neanche la proprietà di connessione specifica un valore, il driver utilizzerà il valore specificato nel profilo di connessione.

0

Il driver utilizza il valore DBUser specificato nella proprietà di connessione DBUser.

Se la proprietà di connessione DBUser non specifica un valore, il driver utilizzerà il valore specificato nel profilo di connessione. Se neanche il profilo di connessione specifica un valore, il driver utilizzerà il valore dall'asserzione SAML.

App_ID

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'ID univoco fornito da Okta associato all'applicazione Amazon Redshift.

Questo parametro è obbligatorio se si esegue l'autenticazione tramite il servizio Okta.

App_Name

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome dell'applicazione Okta utilizzata per autenticare la connessione ad Amazon Redshift.

Questo parametro è facoltativo.

ApplicationName

• Valore predefinito: null

• Tipo di dati: stringa

Il nome dell'applicazione da passare ad Amazon Redshift a scopo di verifica.

Questo parametro è facoltativo.

AuthProfile

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome del profilo di autenticazione da utilizzare per la connessione ad Amazon Redshift.

Questo parametro è facoltativo.

AutoCreate

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione specifica se il driver determina la creazione di un nuovo utente quando l'utente specificato non esiste.

Questo parametro è facoltativo.

true

Se l'utente specificato da DBUser o ID univoco (UID) non esiste, sarà creato un nuovo utente con tale nome.

false

Il driver non provoca la creazione di nuovi utenti. Se l'utente specificato non esiste, l'autenticazione avrà esito negativo.

Client_ID

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'ID client da usare durante l'autenticazione della connessione tramite il servizio Azure AD.

Questo parametro è obbligatorio se si esegue l'autenticazione tramite il servizio Azure AD.

Client_Secret

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il segreto client da usare durante l'autenticazione della connessione tramite il servizio Azure AD.

Questo parametro è obbligatorio se si esegue l'autenticazione tramite il servizio Azure AD.

ClusterID

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome del cluster Amazon Redshift a cui connettersi. Il driver prova a rilevare questo parametro dall'host specificato. Se utilizzi un Network Load Balancer (NLB) e una connessione tramite IAM, il driver non riuscirà a rilevarla, quindi puoi impostarla mediante questa opzione di connessione.

Questo parametro è facoltativo.

Compressione

• Valore predefinito: off

• Tipo di dati: stringa

Il metodo di compressione utilizzato per la comunicazione del protocollo wire tra il server Amazon Redshift e il client o il driver.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

• lz4

  Imposta il metodo di compressione utilizzato per la comunicazione del protocollo wire con Amazon Redshift su lz4.

• off

  Non utilizza la compressione per la comunicazione del protocollo wire con Amazon Redshift.

connectTimeout

• Valore di default: 10

• Tipo di dati: numero intero

Il valore di timeout da utilizzare per le operazioni di connessione socket. Se il tempo necessario per stabilire una connessione Amazon Redshift supera questo valore, la connessione è considerata non disponibile. Il timeout è specificato in secondi. Un valore pari a 0 significa che non viene specificato alcun timeout.

Questo parametro è facoltativo.

connectionTimezone

• Valore predefinito: LOCAL

• Tipo di dati: stringa

Il fuso orario a livello di sessione.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

LOCAL

Configura il fuso orario a livello di sessione nel fuso orario LOCAL JVM.

SERVER

Configura il fuso orario a livello di sessione sul fuso orario impostato per l'utente nel server Amazon Redshift. Puoi configurare i fusi orari a livello di sessione per gli utenti con il seguente comando:

ALTER USER
[...]
SET TIMEZONE TO [...];

database MetadataCurrent DbOnly

• Valore predefinito: true

• Tipo di dati: booleano

Questa opzione specifica se l'API dei metadati recupera i dati da tutti i database accessibili o solo dal database connesso.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

true

L'applicazione recupera i metadati da un singolo database.

false

L'applicazione recupera i metadati da tutti i database accessibili.

DbUser

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'ID utente da utilizzare con il proprio account Amazon Redshift. Puoi usare un ID che attualmente non esiste se hai abilitato la AutoCreate proprietà.

Questo parametro è facoltativo.

DbGroups

• Valore predefinito: PUBLIC

• Tipo di dati: stringa

Un elenco separato da virgole di nomi di gruppo di database esistenti che DBUser unisce per la sessione corrente.

Questo parametro è facoltativo.

DBNAME

• Valore predefinito: null

• Tipo di dati: stringa

Il nome del database a cui connettersi. Questa opzione può essere utilizzata per specificare il nome del database nell'URL di connessione JDBC.

Questo parametro è obbligatorio. Il nome del database va specificato nell'URL di connessione o nelle proprietà di connessione dell'applicazione client.

RowFetchdimensione predefinita

• Valore predefinito: 0

• Tipo di dati: numero intero

Questa opzione specifica un valore predefinito per getFetchSize.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

0

Recupera tutte le righe in un'unica operazione.

Numero intero positivo

Numero di righe da recuperare dal database per ogni iterazione di recupero di. ResultSet

DisableIsValidQuery

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione specifica se il driver invia una nuova query di database quando si utilizza il metodo Connection.isValid() per determinare se la connessione al database è attiva.

Questo parametro è facoltativo.

true

Il driver non invia una query quando si utilizza il metodo Connection.isValid() per determinare se la connessione al database è attiva. Ciò potrebbe far sì che il driver identifichi erroneamente la connessione al database come attiva se il server di database si è arrestato in modo imprevisto.

false

Il driver invia una query quando si utilizza il metodo Connection.isValid() per determinare se la connessione al database è attiva.

abilita Buffer FetchRing

• Valore predefinito: true

• Tipo di dati: booleano

Questa opzione specifica che il driver recupera le righe utilizzando un buffer ad anello su un thread separato. Il parametro fetchRingBuffer Size specifica la dimensione del ring buffer.

Se una transazione rileva uno Statement contenente più comandi SQL separati da punto e virgola, il fetch ring buffer per quella transazione è impostato su false. enableFetchRingIl valore del buffer non cambia.

Questo parametro è facoltativo.

abilitare MultiSql Support

• Valore predefinito: true

• Tipo di dati: booleano

Questa opzione specifica se elaborare più comandi SQL separati da punti e virgola in un'istruzione.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

true

Il driver elabora più comandi SQL, separati da punti e virgola, in un oggetto Statement.

false

Il driver restituisce un errore per più comandi SQL in una singola istruzione.

dimensione di recupero RingBuffer

• Valore predefinito: 1G

• Tipo di dati: stringa

Questa opzione specifica la dimensione del buffer ad anello utilizzato durante il recupero del set di risultati. È possibile specificare una dimensione in byte, ad esempio 1K per 1 KB, 5000 per 5.000 byte, 1M per 1 MB, 1G per 1 GB e così via. È inoltre possibile specificare una percentuale di memoria heap. Il driver smette di recuperare le righe al raggiungimento del limite. Il recupero riprende quando l'applicazione legge le righe e libera spazio nel buffer ad anello.

Questo parametro è facoltativo.

ForceLowercase

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione specifica se il driver mette in minuscolo tutti i gruppi di database (DbGroups) inviati dal provider di identità ad Amazon Redshift quando si utilizza l'autenticazione Single Sign-On.

Questo parametro è facoltativo.

true

Il driver converte in minuscolo i nomi di tutti i gruppi di database inviati dal provider di identità.

false

Il driver non modifica i gruppi di database.

groupFederation

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione specifica se utilizzare i gruppi IDP di Amazon Redshift. Questa funzionalità è supportata dall'API V2. GetClusterCredentials

Questo parametro è facoltativo.

true

Utilizzare i gruppi di Identity Provider (IDP) di Amazon Redshift.

false

Utilizza l'API STS e GetClusterCredentials per la federazione degli utenti e specifica esplicitamente DbGroups la connessione.

HOST

• Valore predefinito: null

• Tipo di dati: stringa

Il nome host del server Amazon Redshift a cui connettersi. Questa opzione può essere utilizzata per specificare il nome host nell'URL di connessione JDBC.

Questo parametro è obbligatorio. Il nome host va specificato nell'URL di connessione o nelle proprietà di connessione dell'applicazione client.

IAM DisableCache

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione specifica se le credenziali IAM vengono memorizzate nella cache.

Questo parametro è facoltativo.

true

Le credenziali IAM non sono memorizzate nella cache.

false

Le credenziali IAM sono memorizzate nella cache. Ciò migliora le prestazioni quando le richieste ad API Gateway sono limitate, ad esempio.

IAMDuration

• Valore predefinito: 900

• Tipo di dati: numero intero

Il periodo di tempo, in secondi, fino alla scadenza delle credenziali temporanee IAM.

• Valore minimo: 900

• Valore massimo: 3.600

Questo parametro è facoltativo.

Identity_Namespace

• Valore predefinito: nessuno

• Tipo di dati: stringa

Lo spazio dei nomi di identità da utilizzare durante l'autenticazione tramite. IdpTokenAuthPlugin Consente a Redshift di determinare quale istanza Centro identità IAM utilizzare.

Questo parametro è facoltativo se esiste una sola istanza Centro identità IAM o se è impostato lo spazio dei nomi di identità predefinito. In caso contrario, è obbligatorio.

IdP_Host

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'host IdP (provider di identità) utilizzato per l'autenticazione in Amazon Redshift. Questo può essere specificato nella stringa di connessione o in un profilo.

Questo parametro è facoltativo.

IdP_Port

• Valore predefinito: nessuno

• Tipo di dati: stringa

La porta utilizzata da un IdP (provider di identità). La porta può essere specificata nella stringa di connessione o in un profilo. La porta predefinita è 5439. A seconda della porta selezionata durante la creazione, la modifica o la migrazione del cluster, consenti l'accesso alla porta selezionata.

Questo parametro è facoltativo.

idp_tenant

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'ID tenant di Azure AD per l'applicazione Amazon Redshift.

Questo parametro è obbligatorio se si esegue l'autenticazione tramite il servizio Azure AD.

IdP_Response_Timeout

• Valore predefinito: 120

• Tipo di dati: numero intero

La quantità di tempo, espressa in secondi, per cui il driver attende la risposta SAML dal provider di identità quando si usano i servizi SAML o Azure AD tramite un plug-in del browser.

Questo parametro è facoltativo.

IniFile

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il percorso completo del file .ini, compreso il nome file. Ad esempio:

IniFile="C:\tools\rsjdbc.ini"

Per ulteriori informazioni sul file .ini, consultare Creazione di file di inizializzazione (.ini) per il driver JDBC versione 2.1.

Questo parametro è facoltativo.

IniSection

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome di una sezione nel file .ini contenente le opzioni di configurazione. Per ulteriori informazioni sul file .ini, consultare Creazione di file di inizializzazione (.ini) per il driver JDBC versione 2.1.

Nell'esempio seguente viene specificata la sezione [Prod] del file .ini:

IniSection="Prod"

Questo parametro è facoltativo.

isServerless

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione specifica se l'host endpoint di Amazon Redshift è un'istanza serverless. Il driver prova a rilevare questo parametro dall'host specificato. Se utilizzi un Network Load Balancer (NLB), il driver non riuscirà a rilevarlo, quindi puoi impostarlo qui.

Questo parametro è facoltativo.

true

L'host endpoint di Amazon Redshift è un'istanza serverless.

false

L'host endpoint di Amazon Redshift è un cluster con provisioning.

URL login_

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'URL della risorsa sul sito Web del provider di identità quando si usa SAML o i servizi Azure AD tramite un plug-in del browser.

Questo parametro è obbligatorio se si esegue l'autenticazione con SAML o i servizi Azure AD tramite un plug-in del browser.

loginTimeout

• Valore predefinito: 0

• Tipo di dati: numero intero

Il numero di secondi da attendere prima del timeout durante la connessione e l'autenticazione con il server. Se stabilire la connessione richiede più tempo della soglia prevista, l'operazione viene interrotta.

Quando questa proprietà è impostata su 0, non si verifica il timeout delle connessioni.

Questo parametro è facoltativo.

effettuare il login ToRp

• Valore predefinito: urn:amazon:webservices

• Tipo di dati: stringa

La parte attendibile che si desidera utilizzare per il tipo di autenticazione AD FS.

Questo parametro è facoltativo.

LogLevel

• Valore predefinito: 0

• Tipo di dati: numero intero

Utilizzare questa proprietà per attivare o disattivare la registrazione nel driver e per specificare il livello di dettaglio incluso nei file di log.

Abilitare la registrazione abbastanza a lungo da rilevare un problema. La registrazione riduce le prestazioni e può richiedere una grande quantità di spazio su disco.

Questo parametro è facoltativo.

Impostare il parametro su uno dei seguenti valori:

0

Disabilitare la registrazione.

1

Abilitare la registrazione sul livello FATAL, che registra eventi di errore molto gravi che comportano l'interruzione del driver.

2

Abilitare la registrazione sul livello ERROR, che registra eventi di errore che potrebbero consentire al driver di restare in esecuzione.

3

Abilitare la registrazione sul livello WARNING, che registra eventi che potrebbero causare un errore se non viene eseguita un'azione.

4

Abilitare la registrazione sul livello INFO, che registra informazioni generali che descrivono l'avanzamento del driver.

5

Abilitare la registrazione sul livello DEBUG, che registra informazioni dettagliate utili per il debug del driver.

6

Abilitare la registrazione sul livello TRACE, che registra tutte le attività del driver.

Quando la registrazione è abilitata, il driver produce i seguenti file di log nella posizione specificata nella proprietà LogPath:

• redshift_jdbc.log: file che registra l'attività del driver che non è specifica di una connessione.

• redshift_jdbc_connection_[Number].log: file per ogni connessione effettuata al database, dove [Number] è un numero che distingue ogni file di log dagli altri. Questo file registra l'attività del driver specifica per la connessione.

Se il LogPath valore non è valido, il driver invia le informazioni registrate allo standard output stream,. System.out

LogPath

• Valore predefinito: la directory di lavoro corrente.

• Tipo di dati: stringa

Il percorso completo della cartella in cui il driver salva i file di registro quando la LogLevel proprietà DSI è abilitata.

Per assicurarsi che l'URL di connessione sia compatibile con tutte le applicazioni JDBC, si consiglia di eseguire l'escape sulle barre rovesciate (\) nel percorso del file digitando un'altra barra rovesciata.

Questo parametro è facoltativo.

OverrideSchemaPatternType

• Valore predefinito: null

• Tipo di dati: numero intero

Questa opzione specifica se sovrascrivere il tipo di query utilizzata nelle chiamate getTables.

0

Nessuna query a schema universale

1

Query a schema locale

2

Query a schema esterno

Questo parametro è facoltativo.

Partner_SPID

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il valore SPID (ID del fornitore di servizi) del partner da utilizzare per l'autenticazione della connessione tramite il servizio. PingFederate

Questo parametro è facoltativo.

Password

• Valore predefinito: nessuno

• Tipo di dati: stringa

Quando si esegue la connessione con l'autenticazione IAM tramite un IDP, si tratta della password per il server IDP_Host. Quando si utilizza l'autenticazione standard, questo può essere utilizzato per la password del database Amazon Redshift anziché per PWD.

Questo parametro è facoltativo.

Plugin_Name

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome completo della classe che implementa un plug-in specifico del provider di credenziali.

Questo parametro è facoltativo.

Sono supportate le seguenti opzioni di provider:

• AdfsCredentialsProvider— Servizio Active Directory Federation.

• AzureCredentialsProvider— Servizio Microsoft Azure Active Directory (AD).

• BasicJwtCredentialsProvider— Servizio JSON Web Tokens (JWT).

• BasicSamlCredentialsProvider — Credenziali SAML (Security Assertion Markup Language) che è possibile utilizzare con molti provider di servizi SAML.

• BrowserAzureCredentialsProvider— Browser del servizio Microsoft Azure Active Directory (AD).

• BrowserAzureOAuth2CredentialsProvider— Browser Microsoft Azure Active Directory (AD) Service per l'autenticazione nativa.

• BrowserSamlCredentialsProvider— Browser SAML per servizi SAML come Okta, Ping o ADFS.

• IdpTokenAuthPlugin— Un plug-in di autorizzazione che accetta un token IAM Identity Center o token di identità (JWT) basati su JSON OpenID Connect (OIDC) da qualsiasi provider di identità Web collegato a IAM Identity Center.

• OktaCredentialsProvider— Servizio Okta.

• PingCredentialsProvider— PingFederate Assistenza.

PORT

• Valore predefinito: null

• Tipo di dati: numero intero

La porta del server Amazon Redshift a cui connettersi. Questa opzione può essere utilizzata per specificare la porta nell'URL di connessione JDBC.

Questo parametro è facoltativo.

preferred_role

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il ruolo IAM che si desidera assumere durante la connessione ad Amazon Redshift.

Questo parametro è facoltativo.

Profilo

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome del profilo da utilizzare per l'autenticazione IAM. Questo profilo contiene eventuali proprietà di connessione aggiuntive non specificate nella stringa di connessione.

Questo parametro è facoltativo.

PWD

• Valore predefinito: nessuno

• Tipo di dati: stringa

La password corrispondente al nome utente Amazon Redshift che fornita utilizzando l'UID della proprietà.

Questo parametro è facoltativo.

queryGroup

• Valore predefinito: null

• Tipo di dati: stringa

Questa opzione assegna una query a una coda in fase di runtime assegnando la query al gruppo di query appropriato. Il gruppo di query viene impostato per la sessione. Tutte le query eseguite sulla connessione appartengono a questo gruppo di query.

Questo parametro è facoltativo.

readOnly

• Valore predefinito: false

• Tipo di dati: booleano

Questa proprietà specifica se il driver è in modalità di sola lettura.

Questo parametro è facoltativo.

true

La connessione è in modalità di sola lettura e non può scrivere nell'archivio dati.

false

La connessione non è in modalità di sola lettura e può scrivere nell'archivio dati.

Regione

• Valore predefinito: null

• Tipo di dati: stringa

Questa opzione specifica la AWS regione in cui si trova il cluster. Se si specifica l' StsEndPoint opzione, l'opzione Regione viene ignorata. L'API GetClusterCredentials Redshift utilizza anche l'opzione Regione.

Questo parametro è facoltativo.

Inserti rossi WriteBatched

• Valore predefinito: false

• Tipo di dati: booleano

Questa opzione abilita l'ottimizzazione per riscrivere e combinare istruzioni INSERT compatibili in batch.

Questo parametro è facoltativo.

re WriteBatched InsertsSize

• Valore predefinito: 128

• Tipo di dati: numero intero

Questa opzione abilita l'ottimizzazione per riscrivere e combinare istruzioni INSERT compatibili in batch. Questo valore deve aumentare esponenzialmente con potenza 2.

Questo parametro è facoltativo.

roleArn

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'Amazon Resource Name (ARN) del ruolo. Assicuratevi di specificare questo parametro quando BasicJwtCredentialsProvider specificate l'opzione Plugin_Name. Specificare l'ARN nel seguente formato:

arn:partition:service:region:account-id:resource-id

Questo parametro è obbligatorio se specificate l'opzione BasicJwtCredentialsProvider Plugin_Name.

ruolo SessionName

• Valore predefinito: jwt_redshift_session

• Tipo di dati: stringa

Un identificatore della sessione del ruolo assunto. In genere, si passa il nome o l'identificatore associato all'utente dell'applicazione. Le credenziali di sicurezza temporanee utilizzate dall'applicazione sono associate a tale utente. È possibile specificare questo parametro quando si specifica BasicJwtCredentialsProvider l'opzione Plugin_Name.

Questo parametro è facoltativo.

scope

• Valore predefinito: nessuno

• Tipo di dati: stringa

Un elenco separato da spazi contenente ambiti ai quali l'utente può acconsentire. È possibile specificare questo parametro in modo che l'applicazione Microsoft Azure possa ottenere il consenso per le API che si desidera chiamare. È possibile specificare questo parametro quando si specifica BrowserAzure OAuth2 CredentialsProvider per l'opzione Plugin_Name.

Questo parametro è obbligatorio per il plug-in OAuth2. BrowserAzure CredentialsProvider

SecretAccessChiave

• Valore predefinito: nessuno

• Tipo di dati: stringa

La chiave di accesso IAM per l'utente o il ruolo. Se viene specificato, è necessario specificare anche l' AccessKeyID. Se passato nell'URL JDBC, SecretAccessKey deve essere codificato come URL.

Questo parametro è facoltativo.

SessionToken

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il token di sessione IAM temporaneo associato al ruolo IAM utilizzato per l'autenticazione. Se passato nell'URL JDBC, il token di sessione IAM temporaneo deve essere con codifica URL.

Questo parametro è facoltativo.

senza server AcctId

• Valore predefinito: null

• Tipo di dati: stringa

L'ID account di Amazon Redshift Serverless. Il driver prova a rilevare questo parametro dall'host specificato. Se utilizzi un Network Load Balancer (NLB), il driver non riuscirà a rilevarlo, quindi puoi impostarlo qui.

Questo parametro è facoltativo.

senza server WorkGroup

• Valore predefinito: null

• Tipo di dati: stringa

Il nome del gruppo di lavoro di Amazon Redshift Serverless. Il driver prova a rilevare questo parametro dall'host specificato. Se utilizzi un Network Load Balancer (NLB), il driver non riuscirà a rilevarlo, quindi puoi impostarlo qui.

Questo parametro è facoltativo.

socketFactory

• Valore predefinito: null

• Tipo di dati: stringa

Questa opzione specifica una factory di socket per la creazione di socket.

Questo parametro è facoltativo.

socketTimeout

• Valore predefinito: 0

• Tipo di dati: numero intero

Il numero di secondi da attendere durante le operazioni di lettura del connettore prima del timeout. Se un'operazione richiede più tempo della soglia prevista, la connessione viene chiusa. Quando questa proprietà è impostata su 0, non si verifica il timeout della connessione.

Questo parametro è facoltativo.

SSL

• Valore predefinito: TRUE

• Tipo di dati: stringa

Utilizzare questa proprietà per attivare o disattivare SSL per la connessione.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

TRUE

Il driver si connette al server tramite SSL.

FALSE

Il driver si connette al server senza utilizzare SSL. Questa opzione non è supportata con l'autenticazione IAM.

In alternativa, è possibile configurare la AuthMech proprietà.

ssl_insecure

• Valore predefinito: true

• Tipo di dati: stringa

Questa proprietà indica se il certificato del server host IDP deve essere verificato.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

true

Il driver non controlla l'autenticità del certificato del server IDP.

false

Il driver controlla l'autenticità del certificato del server IDP.

SSLCert

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il percorso completo di un file .pem o .crt contenente ulteriori certificati emessi da una CA attendibili per verificare l'istanza del server Amazon Redshift quando si utilizza SSL.

Questo parametro è richiesto se è specificato SSLKey.

SSLFactory

• Valore predefinito: nessuno

• Tipo di dati: stringa

L'SSL factory da utilizzare per la connessione al server tramite TLS/SSL senza utilizzare un certificato server.

SSLKey

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il percorso completo del file con estensione .der contenente il file di chiave PKCS8 per la verifica dei certificati specificati in SSLCert.

Questo parametro è richiesto se è specificato SSLCert.

SSLMode

• Valore predefinito: verify-ca

• Tipo di dati: stringa

Utilizzare questa proprietà per specificare il modo in cui il driver convalida i certificati quando TLS/SSL è abilitato.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

verify-ca

Il driver verifica che il certificato proviene da una certification authority (CA) attendibile.

verify-full

Il driver verifica che il certificato proviene da una CA attendibile e che il nome host nel certificato corrisponde al nome host specificato nell'URL di connessione.

SSLPassword

• Valore predefinito: 0

• Tipo di dati: stringa

La password per il file della chiave crittografata specificato in SSLKey.

Questo parametro è obbligatorio se viene specificato SSLKey e il file della chiave è crittografato.

SSL RootCert

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il percorso completo di un file .pem o .crt contenente ulteriori certificati emessi da una CA attendibili per verificare l'istanza del server Amazon Redshift quando si utilizza SSL.

StsEndpointUrl

• Valore predefinito: null

• Tipo di dati: stringa

È possibile specificare un endpoint AWS Security Token Service (AWS STS). Se si specifica questa opzione, l'opzione Regione viene ignorata. Per questo endpoint è possibile specificare solo un protocollo sicuro (HTTPS).

tcp KeepAlive

• Valore predefinito: TRUE

• Tipo di dati: stringa

Utilizzare questa proprietà per attivare o disattivare i keepalive TCP.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

TRUE

Il driver utilizza i keepalive TCP al fine di impedire il timeout delle connessioni.

FALSE

Il driver non utilizza keepalive TCP.

token

• Valore predefinito: nessuno

• Tipo di dati: stringa

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

Questo parametro funziona con. IdpTokenAuthPlugin

token_type

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il tipo di token che viene utilizzato in. IdpTokenAuthPlugin

Puoi specificare le seguenti valori:

ACCESS_TOKEN

Inserisci questo valore se utilizzi un token di accesso fornito da IAM Identity Center.

EXT_JWT

Inserisci questo valore se utilizzi un JSON Web Token (JWT) OpenID Connect (OIDC) fornito da un provider di identità basato sul Web integrato con IAM Identity Center.

Questo parametro funziona con. IdpTokenAuthPlugin

UID

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il nome utente del database utilizzato per accedere al database.

Questo parametro è obbligatorio.

Utente

• Valore predefinito: nessuno

• Tipo di dati: stringa

Quando ci si connette con l'autenticazione IAM tramite un IDP, questo è il nome utente per il server idp_host. Quando si utilizza l'autenticazione standard, può essere usato per il nome utente del database di Amazon Redshift.

Questo parametro è facoltativo.

web IdentityToken

• Valore predefinito: nessuno

• Tipo di dati: stringa

Il token di accesso OAuth 2.1 o un token ID OpenID Connect fornito dal provider di identità. L'applicazione deve ottenere questo token autenticando l'utente dell'applicazione con un provider di identità Web. Assicuratevi di specificare questo parametro quando BasicJwtCredentialsProvider specificate l'opzione Plugin_Name.

Questo parametro è obbligatorio se specificate l'opzione BasicJwtCredentialsProvider Plugin_Name.