PostgreSQL 확장 관리

적용 대상: Azure Database for PostgreSQL - 유연한 서버

Azure Database for PostgreSQL 유연한 서버를 사용하면 확장을 사용하여 데이터베이스의 기능을 확장할 수 있습니다. 확장은 명령을 사용하여 데이터베이스에서 로드하거나 제거할 수 있는 단일 패키지에서 여러 관련 SQL 개체를 번들로 묶습니다. 데이터베이스에 로드된 후에 확장은 기본 제공 기능으로 작동할 수 있습니다.

확장 허용

Azure Database for PostgreSQL 유연한 서버에 확장을 설치하기 전에 이러한 확장을 사용하도록 나열하도록 허용해야 합니다.

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

라이브러리 로드

shared_preload_libraries는 Azure Database for PostgreSQL 유연한 서버가 시작될 때 로드해야 하는 라이브러리를 결정하는 서버 구성 매개 변수입니다. 공유 메모리를 사용하는 모든 라이브러리는 이 매개 변수를 통해 로드되어야 합니다. 공유 프리로드 라이브러리에 확장을 추가해야 하는 경우 다음 단계를 수행합니다.

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>

확장 만들기

확장이 허용 목록에 추가되고 확장에 필요한 shared_load_libraries경우 확장을 사용할 각 데이터베이스에 만들거나 설치할 수 있습니다.

1. 확장을 만들려면 사용자가 역할의 azure_pg_admin 멤버여야 합니다.

2. CREATE EXTENSION 명령을 실행하여 특정 확장을 만들거나 설치합니다. 이 명령은 패키지 개체를 데이터베이스에 로드합니다.

Azure Database for PostgreSQL 유연한 서버 인스턴스는 지원되는 확장 이름 또는 PostgreSQL 버전별 지원되는 확장에 나열된 대로 주요 PostgreSQL 확장의 하위 집합을 지원합니다. 이 정보를 SHOW azure.extensions;를 실행하여 얻을 수도 있습니다. 이러한 목록에 포함되지 않은 확장은 Azure Database for PostgreSQL 유연한 서버에서 지원되지 않습니다. Azure Database for PostgreSQL 유연한 서버에서는 고유한 확장을 만들거나 로드할 수 없습니다.

확장 삭제

확장을 삭제하려면 먼저 허용 목록을 만들어야 합니다.

1. 확장을 삭제하려면 사용자가 역할의 azure_pg_admin 멤버여야 합니다.

2. DROP EXTENSION 명령을 실행하여 특정 확장을 삭제하거나 제거합니다. 이 명령은 확장에 패키지된 개체를 데이터베이스에서 삭제합니다.

확장 업데이트

설치된 확장을 Azure에서 지원하는 사용 가능한 최신 버전으로 업데이트하려면 다음 SQL 명령을 사용합니다.

ALTER EXTENSION <extension_name> UPDATE;

이 명령은 사용자가 Azure에서 승인한 최신 버전으로 수동으로 업그레이드할 수 있도록 하여 데이터베이스 확장 관리를 간소화함으로써 호환성과 보안을 모두 향상합니다.

제한 사항

확장 업데이트는 간단하지만 다음과 같은 특정 제한 사항이 있습니다.

• 특정 버전 선택: 이 명령은 확장의 중간 버전으로의 업데이트를 지원하지 않습니다.

  • 사용 가능한 최신 버전을 지속적으로 업데이트합니다.

• 다운그레이드: 이전 버전으로 확장을 다운그레이드하는 것은 지원되지 않습니다. 다운그레이드가 필요한 경우 지원 지원이 필요할 수 있으며 이전 버전의 가용성에 따라 달라집니다.

설치된 확장 보기

데이터베이스에 현재 설치된 확장을 나열하려면 다음 SQL 명령을 사용합니다.

SELECT * FROM pg_extension;

가능한 오류

확장 "%s"은(는) Azure Database for PostgreSQL의 "azure_pg_admin" 사용자에 대해 허용 목록에 없습니다.

이 오류는 허용 목록에 없는 확장을 참조하는 명령이나 DROP EXTENSION 명령을 실행하거나 명령을 실행 중인 유연한 서버를 위해 Azure Database 인스턴스에서 아직 지원되지 않는 확장을 실행할 CREATE EXTENSION 때 발생합니다.

"azure_pg_admin" 멤버만 CREATE EXTENSION을 사용할 수 있습니다.

이 오류는 명령을 실행하는 CREATE EXTENSION 사용자가 역할의 azure_pg_admin 멤버가 아닌 경우에 발생합니다.

"azure_pg_admin" 멤버만 DROP EXTENSION을 사용할 수 있습니다.

이 오류는 명령을 실행하는 DROP EXTENSION 사용자가 역할의 azure_pg_admin 멤버가 아닌 경우에 발생합니다.

관련 콘텐츠

• 확장을 사용하는 방법.
• 확장에 대한 특별 고려 사항입니다.
• 이름별 확장 목록입니다.