# pgactive 함수 참조
<a name="pgactive-functions-reference"></a>

다음은 효과적으로 사용하기 위한 파라미터, 반환 값 및 실제 사용 정보가 포함된 pgactive 함수의 목록입니다.

## get\_last\_applied\_xact\_info
<a name="get-last-applied-xact-info"></a>

지정된 노드에 대해 마지막으로 적용된 트랜잭션 정보를 검색합니다.

**인수**  
+ sysid(텍스트) - 타임라인 OID
+ dboid(OID)

**반환 타입**  
다음을 기록합니다.  
+ last\_applied\_xact\_id(OID)
+ last\_applied\_xact\_committs(타임스탬프와 시간대)
+ last\_applied\_xact\_at(타임스탬프와 시간대)

**사용 노트**  
이 함수를 사용하여 지정된 노드에 마지막으로 적용된 트랜잭션 정보를 검색합니다.

## pgactive\_apply\_pause
<a name="pgactive-apply-pause"></a>

복제 적용 프로세스를 일시 중지합니다.

**인수**  
없음

**반환 타입**  
boolean

**사용 노트**  
복제 적용 프로세스를 일시 중지하려면 이 함수를 직접적으로 호출합니다.

## pgactive\_apply\_resume
<a name="pgactive-apply-resume"></a>

복제 적용 프로세스를 재개합니다.

**인수**  
없음

**반환 타입**  
void

**사용 노트**  
복제 적용 프로세스를 재개하려면 이 함수를 직접적으로 호출합니다.

## pgactive\_is\_apply\_paused
<a name="pgactive-is-apply-paused"></a>

복제 적용이 현재 일시 중지되었는지 확인합니다.

**인수**  
없음

**반환 타입**  
boolean

**사용 노트**  
이 함수를 사용하여 복제 적용이 현재 일시 중지되었는지 확인합니다.

## pgactive\_create\_group
<a name="pgactive-create-group"></a>

독립 실행형 데이터베이스를 초기 노드로 변환하여 pgactive 그룹을 만듭니다.



**인수**  
+ node\_name(텍스트)
+ node\_dsn(텍스트)
+ apply\_delay 정수 DEFAULT NULL::정수 - replication\_sets 텍스트[] DEFAULT ARRAY[‘default’::텍스트]

**반환 타입**  
void

**사용 노트**  
독립 실행형 데이터베이스를 초기 노드로 변환하여 pgactive 그룹을 만듭니다. 이 함수는 노드를 pgactive 노드로 변환하기 전에 무결성 검사를 수행합니다. 이 함수를 사용하기 전에 PostgreSQL 클러스터에 pgactive 백그라운드 작업자를 지원할 수 있는 충분한 `max_worker_processes`가 있는지 확인합니다.

## pgactive\_detach\_nodes
<a name="pgactive-detach-nodes"></a>

pgactive 그룹에서 지정된 노드를 제거합니다.

**인수**  
+ p\_nodes(텍스트[])

**반환 타입**  
void

**사용 노트**  
이 함수를 사용하여 pgactive 그룹에서 지정된 노드를 제거합니다.

## pgactive\_exclude\_table\_replication\_set
<a name="pgactive-exclude-table-replication-set"></a>

복제에서 특정 테이블을 제외합니다.

**인수**  
+ p\_relation(regclass)

**반환 타입**  
void

**사용 노트**  
이 함수를 사용하여 복제에서 특정 테이블을 제외합니다.

## pgactive\_get\_replication\_lag\_info
<a name="pgactive-get-replication-lag-info"></a>

노드 세부 정보, WAL 상태 및 LSN 값을 포함한 자세한 복제 지연 정보를 검색합니다.

**인수**  
없음

**반환 타입**  
SETOF 레코드 - node\_name 텍스트 - node\_sysid 텍스트 - application\_name 텍스트 - slot\_name 텍스트 - active 부울 - active\_pid 정수 - pending\_wal\_decoding bigint - 전송자 노드에서 디코딩할 WAL의 대략적인 크기(바이트) - pending\_wal\_to\_apply bigint - 수신 노드에서 적용할 WAL의 대략적인 크기(바이트) - restart\_lsn pg\_lsn - confirmed\_flush\_lsn pg\_lsn - sent\_lsn pg\_lsn - write\_lsn pg\_lsn - flush\_lsn pg\_lsn - replay\_lsn pg\_lsn

**사용 노트**  
이 함수를 직접적으로 호출하여 노드 세부 정보, WAL 상태 및 LSN 값을 포함한 복제 지연 정보를 검색합니다.

## pgactive\_get\_stats
<a name="pgactive-get-stats"></a>

pgactive 복제 통계를 검색합니다.

**인수**  
없음

**반환 타입**  
SETOF 레코드 - rep\_node\_id oid - rilocalid oid - riremoteid text - nr\_commit bigint - nr\_rollback bigint - nr\_insert bigint - nr\_insert\_conflict bigint - nr\_update bigint - nr\_update\_conflict bigint - nr\_delete bigint - nr\_delete\_conflict bigint - nr\_disconnect bigint

**사용 노트**  
이 함수를 사용하여 pgactive 복제 통계를 검색합니다.

## pgactive\_get\_table\_replication\_sets
<a name="pgactive-get-table-replication-sets"></a>

특정 관계에 대한 복제 세트 구성을 가져옵니다.

**인수**  
+ 관계(regclass)

**반환 타입**  
SETOF 레코드

**사용 노트**  
이 함수를 직접적으로 호출하여 특정 관계에 대한 복제 세트 구성을 가져옵니다.

## pgactive\_include\_table\_replication\_set
<a name="pgactive-include-table-replication-set"></a>

복제에 특정 테이블을 포함합니다.

**인수**  
+ p\_relation(regclass)

**반환 타입**  
void

**사용 노트**  
복제에 특정 테이블을 포함하려면 이 함수를 사용합니다.

## pgactive\_join\_group
<a name="pgactive-join-group"></a>

기존 pgactive 그룹에 노드를 추가합니다.

**인수**  
+ node\_name(텍스트)
+ node\_dsn(텍스트)
+ join\_using\_dsn(텍스트)
+ apply\_delay(정수, 선택 사항)
+ replication\_sets(텍스트[], 기본값: ['default'])
+ bypass\_collation\_check(부울, 기본값: false)
+ bypass\_node\_identifier\_creation(부울, 기본값: false)
+ bypass\_user\_tables\_check(부울, 기본값: false)

**반환 타입**  
void

**사용 노트**  
이 함수를 직접적으로 호출하여 기존 pgactive 그룹에 노드를 추가합니다. PostgreSQL 클러스터에 pgactive 백그라운드 작업자를 위한 충분한 max\_worker\_processes가 있는지 확인합니다.

## pgactive\_remove
<a name="pgactive-remove"></a>

로컬 노드에서 모든 pgactive 구성 요소를 제거합니다.

**인수**  
+ force(부울, 기본값: false)

**반환 타입**  
void

**사용 노트**  
로컬 노드에서 모든 pgactive 구성 요소를 제거하려면 이 함수를 직접적으로 호출합니다.

## pgactive\_snowflake\_id\_nextval
<a name="pgactive-snowflake-id-nextval"></a>

노드별 고유 시퀀스 값을 생성합니다.

**인수**  
+ regclass

**반환 타입**  
bigint

**사용 노트**  
이 함수를 사용하여 노드별 고유 시퀀스 값을 생성합니다.

## pgactive\_update\_node\_conninfo
<a name="pgactive-update-node-conninfo"></a>

pgactive 노드의 연결 정보를 업데이트합니다.

**인수**  
+ node\_name\_to\_update(텍스트)
+ node\_dsn\_to\_update(텍스트)

**반환 타입**  
void

**사용 노트**  
이 함수를 사용하여 pgactive 노드의 연결 정보를 업데이트합니다.

## pgactive\_wait\_for\_node\_ready
<a name="pgactive-wait-for-node-ready"></a>

그룹 생성 또는 조인 작업의 진행 상황을 모니터링합니다.

**인수**  
+ timeout(정수, 기본값: 0)
+ progress\_interval(정수, 기본값: 60)

**반환 타입**  
void

**사용 노트**  
이 함수를 직접적으로 호출하여 그룹 만들기 또는 조인 작업의 진행 상황을 모니터링합니다.