View a markdown version of this page

Accesso ad Aurora SQL 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 SQL con i client PostgreSQL-compatible

Aurora DSQL utilizza il protocollo wire PostgreSQL. Puoi connetterti a PostgreSQL utilizzando una varietà di strumenti e client, AWS CloudShell come psql, DBeaver e. 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 il valore predefinito 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 ulteriori informazioni, consulta 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 fallisce 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 esterni a 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 qualsiasi di questi parametri per la durata di una singola transazione. Consente RESET 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 durante il 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 archivia internamente tutte le date e le ore in base al fuso orario in UTC. Questo parametro controlla il modo in cui Aurora DSQL visualizza 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 bitmap-scan.
enable_hashjoin Pianificatore di query 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 dei tipi di piano index-only-scan.
enable_indexscan Pianificatore di query Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano di scansione dell'indice.
enable_material Pianificatore di query Abilita o disabilita l'uso della materializzazione da parte del pianificatore di query.
enable_mergejoin Pianificatore di query Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano merge-join.
enable_nestloop Pianificatore di query Abilita o disabilita l'uso dei piani di join nested-loop da parte del pianificatore di query.
enable_seqscan Pianificatore di query Abilita o disabilita l'uso da parte del pianificatore di query dei tipi di piano di scansione sequenziale.
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 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 transazione.

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 applica i propri limiti di durata delle transazioni, tra cui, statement_timeout e. 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 di transazione: Aurora DSQL utilizza un livello di REPEATABLE READ isolamento fisso per tutte le transazioni. Se il driver richiede di specificare un livello di isolamento, usa. BEGIN ISOLATION LEVEL REPEATABLE READ

Accedi ad Aurora DSQL 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 con o la riga di comando locale, oltre a strumenti come GUI-based DBeaver e. 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 e fornire un nuovo token di autenticazione 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.