Timestream for InfluxDB 3의 DB 클러스터의 파라미터 그룹 - Amazon Timestream

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Timestream for InfluxDB 3의 DB 클러스터의 파라미터 그룹

[데이터베이스 파라미터(Database parameters)]에서 데이터베이스 구성 방법을 지정합니다. DB 인스턴스를 파라미터 그룹과 연결하여 데이터베이스 구성을 관리합니다.

Amazon Timestream for InfluxDB는 기본 설정으로 파라미터 그룹을 정의합니다. 맞춤형 설정으로 자신만의 파라미터 그룹을 정의할 수 있습니다. Core 및 Enterprise edition의 파라미터 그룹은 유사하지만 동일하거나 서로 호환되지는 않습니다.

InfluxDB 3의 경우 클러스터 구성은 파라미터 그룹을 통해 관리됩니다. 이러한 파라미터 그룹에는 InfluxDB 3 클러스터의 작동 방식을 결정하는 엔진 구성 값이 포함되어 있습니다.

파라미터 그룹 특성

  • 변경 불가능: 파라미터 그룹은 일단 생성되면 변경할 수 없습니다. 생성 후에는 파라미터를 수정할 수 없습니다.

  • 복제: 기존 파라미터 그룹을 복제하고 복제 프로세스 중 파라미터를 수정하여 새 파라미터 그룹을 생성할 수 있습니다. 이 기능은 AWS Management 콘솔 유일한 기능입니다.

  • 삭제: 파라미터 그룹은 삭제할 수 없습니다.

  • 기본 그룹: Timestream for InfluxDB는 일반적인 사용 사례에 최적화된 사전 구성된 설정을 가진 기본 파라미터 그룹을 제공합니다.

클러스터 구성의 주요 파라미터

InfluxDB 3의 파라미터 그룹을 사용하면 다음을 포함한 클러스터의 다양한 측면을 구성할 수 있습니다.

  • 엔진 유형(InfluxDBV2, InfluxDBV3Core, InfluxDBV3Enterprise)

  • InfluxDB 3 Enterprise 파라미터

  • 서비스 정의 파라미터 그룹

  • 쿼리 동시성 한도

  • 쿼리에 대한 메모리 할당

  • 스토리지 캐시 설정

  • HTTP 제한 시간 구성

  • 로그 수준 및 세부 수준

  • 압축 설정(Enterprise 버전)

새 클러스터를 생성할 때 파라미터 그룹과 연결해야 합니다. 이 연결은 클러스터의 운영 특성을 결정합니다.

공통 파라미터(Core 및 Enterprise 모두에서 사용 가능)

파라미터 설명 범위/형식
쿼리 구성
queryFileLimit 최대 쿼리 파일 수 0-1024
queryLogSize 쿼리 로그의 크기 1~10,000
logFilter 로그 필터링 구성 최대 1,024자
logFormat 로그 형식 ‘전체’
DataFusion 엔진
dataFusionNumThreads DataFusion 스레드 수 1~2,048
dataFusionRuntimeType 런타임 실행 모델 current-thread, multi-thread, multi-thread-alt
dataFusionMaxParquetFanout 최대 Parquet 파일 팬아웃 1~1,000,000
dataFusionUseCachedParquetLoader Parquet 로더 캐싱 활성화 부울
메모리 관리
bufferMemLimitMb MB 단위의 버퍼 메모리 한도 1024-16777216000
execMemPoolBytes 실행 메모리 풀 크기 백분율 또는 절댓값
parquetMemCacheSize Parquet 메모리 캐시 크기 백분율 또는 절댓값
forceSnapshotMemThreshold 강제 스냅샷의 메모리 임곗값 백분율 또는 절댓값
WAL 구성
walSnapshotSize WAL 스냅샷 크기 1~10,000
walMaxWriteBufferSize 최대 WAL 쓰기 버퍼 크기 1~1,000,000
snapshottedWalFilesToKeep 유지할 스냅샷이 생성된 WAL 파일 수 0-10000
walReplayConcurrencyLimit WAL 재생 동시성 한도 1-100
캐시 설정
lastCacheEvictionInterval 마지막 값 캐시 제거 간격 지속 시간
distinctCacheEvictionInterval 고유 값 캐시 제거 간격 지속 시간
tableIndexCacheMaxEntries 최대 테이블 인덱스 캐시 항목 1-1000
parquetMemCachePrunePercentage Parquet 캐시 정리 비율 0-1
HTTP 구성
maxHttpRequestSize 최대 HTTP 요청 크기 1024-16777216
보존 및 삭제
retentionCheckInterval 보존 정책 검사 간격 지속 시간
deleteGracePeriod 삭제 유예 기간 지속 시간
hardDeleteDefaultDuration 기본 하드 삭제 기간 지속 시간

Enterprise 전용 파라미터

파라미터 설명 범위/형식
노드 구성
ingestQueryInstances 라이터/리더 노드 수 1~2(필수)
queryOnlyInstances 전용 리더 노드 수 0~1(필수)
dedicatedCompactor 전용 압축기 노드 활성화 부울(필수)
압축 설정
compactionRowLimit 압축에 대한 행 한도 1~100,000,000
compactionMaxNumFilesPerPlan 압축 계획당 최대 파일 수 1~10,000
compactionGen2Duration 2세대 압축 기간 지속 시간
compactionMultipliers 압축 수준 승수 형식: "n,n,n,n"
compactionCleanupWait 정리 전 대기 시간 지속 시간
compactionCheckInterval 압축 검사 간격 지속 시간
캐시 구성
lastValueCacheDisableFromHistory 기록 데이터에서 LVC 비활성화 부울
distinctValueCacheDisableFromHistory 기록 데이터에서 DVC 비활성화 부울
복제
replicationInterval 데이터 복제 간격 지속 시간
catalogSyncInterval 카탈로그 동기화 간격 지속 시간

파라미터 그룹 관리

파라미터 그룹을 삭제하려면 다음을 수행하세요.

  1. 생성: 사용자 지정 설정을 사용하여 새 파라미터 그룹을 생성합니다.

  2. 연결: 파라미터 그룹을 새 클러스터나 기존 클러스터와 연결합니다.

  3. 삭제 또는 수정: 파라미터 그룹은 수정하거나 삭제할 수 없습니다.

파라미터 그룹은 변경할 수 없으므로 클러스터를 생성하기 전에 구성을 신중하게 계획하세요. 나중에 파라미터를 변경해야 하는 경우 새 파라미터 그룹을 생성하고 클러스터와 연결해야 하며, 이 과정에서 클러스터를 다시 시작해야 할 수 있습니다.

파라미터 그룹 생성

InfluxDB 3 Core 파라미터 그룹 생성:

aws timestream-influxdb create-db-parameter-group \ --name "my-influxdb3-core-pg" \ --description "Custom parameter group for InfluxDB 3 Core" \ --parameters '{ "InfluxDBv3Core": { "queryFileLimit": 512, "dataFusionNumThreads": 16, "bufferMemLimitMb": 8192, "maxHttpRequestSize": 8388608 } }'

InfluxDB 3 Enterprise 파라미터 그룹 생성(3노드 구성):

aws timestream-influxdb create-db-parameter-group \ --name "my-influxdb3-enterprise-pg" \ --description "Custom parameter group for 3-node InfluxDB 3 Enterprise cluster" \ --parameters '{ "InfluxDBv3Enterprise": { "ingestQueryInstances": 2, "queryOnlyInstances": 0, "dedicatedCompactor": true, "compactionRowLimit": 1000000, "compactionCheckInterval": "30m", "dataFusionNumThreads": 32, "bufferMemLimitMb": 16384 } }'

InfluxDB 3 Enterprise 파라미터 그룹 생성(단일 노드 구성):

aws timestream-influxdb create-db-parameter-group \ --name "my-influxdb3-enterprise-single-pg" \ --description "Custom parameter group for single-node InfluxDB 3 Enterprise" \ --parameters '{ "InfluxDBv3Enterprise": { "ingestQueryInstances": 1, "queryOnlyInstances": 0, "dedicatedCompactor": false, "dataFusionNumThreads": 16 } }'

서비스 정의 파라미터 그룹 사용

기본 코어 파라미터 그룹으로 클러스터 생성:

aws timestream-influxdb create-db-cluster \ --name "my-core-cluster" \ --db-parameter-group-identifier "InfluxDBv3Core" \ --vpc-subnet-ids subnet-12345 subnet-67890 \ --vpc-security-group-ids sg-abcdef \ --db-instance-type db.influxIOIncluded.large \

기본 엔터프라이즈 파라미터 그룹으로 클러스터 생성(3노드):

aws timestream-influxdb create-db-cluster \ --name "my-enterprise-cluster" \ --db-parameter-group-identifier "InfluxDBv3Enterprise" \ --vpc-subnet-ids subnet-12345 subnet-67890 \ --vpc-security-group-ids sg-abcdef \ --db-instance-type db.influxIOIncluded.xlarge \

단일 노드 엔터프라이즈 파라미터 그룹으로 클러스터 생성:

aws timestream-influxdb create-db-cluster \ --name "my-enterprise-single" \ --db-parameter-group-identifier "InfluxDBv3Enterprise1Node" \ --vpc-subnet-ids subnet-12345 subnet-67890 \ --vpc-security-group-ids sg-abcdef \ --db-instance-type db.influxIOIncluded.large \

파라미터 그룹 나열 및 설명

모든 파라미터 그룹 나열:

aws timestream-influxdb list-db-parameter-groups

특정 파라미터 그룹 설명:

aws timestream-influxdb get-db-parameter-group \ --identifier "my-influxdb3-enterprise-pg"

서비스 정의 파라미터 그룹 참조

Amazon Timestream for InfluxDB는 세 가지 서비스 정의 파라미터 그룹을 제공합니다.

  1. InfluxDBv3Core: 단일 노드 InfluxDB 3 Core 클러스터의 기본 구성입니다.

  2. InfluxDBv3Enterprise: 3노드 InfluxDB 3 Enterprise 클러스터(라이터/리더 노드 2개 + 전용 압축기 1개)의 기본 구성입니다.

  3. InfluxDBv3Enterprise1Node: 단일 노드 InfluxDB 3 Enterprise 클러스터의 기본 구성입니다(전용 압축기 없음).

이러한 서비스 정의 파라미터 그룹은 변경할 수 없으며 직접 사용하거나 --source-db-parameter-group-id 옵션을 사용하여 사용자 지정 파라미터 그룹을 생성하기 위한 템플릿으로 사용할 수 있습니다.