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