카탈로그 관리 속성

카탈로그 관리 속성 (Catalog management properties)

다음 속성들은 카탈로그 관리를 구성하고, 동적 카탈로그 관리를 위한 추가 제어를 제공해요.

출처: 문서

본문

catalog.management

  • 타입: string
  • 허용 값: static, dynamic
  • 기본값: static

static으로 설정하면 Trino는 서버 시작 시에만 카탈로그 속성 파일을 읽고 사용 가능한 카탈로그를 구성해요. dynamic으로 설정하면 CREATE CATALOG와 DROP CATALOG으로 카탈로그 구성을 관리할 수도 있어요. 클러스터에 새로 합류하는 워커 노드는 코디네이터 노드에서 현재 카탈로그 구성을 받아요.

경고 (Warning)

이 기능은 실험적(experimental) 기능이에요. 보안 영향 때문에 문법이 변경되거나 하위 호환되지 않을 수 있어요.

경고 (Warning)

일부 커넥터는 그 커넥터를 쓰는 카탈로그를 드롭할 때 모든 리소스를 해제하지 않는 것으로 알려져 있어요. 여기에는 HDFS, S3, GCS 또는 Azure에서 데이터를 읽을 수 있는 모든 커넥터가 포함되는데, Hive 커넥터, Iceberg 커넥터, Delta Lake 커넥터, Hudi 커넥터가 그렇죠.

경고 (Warning)

CREATE CATALOG 쿼리 전체가 로그에 남고 Web UI에서도 보여요. 여기에는 비밀번호나 다른 자격 증명 같은 민감한 속성이 포함될 수 있어요. Secrets 문서를 참고하세요.

catalog.prune.update-interval

  • 타입: duration
  • 기본값: 5s
  • 최솟값: 1s

catalog.management가 dynamic으로 설정되어 있어야 해요. 드롭된 카탈로그를 정리(prune)하는 주기예요. 카탈로그를 드롭해도 그걸 사용하는 실행 중인 쿼리는 중단되지 않지만, 새 쿼리에서는 사용할 수 없게 돼요.

catalog.store

  • 타입: string
  • 허용 값: file, memory
  • 기본값: file

catalog.management가 dynamic으로 설정되어 있어야 해요. file로 설정하면 SQL 명령으로 카탈로그를 생성·드롭할 때 코디네이터 노드에 카탈로그 속성 파일을 추가·제거해요. Trino 서버 프로세스는 카탈로그 설정 디렉토리에 쓰기 권한이 필요해요. 코디네이터 시작 시 기존 카탈로그 파일도 읽어와요. memory로 설정하면 카탈로그 구성을 메모리에서만 관리하고, 시작 시 기존 파일은 무시해요.

catalog.config-dir

  • 타입: string
  • 기본값: etc/catalog/

catalog.management가 static이거나 catalog.store가 file일 때 필요해요. 카탈로그 속성 파일이 있는 디렉토리예요.

catalog.disabled-catalogs

catalog.management가 static이거나 catalog.store가 file일 때 필요해요. 시작 시 무시할 카탈로그를 쉼표로 구분한 목록이에요.

catalog.read-only

  • 타입: string
  • 기본값: false

catalog.store가 file로 설정되어 있어야 해요. true면 기존 카탈로그 속성 파일을 DROP CATALOG으로 제거할 수 없고, CREATE CATALOG으로 동일한 이름의 새 카탈로그 파일을 쓸 수도 없어요. 결과적으로 코디네이터를 재시작하면 알려진 카탈로그가 기존 파일만으로 재설정돼요.

더 알아보기 (Learn more)

카탈로그를 SQL로 생성·드롭하는 방법이 궁금하다면 CREATE CATALOG 문서를 이어서 읽어 보세요.