CREATE DCM PROJECT

CREATE DCM PROJECT

새 DCM 프로젝트를 만들거나 기존 DCM 프로젝트를 교체하는 명령이에요. DCM(Data Catalog Management) 프로젝트는 데이터 카탈로그 관리 작업을 담는 Snowflake 객체예요.

출처: 문서

본문

새 DCM 프로젝트를 만들거나 기존 DCM 프로젝트를 교체해요.

함께 보기: ALTER DCM PROJECT, DESCRIBE DCM PROJECT, DROP DCM PROJECT, EXECUTE DCM PROJECT, SHOW DCM PROJECTS, SHOW DEPLOYMENTS IN DCM PROJECT

구문 (Syntax)

CREATE [ OR REPLACE ] DCM PROJECT [ IF NOT EXISTS ] <name>
  [LOG_LEVEL = { DEBUG | INFO | WARN | ERROR }]
  [ COMMENT = '<string_literal>' ]

필수 매개변수 (Required parameters)

name DCM 프로젝트의 식별자(이름)를 지정하는 문자열로, 프로젝트가 만들어지는 스키마 안에서 고유해야 해요.

또한 식별자는 반드시 알파벳 문자로 시작해야 하며, 전체 식별자 문자열이 큰따옴표로 묶이지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예: "My object"). 큰따옴표로 묶인 식별자는 대소문자를 구분해요.

자세한 내용은 식별자 요구 사항(Identifier requirements)을 참고해요.

선택 매개변수 (Optional parameters)

LOG_LEVEL = { DEBUG | INFO | WARN | ERROR } 활성 이벤트 테이블에서 수집되어 사용 가능하게 되어야 하는 메시지의 심각도 수준을 지정해요. 지정된 수준(및 그보다 더 심각한 수준)의 메시지가 수집돼요.

자세한 내용은 LOG_LEVEL과 로깅·메트릭·트레이싱 수준 설정(Setting levels for logging, metrics, and tracing)을 참고해요.

COMMENT = 'string_literal' DCM 프로젝트에 대한 설명(comment)을 지정해요.

  • 기본값: 값 없음

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 데 사용하는 역할(role)은 최소한 다음 권한을 가져야 해요.

권한 (Privilege) 객체 (Object)
CREATE DCM PROJECT Schema

스키마 안의 객체를 작업하려면 상위 데이터베이스에 대한 권한이 최소 하나, 상위 스키마에 대한 권한이 최소 하나 필요해요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법은 사용자 지정 역할 만들기(Creating custom roles)를 참고해요. 보호 가능한 객체에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여의 일반적인 내용은 접근 제어 개요(Overview of Access Control)를 참고해요.

사용 메모 (Usage notes)

OR REPLACE와 IF NOT EXISTS 절은 서로 배타적이에요. 같은 문에서 둘 다 사용할 수 없어요.

CREATE OR REPLACE <object> 문은 원자적(atomic)으로 동작해요. 즉, 객체를 교체할 때 기존 객체는 삭제되고 새 객체는 단일 트랜잭션 안에서 생성돼요.

DCM 프로젝트를 교체하면 유지되던 배포 이력(deployment history)과 아티팩트가 삭제돼요. 교체된 프로젝트가 이전에 관리하던 객체·권한 부여·첨부 항목은 관리되지 않는(unmanaged) 리소스로 그 자리에 남아요.

메타데이터에 관해서는 다음 사항에 주의해요.

⚠️ 주의: 고객은 Snowflake 서비스를 사용할 때 (User 객체를 제외하고) 개인 데이터·민감 데이터·수출 통제 데이터·기타 규제 데이터를 메타데이터로 입력하지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고해요.

예시 (Examples)

DCM 프로젝트를 만들어요.

CREATE DCM PROJECT MY_PROJECT;

설명과 함께 DCM 프로젝트를 만들어요.

CREATE DCM PROJECT MY_PROJECT
  COMMENT = 'My DCM project for data management';

더 알아보기 (Learn more)