- 리소스: IcebergCatalog
- CredentialMode
- CatalogType
- 복제본
- 주
- RestrictedLocationsConfig
- EncryptionConfig
- FederatedCatalogOptions
- IdentityFederationOrganizationServiceAccount
- UnityCatalogInfo
- GlueCatalogInfo
- SnowflakeCatalogInfo
- WorkdayCatalogInfo
- IdentityMode
- UserIdentityFederationOidcClaims
- UserIdentityFederationOidc
- RefreshOptions
- RefreshSchedule
- RefreshScope
- RefreshStatus
- CrossCloudCacheOptions
- 메서드
리소스: IcebergCatalog
Iceberg REST 카탈로그 정보입니다.
| JSON 표현 |
|---|
{ "name": string, "credential-mode": enum ( |
| 필드 | |
|---|---|
name |
식별자. 카탈로그 이름( |
credential-mode |
(선택사항) 카탈로그의 사용자 인증 정보 모드입니다. |
biglake-service-account |
출력 전용입니다. 사용자 인증 정보 판매에 사용되는 서비스 계정입니다(출력 전용). 카탈로그에 사용자 인증 정보 벤더 제공이 사용 설정되지 않은 경우 비어 있을 수 있습니다. 페더레이션 카탈로그의 경우 서비스 계정이 항상 프로비저닝되며 백그라운드 메타데이터 새로고침을 위해 원격 카탈로그에 액세스하는 데 사용됩니다. |
biglake-service-account-id |
출력 전용입니다. 서비스 계정의 고유 ID입니다. 이는 제휴 시나리오에 사용됩니다. |
catalog-type |
필수 항목입니다. 카탈로그 유형입니다. catalogs.create에 필요합니다. 카탈로그 유형은 CATALOG_TYPE_GCS_BUCKET에서 CATALOG_TYPE_BIGLAKE로 변환하는 경우를 제외하고 변경할 수 없습니다. |
default-location |
(선택사항) 카탈로그의 기본 스토리지 위치입니다(예: BigLake 카탈로그의 경우 이 필드를 제공해야 하며 Google Cloud Storage 버킷 또는 해당 버킷 내의 경로를 가리켜야 합니다. 이 경로는 네임스페이스 또는 테이블 수준에서 위치가 지정되지 않은 경우 테이블의 데이터 및 메타데이터 디렉터리에 대한 전체 경로를 구성하는 기본 디렉터리 역할을 합니다. 전체 경로는 기본 위치에 네임스페이스 및 테이블 식별자를 추가하여 형성됩니다. |
storage-regions[] |
출력 전용입니다. 기본 위치 버킷의 Google Cloud 리전입니다(예: |
create-time |
출력 전용입니다. 카탈로그가 생성된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
update-time |
출력 전용입니다. 카탈로그가 마지막으로 업데이트된 시간입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
replicas[] |
출력 전용입니다. 카탈로그 메타데이터의 복제본입니다. |
description |
(선택사항) 사용자가 제공한 카탈로그 설명입니다. 설명은 최대 길이가 1,024자(영문 기준)인 UTF-8 문자열이어야 합니다. |
restricted-locations-config |
(선택사항) 제한된 위치 구성 이 필드는 현재 BigLake 카탈로그에만 사용됩니다. 이 필드가 설정되지 않았거나 |
federated-catalog-options |
(선택사항) 페더레이션 카탈로그의 구성 옵션입니다. |
cross-cloud-cache-options |
(선택사항) 데이터 및 메타데이터 파일의 크로스 클라우드 캐싱을 위한 구성 옵션입니다. |
encryption-config |
(선택사항) 커스텀 암호화 구성(예: Cloud KMS 키) |
CredentialMode
카탈로그에 사용되는 사용자 인증 정보 모드입니다.
| 열거형 | |
|---|---|
CREDENTIAL_MODE_UNSPECIFIED |
기본값/설정되지 않은 값입니다. 이 값은 사용되지 않습니다. |
CREDENTIAL_MODE_END_USER |
최종 사용자 인증 정보 모드(기본값) 인증 사용자는 카탈로그 리소스와 기본 Google Cloud Storage 객체에 액세스할 수 있어야 합니다. |
CREDENTIAL_MODE_VENDED_CREDENTIALS |
사용자 인증 정보 벤더 제공 모드입니다. 인증 사용자는 카탈로그 리소스에만 액세스하면 되며 시스템은 호출자에게 Google Cloud Storage 객체에 액세스할 수 있는 범위 축소 사용자 인증 정보를 제공합니다. 이 모드의 모든 테이블 작업에는 자세한 내용은 https://docs.cloud.google.com/lakehouse/docs/credential-vending을 참조하세요. |
CatalogType
카탈로그 유형을 결정합니다.
| 열거형 | |
|---|---|
CATALOG_TYPE_UNSPECIFIED |
기본값/설정되지 않은 값입니다. 이 값은 사용되지 않습니다. |
CATALOG_TYPE_GCS_BUCKET |
Google Cloud Storage 버킷 카탈로그 유형입니다. |
CATALOG_TYPE_BIGLAKE |
BigLake 카탈로그 유형입니다. |
CATALOG_TYPE_FEDERATED |
페더레이션 카탈로그 유형입니다. |
CATALOG_TYPE_ALLOYDB_AGENT_MODE |
에이전트 모드에서 AlloyDB 테이블을 쿼리하기 위한 카탈로그입니다. |
복제본
카탈로그의 복제본입니다.
| JSON 표현 |
|---|
{
"region": string,
"state": enum ( |
| 필드 | |
|---|---|
region |
출력 전용입니다. 복제본의 리전입니다. 예: 'us-east1' |
state |
출력 전용입니다. 복제본의 현재 상태입니다. |
주
카탈로그가 여러 리전에 복제되는 경우 이 enum은 복제본의 현재 상태를 설명합니다.
| 열거형 | |
|---|---|
STATE_UNKNOWN |
기본값/설정되지 않은 값입니다. 이 값은 사용되지 않습니다. |
STATE_PRIMARY |
복제본은 쓰기 가능한 기본 복제본입니다. |
STATE_PRIMARY_IN_PROGRESS |
복제본이 최근에 기본으로 할당되었지만 아직 모든 네임스페이스가 쓰기 가능하지 않습니다. |
STATE_SECONDARY |
복제본은 읽기 전용 보조 복제본입니다. |
RestrictedLocationsConfig
위치 제한 구성
| JSON 표현 |
|---|
{ "restricted-locations": [ string ] } |
| 필드 | |
|---|---|
restricted-locations[] |
(선택사항) 카탈로그 내 리소스에서 사용할 수 있는 추가 Google Cloud Storage 버킷 및 위치(예:
|
EncryptionConfig
커스텀 암호화 구성(예: Cloud KMS 키)
| JSON 표현 |
|---|
{ "kms-key-name": string } |
| 필드 | |
|---|---|
kms-key-name |
(선택사항) 카탈로그에서 가져온 캐시된 데이터를 암호화하는 데 사용되는 Cloud KMS 키 이름입니다. 형식: |
FederatedCatalogOptions
페더레이션 카탈로그의 구성 옵션입니다.
| JSON 표현 |
|---|
{ "identity-mode": enum ( |
| 필드 | |
|---|---|
identity-mode |
(선택사항) 페더레이션 카탈로그의 ID 모드입니다. |
refresh-options |
(선택사항) 구성을 새로고침합니다. |
refresh-status |
출력 전용입니다. 백그라운드 메타데이터 새로고침 작업의 상태입니다. |
| 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
identity-federation-organization-service-account |
출력 전용입니다. ID 제휴에 사용되는 조직 수준 서비스 계정입니다. |
| 상호 배타적 필드의 끝입니다. | |
| 원격 Iceberg REST 카탈로그 관련 정보입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
unity-catalog-info |
(선택사항) Databricks Unity Catalog 관련 정보입니다. |
glue-catalog-info |
(선택사항) AWS Glue Data Catalog 관련 정보입니다. |
snowflake-catalog-info |
(선택사항) Snowflake Horizon Catalog 관련 정보입니다. |
workday-catalog-info |
(선택사항) Workday 데이터 레이크 관련 정보입니다. |
| 상호 배타적 필드의 끝입니다. | |
secret-name |
(선택사항) Secret Manager의 보안 비밀 리소스 이름입니다( 프로젝트 ID는 카탈로그의 프로젝트와 일치해야 하며 위치는 카탈로그의 위치와 일치해야 합니다. 버전이 지정되지 않은 경우 최신 버전이 사용됩니다.
|
service-directory-name |
(선택사항) 비공개 네트워크 연결을 통해 원격 카탈로그(예: 스토리지 버킷의 데이터 파일 액세스)로 전송 계층 트래픽을 라우팅하는 데 사용되는 서비스 디렉터리 리소스 이름입니다. 형식: BigQuery 쿼리에서 Cross-Cloud Interconnect와 같은 비공개 네트워크 연결을 통해 데이터 파일(예: S3 또는 Azure Data Lake Storage의 Iceberg 데이터)을 가져오기 위해 비공개 엔드포인트를 확인하는 데 사용됩니다. |
metadata-service-directory-name |
(선택사항) 비공개 네트워크 연결을 통해 원격 카탈로그로 메타데이터 계층 트래픽을 라우팅하는 데 사용되는 서비스 디렉터리 리소스 이름입니다. 형식: Cross-Cloud Interconnect와 같은 비공개 네트워크 연결을 통해 카탈로그 메타데이터(예: Iceberg 구성, 네임스페이스, 테이블)를 검색하는 데 사용됩니다. |
user-identity-federation-oidc-claims |
출력 전용입니다. 지원 중단됨: 대신 사용자 ID 제휴의 ID 토큰에서 내보낸 OIDC 클레임입니다. |
user-identity-federation-oidc |
출력 전용입니다. 사용자 ID 제휴의 OIDC 구성입니다. |
IdentityFederationOrganizationServiceAccount
ID 제휴에 사용되는 조직 수준 서비스 계정입니다(출력 전용). 카탈로그에 ID 제휴가 사용 설정되지 않은 경우 비어 있을 수 있습니다.
| JSON 표현 |
|---|
{ "service-account": string, "service-account-unique-id": string } |
| 필드 | |
|---|---|
service-account |
출력 전용입니다. 조직 수준 서비스 계정의 이메일입니다. |
service-account-unique-id |
출력 전용입니다. 조직 수준 서비스 계정의 고유 ID입니다. |
UnityCatalogInfo
Databricks Unity Catalog 관련 정보입니다. Iceberg REST 카탈로그 엔드포인트는 https://<instanceName>/api/2.1/unity-catalog/iceberg-rest/v1/config?warehouse=<catalogName> 형식입니다.
| JSON 표현 |
|---|
{ "instance-name": string, "catalog-name": string, "service-principal-application-id": string } |
| 필드 | |
|---|---|
instance-name |
필수 항목. 변경할 수 없습니다. Databricks 작업공간의 인스턴스 이름입니다. 예를 들어 Databricks 작업공간 URL |
catalog-name |
필수 항목입니다. 변경할 수 없습니다. Databricks Unity Catalog의 카탈로그 이름입니다. |
service-principal-application-id |
(선택사항) OIDC 인증 흐름에서 Databricks Unity Catalog에 액세스하는 데 사용되는 Databricks 서비스 주 구성원의 애플리케이션 ID입니다. |
GlueCatalogInfo
AWS Glue Data Catalog 관련 정보입니다. Iceberg REST 카탈로그 엔드포인트는 https://glue.<awsRegion>.amazonaws.com/iceberg/v1/config?warehouse=<warehouse> 형식입니다.
| JSON 표현 |
|---|
{ "warehouse": string, "aws-region": string, "aws-role-arn": string } |
| 필드 | |
|---|---|
warehouse |
필수 항목. 변경할 수 없습니다. AWS Glue Data Catalog의 웨어하우스 위치입니다. 기본 계정 카탈로그의 경우 12자리 AWS 계정 ID(예: |
aws-region |
필수 항목입니다. 변경할 수 없습니다. AWS Glue Data Catalog의 AWS 리전(예: |
aws-role-arn |
필수 항목입니다. 페더레이션 카탈로그가 AWS Glue Data Catalog에 액세스하기 위해 사용하는 AWS IAM 역할의 Amazon Resource Name(ARN)입니다. |
SnowflakeCatalogInfo
Snowflake Horizon Catalog 관련 정보입니다. Iceberg REST 카탈로그 엔드포인트는 https://<accountIdentifier>.snowflakecomputing.com/polaris/api/catalog/v1/config?warehouse=<warehouse> 형식입니다.
| JSON 표현 |
|---|
{ "account-identifier": string, "warehouse": string, "snowflake-role": string } |
| 필드 | |
|---|---|
account-identifier |
필수 항목. 변경할 수 없습니다. Snowflake의 계정 식별자입니다. 예를 들어 Snowflake 배포 URL 계정 식별자에는 문자, 숫자, 밑줄이 포함될 수 있으며 세그먼트는 하이픈( |
warehouse |
필수 항목입니다. 변경할 수 없습니다. Snowflake Horizon Catalog의 데이터베이스 이름입니다. |
snowflake-role |
(선택사항) 워크로드 아이덴티티 제휴(OIDC) 인증 흐름에서 Snowflake Horizon Catalog에 대한 액세스 범위를 지정하는 데 사용되는 Snowflake 역할입니다. |
WorkdayCatalogInfo
Workday 데이터 레이크 관련 정보입니다. Iceberg REST 카탈로그 엔드포인트는 https://<baseUrl>/datalake/api/catalog/v1/config?warehouse=workday 형식입니다.
| JSON 표현 |
|---|
{ "base-url": string, "tenant": string, "api-client-client-id": string } |
| 필드 | |
|---|---|
base-url |
필수 항목. 변경할 수 없습니다. Workday 인스턴스의 기준 URL입니다. 예를 들면 |
tenant |
필수 항목입니다. 변경할 수 없습니다. Workday 테넌트 이름입니다. |
api-client-client-id |
(선택사항) OIDC 인증 흐름에서 Workday 데이터 레이크에 액세스하는 데 사용되는 Workday API 클라이언트의 클라이언트 ID입니다. |
IdentityMode
카탈로그에서 쿼리에 사용하는 ID 모드입니다.
| 열거형 | |
|---|---|
IDENTITY_MODE_UNSPECIFIED |
기본값/설정되지 않은 값입니다. 이 값은 IDENTITY_MODE_SERVICE_IDENTITY와 동일하게 취급됩니다. |
IDENTITY_MODE_SERVICE_IDENTITY |
쿼리는 google.cloud.biglake.v1main.IcebergCatalog.biglake_service_account의 서비스 계정을 사용하여 실행됩니다. |
IDENTITY_MODE_USER_IDENTITY_FEDERATION |
쿼리는 최종 사용자의 ID를 사용하여 실행되며 원격 카탈로그로 전파됩니다. 원격 카탈로그에서 ID 제휴를 구성해야 합니다. 자세한 내용은 https://docs.cloud.google.com/lakehouse/docs/about-cross-cloud-data-access#identity-mode를 참조하세요. |
UserIdentityFederationOidcClaims
IDENTITY_MODE_USER_IDENTITY_FEDERATION가 사용 설정된 경우 ID 토큰에서 내보내는 OIDC 클레임입니다.
이 값은 토큰의 ID 공급업체(발급자)와 의도된 수신자(대상)를 식별합니다. 사용자 ID 제휴를 사용 설정하려면 사용자가 이 발급기관을 신뢰하고 이 잠재고객을 예상하도록 원격 카탈로그를 구성해야 합니다.
| JSON 표현 |
|---|
{ "issuer-url": string, "audience": string } |
| 필드 | |
|---|---|
issuer-url |
출력 전용입니다. ID 공급업체의 발급기관 URL입니다. |
audience |
출력 전용입니다. 이 카탈로그가 토큰에서 예상하는 잠재고객입니다. |
UserIdentityFederationOidc
IDENTITY_MODE_USER_IDENTITY_FEDERATION가 사용 설정된 경우 사용되는 OIDC 구성입니다.
사용자 ID 제휴를 사용 설정하려면 사용자가 이러한 매개변수가 있는 토큰을 신뢰하도록 원격 카탈로그를 구성해야 합니다.
| JSON 표현 |
|---|
{ "issuer-url": string, "audience": string, "jwks-url": string } |
| 필드 | |
|---|---|
issuer-url |
출력 전용입니다. ID 공급업체의 발급기관 URL입니다. |
audience |
출력 전용입니다. 이 카탈로그가 토큰에서 예상하는 잠재고객입니다. |
jwks-url |
출력 전용입니다. 토큰을 확인하는 데 사용되는 공개 키를 제공하는 JSON 웹 키 세트(JWKS) URL입니다. Snowflake Horizon 페더레이션 카탈로그에만 설정되며, Snowflake 보안 통합에서 |
RefreshOptions
구성을 새로고침합니다.
| JSON 표현 |
|---|
{ "refresh-schedule": { object ( |
| 필드 | |
|---|---|
refresh-schedule |
(선택사항) 일정은 메타데이터 새로고침을 예약해야 하는지 여부와 시기를 정의합니다. |
refresh-scope |
(선택사항) 범위 구성을 새로고침합니다. |
RefreshSchedule
일정은 메타데이터 새로고침을 예약해야 하는지 여부와 시기를 정의합니다.
| JSON 표현 |
|---|
{ "refresh-interval": string } |
| 필드 | |
|---|---|
refresh-interval |
(선택사항) 원격 카탈로그에서 메타데이터를 새로고침하는 간격입니다. 설정하지 않거나 값이 0 이하이면 백그라운드 메타데이터 새로고침이 사용 중지됩니다. 기존 페더레이션 카탈로그에 대해 이 필드가 업데이트된 경우 새 새로고침 간격이 적용되기 전에 이전 백그라운드 메타데이터 새로고침이 완료되어야 합니다. 소수점 아래가 최대 9자리까지이고 ' |
RefreshScope
범위는 새로고침할 네임스페이스의 하위 집합을 정의합니다.
| JSON 표현 |
|---|
{ "namespace-filters": [ string ] } |
| 필드 | |
|---|---|
namespace-filters[] |
(선택사항) 새로고침 프로세스에 포함되는 네임스페이스를 결정하는 필터입니다. - 빈 목록은 모든 네임스페이스를 포함함을 의미합니다. - '[namespaces]'는 지정된 네임스페이스를 포함한다는 의미입니다. ['ns1', 'ns2'] : 'ns1' 및 'ns2' 네임스페이스만 검색합니다. |
RefreshStatus
원격 카탈로그 백그라운드 메타데이터 새로고침 상태입니다.
| JSON 표현 |
|---|
{
"start-time": string,
"end-time": string,
"status": {
object ( |
| 필드 | |
|---|---|
start-time |
출력 전용입니다. 카탈로그 새로고침이 시작된 경우(진행 중인 새로고침 포함) 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
end-time |
출력 전용입니다. 카탈로그 새로고침이 종료되면 진행 중인 새로고침을 설정 해제합니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
status |
출력 전용입니다. 마지막 백그라운드 메타데이터 새로고침 작업의 상태입니다. 진행 중인 새로고침의 경우 설정되지 않습니다. |
CrossCloudCacheOptions
데이터 및 메타데이터 파일의 크로스 클라우드 캐싱을 위한 구성 옵션입니다.
| JSON 표현 |
|---|
{ "enabled": boolean } |
| 필드 | |
|---|---|
enabled |
(선택사항) 데이터 및 메타데이터 파일의 크로스 클라우드 캐싱이 사용 설정되었는지 여부를 지정합니다. 이는 BigQuery를 통한 쿼리에만 영향을 미칩니다. 이 값이 이 값이 |
메서드 |
|
|---|---|
|
Iceberg REST 카탈로그를 만듭니다. |
|
Iceberg REST 카탈로그를 삭제합니다. |
|
카탈로그를 새 기본 복제본 리전으로 장애 조치합니다. |
|
Iceberg REST 카탈로그 구성 옵션을 반환합니다. |
|
Iceberg REST 카탈로그를 나열합니다. |
|
Iceberg REST 카탈로그 구성 옵션을 업데이트합니다. |