Azure Database for PostgreSQL에 PostgreSQL 확장을 사용하는 방법

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

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

확장 허용

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

포털

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택합니다.

3. azure.extensions 매개 변수를 검색합니다.

4. 허용하려는 확장을 선택합니다.

   

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 템플릿 사용:

다음 예제에서는 이름이 postgres-test-server다음과 같은 서버의 허용 목록에 dblinkdict_xsynpg_buffercache 확장을 추가합니다.

{
    "$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 유연한 서버가 시작될 때 로드해야 하는 라이브러리를 결정하는 서버 구성 매개 변수입니다. 공유 메모리를 사용하는 모든 라이브러리는 이 매개 변수를 통해 로드되어야 합니다. 공유 프리로드 라이브러리에 확장을 추가해야 하는 경우 다음 단계를 수행합니다.

Azure Portal 사용:

1. Azure Database for PostgreSQL 유연한 서버 인스턴스를 선택합니다.

2. 리소스 메뉴의 설정 섹션에서 서버 매개 변수를 선택합니다.

3. shared_preload_libraries 매개 변수를 검색합니다.

4. 추가하려는 라이브러리를 선택합니다.

   

CLI 매개 변수 집합 명령을 통해 설정할 shared_preload_libraries 수 있습니다.

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

확장 만들기

확장이 허용 목록에 추가되고 로드된 후에는 확장을 사용할 각 데이터베이스에 설치해야 합니다.

1. 확장을 만들려면 사용자가 역할의 azure_pg_admin 멤버여야 합니다. 역할의 멤버는 azure_pg_admin 다른 사용자에게 확장을 만들 수 있는 권한을 부여할 수 있습니다.

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

참고 항목

Azure Database for PostgreSQL 유연한 서버에서 제공되는 타사 확장은 오픈 소스 라이선스 코드입니다. 프리미엄 또는 독점 라이선스 모델이 있는 타사 확장 또는 확장 버전은 제공하지 않습니다.

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

PostgreSQL 확장 업그레이드

간단한 명령을 사용하면 데이터베이스 확장을 현재 위치로 업그레이드할 수 있습니다. 이 기능을 통해 고객은 타사 확장 프로그램을 최신 버전으로 자동 업데이트하여 수동 작업 없이도 최신의 안전한 시스템을 유지할 수 있습니다.

확장 업데이트

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

ALTER EXTENSION <extension_name> UPDATE;

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

설치된 확장

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

SELECT * FROM pg_extension;

사용 가능한 확장 목록을 봅니다.

제한 사항

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

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

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

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

Azure Database for PostgreSQL 제품 팀과 제안 및 버그를 공유합니다.

관련 콘텐츠

• 확장 버전
• 확장 고려 사항
• 피드백 포럼