SHOW ENTITIES IN DCM PROJECT

SHOW ENTITIES IN DCM PROJECT

SHOW ENTITIES IN DCM PROJECT 명령은 지정한 DCM 프로젝트가 현재 관리하는 모든 Snowflake 객체를 표시하는 명령이에요. 모든 객체의 완전 정규화된 이름(FQN) 혼합 목록을 제공해요.

출처: 문서

본문

이 명령은 지정한 DCM 프로젝트가 관리하는 모든 Snowflake 객체를 보여줘요. 결과를 보려면 사용자가 DCM 프로젝트에 대한 READ 권한과 관리 객체 자체에 대한 READ 권한이 모두 필요해요.

참고: 결과가 가장 최근 배포의 엔티티와 반드시 일치하지는 않아요. 수동으로 삭제되거나 프로젝트에서 분리된 객체는 여기에 나열되지 않아요.

이 명령은 생성 날짜 순으로 정렬된 객체 메타데이터와 속성을 반환해요.

관련 명령: CREATE DCM PROJECT, ALTER DCM PROJECT, DESCRIBE DCM PROJECT, DROP DCM PROJECT, EXECUTE DCM PROJECT, SHOW DCM PROJECTS.

구문 (Syntax)

SHOW ENTITIES IN DCM PROJECT <name> [ LIMIT <rows> ]

SHOW ENTITIES LIKE <pattern> IN DCM PROJECT <name>;

SHOW ENTITIES IN DCM PROJECT <name> STARTS WITH <prefix>;

SHOW ENTITIES IN DCM PROJECT <name> LIMIT <n> FROM <cursor>;

필수 파라미터 (Required parameters)

  • name — 나열할 배포가 포함된 DCM 프로젝트의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요.

선택 파라미터 (Optional parameters)

  • LIMIT <rows> — 반환되는 최대 행 수를 제한해요. 기본값: 없음.

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

  • STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요.

  • LIMIT <rows> [ FROM <name_string> ] — 최대 행 수를 제한하면서 결과의 "페이지네이션"을 가능하게 해요. FROM '<name_string>' 하위 절은 결과의 "커서" 역할을 해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분하고, 부분 이름이 지원돼요.

    참고: STARTS WITH와 FROM 절을 모두 지원하는 SHOW 명령에서는 두 절을 같은 문장에서 결합할 수 있어요. 다만 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요. 객체는 이름 기준 사전 순으로 반환됩니다.

출력 (Output)

명령 출력은 다음 컬럼을 포함해요:

  • CREATED_ON — 생성 타임스탬프 (LTZ).
  • NAME — 객체의 완전 정규화된 이름 (FQN). DESC에 적합.
  • OBJECT_TYPE — 객체 유형.
  • OWNER — 도메인 규칙에 따른 소유 역할.
  • COMMENT — 사용자 지정 주석.

출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 예를 들어 동적 테이블만 필터링하려면:

SHOW ENTITIES IN DCM PROJECT my_project
  ->> SELECT * FROM $1 WHERE "object_type" = 'DYNAMIC_TABLE';

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

이 작업을 실행하는 역할은 최소한 다음 권한을 가져야 해요:

  • DCM 프로젝트에 대한 READ 권한.
  • 관리 객체 유형에 따라 달라지는, 각 관리 객체에 대한 적절한 가시성 권한.

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

예제 (Examples)

my_project DCM 프로젝트의 모든 엔티티를 표시해요:

SHOW ENTITIES IN DCM PROJECT my_project;

my_project DCM 프로젝트에서 my_로 시작하는 모든 엔티티를 표시해요:

SHOW ENTITIES LIKE 'my_%' IN DCM PROJECT my_project;

더 알아보기 (Learn more)