Configura le estensioni PostgreSQL

MySQL   |  PostgreSQL   |  SQL Server

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

Utilizzare le estensioni PostgreSQL

Puoi installare solo le estensioni supportate da Cloud SQL. Per saperne di più, consulta Estensioni PostgreSQL supportate da Cloud SQL.

Nota: puoi installare le estensioni solo sull'istanza principale, non nella replica di lettura. Una volta installata, l'estensione viene replicata nella replica di lettura.

Installare un'estensione

Prima di utilizzare un'estensione, installala:

• Nello strumento psql, esegui il comando CREATE EXTENSION.

Nota: devi impostare i flag prima di creare alcune estensioni, ad esempio pglogical. Per maggiori informazioni, consulta Configurare le repliche esterne.

Requisito per i privilegi di super user

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

Nota: se importi un database contenente un'estensione creata da un utente personalizzato, non puoi eliminare l'utente senza eliminare l'intero database importato.

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 all'interno della stessa istanza, non puoi impostare l'host su localhost o su 127.0.0.1. Devi invece utilizzare l'indirizzo IP visualizzato per l'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 sulla questione in corso o crea un nuovo problema. Per un elenco dei problemi aperti in Cloud SQL e informazioni sulla creazione di nuovi problemi, consulta Cercare o creare 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 seguenti.

Il supporto di Cloud SQL per le estensioni PostgreSQL può essere suddiviso in queste categorie:

• Estensioni PostGIS
• Estensioni dei tipi di dati
• Estensioni di lingua
• Estensioni varie

PostGIS

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

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

Versione di 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.2.5
PostgreSQL 14	3.2.5
PostgreSQL 15	3.2.5

Per una versione principale specifica di PostgreSQL, nel comando CREATE EXTENSION puoi specificare una versione dell'estensione PostGIS utilizzando la clausola VERSION.

L'estensione PostGIS include quanto segue:

• postgis
• postgis_raster
• postgis_sfcgal
• postgis_tiger_geocoder
• postgis_topology
• address_standardizer
• address_standardizer_data_us

Per maggiori informazioni, consulta 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 attraverso il routing e l'analisi della rete.

Puoi eseguire manualmente l'upgrade di PostGIS e delle sue estensioni correlate alla loro versione più recente. Per saperne di più sull'upgrade delle estensioni PostGIS, consulta Upgrade di PostGIS.

Estensioni dei tipi di dati

Estensione	Description
btree_gin	Fornisce classi di operatori GIN di esempio che implementano il comportamento equivalente di B-tree. Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.0. PostgreSQL 10 utilizza la versione 1.2. Tutte le altre versioni utilizzano la versione 1.3.
btree_gist	Fornisce classi di operatori di indice GiST che implementano il comportamento equivalente di B-tree. 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.
	Implementa un tipo di dati chkpass progettato per l'archiviazione di password criptate. Cloud SQL per PostgreSQL 9.6 e 10 utilizzano la versione 1.0. Non supportata per altre versioni.
citext	Fornisce un tipo di stringa di caratteri citext senza distinzione tra maiuscole e minuscole. 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.
Centro assistenza	Implementa il tipo di dati hstore per la memorizzazione di set di coppie chiave/valore in 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.
è	Fornisce tipi di dati per alcuni standard di numerazione dei prodotti internazionali. Cloud SQL per PostgreSQL 9.6 e 10 utilizzano la versione 1.1. Tutte le altre versioni utilizzano la versione 1.2.
ip4r	Fornisce tipi di dati per indirizzi IPv4/v6 e intervalli di indirizzi, oltre al 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 archiviati in una struttura gerarchica ad albero. Cloud SQL per PostgreSQL 9.6, 10, 11 e 12 utilizzano 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	Introduce un nuovo tipo di dati, hll, che è una struttura di dati HyperLogLog. Vedi anche postgresql-hll in questo documento. Cloud SQL per PostgreSQL utilizza la versione 2.16.
prefisso	Fornisce la corrispondenza del prefisso e il supporto dell'indice. Cloud SQL per PostgreSQL utilizza la versione 1.2.0.

Estensioni di lingua

Estensione	Description
plpgsql	Un linguaggio procedurale caricabile per la creazione di funzioni, procedure e trigger. Puoi utilizzare questo linguaggio anche 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.0, che a sua volta utilizza la versione 11.5 del motore JavaScript V8.

Estensioni varie

Estensione	Description
verifica	Fornisce funzioni per verificare la coerenza logica della struttura delle relazioni, consentendo all'applicazione pg_amcheck di verificare l'eventuale danneggiamento.
auto_explain	Abilita il logging automatico dei piani di esecuzione delle istruzioni lente, per la risoluzione dei problemi e altro ancora. Fornisce un modo automatico per eseguire le funzionalità del comando EXPLAIN. Vedi anche auto_explain in questo documento.
attivazione automatica	Fornisce funzioni per l'incremento automatico dei campi. Questo attivatore archivia il valore successivo di una sequenza in un campo numero intero. Cloud SQL per PostgreSQL utilizza la versione 1.0.
sbocciare	Fornisce un metodo per accedere agli indici basati sui filtri Bloom. Un filtro Bloom è una struttura di dati efficiente in termini di spazio che puoi utilizzare per verificare se un elemento fa parte di un insieme. Cloud SQL per PostgreSQL utilizza la versione 1.0.
link db	Fornisce funzioni per la connessione ai database PostgreSQL da una sessione di database. Consulta anche la sezione dblink in questo documento. Cloud SQL per PostgreSQL utilizza la versione 1.2. Nota: se utilizzi Private Service Connect per connetterti a un'istanza Cloud SQL, questa estensione non può essere utilizzata con la tua istanza.
decoderbufs	Un decodificatore logico PostgreSQL che fornisce dati di output come buffer di protocollo, adattato per Debezium.
dict_int	Un modello di dizionario aggiuntivo per la ricerca a testo intero che controlla l'indicizzazione dei numeri interi. Cloud SQL per PostgreSQL utilizza la versione 1.0.
distanza terra	Offre due approcci per calcolare le distanze nei grandi cerchi sulla superficie della Terra. Cloud SQL per PostgreSQL utilizza la versione 1.1.
strappare le risposte	Fornisce diverse funzioni per determinare somiglianze e distanza tra le stringhe. Cloud SQL per PostgreSQL utilizza la versione 1.1.
insert_username	Fornisce funzioni per memorizzare il nome dell'utente corrente in un campo di testo. Puoi utilizzarlo per tenere traccia di chi ha modificato l'ultima 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 la manipolazione di array senza null di numeri interi e per l'esecuzione di ricerche indicizzate. Cloud SQL per PostgreSQL 9.6, 10, 11 e 12 utilizzano 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 tenere traccia dell'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 dati straniero (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 emulano un sottoinsieme di funzioni e pacchetti da un database Oracle. Utilizza queste funzioni per trasferire le 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	Controlla il contenuto delle pagine di database a basso livello. Consulta anche la sezione pageinspect di 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. Cloud SQL per PostgreSQL 9.6 utilizza pgAudit, versione 1.1.4. Cloud SQL per PostgreSQL 10 utilizza pgAudit, versione 1.2.3. Cloud SQL per PostgreSQL 11 utilizza pgAudit, versione 1.3.3. Cloud SQL per PostgreSQL 12 utilizza pgAudit, versione 1.4.2. Cloud SQL per PostgreSQL 13 utilizza pgAudit, versione 1.5.1. Cloud SQL per PostgreSQL 14 utilizza pgAudit, versione 1.6.1. I valori possibili da impostare per i file di audit log per tutte le versioni di pgAudit sono READ, WRITE, FUNCTION, ROLE, DDL, MISC e ALL. Per le versioni dalla 1.4.2 alla 1.6.1, puoi anche impostare il valore di MISC_SET. Per ulteriori informazioni sull'utilizzo di questa estensione con Cloud SQL, consulta Esegui il controllo di PostgreSQL con pgAudit.
pg_background	Consente di eseguire comandi arbitrari in un worker in background. Cloud SQL per PostgreSQL utilizza la versione 1.2.
pg_bigm	Abilita la ricerca a testo intero e autorizza un indice di due grammi (bigram) per una ricerca a testo intero più rapida. Vedi anche pg_bigm in questo documento.
pg_buffercache	Fornisce un mezzo per esaminare in tempo reale cosa accade nella cache del buffer condivisa. Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.2. PostgreSQL 10, 11, 12, 13 e 14 utilizzano la versione 1.3.
pg_cron	Fornisce uno scheduler di job basato su cron. Questa estensione consente alla sintassi cron di pianificare i comandi PostgreSQL direttamente dal database. Per saperne di più 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 la pagina Configurare la replica e la decodifica logica. Cloud SQL per PostgreSQL utilizza la versione 2.4.3. Nota:se utilizzi Private Service Connect per connetterti a un'istanza Cloud SQL, questa estensione non può essere utilizzata con la tua istanza.
TEMPLATEincore	Un insieme di funzioni per gestire le pagine nella memoria cache del disco del sistema operativo da PostgreSQL. Vedi anche ytincore 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	Consente di migliorare i piani di esecuzione di PostgreSQL utilizzando i suggerimenti, ovvero semplici descrizioni nei commenti SQL. Vedi anche pg_hint_plan in questo documento.
output pagina	Questo plug-in viene utilizzato dalla replica logica per Change Data Capture (CDC). pgoutput è un plug-in predefinito ed è quindi supportato in tutte le versioni di Cloud SQL per PostgreSQL.
pg_partman	Consente di creare e gestire set di partizioni di tabelle basate su tempo e seriali. Vedi anche pg_partman in questo documento. Cloud SQL per PostgreSQL utilizza la versione 4.7.4.
pg_prewarm	Consente di caricare facilmente i dati sulla relazione nella cache del buffer del sistema operativo o nella cache del buffer PostgreSQL. Cloud SQL per PostgreSQL 9.6 e 10 utilizzano la versione 1.1. PostgreSQL 11, 12, 13 e 14 utilizzano la versione 1.2.
pg_proctab	Consente di utilizzare pg_top con Cloud SQL per PostgreSQL e di generare report dalla tabella dei processi del sistema operativo. Vedi anche pg_proctab in questo documento.
pg_repack	Consente di rimuovere il bloat da tabelle e indici. Facoltativamente, ti consente di eseguire un CLUSTER online (ordinare le tabelle per indice del cluster). Vedi anche pg_repack in questo documento. Cloud SQL per PostgreSQL utilizza la versione 1.5.0.
pgrowlock	Fornisce informazioni sul blocco delle righe per la tabella specificata. Cloud SQL per PostgreSQL utilizza la versione 1.2.
schermata	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 supporto per 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. Cloud SQL per PostgreSQL 11 e versioni successive utilizzano la versione 1.5.
pg_stat_statements	Fornisce un mezzo per monitorare le statistiche di esecuzione di tutte le istruzioni SQL eseguite. Cloud SQL per PostgreSQL 9.6 utilizza la versione 1.4. PostgreSQL 10 e 11 utilizzano 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 per il 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 dei trigrammi, nonché classi di operatori di indice che supportano la ricerca rapida di stringhe simili. Cloud SQL per PostgreSQL 9.6 e 10 utilizzano 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.
Vai alla prossima diapositiva.	Crea e gestisce tabelle temporanee globali in stile DB2 o Oracle in un database PostgreSQL. Cloud SQL per PostgreSQL utilizza la versione 3.0.
vettore.com	Un'estensione open source per l'archiviazione e la ricerca di incorporamenti vettoriali nei database PostgreSQL. Cloud SQL per PostgreSQL 12 e versioni successive supportano la versione 0.6.0, mentre Cloud SQL per PostgreSQL versione 11 supporta solo fino alla versione 0.5.1. Nota: la modalità di archiviazione TOAST consigliata per pgvector 0.6.0 con PostgreSQL versione 12 è extended. Per la versione 13 e successive, la modalità di archiviazione è external per garantire prestazioni ottimali. Se utilizzi pgvector 0.6.0 con la versione 12 e poi esegui l'upgrade a una versione principale, ti consigliamo di modificare la modalità di archiviazione in external come segue: ALTER TYPE vector SET (STORAGE = external);.
pg_visibility	Consente di esaminare la mappa di visibilità (VM) e le informazioni di 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 di campionamento degli eventi di attesa, fornendo dati sugli eventi di attesa per i processi sui server. Cloud SQL per PostgreSQL utilizza la versione 1.1.5.
PL/proxy	Gestore del linguaggio procedurale che consente chiamate di procedure remote tra database PostgreSQL, con sharding facoltativo. Vedi anche PL/Proxy in questo documento. Cloud SQL per PostgreSQL utilizza la versione 2.11.0. Nota:se utilizzi Private Service Connect per connetterti a un'istanza Cloud SQL, questa estensione non può essere utilizzata con la tua istanza.
postgres_fdw	Consente di creare wrapper di dati esterni all'interno o tra istanze. Vedi anche postgres_fdw in questo documento. Cloud SQL per PostgreSQL 9.6, 10, 11, 12 e 13 utilizzano la versione 1.0. PostgreSQL 14 utilizza la versione 1.1. Nota:se utilizzi Private Service Connect per connetterti a un'istanza Cloud SQL, questa estensione non può essere utilizzata con la tua istanza.
postgresql_anonymizer	Maschera o sostituisce le informazioni che consentono l'identificazione personale (PII) o i dati sensibili di un database PostgreSQL. Per maggiori informazioni, consulta la sezione 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 cheminformatici e di machine learning. Puoi utilizzare questa estensione per confrontare, manipolare e identificare le strutture molecolari. Cloud SQL per PostgreSQL utilizza la versione 4.2.0.
refint	Include le funzioni per verificare le restrizioni relative alle chiave esterna, la tabella di riferimento e la tabella di riferimento. Questa estensione dimostra anche l' interfaccia di programmazione di un server (SPI). Cloud SQL per PostgreSQL utilizza la versione 1.0.
sslinfo	Fornisce informazioni sul certificato SSL fornito dal client attuale 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 al contenuto delle tabelle di database. Cloud SQL per PostgreSQL utilizza la versione 1.0.
tsm_system_rows	Fornisce il metodo di campionamento delle tabelle SYSTEM_ROWS, che può essere utilizzato nella clausola TABLEEXAMPLE 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 TABLEEXAMPLE di un comando SELECT. Cloud SQL per PostgreSQL utilizza la versione 1.0.
incomprensibile	Un dizionario di ricerca testuale che rimuove gli accenti (segni diacritici) dai leexeme. Cloud SQL per PostgreSQL utilizza la versione 1.1.
uuid-ossp	Fornisce funzioni per generare identificatori univoci universali (UUID) utilizzando uno dei vari algoritmi standard. Cloud SQL per PostgreSQL utilizza la versione 1.1.

Scopri di più su alcune estensioni PostgreSQL

Questa sezione descrive ulteriori informazioni su alcune delle estensioni PostgreSQL supportate nelle tabelle riportate sopra.

auto_explain

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

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

link db

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

Attualmente, questa estensione funziona per due istanze IP privati Cloud SQL all'interno della stessa rete VPC o per più database all'interno della stessa istanza.

Nota: in Cloud SQL, l'utilizzo dei certificati client con dblink non è supportato.

Per ulteriori informazioni, consulta dblink nella documentazione di PostgreSQL.

Utilizza dblink per connetterti con una password

Per connetterti ai database o alla stessa istanza di un altro utente, devi specificare una password. Ad esempio (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, ecco uno snippet di codice per scopi di esempio (non per produzione):

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

Usa dblink per connetterti senza una password

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

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

2. Connettiti senza specificare un host, il che implica la connessione alla stessa istanza. 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. Devi utilizzare l'indirizzo IP mostrato per l'istanza nella console Google Cloud.

Vedi anche postgres_fdw e PL/Proxy in questo documento.

ispezione pagina

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

pg_bigm

Questa estensione consente la ricerca nell'intero testo e consente di utilizzare un indice di due grammi (bigram) per velocizzare la ricerca nell'intero testo.

Per iniziare a utilizzare questa estensione su un'istanza, imposta il flag cloudsql.enable_pg_bigm 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 per questa estensione, consulta Configurare i flag di database.

pg_cron

Per iniziare a utilizzare pg_cron su un'istanza, imposta il flag cloudsql.enable_pg_cron su on. Per informazioni sull'impostazione dei 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 le tecniche PostgreSQL standard (come il flag max_worker_processes) per regolare il numero di questi worker in background.

Per questa estensione, Cloud SQL supporta la modalità worker in background, ma non l'interfaccia libpq. Pertanto, l'autenticazione basata su attendibilità che riguarda direttamente questa estensione non è necessaria.

pgfincore

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

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 il flag cloudsql.enable_pg_hint_plan su on. Per informazioni sull'impostazione dei flag e per esaminare i flag supportati per questa estensione, consulta Configurare i flag di database.

In alternativa, solo per un utente con il ruolo cloudsqlsuperuser, puoi utilizzare il comando load per caricare l'estensione per una sessione.

pg_partman

Questa estensione consente di creare e gestire set di partizioni di tabelle basate su tempo e seriali.

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

pg_proctab

Ecco i passaggi per utilizzare l'estensione pg_proctab per abilitare l'utilità pg_top:

1. Nello strumento psql, esegui il 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:

• Carica media
• Stati della CPU (% utente, bello, di sistema, inattivo e iowait)
• Memoria (utilizzata, gratuita e memorizzata nella cache)

pg_repack

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

Se un utente esterno al ruolo cloudsqlsuperuser vuole utilizzare un'estensione, devi concedergli i privilegi cloudsqlsuperuser. Per ulteriori informazioni, consulta questo documento in Requisito per i privilegi di super user. L'esempio seguente utilizza il comando GRANT per aggiungere i privilegi necessari.

Esempio di aggiunta di privilegi

Ad esempio, 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,, 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, ad esempio csuper1:

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

5. Una volta completato il job pg_repack, revoca la concessione eseguita nel passaggio 2:

    REVOKE testuser FROM csuper1;
   

Il comando pg_repack potrebbe non riuscire con 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 maggiori informazioni, consulta 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 su un valore superiore 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, consulta Configurare i flag di database.

pagina

Per iniziare a utilizzare questa estensione su un'istanza, imposta il flag pgtt.enabled su on. Per informazioni sull'impostazione dei flag e per esaminare 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 di visibilità a livello di pagina di una tabella. Per ulteriori informazioni, consulta pg_visibility nella 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 di PL/proxy.

Le istanze di destinazione per le connessioni devono trovarsi nella stessa rete VPC dell'istanza di connessione. Inoltre, nella console Google Cloud, non puoi scegliere il pulsante Consenti solo connessioni SSL per le istanze cluster.

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

Vedi anche postgres_fdw e dblink in questo documento.

postgresql_anonymizer

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

postgres_fdw

Questa estensione consente di esporre le tabelle di altri database PostgreSQL ("esteri") come tabelle "esterne" nel database attuale. Queste tabelle sono quindi disponibili per l'uso, quasi come se fossero tabelle locali. Per ulteriori informazioni, consulta postgres_fdw nella documentazione di PostgreSQL.

Questa estensione funziona per due istanze IP private di Cloud SQL all'interno della 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 su 127.0.0.1. Devi invece utilizzare l'indirizzo IP visualizzato per l'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 cloudsqlsuperuser può essere il proprietario di un wrapper di dati straniero postgres_fdw.

Vedi anche PL/Proxy e dblink in questo documento.

postgresql-hll

Questa estensione introduce un nuovo tipo di dati, hll, che è una struttura di dati HyperLogLog. Per ulteriori informazioni, consulta la documentazione di postgresql-hll.