Zarządzanie rozszerzeniami PostgreSQL w usłudze Azure Database for PostgreSQL — serwer elastyczny

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

Elastyczny serwer usługi Azure Database for PostgreSQL umożliwia rozszerzenie funkcjonalności bazy danych przy użyciu rozszerzeń. Rozszerzenia łączą wiele powiązanych obiektów SQL w jednym pakiecie, który można załadować lub usunąć z bazy danych za pomocą polecenia . Po załadowaniu do bazy danych rozszerzenia działają jak wbudowane funkcje.

Zezwalaj na rozszerzenia

Przed zainstalowaniem rozszerzeń na serwerze elastycznym usługi Azure Database for PostgreSQL należy zezwolić na używanie tych rozszerzeń.

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera.

3. Wybierz rozszerzenia, które chcesz dodać do listy dozwolonych, spośród dostępnych w parametrze azure.extensions , a następnie wybierz pozycję Zapisz.

   

Interfejs wiersza polecenia platformy Azure

Rozszerzenia można zezwolić za pomocą polecenia zestawu parametrów interfejsu wiersza polecenia.

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

Szablon usługi Resource Manager

Korzystanie z szablonu usługi ARM:

W poniższym przykładzie dodano rozszerzenia do listy dblinkdozwolonych , dict_xsynpg_buffercache na serwerze, którego nazwa to 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"
            }
        }
    ]
}

Ładowanie bibliotek

shared_preload_libraries to parametr konfiguracji serwera, który określa, które biblioteki należy załadować po uruchomieniu serwera elastycznego usługi Azure Database for PostgreSQL. Wszystkie biblioteki korzystające z pamięci udostępnionej muszą zostać załadowane za pomocą tego parametru. Jeśli rozszerzenie musi zostać dodane do udostępnionych bibliotek wstępnego ładowania, wykonaj następujące kroki:

Portal

Korzystanie z witryny Azure Portal:

1. Wybierz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL.

2. W menu zasobów w sekcji Ustawienia wybierz pozycję Parametry serwera.

3. Uwzględnij biblioteki, które chcesz dodać do wartości shared_preload_libraries, a następnie wybierz pozycję Zapisz.

   

4. Ponieważ shared_preload_librariesjest parametrem serwera statycznego, wymaga ponownego uruchomienia serwera, aby zmiany zaczęły obowiązywać.

   

Interfejs wiersza polecenia platformy Azure

Można ustawić shared_preload_libraries za pomocą polecenia zestawu parametrów interfejsu wiersza polecenia.

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

Serwer można ponownie uruchomić przy użyciu polecenia zestawu parametrów interfejsu wiersza polecenia.

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

Tworzenie rozszerzeń

Po dodaniu rozszerzenia do listy dozwolonych i, jeśli rozszerzenie wymaga tego rozszerzenia, można go również shared_load_librariesutworzyć lub zainstalować w każdej bazie danych, na której ma być używany.

1. Aby utworzyć rozszerzenie, użytkownik musi być członkiem azure_pg_admin roli.

2. Uruchom polecenie CREATE EXTENSION, aby utworzyć lub zainstalować określone rozszerzenie. To polecenie ładuje spakowane obiekty do bazy danych.

Uwaga

Rozszerzenia innych firm oferowane na serwerze elastycznym usługi Azure Database for PostgreSQL to kod licencjonowany na oprogramowanie open source. Nie oferujemy żadnych rozszerzeń ani wersji rozszerzeń innych firm z modelami licencjonowania w warstwie Premium ani zastrzeżonymi.

Wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL obsługuje podzestaw rozszerzeń kluczy PostgreSQL, jak wymieniono w obsługiwanych rozszerzeniach według nazwy lub w obsługiwanych rozszerzeniach według wersji bazy danych PostgreSQL. Te informacje są również dostępne, uruchamiając polecenie SHOW azure.extensions;. Rozszerzenia nieuwzględniane na tych listach nie są obsługiwane na serwerze elastycznym usługi Azure Database for PostgreSQL. Nie można tworzyć ani ładować własnych rozszerzeń na serwerze elastycznym usługi Azure Database for PostgreSQL.

Usuwanie rozszerzeń

Aby usunąć rozszerzenie, najpierw upewnij się, że jest to lista dozwolonych.

1. Aby usunąć rozszerzenie, użytkownik musi być członkiem azure_pg_admin roli.

2. Uruchom polecenie DROP EXTENSION, aby usunąć lub odinstalować określone rozszerzenie. To polecenie usuwa obiekty spakowane w rozszerzeniu z bazy danych.

Aktualizowanie rozszerzeń

Aby zaktualizować zainstalowane rozszerzenie do najnowszej dostępnej wersji obsługiwanej przez platformę Azure, użyj następującego polecenia SQL:

ALTER EXTENSION <extension_name> UPDATE;

To polecenie upraszcza zarządzanie rozszerzeniami bazy danych, umożliwiając użytkownikom ręczne uaktualnienie do najnowszej wersji zatwierdzonej przez platformę Azure, zwiększając zgodność i zabezpieczenia.

Ograniczenia

Chociaż aktualizowanie rozszerzeń jest proste, istnieją pewne ograniczenia:

• Wybór określonej wersji: polecenie nie obsługuje aktualizacji do wersji pośrednich rozszerzenia.

  • Stale aktualizuje najnowszą dostępną wersję.

• Obniżanie wersji: nie obsługuje obniżania poziomu rozszerzenia do poprzedniej wersji. Jeśli konieczna jest obniżenie poziomu, może to wymagać pomocy technicznej i zależy od dostępności poprzedniej wersji.

Wyświetlanie zainstalowanych rozszerzeń

Aby wyświetlić listę rozszerzeń aktualnie zainstalowanych w bazie danych, użyj następującego polecenia SQL:

SELECT * FROM pg_extension;

Możliwe błędy

Rozszerzenie %s nie jest wyświetlane na liście dozwolonych dla użytkowników "azure_pg_admin" w usłudze Azure Database for PostgreSQL

Ten błąd występuje podczas uruchamiania CREATE EXTENSION polecenia lub DROP EXTENSION odwołującego się do rozszerzenia, które nie jest dozwolone, lub rozszerzenia, które nie jest jeszcze obsługiwane w wystąpieniu usługi Azure Database dla serwera elastycznego, na którym jest uruchomione polecenie.

Tylko członkowie "azure_pg_admin" mogą używać rozszerzenia CREATE

Ten błąd występuje, gdy użytkownik, który uruchamia CREATE EXTENSION polecenie, nie jest członkiem azure_pg_admin roli.

Tylko członkowie "azure_pg_admin" mogą używać rozszerzenia DROP

Ten błąd występuje, gdy użytkownik, który uruchamia DROP EXTENSION polecenie, nie jest członkiem azure_pg_admin roli.

Powiązana zawartość

• Jak używać rozszerzeń.
• Specjalne zagadnienia dotyczące rozszerzeń.
• Lista rozszerzeń według nazwy.