표 나열

테이블을 나열하면 Lakehouse 런타임 카탈로그의 네임스페이스 내에 등록된 모든 테이블 항목을 볼 수 있습니다.

쿼리 엔진은 표준 SQL 명령어를 사용하여 테이블을 나열할 수 있고, REST 클라이언트는 오픈소스 Iceberg REST 카탈로그 API 사양(GET /v1/{prefix}/namespaces/{namespace}/tables)을 통해 테이블 식별자를 직접 가져올 수 있습니다.

시작하기 전에

표 개요를 참고하여 다양한 유형의 표와 표 사용의 영향을 알아보세요.

  1. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  2. BigLake API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

    API 사용 설정

필요한 역할

표를 나열하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 모두: BigLake 뷰어 (roles/biglake.viewer) - 프로젝트

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

표 나열

테이블을 나열합니다.

콘솔

  1. Google Cloud 콘솔에서 Lakehouse로 이동합니다.

    레이크하우스로 이동

  2. 기존 카탈로그를 선택하거나 카탈로그가 없는 경우 카탈로그를 만듭니다.

테이블이 네임스페이스 세부정보 페이지에 표시됩니다.

Spark 

spark.sql("SHOW TABLES").show()

Trino 

SHOW TABLES;

REST

REST API를 사용하여 네임스페이스 내의 테이블 식별자를 나열하려면 ListIcebergTableIdentifiers 엔드포인트에 GET 요청을 실행합니다.

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables

응답에는 지정된 네임스페이스에 등록된 표 식별자의 JSON 배열이 포함됩니다.

다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트 ID입니다.
  • CATALOG_ID: Lakehouse 런타임 카탈로그의 ID입니다.
  • NAMESPACE_NAME: 카탈로그 네임스페이스의 이름입니다.

다음 단계