CREATE CATALOG

CREATE CATALOG

실행 중인 Trino에 새 카탈로그(catalog)를 동적으로 등록할 때 쓰는 명령어예요. 커넥터를 지정하고 속성을 설정해 데이터 소스를 추가할 수 있어요.

출처: 문서

본문

Synopsis

CREATE CATALOG
catalog_name
USING connector_name
[ WITH ( property_name = expression [, ...] ) ]

Description

지정한 커넥터를 사용해 새 카탈로그를 만들어요.

선택적인 WITH 절은 새로 만든 카탈로그에 속성을 설정할 때 사용해요. 속성 이름은 큰따옴표로 감쌀 수 있으며, - 같은 특수 문자를 포함하면 큰따옴표가 필요해요. 사용 가능한 모든 속성은 커넥터 문서를 참고하세요. 모든 속성 값은 숫자·불리언 값까지도 varchar(작은따옴표)여야 해요.

다음 상황에서는 쿼리가 실패해요:

  • 필수 속성이 빠진 경우
  • 잘못된 속성이 설정된 경우(예: 속성 이름에 오타가 있거나 다른 커넥터의 속성 이름을 사용한 경우)
  • 속성 값이 잘못된 경우(예: 숫자 값이 범위를 벗어나거나 문자열 값이 요구 패턴과 맞지 않는 경우)
  • 값이 코디네이터 노드에 설정되지 않은 환경 변수를 참조하는 경우

Warning

CREATE CATALOG 쿼리 전체가 로그에 남고 Web UI에 노출돼요. 여기에는 비밀번호 같은 중요한 속성과 다른 자격 증명(credential)도 포함돼요. Secrets 문서를 참고하세요.

Note

이 명령은 카탈로그 관리 타입이 dynamic으로 설정되어 있어야 해요.

Examples

TPC-H 커넥터를 사용해 tpch라는 새 카탈로그를 만들려면:

CREATE CATALOG tpch USING tpch;

Memory 커넥터를 사용해 brain이라는 새 카탈로그를 만들려면:

CREATE CATALOG brain USING memory
WITH ("memory.max-data-per-node" = '128MB');

커넥터 속성에는 대시(-)가 포함돼서 큰따옴표(")로 감싸야 해요. 값 128MB는 문자열 리터럴이므로 작은따옴표로 감쌌어요.

PostgreSQL 커넥터를 사용해 example이라는 새 카탈로그를 만들려면:

CREATE CATALOG example USING postgresql
WITH (
  "connection-url" = 'jdbc:pg:localhost:5432',
  "connection-user" = '${ENV:POSTGRES_USER}',
  "connection-password" = '${ENV:POSTGRES_PASSWORD}',
  "case-insensitive-name-matching" = 'true'
);

이 예시는 POSTGRES_USER와 POSTGRES_PASSWORD 환경 변수가 클러스터의 모든 노드에 시크릿(secret)으로 설정되어 있다고 가정해요.

See also

DROP CATALOG 명령과 카탈로그 관리 속성 문서를 함께 참고하세요.

더 알아보기 (Learn more)

카탈로그를 제거하는 DROP CATALOG과 카탈로그 관리 속성 설정, Secrets 문서도 함께 확인해 보세요.