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

Opzioni per la configurazione del JDBC driver versione 2.1

Di seguito, puoi trovare le descrizioni delle opzioni che puoi specificare per la versione 2.1 del driver Amazon RedshiftJDBC. Le opzioni di configurazione non fanno distinzione tra maiuscole e minuscole.

Puoi impostare le proprietà di configurazione utilizzando la connessione. URL Per ulteriori informazioni, consulta Creazione della connessione URL.

AccessKeyID

È possibile specificare questo parametro per inserire la chiave di IAM accesso 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 JDBCURL, l' AccessKeyID deve essere URL codificato.

Questo parametro è facoltativo.

Un llowDBUser override

Questa opzione specifica se il driver utilizza il DbUser valore dell'SAMLasserzione o il valore specificato nella proprietà di DbUser connessione nella connessione. URL

Questo parametro è facoltativo.

App_ID

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

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

Questo parametro è facoltativo.

ApplicationName

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

Questo parametro è facoltativo.

AuthProfile

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

Questo parametro è facoltativo.

AutoCreate

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

Questo parametro è facoltativo.

Client_ID

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

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

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 ti connetti tramiteIAM, il driver non riuscirà a rilevarlo, quindi puoi impostarlo utilizzando questa opzione di connessione.

Questo parametro è facoltativo.

Compressione

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:

connectTimeout

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

Il fuso orario a livello di sessione.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

databaseMetadataCurrentDbOnly

Questa opzione specifica se i metadati API recuperano i dati da tutti i database accessibili o solo dal database connesso.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

DbUser

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

Questo parametro è facoltativo.

DbGroups

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

Questo parametro è facoltativo.

DBNAME

Il nome del database a cui connettersi. È possibile utilizzare questa opzione per specificare il nome del database nella JDBC connessioneURL.

Questo parametro è obbligatorio. È necessario specificare il nome del database nella connessione URL o nelle proprietà di connessione dell'applicazione client.

defaultRowFetchDimensioni

Questa opzione specifica un valore predefinito per getFetchSize.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

DisableIsValidQuery

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

Questo parametro è facoltativo.

enableFetchRingBuffer

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 buffer ad anello.

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

Questo parametro è facoltativo.

enableMultiSqlSupport

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

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

fetchRingBufferDimensioni

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

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.

groupFederation

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

Questo parametro è facoltativo.

HOST

Il nome host del server Amazon Redshift a cui connettersi. È possibile utilizzare questa opzione per specificare il nome host nella JDBC connessione. URL

Questo parametro è obbligatorio. È necessario specificare il nome host nella connessione URL o nelle proprietà di connessione dell'applicazione client.

IAMDisableCache

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

Questo parametro è facoltativo.

IAMDuration

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

Questo parametro è facoltativo.

Idc_Client_Display_Name

Il nome visualizzato da utilizzare per il client che sta utilizzando BrowserIdcAuthPlugin.

Questo parametro è facoltativo.

Idc_Region

La AWS regione in cui si trova l'istanza di IAM Identity Center.

Questo parametro è richiesto solo quando si esegue l'autenticazione utilizzando BrowserIdcAuthPlugin l'opzione di configurazione plugin_name.

IdP_Host

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

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

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

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

Questo parametro è facoltativo.

IniFile

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 la versione 2.1 del driver JDBC.

Questo parametro è facoltativo.

IniSection

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 la versione 2.1 del driver JDBC.

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

IniSection="Prod"

Questo parametro è facoltativo.

isServerless

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.

Issuer_Url

Punta all'endpoint dell' AWS IAMistanza del server Identity Center.

Questo parametro è richiesto solo quando si esegue l'autenticazione utilizzando BrowserIdcAuthPlugin l'opzione di configurazione plugin_name.

Listen_Port

La porta utilizzata dal driver per ricevere la SAML risposta dal provider di identità o dal codice di autorizzazione quando si usano SAML i servizi Azure AD o AWS Identity Center tramite un plug-in del browser.

Questo parametro è facoltativo.

Accedi_ URL

Il URL per la risorsa sul sito Web del provider di identità quando si utilizzano i servizi Azure AD SAML o Azure tramite un plug-in del browser.

Questo parametro è necessario se ci si autentica con i servizi SAML o con Azure AD tramite un plug-in del browser.

loginTimeout

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.

loginToRp

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

Questo parametro è facoltativo.

LogLevel

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:

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

Se il LogPath valore non è valido, il driver invia le informazioni registrate al flusso di output standard,. System.out

LogPath

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

Per essere sicuri che la connessione URL sia compatibile con tutte le JDBC applicazioni, si consiglia di evitare le barre rovesciate (\) presenti nel percorso del file digitando un'altra barra rovesciata.

Questo parametro è facoltativo.

OverrideSchemaPatternType

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

Questo parametro è facoltativo.

Partner_ SPID

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

Questo parametro è facoltativo.

Password

Quando ci si connette utilizzando IAM l'autenticazione tramite unIDP, questa è la password per il server IDP _Host. Quando si utilizza l'autenticazione standard, questa può essere utilizzata anziché per la password del database Amazon Redshift. PWD

Questo parametro è facoltativo.

Plugin_Name

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:

PORT

La porta del server Amazon Redshift a cui connettersi. È possibile utilizzare questa opzione per specificare la porta nella JDBC connessioneURL.

Questo parametro è facoltativo.

preferred_role

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

Questo parametro è facoltativo.

Profilo

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

Questo parametro è facoltativo.

PWD

La password corrispondente al nome utente Amazon Redshift che hai fornito utilizzando la proprietà. UID

Questo parametro è facoltativo.

queryGroup

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

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

Questo parametro è facoltativo.

Regione

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

Questo parametro è facoltativo.

reWriteBatchedInserti

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

Questo parametro è facoltativo.

reWriteBatchedInsertsSize

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

Questo parametro è facoltativo.

roleArn

L'Amazon Resource Name (ARN) del ruolo. Assicurati di specificare questo parametro quando specifichi BasicJwtCredentialsProvider l'opzione Plugin_Name. Specificate il ARN nel seguente formato:

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

Questo parametro è obbligatorio se si specifica BasicJwtCredentialsProvider l'opzione Plugin_Name.

roleSessionName

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 l'opzione BasicJwtCredentialsProvider Plugin_Name.

Questo parametro è facoltativo.

scope

Un elenco separato da spazi contenente ambiti ai quali l'utente può acconsentire. Specificate questo parametro in modo che l'applicazione Microsoft Azure possa ottenere il consenso per la chiamata APIs che desiderate chiamare. È possibile specificare questo parametro quando si specifica BrowserAzure OAuth2CredentialsProvider l'opzione Plugin_Name.

Questo parametro è obbligatorio per il plug-in. BrowserAzure OAuth2CredentialsProvider

SecretAccessKey

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

Questo parametro è facoltativo.

SessionToken

Il token di IAM sessione temporaneo associato al IAM ruolo che stai utilizzando per l'autenticazione. Se passato in JDBCURL, il token di IAM sessione temporaneo deve essere URL codificato.

Questo parametro è facoltativo.

serverlessAcctId

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.

serverlessWorkGroup

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

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

Questo parametro è facoltativo.

socketTimeout

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

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

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

In alternativa, è possibile configurare la AuthMech proprietà.

SSL_Non sicuro

Questa proprietà indica se il certificato del server dell'IDPhost deve essere verificato.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

SSLCert

Il percorso completo di un file .pem o .crt contenente certificati CA affidabili aggiuntivi per la verifica dell'istanza del server Amazon Redshift durante l'uso. SSL

Questo parametro è obbligatorio se specificato. SSLKey

SSLFactory

La SSL fabbrica da utilizzare quando ci si connette al server tramiteTLS/SSLsenza utilizzare un certificato del server.

SSLKey

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

Questo parametro è obbligatorio se SSLCert specificato.

SSLMode

Utilizzare questa proprietà per specificare in che modo il driver convalida i certificati quandoTLS/SSLè abilitato.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

SSLPassword

La password per il file di chiave crittografato specificato inSSLKey.

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

SSLRootCert

Il percorso completo di un file .pem o .crt contenente il certificato CA root per la verifica dell'istanza di Amazon Redshift Server durante l'utilizzo. SSL

StsEndpointUrl

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

tcpKeepAlive

Usa questa proprietà per attivare o disattivare TCP keepalive.

Questo parametro è facoltativo.

Puoi specificare le seguenti valori:

token

Un token di accesso fornito da AWS IAM Identity Center o un token JSON Web OpenID Connect (OIDCJWT) fornito da un provider di identità Web collegato a AWS IAM Identity Center. L'applicazione deve generare questo token autenticando l'utente dell'applicazione con AWS IAM Identity Center o un provider di identità collegato a Identity Center. 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

UID

Il nome utente del database utilizzato per accedere al database.

Questo parametro è obbligatorio.

Utente

Quando ci si connette utilizzando IAM l'autenticazione tramite unIDP, questo è il nome utente del server idp_host. Quando si utilizza l'autenticazione standard, questa può essere utilizzata per il nome utente del database Amazon Redshift.

Questo parametro è facoltativo.

webIdentityToken

Il token di accesso OAuth 2.1 o token OpenID Connect ID 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.