View a markdown version of this page

Accesso ad Aurora DSQL con i client PostgreSQL-compatible - Amazon Aurora DSQL
Parametri della sessioneClient SQLRisoluzione dei problemi

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

Accesso ad Aurora DSQL con i client PostgreSQL-compatible

Aurora DSQL utilizza il protocollo cablato PostgreSQL. Puoi connetterti a PostgreSQL utilizzando una varietà di strumenti e client, come psql, DBeaver e. AWS CloudShell DataGrip La tabella seguente riassume il modo in cui Aurora DSQL mappa i parametri di connessione PostgreSQL comuni:

PostgreSQL Aurora DSQL Note
Ruolo (noto anche come Utente o Gruppo) Ruolo di database Aurora DSQL crea un ruolo denominato admin. Quando si creano ruoli di database personalizzati, è necessario utilizzare il ruolo admin per associarli ai ruoli IAM per l’autenticazione durante la connessione al cluster. Per ulteriori informazioni, consulta Utilizzo dei ruoli del database e dell’autenticazione IAM.
Host (noto anche come hostname o hostspec) Endpoint del cluster I cluster Aurora DSQL a Regione singola forniscono un unico endpoint gestito e reindirizzano automaticamente il traffico in caso di indisponibilità all’interno della Regione.
Porta N/A — usa default 5432 Questa è l’impostazione predefinita di PostgreSQL.
Database (dbname) Utilizza postgres Aurora DSQL crea questo database alla creazione del cluster.
Modalità SSL SSL è sempre abilitato lato server Aurora DSQL supporta la modalità SSL require. Le connessioni senza SSL vengono rifiutate da Aurora DSQL.
Password Token di autenticazione Aurora DSQL richiede token di autenticazione temporanei anziché password di lunga durata. Per maggiori informazioni, consultare Generazione di un token di autenticazione in Amazon Aurora DSQL.

Durante la connessione, Aurora DSQL richiede un token di autenticazione IAM firmato al posto di una password tradizionale. Questi token temporanei vengono generati utilizzando la versione 4 di AWS Signature e vengono utilizzati solo durante la creazione della connessione. Una volta connessa, la sessione rimane attiva fino al termine o alla disconnessione del client.

Se si tenta di aprire una nuova sessione con un token scaduto, la richiesta di connessione ha esito negativo e deve essere generato un nuovo token. Per ulteriori informazioni, consulta Generazione di un token di autenticazione in Amazon Aurora DSQL.

Parametri di sessione supportati

Aurora DSQL ottimizza automaticamente l'archiviazione, la gestione delle connessioni e l'elaborazione delle transazioni, quindi supporta un set mirato di parametri di sessione. Aurora DSQL accetta i parametri elencati nella tabella seguente. I parametri al di fuori di questo set restituiscono il seguente errore:

ERROR: setting configuration parameter "parameter_name" not supported

Aurora DSQL supporta i seguenti parametri di sessione PostgreSQL. Salvo diversa indicazione, è possibile impostarli utilizzando SETSET SESSION, o come opzioni della stringa di connessione. È inoltre possibile utilizzare SET LOCAL per impostare uno di questi parametri per la durata di una singola transazione. RESETConsente di ripristinare il valore predefinito di un parametro.

Parametri di sessione supportati
Parametro Categoria Description
application_name Identificazione del cliente Imposta il nome dell'applicazione riportato nei metadati di connessione. Utile per identificare le connessioni nel monitoraggio.
client_encoding Localizzazione Imposta la codifica dei caratteri sul lato client. Il database utilizza internamente. UTF-8
datestyle Formattazione dell'output Imposta il formato di visualizzazione per i valori di data e ora (ad esempio,ISO, MDY).
extra_float_digits Formattazione dell'output Imposta il numero di cifre visualizzate per i valori del punto variabile. Alcuni driver, come JDBC, utilizzano questo parametro.
intervalstyle Formattazione dell'output Imposta il formato del display per i valori dell'intervallo.
timezone Localizzazione Imposta il fuso orario della sessione. Aurora DSQL memorizza tutte le date e le ore che riconoscono il fuso orario internamente in UTC. Questo parametro controlla il modo in cui Aurora DSQL mostra i valori al client.
search_path Risoluzione dello schema Imposta l'ordine di ricerca dello schema per i nomi di oggetti non qualificati.
enable_bitmapscan Pianificatore di interrogazioni Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano di scansione bitmap.
enable_hashjoin Pianificatore di interrogazioni Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano hash-join.
enable_indexonlyscan Pianificatore di query Abilita o disabilita l'uso da parte del pianificatore di query di tipi di piano di scansione solo indicizzati.
enable_indexscan Pianificatore di interrogazioni Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano di scansione dell'indice.
enable_material Pianificatore di interrogazioni Abilita o disabilita l'uso della materializzazione da parte del pianificatore di query.
enable_mergejoin Query planner Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano merge-join.
enable_nestloop Pianificatore di interrogazioni Abilita o disabilita l'uso da parte del pianificatore di query dei piani di join a ciclo annidato.
dsql.enable_batched_nestloop Pianificatore di query Abilita o disabilita l'uso da parte del pianificatore di query di piani di join a ciclo annidato in batch.
enable_seqscan Pianificatore di interrogazioni Abilita o disabilita l'uso da parte del pianificatore di query di tipi di piani di scansione sequenziali.
disable_sync_create_index Aurora DSQL-specific Controlla se CREATE INDEX viene eseguito in modo asincrono. L'impostazione predefinita èon, il che significa che Aurora DSQL crea gli indici in modo asincrono. Impostato su per creare indici in modo sincrono su tabelle off vuote.
role Identità della sessione Imposta il ruolo corrente. In Aurora DSQL, è possibile impostare questo parametro solo SET LOCAL all'interno di un blocco di transazioni.

Aurora DSQL gestisce automaticamente i seguenti aspetti del database, quindi non è necessario configurare i parametri di sessione PostgreSQL corrispondenti:

  • Parametri di connessione e rete: Aurora DSQL gestisce internamente il ciclo di vita della connessione e le impostazioni TCP, tra cui, e. tcp_keepalives_idle tcp_keepalives_interval tcp_keepalives_count

  • Parametri di memoria e risorse: Aurora DSQL gestisce automaticamente l'allocazione della memoria, inclusi e. work_mem shared_buffers

  • Parametri di timeout: Aurora DSQL impone i propri limiti di durata delle transazioni, tra cui, e. statement_timeout lock_timeout idle_in_transaction_session_timeout

  • Parametri di replica e WAL: Aurora DSQL gestisce la replica automaticamente tramite la sua architettura multiregionale integrata, tra cui e. wal_level synchronous_commit

  • Parametri di registrazione: Aurora DSQL gestisce la registrazione internamente, inclusi e. log_statement client_min_messages

  • Parametri delle transazioni: Aurora DSQL utilizza un livello di isolamento fisso per tutte le transazioni. REPEATABLE READ Se il driver richiede di specificare un livello di isolamento, utilizzare. BEGIN ISOLATION LEVEL REPEATABLE READ

Accedere ad Aurora SQL utilizzando client SQL

Aurora DSQL supporta più PostgreSQL-compatible client per la connessione al cluster. Le sezioni seguenti descrivono come connettersi utilizzando PostgreSQL AWS CloudShell o la riga di comando locale, oltre a strumenti come DBeaver e. GUI-based JetBrains DataGrip Ogni client richiede un token di autenticazione valido come descritto nella sezione precedente.

Argomenti

Risoluzione dei problemi

Scadenza delle credenziali di autenticazione per i client SQL

Le sessioni stabilite rimangono autenticate per un massimo di 1 ora o fino alla disconnessione esplicita o un timeout impostato lato client. Se è necessario stabilire nuove connessioni, è necessario generare un nuovo token di autenticazione che deve essere fornito nel campo Password della connessione. Il tentativo di aprire una nuova sessione (ad esempio, per elencare nuove tabelle o aprire una nuova console SQL) impone un nuovo tentativo di autenticazione. Se il token di autenticazione configurato nelle impostazioni della Connessione non è più valido, la nuova sessione fallisce e tutte le sessioni aperte in precedenza vengono invalidate. Tienilo a mente quando scegli la durata del token di autenticazione IAM con l'expires-inopzione, che può essere impostata su 15 minuti per impostazione predefinita e può essere impostata su un valore massimo di sette giorni.

Inoltre, consulta la sezione Risoluzione dei problemi della documentazione di Aurora DSQL.