AVAILABLE_LISTINGS

AVAILABLE_LISTINGS

AVAILABLE_LISTINGS는 스키마 정보 스키마(Information Schema) 함수로, 컨슈머가 발견하고 접근할 수 있는 모든 리스팅(listing)을 반환해요. 리스팅을 가져왔는지, 조직 리스팅인지, 아니면 현재 계정에 비공개로 공유되었는지에 따라 필터링할 수 있어요.

출처: Snowflake SQL Reference

본문

카테고리: Information Schema , Table 함수

구문 (Syntax)

AVAILABLE_LISTINGS(
      [ IS_IMPORTED => { TRUE | FALSE | NULL } ]
      [ , IS_ORGANIZATION => { TRUE | FALSE | NULL } ]
      [ , IS_SHARED_WITH_ME => { TRUE | FALSE | NULL } ] )

인자 (Arguments)

다음 인자를 선택적으로 지정해 이 뷰에서 리스팅을 필터링할 수 있어요.

참고: 인자 중 한 번에 하나만 TRUE가 될 수 있어요.

IS_IMPORTED => { TRUE | FALSE | NULL } — TRUE로 설정하면 가져온(imported) 리스팅만 반환하고, FALSE 또는 NULL로 설정하면 모든 리스팅을 반환해요.

기본값: NULL.

IS_ORGANIZATION => { TRUE | FALSE | NULL } — TRUE로 설정하면 조직(organization) 리스팅만 반환하고, FALSE 또는 NULL로 설정하면 모든 리스팅을 반환해요.

기본값: NULL.

IS_SHARED_WITH_ME => { TRUE | FALSE | NULL } — TRUE로 설정하면 현재 계정에 비공개로 공유된 리스팅만 반환하고, FALSE 또는 NULL로 설정하면 모든 리스팅을 반환해요.

기본값: NULL.

출력 (Output)

이 함수는 다음 열을 반환해요:

열 데이터 타입 설명
GLOBAL_NAME VARCHAR 리스팅의 글로벌 이름.
CREATED_ON TIMESTAMP_LTZ 리스팅이 생성된 타임스탬프.
TITLE VARCHAR 리스팅의 제목.
SUBTITLE VARCHAR 리스팅의 부제목.
DESCRIPTION VARCHAR 리스팅의 설명.
IS_MONETIZED BOOLEAN 리스팅이 유료(monetized)인지 여부.
IS_BY_REQUEST BOOLEAN 리스팅이 요청형(개인화 리스팅)인지 여부.
IS_LIMITED_TRIAL BOOLEAN 리스팅이 제한 체험(limited trial)인지 여부.
IS_READY_FOR_IMPORT BOOLEAN 리스팅이 가져오기 준비되었는지 여부.
IS_IMPORTED BOOLEAN 리스팅이 가져왔는지 여부.
IS_APPLICATION BOOLEAN 리스팅이 애플리케이션과 연결되었는지 여부.
IS_PRIVATE BOOLEAN 리스팅이 비공개인지 여부.
CATEGORIES VARCHAR 리스팅과 연결된 카테고리.
DATA_ATTRIBUTES VARCHAR 리스팅과 연결된 데이터 속성.
TERMS VARCHAR 리스팅의 서비스 약관.
RESOURCES VARCHAR 리스팅과 연결된 리소스.
DISTRIBUTION VARCHAR 리스팅의 배포 방식. 가능한 값은 EXTERNAL과 ORGANIZATION.
UNIFORM_LISTING_LOCATOR VARCHAR 리스팅의 균일 리스팅 로케이터(ULL).
ORGANIZATION_PROFILE_NAME VARCHAR 리스팅에 연결된 조직 프로필(있는 경우).
IS_DISCOVERY_ONLY BOOLEAN 리스팅이 발견 전용(discovery only)인지 여부.
SUPPORT_CONTACT VARCHAR 리스팅과 연결된 지원 연락처 정보.
REQUEST_APPROVAL_TYPE VARCHAR 리스팅의 요청 승인 유형. 컨슈머의 리스팅 요청이 Snowflake 내부에서 승인될지 외부에서 승인될지를 나타내요.
IS_CORTEX_KNOWLEDGE_EXTENSION BOOLEAN 이 리스팅에 Cortex Search 서비스가 연결되어 있는지 여부.
PROVIDER_COMPANY_NAME VARCHAR 리스팅 제공자의 회사 이름.
RESHARING VARCHAR 리스팅의 리쉐어링(resharing) 구성.

예시 (Examples)

현재 계정에서 사용 가능한 모든 리스팅을 가져와요:

SELECT * FROM TABLE(<any_database>.INFORMATION_SCHEMA.AVAILABLE_LISTINGS());

현재 계정이 가져온 모든 사용 가능한 리스팅을 가져와요:

SELECT * FROM TABLE(<any_database>.INFORMATION_SCHEMA.AVAILABLE_LISTINGS(IS_IMPORTED => TRUE));

현재 계정의 모든 사용 가능한 조직 리스팅을 가져와요:

SELECT * FROM TABLE(<any_database>.INFORMATION_SCHEMA.AVAILABLE_LISTINGS(IS_ORGANIZATION => TRUE));

현재 계정에 비공개로 공유된 모든 사용 가능한 리스팅을 가져와요:

SELECT * FROM TABLE(<any_database>.INFORMATION_SCHEMA.AVAILABLE_LISTINGS(IS_SHARED_WITH_ME => TRUE));

더 알아보기