SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG¶

구문¶

SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG( '<catalog_integration_name>'
  [ , '<parent_namespace>', <levels> ] )

인자¶

필수:

catalog_integration_name

Iceberg REST 또는 Snowflake Open Catalog 의 카탈로그 통합을 위한 식별자입니다.

선택 사항:

parent_namespace

테이블 나열을 시작할 네임스페이스의 식별자입니다. 카탈로그에서 0번째 네임스페이스 수준에 대한 결과를 검색하려면 빈 문자열('')을 지정합니다.

기본값: 카탈로그 통합을 위한 기본 네임스페이스(CATALOG_NAMESPACE).

levels

테이블을 나열하기 위해 네임스페이스 계층 구조에서 통과할 수준 수를 지정합니다.

예:

• 0으로 설정할 경우 이 함수는 parent_namespace 를 기준으로 모든 테이블을 재귀적으로 반환합니다.

• 1로 설정할 경우 이 함수는 parent_namespace 내의 모든 테이블을 반환합니다.

• n 으로 설정할 경우 이 함수는 parent_namespace 를 기준으로 최대 n 개 수준의 깊이까지 테이블을 반환합니다.

기본값: 1

반환¶

지정된 네임스페이스와 수준 수에 대해 Iceberg REST 카탈로그의 테이블을 나열하는 JSON 형식의 문자열을 반환합니다.

JSON 형식의 문자열 구조는 다음과 같습니다.

[
  {
    "namespace": "<namespace_identifier>",
    "name": "<table_name>"
  },
  {
    "namespace": "<namespace_identifier>",
    "name": "<table_name_n>"
  },
]

액세스 제어 요구 사항¶

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

예¶

기본 카탈로그 네임스페이스에 있는 테이블만 나열합니다.

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration');

카탈로그에 있는 모든 테이블을 나열합니다.

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration', '', 0);

db1 네임스페이스 아래의 모든 테이블을 재귀적으로 나열합니다.

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration', 'db1', 0);

db1 네임스페이스 아래의 3개 수준까지 모든 테이블을 나열합니다.

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration', 'db1', 3);