PostgreSQL-extensies beheren in Azure Database for PostgreSQL - Flexible Server

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

Met azure Database for PostgreSQL flexibele server kunt u de functionaliteit van uw database uitbreiden met behulp van extensies. Extensies bundelen meerdere gerelateerde SQL-objecten in één pakket dat kan worden geladen of verwijderd uit uw database met een opdracht. Nadat de extensie in de database is geladen, werken extensies zoals ingebouwde functies.

Extensies toestaan

Voordat u extensies installeert in een flexibele Azure Database for PostgreSQL-server, moet u toestaan dat deze extensies worden vermeld voor gebruik.

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder Instellingen.

3. Selecteer de extensies die u wilt toestaan, in de extensies die beschikbaar zijn in de azure.extensions parameter en selecteer Opslaan.

   

Azure-CLI

U kunt extensies toestaan via de opdracht CLI-parameterset.

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

Resource Manager-sjabloon

Met behulp van de ARM-sjabloon:

In het volgende voorbeeld worden extensies toegevoegd aan de acceptatielijstdblink, dict_xsynpg_buffercache op een server waarvan de naam ispostgres-test-server:

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

Bibliotheken laden

shared_preload_libraries is een serverconfiguratieparameter die bepaalt welke bibliotheken moeten worden geladen wanneer de flexibele Server van Azure Database for PostgreSQL wordt gestart. Bibliotheken die gebruikmaken van gedeeld geheugen, moeten worden geladen via deze parameter. Als uw extensie moet worden toegevoegd aan de gedeelde preloadbibliotheken, voert u de volgende stappen uit:

Portal

Azure Portal gebruiken:

1. Selecteer uw flexibele Azure Database for PostgreSQL-serverexemplaren.

2. Selecteer serverparameters in het resourcemenu onder Instellingen.

3. Voeg de bibliotheken toe die u wilt toevoegen in de waarde van shared_preload_librariesen selecteer Opslaan.

   

4. Omdat shared_preload_librariesdit een statische serverparameter is, moet de server opnieuw worden opgestart, zodat de wijzigingen van kracht worden.

   

Azure-CLI

U kunt instellen shared_preload_libraries met behulp van de opdracht cli-parameterset.

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

En kan de server opnieuw opstarten met behulp van de cli-parametersetopdracht.

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

Extensies maken

Nadat een extensie is toegestaan en, als de extensie vereist, ook wordt toegevoegd aan, kan deze worden gemaakt shared_load_librariesof geïnstalleerd in elke database waarop deze moet worden gebruikt.

1. Als u een extensie wilt maken, moet een gebruiker lid zijn van de azure_pg_admin rol.

2. Voer de opdracht CREATE EXTENSION uit om een bepaalde extensie te maken of te installeren. Met deze opdracht worden de verpakte objecten in uw database geladen.

Notitie

Extensies van derden die worden aangeboden in een flexibele Azure Database for PostgreSQL-server, zijn opensource-gelicentieerde code. We bieden geen extensies of uitbreidingsversies van derden aan met premium- of eigen licentiemodellen.

Azure Database for PostgreSQL Flexibele serverinstantie ondersteunt een subset van belangrijke PostgreSQL-extensies, zoals vermeld in ondersteunde extensies op naam of in ondersteunde extensies per versie van PostgreSQL. Deze informatie is ook beschikbaar door uit te voeren SHOW azure.extensions;. Extensies die niet in deze lijsten zijn opgenomen, worden niet ondersteund op een flexibele Azure Database for PostgreSQL-server. U kunt uw eigen extensies niet maken of laden in azure Database for PostgreSQL flexibele server.

Extensies verwijderen

Als u een extensie wilt verwijderen, moet u deze eerst toestaan .

1. Als u een extensie wilt verwijderen, moet een gebruiker lid zijn van de azure_pg_admin rol.

2. Voer de opdracht DROP EXTENSION uit om een bepaalde extensie te verwijderen of te verwijderen. Met deze opdracht worden de objecten verwijderd die zijn verpakt in de extensie uit uw database.

Extensies bijwerken

Als u een geïnstalleerde extensie wilt bijwerken naar de nieuwste beschikbare versie die wordt ondersteund door Azure, gebruikt u de volgende SQL-opdracht:

ALTER EXTENSION <extension_name> UPDATE;

Deze opdracht vereenvoudigt het beheer van database-extensies doordat gebruikers handmatig kunnen upgraden naar de nieuwste versie die door Azure is goedgekeurd, waardoor compatibiliteit en beveiliging worden verbeterd.

Beperkingen

Hoewel het bijwerken van extensies eenvoudig is, zijn er bepaalde beperkingen:

• Selectie van een specifieke versie: de opdracht biedt geen ondersteuning voor het bijwerken naar tussenliggende versies van een extensie.

  • De nieuwste beschikbare versie wordt voortdurend bijgewerkt.

• Downgraden: biedt geen ondersteuning voor het downgraden van een extensie naar een eerdere versie. Als een downgrade nodig is, is er mogelijk ondersteuning nodig en is dit afhankelijk van de beschikbaarheid van de vorige versie.

Geïnstalleerde extensies weergeven

Gebruik de volgende SQL-opdracht om de extensies weer te geven die momenteel in uw database zijn geïnstalleerd:

SELECT * FROM pg_extension;

Mogelijke fouten

Extensie %s is niet toegestaan voor gebruikers van 'azure_pg_admin' in Azure Database for PostgreSQL

Deze fout treedt op wanneer u een CREATE EXTENSION of DROP EXTENSION opdracht uitvoert die verwijst naar een extensie die niet is toegestaan, of een extensie die nog niet wordt ondersteund op het exemplaar van Azure Database voor flexibele server waarop u de opdracht uitvoert.

Alleen leden van 'azure_pg_admin' mogen CREATE EXTENSION gebruiken

Deze fout treedt op wanneer de gebruiker die een CREATE EXTENSION opdracht uitvoert geen lid is van azure_pg_admin de rol.

Alleen leden van 'azure_pg_admin' mogen DROP EXTENSION gebruiken

Deze fout treedt op wanneer de gebruiker die een DROP EXTENSION opdracht uitvoert geen lid is van azure_pg_admin de rol.

Gerelateerde inhoud

• Extensies gebruiken.
• Speciale overwegingen met extensies.
• Lijst met extensies op naam.