Configura le estensioni PostgreSQL

Puoi estendere PostgreSQL raggruppando gli oggetti SQL in un pacchetto e utilizzandoli come unità. Questa pagina contiene informazioni sulla configurazione di PostgreSQL supportate da Cloud SQL.

Utilizza le estensioni PostgreSQL

Puoi installare solo le estensioni supportate da Cloud SQL. Per maggiori informazioni, consulta la pagina relativa alle estensioni PostgreSQL supportate da Cloud SQL.

Installare un'estensione

Prima di utilizzare un'estensione, installala:

Requisito per i privilegi di super user

In Cloud SQL, le estensioni possono essere create solo dagli utenti che fanno parte del Ruolo cloudsqlsuperuser. Quando crei una nuova istanza PostgreSQL, l'utente postgres predefinito viene creato per te (anche se deve impostare la password dell'utente). L'utente predefinito di postgres fa parte di Ruolo cloudsqlsuperuser. Per ulteriori informazioni, vedi Informazioni sugli utenti PostgreSQL.

Connessioni tra database

Le istanze di destinazione per le connessioni devono trovarsi nella stessa rete VPC dell'istanza di connessione.

Per le istanze del cluster, non puoi scegliere l'opzione Richiedi certificati client attendibili nella Console Google Cloud. Inoltre, per connetterti ai database nella stessa istanza, non puoi impostare l'host su localhost o a 127.0.0.1. Devi utilizzare l'indirizzo IP visualizzato per la tua istanza nella console Google Cloud.

Richiedi assistenza per una nuova estensione

Non puoi creare estensioni personalizzate in Cloud SQL.

Per richiedere assistenza per un'estensione, fai clic su +1 sul problema aperto o crea un nuovo problema. Per un elenco dei problemi aperti di Cloud SQL e per informazioni su la creazione di nuovi problemi, consulta Cerca o crea problemi e richieste di funzionalità per prodotto.

Estensioni PostgreSQL supportate da Cloud SQL

Per informazioni sull'utilizzo di un'estensione specifica, consulta il link alla documentazione in una delle tabelle riportate di seguito.

Il supporto di Cloud SQL per le estensioni PostgreSQL può essere suddiviso nelle seguenti categorie:

PostGIS

L'estensione PostGIS è supportata per Cloud SQL per PostgreSQL per tutte le versioni principali.

La tabella seguente contiene le versioni dell'estensione PostGIS per ogni versione di Cloud SQL per PostgreSQL:

Versione Cloud SQL per PostgreSQL Estensione PostGIS
PostgreSQL 9.6 3.2.5
PostgreSQL 10 3.2.5
PostgreSQL 11 3.2.5
PostgreSQL 12 3.2.5
PostgreSQL 13 3.4.0
PostgreSQL 14 3.4.0
PostgreSQL 15 3.4.0
PostgreSQL 16 3.4.0

Per una specifica versione principale di PostgreSQL, nel CREA ESTENSIONE, puoi specifica una versione dell'estensione PostGIS utilizzando la clausola VERSION.

L'estensione PostGIS include quanto segue:

Per ulteriori informazioni, vedi Installazione di PostGIS.

Inoltre, Cloud SQL per PostgreSQL include la versione 3.3.0 dell'estensione pgRouting, che estende PostGIS. L'estensione pgRouting migliora l'elaborazione geospaziale tramite il routing e l'analisi della rete.

Puoi eseguire l'upgrade di PostGIS e delle relative estensioni alla versione più recente manualmente. Per scoprire di più sull'upgrade delle estensioni PostGIS, consulta Upgrade di PostGIS.

Estensioni dei tipi di dati

Estensione Descrizione
btree_gin Fornisce classi di operatori GIN di esempio che implementano un comportamento equivalente all'albero B.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.0. PostgreSQL 10 utilizza la versione 1.2. Tutte le altre versioni usano la versione 1.3.
btree_gist Fornisce classi di operatori dell'indice GiST che implementano l'equivalente B-tree comportamento degli utenti.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.2. PostgreSQL 10, 11, 12 e 13 utilizzano la versione 1.5. PostgreSQL 14 utilizza la versione 1.6.
chkpass Implementa un tipo di dati chkpass progettato per memorizzare le password criptate.
Cloud SQL per PostgreSQL 9.6 e 10 utilizza la versione 1.0. Non supportato per altre versioni.
testo Fornisce un tipo di stringa di caratteri citext non sensibile alle maiuscole.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.3. PostgreSQL 10 utilizza la versione 1.4. PostgreSQL 11 utilizza la versione 1.5. PostgreSQL 12, 13 e 14 utilizzano la versione 1.6.
cubo Implementa un tipo di dati cube per la rappresentazione di cubi multidimensionali.
Cloud SQL per PostgreSQL 9.6 e 10 utilizzano la versione 1.2. PostgreSQL 11 utilizza la versione 1.3. PostgreSQL 12 e 13 utilizzano la versione 1.4. PostgreSQL 14 utilizza la versione 1.5.
hstore Implementa il tipo di dati hstore per l'archiviazione di set di coppie chiave/valore all'interno di un singolo valore PostgreSQL.
Cloud SQL per PostgreSQL 9.6 e 10 utilizzano la versione 1.4. PostgreSQL 11 utilizza la versione 1.5. PostgreSQL 12 utilizza la versione 1.6. PostgreSQL 13 utilizza la versione 1.7. PostgreSQL 14 utilizza la versione 1.8.
isn Fornisce tipi di dati per alcuni standard internazionali di numerazione dei prodotti.
Cloud SQL per PostgreSQL 9.6 e 10 utilizza la versione 1.1. Tutte le altre versioni utilizzano la versione 1.2.
IP4R Fornisce tipi di dati per indirizzi e intervalli di indirizzi IPv4/v6, oltre il supporto dell'indice.
Cloud SQL per PostgreSQL utilizza la versione 2.4.2.
ltree Implementa un tipo di dati ltree per la rappresentazione delle etichette dei dati in una struttura gerarchica ad albero.
Cloud SQL per PostgreSQL 9.6, 10, 11 e 12 utilizza la versione 1.1. PostgreSQL 13 e 14 utilizzano la versione 1.2.
lo Supporto per la gestione di oggetti di grandi dimensioni (chiamati anche LO o BLOB).
Cloud SQL per PostgreSQL utilizza la versione 1.1.
postgresql-hll Viene introdotto un nuovo tipo di dati, hll, che è una struttura di dati HyperLogLog. Consulta anche postgresql-hll in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 2.16.
prefisso Fornisce la corrispondenza del prefisso, oltre al supporto dell'indice.
Cloud SQL per PostgreSQL utilizza la versione 1.2.0.

Estensioni di lingua

Estensione Descrizione
plpgsql Un linguaggio procedurale caricabile per la creazione di funzioni, procedure e trigger. Puoi anche utilizzare questo linguaggio per l'esecuzione diretta del codice nei blocchi DO.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
plv8 Fornisce un linguaggio procedurale per l'attivazione di JavaScript.
Cloud SQL per PostgreSQL utilizza la versione 3.2.2, che a sua volta utilizza il motore JavaScript V8 nella versione 11.5.

Estensioni varie

Estensione Descrizione
amcheck Fornisce funzioni per verificare la coerenza logica della struttura delle relazioni, consentendo all'applicazione pg_amcheck di verificare la presenza di danneggiamenti.
auto_explain Consente il logging automatico dei piani di esecuzione delle istruzioni lente per la risoluzione dei problemi e altro ancora. Offre un modo automatizzato per eseguire delle funzionalità EXPLAIN. Vedi anche auto_explain in questo documento.
autoinc Fornisce funzioni per incrementare automaticamente i campi. Questo attivatore memorizza il valore successivo di una sequenza in un campo di tipo intero.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
sfumatura di rosa Fornisce un metodo per accedere agli indici in base ai filtri Bloom. Un filtro di fiori è una struttura di dati efficiente in termini di spazio che puoi utilizzare per verificare se un elemento è membro di un insieme.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
dblink Fornisce funzioni per connettersi ai database PostgreSQL dall'interno di una sessione di database. Vedi anche dblink in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
decoderbufs un decoder logico PostgreSQL che fornisce i dati di output come protocollo Buffer, adattati per Debezium.
dict_int Un modello di dizionario aggiuntivo per la ricerca a testo intero che controlla l'indicizzazione degli interi.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
earthdistance Fornisce due approcci per calcolare le distanze in linea retta sulla superficie della Terra.
Cloud SQL per PostgreSQL utilizza la versione 1.1.
fuzzystrmatch Fornisce diverse funzioni per determinare le somiglianze e la distanza tra le stringhe.
Cloud SQL per PostgreSQL utilizza la versione 1.1.
google_ml_integration Genera incorporamenti vettoriali per tradurre prompt di testo in vettori numerici utilizzando un modello linguistico di grandi dimensioni (LLM).
Cloud SQL per PostgreSQL utilizza la versione 1.2.
insert_username Fornisce funzioni per memorizzare il nome dell'utente corrente in un campo di testo. Puoi utilizzarlo per monitorare chi ha modificato per l'ultima volta una riga in una tabella di database.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
intagg Fornisce un aggregatore di numeri interi e un enumeratore.
Cloud SQL per PostgreSQL utilizza la versione 1.1.
intarray Fornisce un insieme di funzioni e operatori per manipolare array di interi senza valori null e per eseguire ricerche indicizzate su di essi.
Cloud SQL per PostgreSQL 9.6, 10, 11 e 12 utilizza la versione 1.2. PostgreSQL 13 utilizza la versione 1.3. PostgreSQL 14 utilizza la versione 1.5.
moddatetime Fornisce funzioni per memorizzare l'ora corrente in un campo timestamp. Puoi utilizzarlo per monitorare l'ultima volta che una riga in una tabella di database viene modificata.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
oracle_fdw Fornisce un wrapper dei dati esterni (FDW) per accedere ai database Oracle in modo facile ed efficiente.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
orafce Fornisce funzioni e operatori che simulano un sottoinsieme di funzioni e pacchetti da un database Oracle. Utilizza queste funzioni per eseguire il porting delle applicazioni Oracle in PostgreSQL.
Cloud SQL per PostgreSQL 9.6 e 10 utilizzano la versione 4.6.1. PostgreSQL 11 e versioni successive utilizzano la versione 4.7.0.
pageinspect Esamina i contenuti delle pagine del database a basso livello. Consulta anche pageinspect in questo documento.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.5. PostgreSQL 10 utilizza la versione 1.6. PostgreSQL 11 e 12 utilizzano la versione 1.7. PostgreSQL 13 e 14 utilizzano la versione 1.8.
pgAudit Raccoglie i dati di controllo.

I possibili valori da impostare per i file di log di controllo per tutte le versioni di pgAudit sono READ, WRITE, FUNCTION, ROLE, DDL, MISC e ALL. Per le versioni da 1.4.2 a 1.6.1, puoi anche impostare il valore MISC_SET.

Per saperne di più sull'utilizzo di questa estensione con Cloud SQL, vedi Controlla PostgreSQL utilizzando pgAudit.
pg_background Consente di eseguire comandi arbitrari in un worker in background.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
pg_bigm Consente la ricerca a testo intero e un indice di due grammi (bigrammi) per una ricerca a testo intero più rapida. Vedi anche pg_bigm in questo documento.
pg_buffercache Fornisce un mezzo per esaminare cosa succede nella cache del buffer condiviso in tempo reale.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.2. PostgreSQL 10, 11, 12, 13, e 14 usano la versione 1.3.
pg_cron Fornisce uno scheduler dei job basato su cron. Questa estensione consente di utilizzare la sintassi di cron per pianificare i comandi PostgreSQL direttamente dal database. Per maggiori informazioni informazioni sull'estensione, consulta pg_cron in questo documento.
Cloud SQL per PostgreSQL 10 e versioni successive utilizzano la versione 1.6.0.
pgcrypto Fornisce funzioni crittografiche per PostgreSQL.
Cloud SQL per PostgreSQL utilizza la versione 1.3.
pglogical Fornisce la replica logica per PostgreSQL. Consulta: Configurazione della replica e decodifica logiche.
Cloud SQL per PostgreSQL utilizza la versione 2.4.3.
pgfincore Un insieme di funzioni per gestire le pagine nella memoria della cache del disco del sistema operativo da PostgreSQL. Vedi anche pgfincore in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 1.3.1.
pg_freespacemap Esamina la mappa dello spazio libero (FSM). Vedi anche pg_freespacemap in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
pg_hint_plan Ti consente di migliorare i piani di esecuzione di PostgreSQL utilizzando i suggerimenti, che sono semplici descrizioni nei commenti SQL. Consulta anche pg_hint_plan in questo documento.
pgoutput Questo plug-in viene utilizzato dalla replica logica per il monitoraggio delle modifiche. pgoutput è un plug-in predefinito ed è quindi supportato su tutte le versioni di Cloud SQL per PostgreSQL.
pg_ivm Consente di rendere aggiornate le viste materializzate in cui le modifiche incrementali vengono calcolate e applicate alle viste anziché ricalcolare i contenuti da zero.
Le versioni 13 e successive di Cloud SQL per PostgreSQL supportano la versione 1.9.
pg_partman Consente di creare e gestire tabelle basate sul tempo e seriali di set di partizioni. Vedi anche pg_partman in questo documento.
Le versioni 14 e successive di Cloud SQL per PostgreSQL supportano la versione 5.0.1, mentre le versioni precedenti a 14 supportano solo la versione 4.7.4.
pg_prewarm Fornisce un modo pratico per caricare i dati delle relazioni nella cache della memoria intermedia del sistema operativo o nella cache della memoria intermedia di PostgreSQL.
Cloud SQL per PostgreSQL 9.6 e 10 utilizza la versione 1.1. PostgreSQL 11, 12, 13 e 14 utilizzano la versione 1.2.
pg_proctab Ti consente di utilizzare pg_top con Cloud SQL per PostgreSQL e di generare report dalla tabella dei processi del sistema operativo. Consulta anche pg_proctab in questo documento.
pg_repack Consente di rimuovere il bloat da tabelle e indici. Facoltativamente, consente di eseguire un CLUSTER online (ordina le tabelle per cluster ). Vedi anche pg_repack in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 1.5.0.
lucchetti Fornisce informazioni sul blocco delle righe per la tabella specificata.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
Pugstattuple Fornisce varie funzioni per ottenere statistiche a livello di tupla.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.4. Tutte le altre versioni utilizzano la versione 1.5.
pg_similarity Fornisce il supporto per le query di somiglianza su PostgreSQL.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
pg_squeeze Rimuove lo spazio inutilizzato da una tabella e, facoltativamente, utilizza un indice per ordinare i record o le righe (tuple) della tabella. Per ulteriori informazioni su questa estensione, vedi pg_squeeze in questo documento.
Le versioni 11 e successive di Cloud SQL per PostgreSQL utilizzano la versione 1.5.
pg_stat_statements Fornisce un mezzo per monitorare le statistiche di esecuzione di tutte le query SQL eseguite le istruzioni.
Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.4. PostgreSQL 10 e 11 usano la versione 1.6. PostgreSQL 12 utilizza 1.7. PostgreSQL 13 utilizza 1.8. PostgreSQL 14 utilizza la versione 1.9.
pgTAP Fornisce un framework di test delle unità per PostgreSQL, scritto in PL/pgSQL e PL/SQL.
Cloud SQL per PostgreSQL utilizza la versione 1.3.0.
pg_trgm Fornisce funzioni e operatori per determinare la somiglianza del testo alfanumerico in base alla corrispondenza di trigrammi, nonché classi di operatori di indice che supportano la ricerca rapida di stringhe simili.
Cloud SQL per PostgreSQL 9.6 e 10 userà la versione 1.3. PostgreSQL 11 e 12 utilizzano la versione 1.4. PostgreSQL 13 utilizza 1.5. PostgreSQL 14 utilizza la versione 1.6.
pgtt

Crea e gestisce tabelle temporanee globali in stile DB2 o Oracle in un PostgreSQL standard.
Cloud SQL per PostgreSQL utilizza la versione 3.0.
pgvector

Un'estensione open source per archiviare e cercare gli incorporamenti vettoriali nei database PostgreSQL.
Cloud SQL per PostgreSQL 12 e versioni successive supportano la versione 0.7.0, mentre Cloud SQL per PostgreSQL versione 11 supporta solo fino alla versione 0.5.1.

pg_visibility Fornisce un modo per esaminare la mappa di visibilità (VM) e le informazioni sulla visibilità a livello di pagina di una tabella. Vedi anche pg_visibility in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
pg_wait_sampling Raccoglie statistiche campione degli eventi di attesa, fornendo dati su questi eventi per i processi sui server. Cloud SQL per PostgreSQL utilizza la versione 1.1.5.
PL/proxy Gestore del linguaggio procedurale che consente le chiamate di procedure remote tra Database PostgreSQL con sharding facoltativo. Consulta anche PL/Proxy in questo documento.
Cloud SQL per PostgreSQL utilizza la versione 2.11.0.
postgres_fdw Consente di creare wrapper dati esterni all'interno delle istanze o tra di Compute Engine. Vedi anche postgres_fdw in questo documento.
Cloud SQL per PostgreSQL 9.6, 10, 11, 12 e 13 utilizza la versione 1.0. PostgreSQL 14 utilizza la versione 1.1.
postgresql_anonymizer

Mascheramento o sostituzione di informazioni che consentono l'identificazione personale (PII) o dati sensibili da un database PostgreSQL. Per ulteriori informazioni, consulta postgresql_anonymizer.

Cloud SQL per PostgreSQL utilizza la versione 1.0.0.
postgresql_hll

Fornisce una struttura di dati HyperLogLog (hll) che stima la cardinalità di un insieme.

Cloud SQL per PostgreSQL utilizza la versione 2.18.
rdkit Una raccolta di software di cheminformatics e machine learning. Puoi utilizzare questa estensione per confrontare, manipolare e identificare strutture molecolari.
Cloud SQL per PostgreSQL utilizza la versione 4.2.0.
refint Include funzioni per verificare i vincoli di chiave esterna, i riferimenti e la tabella di riferimento. Questa estensione dimostra anche Server Programming Interface (SPI). Cloud SQL per PostgreSQL utilizza la versione 1.0.
sslinfo Fornisce informazioni sul certificato SSL fornito dal client corrente quando si è connesso all'istanza.
Cloud SQL per PostgreSQL utilizza la versione 1.2.
tablefunc Include varie funzioni che restituiscono tabelle (più righe).
Cloud SQL per PostgreSQL utilizza la versione 1.0.
tcn Fornisce una funzione di trigger che notifica ai listener le modifiche ai contenuti delle tabelle di database.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
tabelle_temporali Fornisce il supporto per le tabelle temporali. Una tabella temporale registra il periodo di tempo in cui una riga è valida dal punto di vista di un database.
Cloud SQL per PostgreSQL utilizza la versione 1.2.2.
tsm_system_rows Fornisce il metodo di campionamento delle tabelle SYSTEM_ROWS, che può essere utilizzato nella clausola TABLESAMPLE di un comando SELECT.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
tsm_system_time Fornisce il metodo di campionamento della tabella SYSTEM_TIME, che può essere utilizzato nella clausola TABLESAMPLE di un comando SELECT.
Cloud SQL per PostgreSQL utilizza la versione 1.0.
unaccent Un dizionario di ricerca testuale che rimuove gli accenti (segni diacritici) dai lexemi.
Cloud SQL per PostgreSQL utilizza la versione 1.1.
uuid-ossp Fornisce funzioni per generare identificatori univoci universali (UUID) utilizzando uno di diversi algoritmi standard.
Cloud SQL per PostgreSQL utilizza la versione 1.1.

Scopri di più su alcune estensioni PostgreSQL

Questa sezione descrive ulteriori informazioni su alcuni dei database PostgreSQL supportati disponibili nelle tabelle precedenti.

auto_explain

Per iniziare a utilizzare questa estensione in un'istanza, imposta il cloudsql.enable_auto_explain flag su on. Per informazioni sull'impostazione e per controllare i flag supportati per questa estensione, consulta Configurare i flag di database.

Per visualizzare i dati e gli eventi di logging associati ai log dei piani di esecuzione abilitati da questa estensione, consulta la documentazione di Cloud Logging.

In alternativa, per un utente che dispone solo del ruolo cloudsqlsuperuser, puoi utilizzare il comando load per caricare questa estensione per una sessione.

All'interno di una sessione di database, puoi utilizzare questa estensione per connetterti ai database PostgreSQL ed eseguire query.

Al momento, questa estensione funziona per due istanze IP private Cloud SQL all'interno della stessa rete VPC o per database incrociati all'interno della stessa istanza.

Per ulteriori informazioni, vedi dblink in PostgreSQL documentazione.

Per connetterti ai database o alla stessa istanza di un altro utente, devi specificare una password. Ad esempio, per scopi (ma non per la produzione), ecco uno snippet di codice:


  SELECT * FROM dblink (
    'dbname=name port=1234 host=host user=user password=password',
    'select id, name from table' \
  ) AS t(id int, name text);

In alternativa, per configurare solo una connessione, di seguito è riportato uno snippet di codice a scopo di esempio (non per la produzione):

  SELECT dblink_connect('dbname=dblinktest user=postgres host=name_or_ip password=xxx');

Per connetterti alla stessa istanza dello stesso utente, puoi connetterti senza password. Ad esempio:

  1. Imposta il seguente flag del database per abilitare le connessioni locali senza password
    cloudsql.allow_passwordless_local_connections

  2. Connettersi senza specificare un host, il che implica la connessione allo stesso in esecuzione in un'istanza Compute Engine. Ecco un esempio:

    SELECT *
  FROM dblink('dbname=finance user=alice',
              'select income from revenue')
    AS revenue(income integer);

    Il risultato potrebbe essere simile al seguente:

          income
      --------
      1000
      (1 row)

Per connetterti ai database all'interno della stessa istanza, non puoi impostare l'host su localhost o su 127.0.0.1. Invece, devi utilizzare l'indirizzo IP mostrato per l'istanza nella console Google Cloud.

Vedi anche postgres_fdw e PL/Proxy in questo documento.

pageinspect

Questa estensione ispeziona i contenuti delle pagine del database a un livello basso. Per ulteriori informazioni, consulta pageinspect nella documentazione di PostgreSQL.

pg_bigm

Questa estensione consente la ricerca a testo intero e un indice di due grammi (bigrammi) per una ricerca a testo intero più rapida.

Per iniziare a utilizzare questa estensione in un'istanza, imposta il cloudsql.enable_pg_bigm flag su on. Sono supportati anche i seguenti flag:

  • pg_bigm.enable_recheck
  • pg_bigm.gin_key_limit
  • pg_bigm.similarity_limit

Per informazioni sull'impostazione dei flag e per esaminare i flag supportati consulta Configurare i flag di database.

pg_cron

Per iniziare a utilizzare pg_cron su una imposta il flag cloudsql.enable_pg_cron su on. Per informazioni su impostare i flag e per esaminare i flag supportati per questa estensione, consulta Configurare i flag di database.

I job sono configurati come worker in background, quindi potrebbe essere necessario utilizzare tecniche PostgreSQL standard (ad esempio il flag max_worker_processes) per regolare il numero di questi worker in background.

Per questa estensione, Cloud SQL supporta la modalità di lavoro in background, ma non l'interfaccia libpq. Di conseguenza, attendi direttamente l'autenticazione che coinvolgono questa estensione non è obbligatorio.

pgfincore

Questa estensione contiene funzioni per la gestione delle pagine nella memoria cache del disco del sistema operativo da PostgreSQL. Per ulteriori informazioni, consulta documentazione relativa a chromebookincore.

pg_freespacemap

Questa estensione esamina la mappa dello spazio libero (FSM). Per ulteriori informazioni, consulta pg_freespacemap nella documentazione di PostgreSQL.

pg_hint_plan

Per iniziare a utilizzare questa estensione su un'istanza, imposta la classe cloudsql.enable_pg_hint_plan flag per on. Per informazioni su come impostare i flag e per esaminare quelli supportati per questa estensione, consulta Configurare i flag di database.

In alternativa, solo per un utente con il ruolo cloudsqlsuperuser, puoi utilizza il comando load per caricare questa estensione per una sessione.

pg_partman

Questa estensione consente di creare e gestire set di partizioni di tabelle basati su tempo e su serie.

In Cloud SQL, questa estensione non include il worker in background per e manutenzione della partizione. Puoi utilizzare, ad esempio, Cloud Scheduler per facilitare la manutenzione chiamando funzioni di manutenzione a intervalli regolari.

pg_proctab

Di seguito sono riportati i passaggi per utilizzare l'estensione pg_proctab per attivare l'utilità pg_top:

  1. Nello strumento psql, esegui Comando CREATE EXTENSION per pg_proctab.
  2. Scarica ed esegui pg_top.
  3. Quando ti connetti a un'istanza Cloud SQL per PostgreSQL, aggiungi l'opzione -r per connetterti a un database remoto e ottenere le metriche.

Le seguenti metriche a livello di istanza, incluse nell'output, includono l'utilizzo da parte di altri agenti e servizi di supporto nell'istanza:

  • Carico medio
  • Stati della CPU (% utente, piacevole, di sistema, inattivo e iowait)
  • Memoria (utilizzata, gratuita e memorizzata nella cache)

pg_repack

Questa estensione ti consente di rimuovere il bloat da tabelle e indici. Se vuoi, puoi utilizzare questa estensione per eseguire un CLUSTER online (ordina le tabelle per cluster ). Per ulteriori informazioni, consulta la documentazione di pg_repack. Inoltre, per di questa estensione in Cloud SQL, è necessaria una procedura speciale l'aggiunta di privilegi a un utente.

Se un utente esterno al ruolo cloudsqlsuperuser vuole utilizzare un'estensione, devi concedere all'utente i privilegi cloudsqlsuperuser. Per ulteriori informazioni, nella Questo documento, vedi Requisiti per i privilegi di super user. Nell'esempio seguente viene utilizzato il comando GRANT per aggiungere i privilegi necessari.

Esempio di aggiunta di privilegi

A titolo esemplificativo, di seguito csuper1 è un cloudsqlsuperuser e testdb è un database di proprietà di testuser. Per creare l'estensione pg_repack in testdb, esegui inizialmente questi comandi:

  1. Collegati a testdb come cloudsqlsuperuser:

    psql -U csuper1 -d testdb;

  2. Concedi al proprietario del database, ovvero testuser,, i seguenti diritti a csuper1:

    GRANT testuser TO csuper1;

  3. Crea l'estensione:

    CREATE EXTENSION pg_repack;

  4. Esegui il comando pg_repack su una tabella, ad esempio t1 in testdb, come csuper1:

    pg_repack -h <hostname> -d testdb -U csuper1 -k -t t1

  5. Al termine del job pg_repack, revoca la concessione eseguita nel passaggio 2:

     REVOKE testuser FROM csuper1;

Il comando pg_repack potrebbe non riuscire e restituire il seguente errore:
"ERROR: query failed: SSL SYSCALL error: EOF detected"

Se si verifica questo errore, prova a impostare i keepalive TCP su un valore inferiore, quindi esegui il comando pg_repack. Per ulteriori informazioni, vedi Timeout delle connessioni (da Compute Engine).

pg_squeeze

Questa estensione rimuove lo spazio inutilizzato da una tabella e, facoltativamente, utilizza un indice per ordinare le tuple della tabella. Per iniziare a utilizzare l'estensione su un'istanza, imposta il flag cloudsql.enable_pg_squeeze su on.

Questa estensione supporta anche la decodifica logica scrivendo informazioni aggiuntive nel log write-ahead (WAL). Per attivare questa funzionalità per l'estensione, imposta il parametro di configurazione wal_level su logical o una versione successiva impostando il flag cloudsql.logical_decoding su on.

L'estensione richiede l'impostazione di un valore per il flag max_replication_slots. Se Non hai specificato un valore per questo flag, imposta il valore su 1. In caso contrario, aggiungi 1 al valore impostato per il flag.

Per informazioni sull'impostazione dei flag e per esaminare i flag supportati per questa estensione, vedi Configurare i flag di database.

pgtt

Per iniziare a utilizzare questa estensione in un'istanza, imposta il pgtt.enabled flag su on. Per informazioni sull'impostazione e per controllare i flag supportati per questa estensione, consulta Configurazione dei flag di database.

pg_visibility

Questa estensione consente di esaminare la mappa di visibilità (VM) e le informazioni sulla visibilità a livello di pagina di una tabella. Per ulteriori informazioni, vedi pg_visibility nel documentazione di PostgreSQL.

PL/Proxy

Questa estensione è un gestore del linguaggio procedurale che consente chiamate di procedure remote tra database PostgreSQL, con sharding facoltativo.

Per ulteriori informazioni, consulta la documentazione PL/proxy.

Le istanze di destinazione per le connessioni devono trovarsi nella stessa rete VPC dell'istanza di connessione. Inoltre, nel formato nella console Google Cloud, il pulsante Consenti solo connessioni SSL per di Compute Engine.

Per connetterti ai database all'interno della stessa istanza, non puoi impostare l'host su localhost o su 127.0.0.1. Devi invece utilizzare l'indirizzo IP mostrato per la tua istanza nella console Google Cloud.

Consulta anche postgres_fdw e dblink in questo documento.

postgresql_anonymizer

Per iniziare a utilizzare questa estensione su un'istanza, imposta la classe cloudsql.enable_anon flag per on. Per informazioni su come impostare i flag e per esaminare quelli supportati per questa estensione, consulta Configurare i flag di database.

postgres_fdw

Questa estensione consente tabelle di altri database PostgreSQL ("esteri") essere esposti come "stranieri" nel database attuale. Queste tabelle sono quindi disponibili per l'utilizzo, quasi come se fossero tabelle locali. Per ulteriori informazioni, vedi postgres_fdw nella documentazione di PostgreSQL.

Questa estensione funziona per due istanze IP private di Cloud SQL all'interno della sulla stessa rete VPC o per più database all'interno della stessa istanza.

Per connetterti ai database all'interno della stessa istanza, non puoi impostare l'host su localhost o a 127.0.0.1. Devi invece utilizzare l'indirizzo IP mostrato per la tua istanza nella console Google Cloud.

Inoltre, per un'istanza in cui sono archiviati dati esterni, puoi scegliere l'opzione Consenti solo connessioni SSL nella console Google Cloud. Non puoi scegliere l'opzione Richiedi certificati client attendibili. Solo il cloudsqlsuperuser può essere il proprietario di un wrapper di dati esterni postgres_fdw.

Vedi anche PL/Proxy e dblink in questo documento.

postgresql-hll

Questa estensione introduce un nuovo tipo di dati, hll, che è un dato HyperLogLog alla struttura del centro di costo. Per ulteriori informazioni, consulta la documentazione di postgresql-hll.