Hantera PostgreSQL-tillägg i Azure Database for PostgreSQL – flexibel server

GÄLLER FÖR: Azure Database for PostgreSQL – flexibel server

Med Azure Database for PostgreSQL – flexibel server kan du utöka funktionerna i databasen med hjälp av tillägg. Tillägg paket flera relaterade SQL-objekt i ett enda paket som kan läsas in eller tas bort från databasen med ett kommando. När tilläggen har lästs in i databasen fungerar de som inbyggda funktioner.

Tillåt tillägg

Innan du installerar tillägg i Azure Database for PostgreSQL – flexibel server måste du tillåta att dessa tillägg visas för användning.

    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"
            }
        }
    ]
}

Läsa in bibliotek

shared_preload_libraries är en serverkonfigurationsparameter som avgör vilka bibliotek som måste läsas in när Azure Database for PostgreSQL – flexibel server startar. Alla bibliotek som använder delat minne måste läsas in via den här parametern. Följ dessa steg om tillägget behöver läggas till i de delade förinläsningsbiblioteken:

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>

Skapa tillägg

När ett tillägg har tillåts och, om tillägget kräver det, också läggs till shared_load_librariesi kan det skapas eller installeras i varje databas som det ska användas på.

1. Om du vill skapa ett tillägg måste en användare vara medlem i azure_pg_admin rollen.

2. Kör kommandot CREATE EXTENSION för att skapa eller installera ett visst tillägg. Det här kommandot läser in de paketerade objekten i databasen.

Azure Database for PostgreSQL– flexibel serverinstans stöder en delmängd av viktiga PostgreSQL-tillägg, enligt listan i tillägg som stöds efter namn eller i tillägg som stöds efter version av PostgreSQL. Den här informationen är också tillgänglig genom att köra SHOW azure.extensions;. Tillägg som inte ingår i dessa listor stöds inte på en flexibel Azure Database for PostgreSQL-server. Du kan inte skapa eller läsa in dina egna tillägg i Azure Database for PostgreSQL – flexibel server.

Ta bort tillägg

Om du vill ta bort ett tillägg måste du först tillåta det .

1. Om du vill släppa ett tillägg måste en användare vara medlem i azure_pg_admin rollen.

2. Kör KOMMANDOT DROP EXTENSION för att släppa eller avinstallera ett visst tillägg. Det här kommandot släpper objekten som paketeras i tillägget från databasen.

Uppdatera tillägg

Om du vill uppdatera ett installerat tillägg till den senaste tillgängliga versionen som stöds av Azure använder du följande SQL-kommando:

ALTER EXTENSION <extension_name> UPDATE;

Det här kommandot förenklar hanteringen av databastillägg genom att tillåta användare att manuellt uppgradera till den senaste versionen som godkänts av Azure, vilket förbättrar både kompatibiliteten och säkerheten.

Begränsningar

Det är enkelt att uppdatera tillägg, men det finns vissa begränsningar:

• Val av en specifik version: Kommandot stöder inte uppdatering till mellanliggande versioner av ett tillägg.

  • Den uppdaterar ständigt den senaste tillgängliga versionen.

• Nedgradering: Stöder inte nedgradering av ett tillägg till en tidigare version. Om en nedgradering krävs kan det kräva supporthjälp och beror på tillgängligheten för den tidigare versionen.

Visa installerade tillägg

Om du vill visa en lista över de tillägg som för närvarande är installerade i databasen använder du följande SQL-kommando:

SELECT * FROM pg_extension;

Möjliga fel

Tillägget %s tillåts inte för "azure_pg_admin"-användare i Azure Database for PostgreSQL

Det här felet uppstår när du kör ett CREATE EXTENSION eller DROP EXTENSION -kommando som refererar till ett tillägg som inte är tillåtetlistat, eller ett tillägg som ännu inte stöds på instansen av Azure Database för flexibel server där du kör kommandot.

Endast medlemmar i "azure_pg_admin" får använda CREATE-TILLÄGGET

Det här felet uppstår när användaren som kör ett CREATE EXTENSION kommando inte är medlem i azure_pg_admin rollen.

Endast medlemmar i "azure_pg_admin" får använda DROP-TILLÄGGET

Det här felet uppstår när användaren som kör ett DROP EXTENSION kommando inte är medlem i azure_pg_admin rollen.

Relaterat innehåll

• Så här använder du tillägg.
• Särskilda överväganden med tillägg.
• Lista över tillägg efter namn.