Azure Cosmos DB for PostgreSQL 분산 SQL API

아티클
08/15/2024

적용 대상: Azure Cosmos DB for PostgreSQL(PostgreSQL에 대한 Citus 데이터베이스 확장 기반)

Azure Cosmos DB for PostgreSQL에는 표준 PostgreSQL 이외의 기능이 포함되어 있습니다. 이 문서에서는 다음 용도의 함수 및 구성 옵션이 분류된 참조를 제공합니다.

분할된 데이터베이스에서 쿼리 실행 병렬 처리
여러 서버 간에 분할된 데이터 관리
열 형식 스토리지를 사용하여 데이터 압축
시계열 분할 자동화

SQL 함수

분할

속성	설명
alter_distributed_table	분산 테이블의 배포 열, 분할된 데이터베이스 수 또는 공동 배치 속성을 변경합니다.
citus_copy_shard_placement	정상 배치의 데이터를 사용하여 비활성 분할된 데이터베이스 배치를 복구합니다.
citus_schema_distribute	PostgreSQL 스키마를 분산 스키마로 전환
citus_schema_undistribute	citus_schema_distribute 작업 실행 취소
create_distributed_table	PostgreSQL 테이블을 분산(분할된) 테이블로 바꿉니다.
create_reference_table	모든 노드에서 동기화된 테이블의 전체 복사본을 유지 관리합니다.
citus_add_local_table_to_metadata	메타데이터에 로컬 테이블을 추가하여 모든 노드에서 쿼리할 수 있도록 설정
isolate_tenant_to_new_shard	배포 열에 특정 단일 값이 있는 행을 보관할 새 분할된 데이터베이스을 만듭니다.
truncate_local_data_after_distributing_table	테이블을 배포한 후 모든 로컬 행을 잘라냅니다.
undistribute_table	create_distributed_table 또는 create_reference_table 작업을 실행 취소합니다.

분할된 데이터베이스 리밸런싱

속성	설명
citus_add_rebalance_strategy	`pg_dist_rebalance_strategy`에 행을 추가합니다.
citus_move_shard_placement	일반적으로 데이터베이스 관리자가 직접 호출하지 않고 분할된 데이터베이스 리밸런싱 중에 간접적으로 사용됩니다.
citus_set_default_rebalance_strategy	인수로 명명된 전략을 분할된 데이터베이스를 리밸런싱할 때 선택한 기본값으로 변경합니다.
get_rebalance_progress	`rebalance_table_shards`에서 계획되고 실행된 이동을 모니터링합니다.
get_rebalance_table_shards_plan	rebalance_table_shards에서 계획된 분할된 데이터베이스 이동을 수행하지 않고 출력합니다.
rebalance_table_shards	지정된 테이블의 분할된 데이터베이스를 이동하여 작업자 간에 균등하게 배포합니다.

공동 배치

속성	설명
create_distributed_function	공동 배치된 분할된 데이터베이스 근처의 작업자에서 함수가 실행되게 합니다.
update_distributed_table_colocation	분산 테이블의 공동 배치를 업데이트하거나 중단합니다.

열 형식 스토리지

속성	설명
alter_columnar_table_set	열 형식 테이블의 설정을 변경합니다.
alter_table_set_access_method	힙 또는 열 형식 스토리지 간에 테이블을 변환합니다.

시계열 분할

속성	설명
alter_old_partitions_set_access_method	파티션의 스토리지 방법을 변경합니다.
create_time_partitions	지정된 시간 범위를 포함하도록 지정된 간격의 파티션을 만듭니다.
drop_old_time_partitions	간격이 지정된 타임스탬프보다 이전인 모든 파티션을 제거합니다.

정보 제공

속성	설명
citus_get_active_worker_nodes	활성 작업자 호스트 이름과 포트 번호를 가져옵니다.
citus_relation_size	지정된 분산 테이블의 모든 분할된 데이터베이스에서 사용하는 디스크 공간을 가져옵니다.
citus_remote_connection_stats	각 원격 노드에 대한 활성 연결 수를 표시합니다.
citus_stat_statements_reset	`citus_stat_statements`에서 모든 행을 제거합니다.
citus_table_size	인덱스를 제외하고 지정된 분산 테이블의 모든 분할된 데이터베이스에서 사용하는 디스크 공간을 가져옵니다.
citus_total_relation_size	모든 인덱스 및 TOAST 데이터를 포함하여 지정된 분산 테이블의 모든 분할된 데이터베이스에서 사용하는 총 디스크 공간을 가져옵니다.
column_to_column_name	`pg_dist_partition`의 `partkey` 열을 텍스트 열 이름으로 변환합니다.
get_shard_id_for_distribution_column	배포 열의 값과 연결된 분할된 데이터베이스 ID를 찾습니다.

서버 매개 변수

쿼리 실행

속성	설명
citus.all_modifications_commutative	모든 명령이 공유 잠금을 클레임할 수 있도록 허용합니다.
citus.count_distinct_error_rate	postgresql-hll 대략적 개수 계산의 오류 비율을 튜닝합니다.
citus.enable_repartition_joins	비배포 열에 만들어진 JOIN을 허용합니다.
citus.enable_repartitioned_insert_select	SELECT 문의 행을 다시 분할하고 삽입을 위해 작업자 간에 행을 전송할 수 있도록 허용합니다.
citus.limit_clause_row_fetch_count	limit 절 최적화를 위해 작업당 가져올 행 수입니다.
citus.local_table_join_policy	로컬 테이블과 분산 테이블 간 조인을 수행할 때 데이터가 이동하는 위치입니다.
citus.multi_shard_commit_protocol	해시 분산 테이블에서 COPY를 수행할 때 사용할 커밋 프로토콜입니다.
citus.propagate_set_commands	코디네이터에서 작업자로 전파되는 SET 명령입니다.
citus.create_object_propagation	지원되는 개체에 대한 트랜잭션의 CREATE 문 동작
citus.use_citus_managed_tables	작업자 노드 쿼리에서 로컬 테이블에 액세스하도록 허용

정보 제공

속성	설명
citus.explain_all_tasks	EXPLAIN 출력에 모든 작업이 표시되도록 합니다.
citus.explain_analyze_sort_method	EXPLAIN ANALYZE 출력에서 작업의 정렬 방법입니다.
citus.log_remote_commands	코디네이터가 작업자 노드로 보내는 로그 쿼리입니다.
citus.multi_task_query_log_level	둘 이상의 작업을 생성하는 쿼리에 대한 로그 수준입니다.
citus.stat_statements_max	`citus_stat_statements`에 저장할 최대 행 수입니다.
citus.stat_statements_purge_interval	유지 관리 디먼이 `pg_stat_statements`에서 일치되지 않은 레코드를 `citus_stat_statements`에서 제거하는 빈도입니다.
citus.stat_statements_track	문 추적을 사용하거나 사용하지 않도록 설정합니다.
citus.show_shards_for_app_name_prefixes	분할을 보고자 하는 선택된 클라이언트에 대해 분할을 표시하도록 허용합니다.
citus.override_table_visibility	분할 숨기기 사용/사용 안 함

노드 간 연결 관리

속성	설명
citus.executor_slow_start_interval	동일한 작업자 노드에 대한 연결을 다시 열기까지 대기할 시간(밀리초)입니다.
citus.force_max_query_parallelization	가능한 한 많은 연결을 엽니다.
citus.max_adaptive_executor_pool_size	세션당 최대 작업자 연결 수입니다.
citus.max_cached_conns_per_worker	후속 명령 속도를 높이기 위해 열린 상태로 유지되는 연결 수입니다.
citus.node_connection_timeout	연결이 설정될 때까지 대기할 최대 기간(밀리초)입니다.

데이터 전송

속성	설명
citus.enable_binary_protocol	PostgreSQL의 이진 serialization 형식(해당하는 경우)을 사용하여 작업자와 데이터를 전송합니다.
citus.max_intermediate_result_size	푸시다운할 수 없는 CTE 및 하위 쿼리의 중간 결과 크기(KB)입니다.

교착 상태

속성	설명
citus.distributed_deadlock_detection_factor	분산 교착 상태를 확인하기까지 대기할 시간입니다.
citus.log_distributed_deadlock_detection	분산 교착 상태 검색 관련 처리를 서버 로그에 로깅할지 여부입니다.

시스템 테이블

코디네이터 노드에는 데이터 속성과 클러스터 전체의 쿼리 작업을 확인할 수 있는 메타데이터 테이블과 뷰가 포함되어 있습니다.

속성	설명
citus_dist_stat_activity	모든 노드에서 실행 중인 분산 쿼리입니다.
citus_lock_waits	클러스터 전체에서 차단된 쿼리입니다.
citus_shards	각 분할된 데이터베이스의 위치, 분할된 데이터베이스가 속한 테이블 유형, 분할된 데이터베이스 크기
citus_stat_statements	쿼리가 실행되는 방법과 대상에 대한 통계입니다.
citus_tables	모든 분산 테이블과 참조 테이블에 대한 요약입니다.
citus_worker_stat_activity	개별 분할된 데이터베이스에 대한 작업을 포함하여 작업자에 대한 쿼리입니다.
pg_dist_colocation	함께 배치해야 하는 테이블의 분할된 데이터베이스입니다.
pg_dist_node	클러스터의 작업자 노드에 대한 정보입니다.
pg_dist_object	코디네이터 노드에 생성되어 작업자 노드에 전파된 유형 및 함수와 같은 개체입니다.
pg_dist_placement	작업자 노드에서 분할된 데이터베이스 복제본의 위치입니다.
pg_dist_rebalance_strategy	`rebalance_table_shards`가 분할된 데이터베이스를 이동할 위치를 결정하는 데 사용할 수 있는 전략입니다.
pg_dist_shard	모든 분할된 데이터베이스의 테이블, 배포 열, 값 범위입니다.
time_partitions	`create_time_partitions` 및 `drop_old_time_partitions`와 같은 함수에서 관리하는 각 파티션에 대한 정보입니다.

다음 단계

몇 가지 유용한 진단 쿼리에 대해 알아봅니다.
기본 PostgreSQL 데이터베이스의 구성 매개 변수 목록을 검토합니다.