열 기반 엔진 플래그

이 페이지에서는 AlloyDB Omni가 열 엔진과 관련된 기능을 사용 설정하고 관리하는 데 사용하는 데이터베이스 플래그를 설명합니다. AlloyDB Omni에서 지원하는 모든 데이터베이스 플래그 목록은 지원되는 데이터베이스 플래그를 참고하세요.

인스턴스 다시 시작으로 표시된 플래그는 해당 인스턴스에서 이 플래그를 설정, 삭제 또는 수정할 때마다 AlloyDB Omni 인스턴스를 다시 시작해야 함을 의미합니다. 플래그 값은 다시 수정할 때까지 인스턴스에 유지됩니다.

데이터베이스 플래그를 설정하는 방법에 관한 안내는 AlloyDB Omni 데이터베이스 플래그 구성을 참고하세요.

사용 설정

google_columnar_engine.enabled

유형Boolean
기본값off
인스턴스 다시 시작예

on인 경우 AlloyDB Omni 열 엔진을 사용 설정합니다.

자동 열 지정

google_columnar_engine.enable_auto_columnarization

유형Boolean
기본값on
인스턴스 다시 시작아니요

on이면 열 기반 엔진의 자동 열 정렬 기능을 사용 설정합니다.

google_columnar_engine.relations

유형String
기본값빈 문자열
인스턴스 다시 시작아니요

자동 열 정렬 프로세스 외에도 AlloyDB Omni가 클러스터의 열 스토어에 추가할 열 목록을 지정합니다. 이러한 열은 클러스터 내의 모든 테이블에서 가져올 수 있습니다.

플래그의 값은 쉼표로 구분된 항목 목록 형식입니다. 각 항목은 단일 테이블의 하나 이상의 열을 지정하며 다음 형식으로 표현됩니다.

'DATABASE_NAME.SCHEMA_NAME.TABLE_NAME(COLUMN_LIST)'

자세한 내용은 열 스토어 콘텐츠 수동 관리를 참고하세요.

google_columnar_engine.auto_columnarization_schedule

유형String
기본값빈 문자열
인스턴스 다시 시작아니요
최대 허용 값2147483647

AlloyDB Omni가 인스턴스에서 자동 열 정렬 프로세스를 실행하는 빈도를 지정합니다.

값은 다음 형식의 문자열입니다.

'EVERY NUMBER TIME_UNITS'

다음을 바꿉니다.

  • NUMBER: 양의 정수입니다.

  • TIME_UNITS: DAYS 또는 HOURS

정의하지 않으면 AlloyDB Omni는 자동 열 정렬 프로세스를 1시간마다 한 번 실행합니다.

크기 조정 및 쿼리 처리

google_columnar_engine.memory_size_in_mb

유형Integer
유효한 값128과 인스턴스 메모리의 70% 를 나타내는 값 사이
기본값인스턴스 메모리 1GB
인스턴스 다시 시작예

AlloyDB Omni가 열 스토어에 할당하는 인스턴스 메모리 양이며 메비바이트 (MiB) 단위로 표시합니다.

이 플래그를 설정하지 않으면 AlloyDB Omni는 열 스토어에 인스턴스 메모리 1GB를 할당합니다.

google_columnar_engine.enable_columnar_scan

유형Boolean
기본값on
인스턴스 다시 시작아니요

on인 경우 쿼리를 처리할 때 AlloyDB Omni가 열 스토어의 데이터에 액세스할 수 있도록 허용합니다.

이 플래그가 off이고 google_columnar_engine.enabled가 on인 경우 열 형식 엔진은 사용 설정된 상태로 유지되고 열 스토어를 유지하지만 AlloyDB Omni는 쿼리를 처리할 때 열 형식 데이터를 사용하지 않습니다.

google_columnar_engine.storage_cache_size

저장용량 캐시 크기를 사용 설정하려면 디스크 캐시를 사용 설정해야 합니다.

유형Integer
유효한 값1024 ... 2147483647
기본값5% of the disk cache is allocated to the columnar engine
인스턴스 다시 시작예

on인 경우 AlloyDB Omni가 열 형식 엔진의 스토리지 캐시 크기를 구성할 수 있습니다.

이 플래그의 최대 허용 값은 총 디스크 캐시의 50% 또는 1000 * google_columnar_engine.memory_size_in_mb 중 더 낮은 값입니다.

유지보수 활동

google_job_scheduler.maintenance_cpu_percentage

유형Integer
유효한 값0 ... 100
기본값20
인스턴스 다시 시작아니요

열 기반 엔진이 백그라운드 처리에 적용할 수 있는 인스턴스 CPU 용량의 최대 백분율입니다.

google_job_scheduler.max_parallel_workers_per_job

유형Integer
유효한 값0 ... 262143
기본값2
인스턴스 다시 시작아니요

단일 백그라운드 처리 작업을 처리하기 위해 열 기반 엔진에서 만들 수 있는 최대 동시 작업자 수입니다.

자동 새로고침 - 이벤트 기반

google_columnar_engine.refresh_threshold_percentage

유형Integer
유효한 값1 ... 100
기본값50
인스턴스 다시 시작아니요

열 스토어의 데이터 새로고침 기준을 지정하며 백분율 단위로 표시합니다.

AlloyDB Omni는 다음 조건이 충족되면 열 테이블 내의 데이터 블록 집합인 열 단위 내의 데이터를 새로고침합니다.

  • 열 단위의 테이블이 별도의 refresh_threshold_scan_count 플래그로 정의된 스캔 임곗값을 초과했습니다.

  • 열 단위의 기본 데이터 블록 중 잘못된 상태가 된 블록의 비율이 refresh_threshold_percentage 플래그의 값을 초과합니다. 열 테이블에서 사용하는 행 기반 데이터가 변경되어 열 데이터 블록이 유효하지 않게 됩니다.

google_columnar_engine.refresh_threshold_scan_count

유형Integer
유효한 값0 ... 2147483647
기본값5
인스턴스 다시 시작아니요

AlloyDB Omni는 테이블의 최근 DML 쿼리 이후 각 열 기반 테이블에서 수행된 테이블 스캔의 실행 수를 유지합니다. refresh_threshold_scan_count 플래그의 값은 AlloyDB Omni에서 데이터를 새로고침하기 전에 열 테이블에서 이 카운터의 최솟값을 지정합니다. 그러면 AlloyDB Omni는 refresh_threshold_percentage에 정의된 잘못된 블록 기준점을 사용하여 테이블의 데이터를 새로고침할 시기를 결정합니다.

이 플래그 값이 0로 설정된 경우 AlloyDB Omni는 열 데이터를 새로고침할 시기를 결정하기 위해 테이블 스캔을 무시하고 대신 refresh_threshold_percentage만 사용합니다.

자동 새로고침 - 주기적 및 적응형

google_columnar_engine.adaptive_auto_refresh_schedule

유형String
기본값빈 문자열
인스턴스 다시 시작아니요
최대 허용 값2147483647

AlloyDB Omni가 인스턴스에서 적응형 자동 새로고침 프로세스를 실행하는 빈도를 지정합니다.

값은 다음 형식의 문자열입니다.

'EVERY NUMBER TIME_UNITS'

다음을 바꿉니다.

  • NUMBER: 양의 정수입니다.

  • TIME_UNITS: DAYS 또는 HOURS입니다.

정의하지 않으면 AlloyDB Omni에서 적응형 자동 새로고침 프로세스를 1시간마다 한 번 실행합니다.

google_columnar_engine. min_adaptive_auto_refresh_blocks

유형Integer
유효한 값0 ... 2147483647
기본값50
인스턴스 다시 시작아니요

잘못된 열 단위의 기본 데이터 블록 수가 min_adaptive_auto_refresh_blocks 플래그의 값을 초과합니다. 열 테이블에서 사용하는 행 기반 데이터가 변경되어 열 데이터 블록이 유효하지 않게 됩니다.

벡터화된 조인

google_columnar_engine.enable_vectorized_join

유형Boolean
기본값off
인스턴스 다시 시작No

on인 경우 AlloyDB Omni는 자동으로 멀티스레드 벡터화된 작업을 사용하여 여러 테이블을 조인하는 쿼리의 성능을 개선합니다.

자세한 내용은 벡터화된 조인 사용 설정을 참고하세요.

google_columnar_engine.vectorized_join_threads

유형Integer
유효한 값인스턴스 vCPU 수의 최대 절반
기본값1
인스턴스 다시 시작No

벡터화된 조인 연산자가 사용할 수 있는 최대 동시 스레드 수를 정의합니다. 이 옵션은 enable_vectorized_join 플래그로 사용 설정됩니다.

인스턴스의 vCPU의 절반까지 값을 정의할 수 있습니다. 예를 들어 vCPU 16개 인스턴스에서 이 플래그의 최대 값은 8입니다.

미리보기 기능

google_columnar_engine.enable_json_support

유형Boolean
기본값off
인스턴스 다시 시작No

이 플래그와 enable_raw_format가 모두 on로 설정된 경우 AlloyDB Omni는 열 스토어에서 PostgreSQL JSON 및 JSONB 데이터 유형을 허용합니다.

google_columnar_engine.enable_raw_format

유형Boolean
기본값off
인스턴스 다시 시작No

이 플래그와 enable_json_support가 모두 on로 설정된 경우 AlloyDB Omni는 열 스토어에서 PostgreSQL JSON 및 JSONB 데이터 유형을 허용합니다.