SYSTEM$LIST_NAMESPACES_FROM_CATALOG¶

구문¶

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

인자¶

필수:

catalog_integration_name

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

선택 사항:

parent_namespace

네임스페이스 나열을 시작할 네임스페이스의 식별자입니다.

카탈로그 통합 수준에서 CATALOG_NAMESPACE 가 정의된 경우 카탈로그의 0번째 네임스페이스 수준에 대한 결과를 검색하려면 빈 문자열('')을 지정합니다.

CATALOG_NAMESPACE 가 테이블 수준에서만 정의된 경우 기본적으로 0번째 네임스페이스 수준에 대한 결과가 반환되므로 빈 문자열('')을 지정할 필요가 없습니다.

기본값:

• CATALOG_NAMESPACE 가 카탈로그 통합 수준에서 정의된 경우 카탈로그 통합을 위한 네임스페이스입니다.

• CATALOG_NAMESPACE 가 테이블 수준에서만 정의된 경우 카탈로그에서 0번째 네임스페이스 수준에 대한 결과를 검색합니다.

levels

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

예:

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

• 1로 설정할 경우 이 함수는 parent_namespace 보다 한 수준 아래의 모든 네임스페이스를 반환합니다.

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

기본값: 1

반환¶

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

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

[
  "<namespace_identifier>",
  "<namespace_identifier_n>"
]

액세스 제어 요구 사항¶

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

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

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

예¶

카탈로그 통합의 기본 네임스페이스 바로 아래에 있는 네임스페이스만 나열합니다.

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration');

카탈로그에 있는 모든 네임스페이스를 재귀적으로 나열합니다.

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration', '', 0);

‘’db1’’ 네임스페이스보다 한 수준 아래(바로 아래)의 네임스페이스만 나열합니다.

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration', 'db1');

‘’db1’’ 네임스페이스보다 세 수준 아래의 네임스페이스를 나열합니다.

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration', 'db1', 3);