Gestire le estensioni PostgreSQL

SI APPLICA A: Database di Azure per PostgreSQL - Server flessibile

Database di Azure per PostgreSQL server flessibile consente di estendere le funzionalità del database usando le estensioni. Le estensioni raggruppano più oggetti SQL correlati in un singolo pacchetto che possono essere caricati o rimossi dal database con un comando. Dopo il caricamento nel database, le estensioni funzionano come le funzionalità predefinite.

Consenti estensioni

Prima di installare le estensioni in Database di Azure per PostgreSQL server flessibile, è necessario consentire l'elenco di queste estensioni per l'uso.

    az postgres flexible-server parameter set --resource-group <resource_group>  --server-name <server> --subscription <subscription_id> --name azure.extensions --value <extension_name>,<extension_name>

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "flexibleServers_name": {
            "defaultValue": "postgres-test-server",
            "type": "String"
        },
        "azure_extensions_set_value": {
            "defaultValue": " dblink,dict_xsyn,pg_buffercache",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
            "apiVersion": "2021-06-01",
            "name": "[concat(parameters('flexibleServers_name'), '/azure.extensions')]",
            "properties": {
                "value": "[parameters('azure_extensions_set_value')]",
                "source": "user-override"
            }
        }
    ]
}

Carica librerie

shared_preload_libraries è un parametro di configurazione del server che determina quali librerie devono essere caricate all'avvio del server flessibile di Database di Azure per PostgreSQL. Tutte le librerie che usano la memoria condivisa devono essere caricate tramite questo parametro. Se l'estensione deve essere aggiunta alle librerie di precaricamento condiviso, seguire questa procedura:

az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --name shared_preload_libraries --value <extension_name>,<extension_name>

az postgres flexible-server restart --resource-group <resource_group> --name <server>

Creare estensioni

Dopo aver consentito l'elenco di un'estensione e, se l'estensione lo richiede, viene aggiunto anche a shared_load_libraries, può essere creato o installato in ogni database in cui deve essere usato.

1. Per creare un'estensione, un utente deve essere membro del azure_pg_admin ruolo.

2. Eseguire il comando CREATE EXTENSION per creare o installare una determinata estensione. Questo comando carica gli oggetti in pacchetto nel database.

Database di Azure per PostgreSQL'istanza del server flessibile supporta un subset di estensioni PostgreSQL chiave, come indicato nelle estensioni supportate per nome o nelle estensioni supportate per versione di PostgreSQL. Queste informazioni sono disponibili anche eseguendo SHOW azure.extensions;. Le estensioni non incluse in tali elenchi non sono supportate in Database di Azure per PostgreSQL server flessibile. Non è possibile creare o caricare estensioni personalizzate in Database di Azure per PostgreSQL server flessibile.

Elimina estensioni

Per eliminare un'estensione, assicurarsi prima di tutto di consentire l'elenco .

1. Per eliminare un'estensione, un utente deve essere un membro del azure_pg_admin ruolo.

2. Eseguire il comando DROP EXTENSION per eliminare o disinstallare una particolare estensione. Questo comando elimina gli oggetti inclusi nell'estensione dal database.

Aggiornare le estensioni

Per aggiornare un'estensione installata alla versione più recente disponibile supportata da Azure, usare il comando SQL seguente:

ALTER EXTENSION <extension_name> UPDATE;

Questo comando semplifica la gestione delle estensioni di database consentendo agli utenti di eseguire manualmente l'aggiornamento alla versione più recente approvata da Azure, migliorando sia la compatibilità che la sicurezza.

Limiti

Durante l'aggiornamento delle estensioni è semplice, esistono alcune limitazioni:

• Selezione di una versione specifica: il comando non supporta l'aggiornamento alle versioni intermedie di un'estensione.

  • Aggiorna costantemente la versione più recente disponibile.

• Downgrade: non supporta il downgrade di un'estensione a una versione precedente. Se è necessario un downgrade, potrebbe richiedere assistenza di supporto e dipende dalla disponibilità della versione precedente.

Visualizzare le estensioni installate

Per elencare le estensioni attualmente installate nel database, usare il comando SQL seguente:

SELECT * FROM pg_extension;

Possibili errori

L'estensione "%s" non è inclusa nell'elenco degli utenti "azure_pg_admin" in Database di Azure per PostgreSQL

Questo errore si verifica quando si esegue un CREATE EXTENSION comando o DROP EXTENSION che fa riferimento a un'estensione che non è consentita nell'elenco o a un'estensione non ancora supportata nell'istanza di Database di Azure per il server flessibile in cui si esegue il comando.

Solo i membri di "azure_pg_admin" possono usare CREATE EXTENSION

Questo errore si verifica quando l'utente che esegue un CREATE EXTENSION comando non è membro del azure_pg_admin ruolo.

Solo i membri di "azure_pg_admin" possono usare DROP EXTENSION

Questo errore si verifica quando l'utente che esegue un DROP EXTENSION comando non è membro del azure_pg_admin ruolo.

Contenuto correlato

• Come usare le estensioni.
• Considerazioni speciali con le estensioni.
• Elenco di estensioni in base al nome.