SHOW LISTINGS

SHOW LISTINGS

SHOW LISTINGS 명령은 접근 권한(privilege)이 있는 리스팅(listing) 목록을 보여주는 명령이에요. 명령을 실행하는 사용자가 리스팅에 대해 USAGE, MODIFY, 또는 OWNERSHIP 권한 중 하나를 가진 리스팅만 표시해요.

출처: 문서

본문

이 명령은 접근 권한이 있는 리스팅을 나열해요. 리스팅은 Snowflake Marketplace 또는 데이터 교환에서 제공되는 데이터 제품을 나타내요.

관련 명령: CREATE LISTING, ALTER LISTING, DESCRIBE LISTING, DROP LISTING.

구문 (Syntax)

SHOW LISTINGS [ LIKE '<pattern>' ]
              [ STARTS WITH '<name_string>' ]
              [ LIMIT <rows> [ FROM '<name_string>' ] ]

선택 파라미터 (Optional parameters)

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

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

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

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

출력 (Output)

명령 출력은 리스팅 속성과 메타데이터를 다음 컬럼으로 제공해요:

  • global_name — 리스팅의 전역 이름.
  • name — 리스팅을 만들 때 지정한 이름.
  • title — 리스팅 매니페스트에 지정된 제목.
  • subtitle — 리스팅 매니페스트에 지정된 부제.
  • profile — 리스팅 매니페스트에 지정된 제공자 프로필 이름.
  • created_on — 리스팅이 생성된 날짜·시간.
  • updated_on — 리스팅이 마지막으로 갱신된 날짜·시간.
  • published_on — 리스팅이 마지막으로 게시된 날짜·시간.
  • state — 리스팅 상태. DRAFT, PUBLISHED, UNPUBLISHED 중 하나.
  • review_state — 공개 리스팅 전용 검토 상태. UNSENT, PENDING, REJECTED, APPROVED, CANCELLED 중 하나.
  • comment — 연결된 주석(있으면).
  • owner — 리스팅 소유자.
  • owner_role_type — 소유자 역할 유형.
  • regions — 공개 리스팅을 사용할 수 있는 리전 목록.
  • target_accounts — 대상 계정의 쉼표로 구분된 목록.
  • is_monetized — 수익화 여부 플래그.
  • is_application — 앱 플래그. true면 Snowflake Native App이 리스팅에 연결됨.
  • is_targeted — 대상 지정 플래그.
  • is_limited_trial — 구매 전 제한된 평가판을 사용할 수 있는지 여부.
  • is_by_request — 개인화된 리스팅 여부.
  • distribution — 리스팅이 EXTERNAL인지 ORGANIZATION인지 여부.
  • is_mountless_queryable — 소비자가 마운트 없이 ULL(Uniform Listing Locator)를 사용해 리스팅을 쿼리할 수 있는지 여부.
  • rejected_on — 승인용 공개 리스팅이 마지막으로 거부된 날짜·시간.
  • organization_profile_name — ORGANIZATION 리스팅과 연결된 프로필.
  • uniform_listing_locator — 소비자가 마운트 없이 ORGANIZATION 리스팅에 접근할 수 있게 해주는 ULL.
  • detailed_target_accounts — 회사 이름이 포함된 비공개 리스팅 대상 계정 세부 정보.
  • compliance_badges — Snowflake 컴플라이언스 팀이 승인한 컴플라이언스 인증 목록(있는 경우). 사용 가능한 인증: SOC2, HIPAA, ISO27001.

사용 참고 사항 (Usage notes)

  • 리스팅을 표시하려면 리스팅에 USAGE, MODIFY, 또는 OWNERSHIP 권한이 있는 역할을 사용해야 해요.
  • LIMIT rows의 값은 10000을 초과할 수 없어요. LIMIT rows를 생략하면 결과 집합이 1만 행보다 크면 오류가 발생해요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

이름이 MYLISTING으로 시작하는 모든 리스팅을 표시해요:

SHOW LISTINGS LIKE 'MYLISTING%'

MYLISTING 리스팅부터 시작해 10개의 리스팅을 표시해요:

SHOW LISTINGS LIMIT 10 FROM 'MYLISTING%'

더 알아보기 (Learn more)