데이터베이스 확장 프로그램 구성

이 페이지에서는 AlloyDB에서 PostgreSQL 확장 프로그램을 사용 설정 및 사용 중지하는 방법을 설명합니다.

AlloyDB에서 지원하는 확장 프로그램 목록은 지원되는 데이터베이스 확장 프로그램을 참고하세요.

시작하기 전에

  • 사용 중인 Google Cloud 프로젝트에 AlloyDB에 액세스할 수 있는 권한이 있어야 합니다.
  • 사용 중인 Google Cloud 프로젝트에 다음 IAM 역할 중 하나가 있어야 합니다.
    • roles/alloydb.admin (AlloyDB 관리자가 사전 정의한 IAM 역할)
    • roles/owner(소유자 기본 IAM 역할)
    • roles/editor(편집자 기본 IAM 역할)

    이러한 역할이 없는 경우 조직 관리자에게 문의하여 액세스 권한을 요청하세요.

확장 프로그램 사용 설정

일반적으로 AlloyDB 클러스터의 기본 인스턴스에서 데이터베이스에 연결하고 LOAD 또는 CREATE EXTENSION 명령어를 입력하여 확장 프로그램을 사용 설정합니다.

하지만 일부 확장 프로그램의 경우 LOAD 또는 CREATE EXTENSION 명령어를 사용하여 확장 프로그램을 사용 설정하기 전에 하나 이상의 데이터베이스 플래그를 설정해야 합니다. 인스턴스가 기본 인스턴스인지 읽기 풀 인스턴스인지와 관계없이 확장 프로그램을 사용하려는 AlloyDB 인스턴스에서 이러한 플래그를 설정합니다.

절차

  1. 필요한 경우 확장 프로그램을 사용하려는 인스턴스(기본 인스턴스 또는 읽기 풀 인스턴스)에서 적절한 데이터베이스 플래그를 설정합니다.

    지원되는 확장 프로그램 목록에는 이 단계가 필요한 확장 프로그램과 설정해야 하는 데이터베이스 플래그가 표시됩니다.

  2. psql 클라이언트를 인스턴스에 연결에 설명된 대로 psql 클라이언트를 클러스터의 기본 인스턴스에 연결합니다.

  3. psql 명령 프롬프트에서 데이터베이스에 연결하고 확장 프로그램을 만듭니다. 
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. 원하는 경우 이전 단계를 반복하여 다른 데이터베이스에 연결하고 각 데이터베이스에서 확장 프로그램을 만듭니다.

확장 프로그램 사용 중지

확장 프로그램을 사용 설정하는 데 사용한 절차를 반대로 하여 확장 프로그램을 사용 중지합니다.

  1. psql 클라이언트를 인스턴스에 연결에 설명된 대로 psql 클라이언트를 클러스터의 기본 인스턴스에 연결합니다.

  2. psql 명령 프롬프트에서 확장 프로그램이 사용 설정된 데이터베이스에 연결하고 확장 프로그램을 삭제합니다. 
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. 이전 단계를 반복하여 확장 프로그램이 사용 설정된 다른 데이터베이스에 연결하고 각 데이터베이스에 확장 프로그램을 드롭합니다.

  4. 확장 프로그램이 사용된 인스턴스에 데이터베이스 플래그를 설정해야 하는 경우 인스턴스의 데이터베이스 플래그 구성의 안내에 따라 사용된 각 인스턴스에서 플래그를 삭제합니다.

    지원되는 확장 프로그램 목록에는 데이터베이스 플래그 설정이 필요한 확장 프로그램과 어떤 플래그가 필요한지 표시됩니다.