Správa rozšíření PostgreSQL

PLATÍ PRO: Flexibilní server Azure Database for PostgreSQL

Flexibilní server Azure Database for PostgreSQL umožňuje rozšířit funkce databáze pomocí rozšíření. Rozšíření sbalí několik souvisejících objektů SQL v jednom balíčku, který lze načíst nebo odebrat z databáze pomocí příkazu. Po načtení do databáze fungují rozšíření jako integrované funkce.

Povolit rozšíření

Před instalací rozšíření na flexibilním serveru Azure Database for PostgreSQL musíte povolit, aby byla tato rozšíření uvedena pro použití.

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru.

3. Vyberte rozšíření, která chcete povolit, z rozšíření dostupných v parametru azure.extensions a vyberte Uložit.

   

Azure CLI

Rozšíření můžete povolit pomocí příkazu sady parametrů rozhraní příkazového řádku.

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

Šablona Resource Manageru

Použití šablony ARM:

Následující příklad přidá rozšíření do seznamu dblinkpovolených , dict_xsynpg_buffercache na serveru, jehož název je postgres-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"
            }
        }
    ]
}

Načtení knihoven

shared_preload_libraries je parametr konfigurace serveru, který určuje, které knihovny se musí načíst při spuštění flexibilního serveru Azure Database for PostgreSQL. Všechny knihovny, které používají sdílenou paměť, musí být načteny prostřednictvím tohoto parametru. Pokud je potřeba rozšíření přidat do sdílených knihoven předběžného načtení, postupujte takto:

Azure Portal

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Nastavení vyberte Parametry serveru.

3. Přidejte knihovny, které chcete přidat do hodnoty shared_preload_librariesa vyberte Uložit.

   

4. Protože shared_preload_librariesje parametr statického serveru, vyžaduje restartování serveru, aby se změny projevily.

   

Azure CLI

Můžete nastavit shared_preload_libraries pomocí příkazu sady parametrů rozhraní příkazového řádku.

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

Server můžete restartovat pomocí příkazu sady parametrů rozhraní příkazového řádku.

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

Vytváření rozšíření

Po přidání rozšíření do seznamu povolených a pokud ho rozšíření vyžaduje, je možné shared_load_librariesho vytvořit nebo nainstalovat do každé databáze, na kterou se má použít.

1. Pokud chcete vytvořit rozšíření, musí být uživatel členem azure_pg_admin role.

2. Spuštěním příkazu CREATE EXTENSION vytvořte nebo nainstalujte konkrétní rozšíření. Tento příkaz načte zabalené objekty do databáze.

Poznámka:

Rozšíření třetích stran nabízená na flexibilním serveru Azure Database for PostgreSQL jsou opensourcový licencovaný kód. Nenabízíme žádná rozšíření nebo verze rozšíření třetích stran s prémiovými nebo proprietárními licenčními modely.

Flexibilní instance serveru Azure Database for PostgreSQL podporuje podmnožinu klíčových rozšíření PostgreSQL, jak je uvedeno v podporovaných rozšířeních podle názvu nebo v podporovaných rozšířeních podle verze PostgreSQL. Tyto informace jsou k dispozici také spuštěním SHOW azure.extensions;příkazu . Rozšíření, která nejsou zahrnutá v těchto seznamech, se na flexibilním serveru Azure Database for PostgreSQL nepodporují. Na flexibilním serveru Azure Database for PostgreSQL nemůžete vytvářet ani načítat vlastní rozšíření.

Přetažení rozšíření

Pokud chcete rozšíření odstranit, nezapomeňte ho nejdřív povolit .

1. Pokud chcete rozšíření odstranit, musí být uživatel členem azure_pg_admin role.

2. Spuštěním příkazu DROP EXTENSION odstraňte nebo odinstalujte konkrétní rozšíření. Tento příkaz zahodí objekty zabalené v rozšíření z vaší databáze.

Aktualizace rozšíření

Pokud chcete aktualizovat nainstalované rozšíření na nejnovější dostupnou verzi podporovanou v Azure, použijte následující příkaz SQL:

ALTER EXTENSION <extension_name> UPDATE;

Tento příkaz zjednodušuje správu rozšíření databáze tím, že uživatelům umožňuje ruční upgrade na nejnovější verzi schválenou Azure, což zvyšuje kompatibilitu i zabezpečení.

Omezení

Aktualizace rozšíření je sice jednoduchá, ale existují určitá omezení:

• Výběr konkrétní verze: Příkaz nepodporuje aktualizaci na zprostředkující verze rozšíření.

  • Neustále aktualizuje nejnovější dostupnou verzi.

• Downgrading: Nepodporuje downgradování rozšíření na předchozí verzi. Pokud je potřeba downgrade, může vyžadovat pomoc s podporou a závisí na dostupnosti předchozí verze.

Zobrazení nainstalovaných rozšíření

Pokud chcete zobrazit seznam rozšíření aktuálně nainstalovaných v databázi, použijte následující příkaz SQL:

SELECT * FROM pg_extension;

Možné chyby

Rozšíření %s není povolené pro uživatele azure_pg_admin ve službě Azure Database for PostgreSQL

K této chybě dochází při spuštění CREATE EXTENSION DROP EXTENSION nebo příkazu odkazujícího na rozšíření, které není na seznamu povolených, nebo rozšíření, které ještě není podporováno v instanci služby Azure Database pro flexibilní server, na kterém příkaz spouštíte.

Rozšíření CREATE můžou používat jenom členové azure_pg_admin.

K této chybě dochází, když uživatel, který spouští CREATE EXTENSION příkaz, není členem azure_pg_admin role.

Rozšíření DROP můžou používat jenom členové azure_pg_admin.

K této chybě dochází, když uživatel, který spouští DROP EXTENSION příkaz, není členem azure_pg_admin role.

Související obsah

• Jak používat rozšíření
• Důležité informace o rozšířeních
• Seznam rozšíření podle názvu