# pgactive 확장 기능 초기화
<a name="Appendix.PostgreSQL.CommonDBATasks.pgactive.basic-setup"></a>

RDS for PostgreSQL DB 인스턴스에서 `pgactive` 확장 기능을 초기화하려면 `rds.enable_pgactive` 파라미터 값을 `1`로 설정한 다음 데이터베이스에 확장을 생성합니다. 이렇게 하면 파라미터 `rds.logical_replication` 및 `track_commit_timestamp`가 자동으로 활성화되고 `wal_level` 값이 `logical`로 설정됩니다.

이러한 작업을 수행하려면 `rds_superuser` 역할의 권한이 있어야 합니다.

AWS Management Console 또는 AWS CLI를 사용하여 PostgreSQL DB 인스턴스에 필요한 RDS를 생성할 수 있습니다. 다음 단계에서는 RDS for PostgreSQL DB 인스턴스가 사용자 지정 DB 파라미터 그룹에 연결되어 있다고 가정합니다. 사용자 지정 DB 파라미터 그룹 생성에 대한 자세한 내용은 [Amazon RDS의 파라미터 그룹](USER_WorkingWithParamGroups.md) 단원을 참조하세요.

## 콘솔
<a name="Appendix.PostgreSQL.CommonDBATasks.pgactive.basic-setup.CON"></a>

**pgactive 확장 기능을 초기화하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.

1. 탐색 창에서 RDS for PostgreSQL DB 인스턴스를 선택합니다.

1. RDS for PostgreSQL DB 인스턴스의 **구성** 탭을 엽니다. 인스턴스 세부 정보에서 **DB 인스턴스 파라미터 그룹** 링크를 찾습니다.

1. 링크를 선택하여 RDS for PostgreSQL DB 인스턴스와 연결된 사용자 지정 파라미터를 엽니다.

1. `rds.enable_pgactive` 파라미터를 찾아 `1`로 설정하여 `pgactive` 기능을 초기화합니다.

1. **변경 사항 저장**을 선택합니다.

1. Amazon RDS 콘솔의 탐색 창에서 **데이터베이스**를 선택합니다.

1. RDS for PostgreSQL DB 인스턴스를 선택한 다음 **작업** 메뉴에서 **재부팅**을 선택합니다.

1. DB 인스턴스 재부팅을 확인하여 변경 사항을 적용합니다.

1. DB 인스턴스를 사용할 수 있게 되면 `psql` 또는 다른 PostgreSQL 클라이언트를 사용하여 RDS for PostgreSQL DB 인스턴스에 연결합니다.

   다음 예시에서는 RDS for PostgreSQL DB 인스턴스에 *postgres*라는 기본 데이터베이스가 있다고 가정합니다.

   ```
   psql --host=mydb.111122223333.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password=PASSWORD --dbname=postgres
   ```

1. pgactive가 초기화되었는지 확인하려면 다음 명령을 실행합니다.

   ```
   postgres=>SELECT setting ~ 'pgactive' 
   FROM pg_catalog.pg_settings
   WHERE name = 'shared_preload_libraries';
   ```

   `pgactive`가 `shared_preload_libraries`에 들어 있는 경우 앞의 명령은 다음을 반환합니다.

   ```
   ?column? 
   ----------
    t
   ```

## AWS CLI
<a name="Appendix.PostgreSQL.CommonDBATasks.pgactive.basic-setup.CLI"></a>

**pgactive 확장 기능을 초기화하려면**

AWS CLI를 사용하여 `pgactive`를 초기화하려면 다음 절차와 같이 [modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) 작업을 호출하여 사용자 지정 파라미터 그룹의 특정 파라미터를 수정합니다.

1. 다음 AWS CLI 명령으로 `rds.enable_pgactive`를 `1`로 설정하여 RDS for PostgreSQL DB 인스턴스의 `pgactive` 기능을 초기화합니다.

   ```
   postgres=>aws rds modify-db-parameter-group \
      --db-parameter-group-name custom-param-group-name \
      --parameters "ParameterName=rds.enable_pgactive,ParameterValue=1,ApplyMethod=pending-reboot" \
      --region aws-region
   ```

1. 다음 AWS CLI 명령으로 RDS for PostgreSQL DB 인스턴스를 재부팅하여 `pgactive` 라이브러리가 초기화되도록 합니다.

   ```
   aws rds reboot-db-instance \
       --db-instance-identifier your-instance \
       --region aws-region
   ```

1. 인스턴스를 사용할 수 있다면 `psql`을 사용하여 RDS for PostgreSQL DB 인스턴스에 연결합니다.

   ```
   psql --host=mydb.111122223333.aws-region.rds.amazonaws.com --port=5432 --username=master user --password=PASSWORD --dbname=postgres
   ```

1. pgactive가 초기화되었는지 확인하려면 다음 명령을 실행합니다.

   ```
   postgres=>SELECT setting ~ 'pgactive' 
   FROM pg_catalog.pg_settings
   WHERE name = 'shared_preload_libraries';
   ```

   `pgactive`가 `shared_preload_libraries`에 들어 있는 경우 앞의 명령은 다음을 반환합니다.

   ```
   ?column? 
   ----------
    t
   ```