Управление расширениями PostgreSQL

ОБЛАСТЬ ПРИМЕНЕНИЯ: База данных Azure для PostgreSQL — гибкий сервер

База данных Azure для PostgreSQL гибкий сервер позволяет расширить функциональные возможности базы данных с помощью расширений. Расширения объединяют несколько связанных объектов SQL в одном пакете, который можно загрузить или удалить из базы данных с помощью команды. После загрузки в базу данных расширения работают как встроенные функции.

Разрешить расширения

Перед установкой расширений на гибком сервере База данных Azure для PostgreSQL необходимо разрешить использовать эти расширения.

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера.

3. Выберите расширения, которые вы хотите разрешить, из тех, которые доступны в параметре azure.extensions , и нажмите кнопку "Сохранить".

   

Azure CLI

Расширения можно разрешить с помощью команды набора параметров CLI.

    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

Использование шаблона ARM:

В следующем примере добавляются расширения в список dblinkразрешений , dict_xsynpg_buffercache на сервере, имя которого :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"
            }
        }
    ]
}

Загрузка библиотек

shared_preload_libraries— это параметр конфигурации сервера, который определяет, какие библиотеки необходимо загрузить при запуске гибкого сервера База данных Azure для PostgreSQL. Все библиотеки, использующие общую память, должны загружаться с помощью этого параметра. Если расширение необходимо добавить в общие библиотеки предварительной загрузки, выполните следующие действия.

Портал

В случае использования портала Azure выполните следующие действия:

1. Выберите гибкий экземпляр сервера База данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Параметры " выберите параметры сервера.

3. Включите библиотеки, которые нужно добавить в значение shared_preload_libraries, и нажмите кнопку "Сохранить".

   

4. Так как shared_preload_librariesэто статический параметр сервера, он требует перезагрузки сервера, чтобы изменения вступили в силу.

   

Azure CLI

Можно задать shared_preload_libraries с помощью команды набора параметров CLI.

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

И может перезапустить сервер с помощью команды набора параметров CLI.

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

Создание расширений

После того как расширение разрешено, и если расширение требует его, также добавляется shared_load_librariesв, его можно создать или установить в каждой базе данных, в которой он будет использоваться.

1. Чтобы создать расширение, пользователь должен быть членом azure_pg_admin роли.

2. Выполните команду CREATE EXTENSION, чтобы создать или установить определенное расширение. Эта команда загружает упакованные объекты в базу данных.

Примечание.

Сторонние расширения, предлагаемые в База данных Azure для PostgreSQL гибком сервере, являются лицензированным кодом с открытым исходным кодом. Мы не предлагаем сторонние расширения или версии расширений с моделями лицензирования уровня "Премиум" или "Частный".

База данных Azure для PostgreSQL гибкий экземпляр сервера поддерживает подмножество ключевых расширений PostgreSQL, как указано в поддерживаемых расширениях по имени или в поддерживаемых расширениях по версии PostgreSQL. Эти сведения также можно получить, выполнив SHOW azure.extensions;. Расширения, не включенные в эти списки, не поддерживаются на гибком сервере База данных Azure для PostgreSQL. Вы не можете создавать или загружать собственные расширения в База данных Azure для PostgreSQL гибком сервере.

Удаление расширений

Чтобы удалить расширение, сначала убедитесь, что он разрешен .

1. Чтобы удалить расширение, пользователь должен быть членом azure_pg_admin роли.

2. Выполните команду DROP EXTENSION, чтобы удалить или удалить определенное расширение. Эта команда удаляет объекты, упакованные в расширение из базы данных.

Обновление расширений

Чтобы обновить установленное расширение до последней доступной версии, поддерживаемой Azure, используйте следующую команду SQL:

ALTER EXTENSION <extension_name> UPDATE;

Эта команда упрощает управление расширениями базы данных, позволяя пользователям вручную обновляться до последней версии, утвержденной Azure, повышая совместимость и безопасность.

Ограничения

Хотя обновление расширений является простым, существуют некоторые ограничения:

• Выбор определенной версии: команда не поддерживает обновление до промежуточных версий расширения.

  • Он постоянно обновляет последнюю доступную версию.

• Понижение: не поддерживает понижение уровня расширения до предыдущей версии. Если требуется понижение, может потребоваться помощь в поддержке и зависит от доступности предыдущей версии.

Просмотр установленных расширений

Чтобы вывести список расширений, установленных в настоящее время в базе данных, используйте следующую команду SQL:

SELECT * FROM pg_extension;

Возможные ошибки

Расширение "%s" не разрешено для пользователей "azure_pg_admin" в База данных Azure для PostgreSQL

Эта ошибка возникает при запуске CREATE EXTENSION или DROP EXTENSION команде, ссылающейся на расширение, которое не разрешено, или расширение, которое еще не поддерживается в экземпляре базы данных Azure для гибкого сервера, на котором выполняется команда.

Только члены "azure_pg_admin" разрешены использовать CREATE EXTENSION

Эта ошибка возникает, когда пользователь, выполняющий CREATE EXTENSION команду, не является членом azure_pg_admin роли.

Только члены "azure_pg_admin" разрешены использовать DROP EXTENSION

Эта ошибка возникает, когда пользователь, выполняющий DROP EXTENSION команду, не является членом azure_pg_admin роли.

Связанный контент

• Использование расширений.
• Особые вопросы с расширениями.
• Список расширений по имени.