REST Resource: iceberg.v1.restcatalog.extensions.projects.catalogs

리소스: IcebergCatalog

Iceberg REST 카탈로그 정보입니다.

JSON 표현
{
  "name": string,
  "credential-mode": enum (CredentialMode),
  "biglake-service-account": string,
  "biglake-service-account-id": string,
  "catalog-type": enum (CatalogType),
  "default-location": string,
  "storage-regions": [
    string
  ],
  "create-time": string,
  "update-time": string,
  "replicas": [
    {
      object (Replica)
    }
  ],
  "description": string,
  "restricted-locations-config": {
    object (RestrictedLocationsConfig)
  },
  "federated-catalog-options": {
    object (FederatedCatalogOptions)
  },
  "cross-cloud-cache-options": {
    object (CrossCloudCacheOptions)
  },
  "encryption-config": {
    object (EncryptionConfig)
  }
}
필드
name

string

식별자. 카탈로그 이름(projects/my-project/catalogs/my-catalog)입니다. 이 필드는 변경할 수 없습니다. 이 필드는 catalogs.create에서 무시됩니다.

credential-mode

enum (CredentialMode)

(선택사항) 카탈로그의 사용자 인증 정보 모드입니다.

biglake-service-account

string

출력 전용입니다. 사용자 인증 정보 판매에 사용되는 서비스 계정입니다(출력 전용). 카탈로그에 사용자 인증 정보 벤더 제공이 사용 설정되지 않은 경우 비어 있을 수 있습니다.

페더레이션 카탈로그의 경우 서비스 계정이 항상 프로비저닝되며 백그라운드 메타데이터 새로고침을 위해 원격 카탈로그에 액세스하는 데 사용됩니다. google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.IdentityMode가 IDENTITY_MODE_SERVICE_IDENTITY로 설정된 경우 쿼리에도 사용됩니다.

biglake-service-account-id

string

출력 전용입니다. 서비스 계정의 고유 ID입니다. 이는 제휴 시나리오에 사용됩니다.

catalog-type

enum (CatalogType)

필수 항목입니다. 카탈로그 유형입니다. catalogs.create에 필요합니다. 카탈로그 유형은 CATALOG_TYPE_GCS_BUCKET에서 CATALOG_TYPE_BIGLAKE로 변환하는 경우를 제외하고 변경할 수 없습니다.

default-location

string

(선택사항) 카탈로그의 기본 스토리지 위치입니다(예: gs://my-bucket). Google Cloud Storage 버킷 카탈로그의 경우 출력 전용입니다.

BigLake 카탈로그의 경우 이 필드를 제공해야 하며 Google Cloud Storage 버킷 또는 해당 버킷 내의 경로를 가리켜야 합니다. 이 경로는 네임스페이스 또는 테이블 수준에서 위치가 지정되지 않은 경우 테이블의 데이터 및 메타데이터 디렉터리에 대한 전체 경로를 구성하는 기본 디렉터리 역할을 합니다. 전체 경로는 기본 위치에 네임스페이스 및 테이블 식별자를 추가하여 형성됩니다.

storage-regions[]

string

출력 전용입니다. 기본 위치 버킷의 Google Cloud 리전입니다(예: us-central1, nam4 또는 us). 여기에는 커스텀 이중 리전 버킷을 사용하도록 구성된 카탈로그를 제외한 모든 위치에 대해 하나의 값이 포함되며, 이 경우 버킷의 두 리전이 포함됩니다. 이 필드의 리전은 카탈로그의 기본 위치 관할권 내에 있거나 그 근처에 있어야 합니다.

create-time

string (Timestamp format)

출력 전용입니다. 카탈로그가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

update-time

string (Timestamp format)

출력 전용입니다. 카탈로그가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

replicas[]

object (Replica)

출력 전용입니다. 카탈로그 메타데이터의 복제본입니다.

description

string

(선택사항) 사용자가 제공한 카탈로그 설명입니다. 설명은 최대 길이가 1,024자(영문 기준)인 UTF-8 문자열이어야 합니다.

restricted-locations-config

object (RestrictedLocationsConfig)

(선택사항) 제한된 위치 구성 이 필드는 현재 BigLake 카탈로그에만 사용됩니다.

이 필드가 설정되지 않았거나 restrictedLocationsConfig.restricted_locations가 비어 있으면 액세스 가능한 모든 위치가 허용됩니다. restrictedLocationsConfig.restricted_locations가 비어 있지 않으면 defaultLocation 및 restrictedLocationsConfig.restricted_locations의 위치만 허용됩니다.

federated-catalog-options

object (FederatedCatalogOptions)

(선택사항) 페더레이션 카탈로그의 구성 옵션입니다.

cross-cloud-cache-options

object (CrossCloudCacheOptions)

(선택사항) 데이터 및 메타데이터 파일의 크로스 클라우드 캐싱을 위한 구성 옵션입니다.

encryption-config

object (EncryptionConfig)

(선택사항) 커스텀 암호화 구성(예: Cloud KMS 키)

CredentialMode

카탈로그에 사용되는 사용자 인증 정보 모드입니다.

열거형
CREDENTIAL_MODE_UNSPECIFIED 기본값/설정되지 않은 값입니다. 이 값은 사용되지 않습니다.
CREDENTIAL_MODE_END_USER 최종 사용자 인증 정보 모드(기본값) 인증 사용자는 카탈로그 리소스와 기본 Google Cloud Storage 객체에 액세스할 수 있어야 합니다.
CREDENTIAL_MODE_VENDED_CREDENTIALS

사용자 인증 정보 벤더 제공 모드입니다. 인증 사용자는 카탈로그 리소스에만 액세스하면 되며 시스템은 호출자에게 Google Cloud Storage 객체에 액세스할 수 있는 범위 축소 사용자 인증 정보를 제공합니다. 이 모드의 모든 테이블 작업에는 X-Iceberg-Access-Delegation 헤더를 vended-credentials로 설정해야 합니다. 시스템은 google.cloud.biglake.v1main.IcebergCatalog.biglake_service_account에 서비스 계정을 생성하며, 카탈로그 관리자는 이 계정에 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 (State)
}
필드
region

string

출력 전용입니다. 복제본의 리전입니다. 예: 'us-east1'

state

enum (State)

출력 전용입니다. 복제본의 현재 상태입니다.

주

카탈로그가 여러 리전에 복제되는 경우 이 enum은 복제본의 현재 상태를 설명합니다.

열거형
STATE_UNKNOWN 기본값/설정되지 않은 값입니다. 이 값은 사용되지 않습니다.
STATE_PRIMARY 복제본은 쓰기 가능한 기본 복제본입니다.
STATE_PRIMARY_IN_PROGRESS 복제본이 최근에 기본으로 할당되었지만 아직 모든 네임스페이스가 쓰기 가능하지 않습니다.
STATE_SECONDARY 복제본은 읽기 전용 보조 복제본입니다.

RestrictedLocationsConfig

위치 제한 구성

JSON 표현
{
  "restricted-locations": [
    string
  ]
}
필드
restricted-locations[]

string

(선택사항) 카탈로그 내 리소스에서 사용할 수 있는 추가 Google Cloud Storage 버킷 및 위치(예: gs://my-other-bucket/...)입니다. 이 필드는 현재 BigLake 카탈로그에만 사용됩니다.

restrictedLocations가 비어 있고 제한 없는 카탈로그 생성이 사용 설정된 경우 액세스 가능한 모든 위치가 허용됩니다. 그렇지 않으면 defaultLocation 및 이 목록의 위치만 허용됩니다.

EncryptionConfig

커스텀 암호화 구성(예: Cloud KMS 키)

JSON 표현
{
  "kms-key-name": string
}
필드
kms-key-name

string

(선택사항) 카탈로그에서 가져온 캐시된 데이터를 암호화하는 데 사용되는 Cloud KMS 키 이름입니다. 형식: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}

FederatedCatalogOptions

페더레이션 카탈로그의 구성 옵션입니다.

JSON 표현
{
  "identity-mode": enum (IdentityMode),
  "refresh-options": {
    object (RefreshOptions)
  },
  "refresh-status": {
    object (RefreshStatus)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "identity-federation-organization-service-account": {
    object (IdentityFederationOrganizationServiceAccount)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "unity-catalog-info": {
    object (UnityCatalogInfo)
  },
  "glue-catalog-info": {
    object (GlueCatalogInfo)
  },
  "snowflake-catalog-info": {
    object (SnowflakeCatalogInfo)
  },
  "workday-catalog-info": {
    object (WorkdayCatalogInfo)
  }
  // End of mutually exclusive fields.
  "secret-name": string,
  "service-directory-name": string,
  "metadata-service-directory-name": string,
  "user-identity-federation-oidc-claims": {
    object (UserIdentityFederationOidcClaims)
  },
  "user-identity-federation-oidc": {
    object (UserIdentityFederationOidc)
  }
}
필드
identity-mode

enum (IdentityMode)

(선택사항) 페더레이션 카탈로그의 ID 모드입니다.

refresh-options

object (RefreshOptions)

(선택사항) 구성을 새로고침합니다.

refresh-status

object (RefreshStatus)

출력 전용입니다. 백그라운드 메타데이터 새로고침 작업의 상태입니다.

다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
identity-federation-organization-service-account

object (IdentityFederationOrganizationServiceAccount)

출력 전용입니다. ID 제휴에 사용되는 조직 수준 서비스 계정입니다.

상호 배타적 필드의 끝입니다.
원격 Iceberg REST 카탈로그 관련 정보입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
unity-catalog-info

object (UnityCatalogInfo)

(선택사항) Databricks Unity Catalog 관련 정보입니다.

glue-catalog-info

object (GlueCatalogInfo)

(선택사항) AWS Glue Data Catalog 관련 정보입니다.

snowflake-catalog-info

object (SnowflakeCatalogInfo)

(선택사항) Snowflake Horizon Catalog 관련 정보입니다.

workday-catalog-info

object (WorkdayCatalogInfo)

(선택사항) Workday 데이터 레이크 관련 정보입니다.

상호 배타적 필드의 끝입니다.
secret-name

string

(선택사항) Secret Manager의 보안 비밀 리소스 이름입니다(projects/{projectId}/locations/{location}/secrets/{secret_id} 또는 projects/{projectId}/locations/{location}/secrets/{secret_id}/versions/{version_id} 형식).

프로젝트 ID는 카탈로그의 프로젝트와 일치해야 하며 위치는 카탈로그의 위치와 일치해야 합니다. 버전이 지정되지 않은 경우 최신 버전이 사용됩니다.

google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.UnityCatalogInfo.service_principal_application_id, google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.SnowflakeCatalogInfo.snowflake_role 또는 google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.WorkdayCatalogInfo.api_client_client_id가 설정된 경우 이 필드는 사용되지 않습니다.

service-directory-name

string

(선택사항) 비공개 네트워크 연결을 통해 원격 카탈로그(예: 스토리지 버킷의 데이터 파일 액세스)로 전송 계층 트래픽을 라우팅하는 데 사용되는 서비스 디렉터리 리소스 이름입니다.

형식: projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}

BigQuery 쿼리에서 Cross-Cloud Interconnect와 같은 비공개 네트워크 연결을 통해 데이터 파일(예: S3 또는 Azure Data Lake Storage의 Iceberg 데이터)을 가져오기 위해 비공개 엔드포인트를 확인하는 데 사용됩니다.

metadata-service-directory-name

string

(선택사항) 비공개 네트워크 연결을 통해 원격 카탈로그로 메타데이터 계층 트래픽을 라우팅하는 데 사용되는 서비스 디렉터리 리소스 이름입니다.

형식: projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}

Cross-Cloud Interconnect와 같은 비공개 네트워크 연결을 통해 카탈로그 메타데이터(예: Iceberg 구성, 네임스페이스, 테이블)를 검색하는 데 사용됩니다. oauth2ServerUrl가 설정되지 않은 경우 OAuth 토큰을 가져오는 데도 사용됩니다. 이 필드가 설정되지 않으면 요청이 공개 인터넷을 통해 전송됩니다.

user-identity-federation-oidc-claims
(deprecated)

object (UserIdentityFederationOidcClaims)

출력 전용입니다. 지원 중단됨: 대신 google.cloud.biglake.v1main.IcebergCatalog.FederatedCatalogOptions.user_identity_federation_oidc를 사용하세요.

사용자 ID 제휴의 ID 토큰에서 내보낸 OIDC 클레임입니다.

user-identity-federation-oidc

object (UserIdentityFederationOidc)

출력 전용입니다. 사용자 ID 제휴의 OIDC 구성입니다.

IdentityFederationOrganizationServiceAccount

ID 제휴에 사용되는 조직 수준 서비스 계정입니다(출력 전용). 카탈로그에 ID 제휴가 사용 설정되지 않은 경우 비어 있을 수 있습니다.

JSON 표현
{
  "service-account": string,
  "service-account-unique-id": string
}
필드
service-account

string

출력 전용입니다. 조직 수준 서비스 계정의 이메일입니다.

service-account-unique-id

string

출력 전용입니다. 조직 수준 서비스 계정의 고유 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

string

필수 항목. 변경할 수 없습니다. Databricks 작업공간의 인스턴스 이름입니다. 예를 들어 Databricks 작업공간 URL https://1.1.gcp.databricks.com의 경우 인스턴스 이름은 1.1.gcp.databricks.com입니다.

catalog-name

string

필수 항목입니다. 변경할 수 없습니다. Databricks Unity Catalog의 카탈로그 이름입니다.

service-principal-application-id

string

(선택사항) 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

string

필수 항목. 변경할 수 없습니다. AWS Glue Data Catalog의 웨어하우스 위치입니다.

기본 계정 카탈로그의 경우 12자리 AWS 계정 ID(예: 111222333444)를 사용하세요. Amazon S3 테이블 버킷의 경우 <account_id>:s3tablescatalog/<table_bucket_name> 형식(예: 111222333444:s3tablescatalog/my-table-bucket)을 사용하세요.

aws-region

string

필수 항목입니다. 변경할 수 없습니다. AWS Glue Data Catalog의 AWS 리전(예: us-east-1). 최상의 성능을 위해 페더레이션 카탈로그의 리전은 AWS 리전과 동일한 지리적 위치 및 관할권에 있어야 합니다.

aws-role-arn

string

필수 항목입니다. 페더레이션 카탈로그가 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

string

필수 항목. 변경할 수 없습니다. Snowflake의 계정 식별자입니다. 예를 들어 Snowflake 배포 URL https://myorg-myaccount.snowflakecomputing.com의 경우 계정 식별자는 myorg-myaccount입니다.

계정 식별자에는 문자, 숫자, 밑줄이 포함될 수 있으며 세그먼트는 하이픈(-) 또는 점(.)으로 구분됩니다. 이는 조직 계정 형식(예: myorg-myaccount), 기존 계정 로케이터 형식(예: xy12345.us-east-1), 비공개 연결(PrivateLink) 형식(예: myorg-myaccount.privatelink 또는 xy12345.us-east-1.privatelink)을 지원합니다. 자세한 내용은 https://docs.snowflake.com/en/user-guide/admin-account-identifier를 참조하세요.

warehouse

string

필수 항목입니다. 변경할 수 없습니다. Snowflake Horizon Catalog의 데이터베이스 이름입니다.

snowflake-role

string

(선택사항) 워크로드 아이덴티티 제휴(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

string

필수 항목. 변경할 수 없습니다. Workday 인스턴스의 기준 URL입니다. 예를 들면 impl-services1.wd12.myworkday.com 또는 wd501.myworkday.com입니다.

tenant

string

필수 항목입니다. 변경할 수 없습니다. Workday 테넌트 이름입니다.

api-client-client-id

string

(선택사항) 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

string

출력 전용입니다. ID 공급업체의 발급기관 URL입니다.

audience

string

출력 전용입니다. 이 카탈로그가 토큰에서 예상하는 잠재고객입니다.

UserIdentityFederationOidc

IDENTITY_MODE_USER_IDENTITY_FEDERATION가 사용 설정된 경우 사용되는 OIDC 구성입니다.

사용자 ID 제휴를 사용 설정하려면 사용자가 이러한 매개변수가 있는 토큰을 신뢰하도록 원격 카탈로그를 구성해야 합니다.

JSON 표현
{
  "issuer-url": string,
  "audience": string,
  "jwks-url": string
}
필드
issuer-url

string

출력 전용입니다. ID 공급업체의 발급기관 URL입니다.

audience

string

출력 전용입니다. 이 카탈로그가 토큰에서 예상하는 잠재고객입니다.

jwks-url

string

출력 전용입니다. 토큰을 확인하는 데 사용되는 공개 키를 제공하는 JSON 웹 키 세트(JWKS) URL입니다. Snowflake Horizon 페더레이션 카탈로그에만 설정되며, Snowflake 보안 통합에서 EXTERNAL_OAUTH_JWS_KEYS_URL로 사용됩니다.

RefreshOptions

구성을 새로고침합니다.

JSON 표현
{
  "refresh-schedule": {
    object (RefreshSchedule)
  },
  "refresh-scope": {
    object (RefreshScope)
  }
}
필드
refresh-schedule

object (RefreshSchedule)

(선택사항) 일정은 메타데이터 새로고침을 예약해야 하는지 여부와 시기를 정의합니다.

refresh-scope

object (RefreshScope)

(선택사항) 범위 구성을 새로고침합니다.

RefreshSchedule

일정은 메타데이터 새로고침을 예약해야 하는지 여부와 시기를 정의합니다.

JSON 표현
{
  "refresh-interval": string
}
필드
refresh-interval

string (Duration format)

(선택사항) 원격 카탈로그에서 메타데이터를 새로고침하는 간격입니다. 설정하지 않거나 값이 0 이하이면 백그라운드 메타데이터 새로고침이 사용 중지됩니다. 기존 페더레이션 카탈로그에 대해 이 필드가 업데이트된 경우 새 새로고침 간격이 적용되기 전에 이전 백그라운드 메타데이터 새로고침이 완료되어야 합니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

RefreshScope

범위는 새로고침할 네임스페이스의 하위 집합을 정의합니다.

JSON 표현
{
  "namespace-filters": [
    string
  ]
}
필드
namespace-filters[]

string

(선택사항) 새로고침 프로세스에 포함되는 네임스페이스를 결정하는 필터입니다. - 빈 목록은 모든 네임스페이스를 포함함을 의미합니다. - '[namespaces]'는 지정된 네임스페이스를 포함한다는 의미입니다. ['ns1', 'ns2'] : 'ns1' 및 'ns2' 네임스페이스만 검색합니다.

RefreshStatus

원격 카탈로그 백그라운드 메타데이터 새로고침 상태입니다.

JSON 표현
{
  "start-time": string,
  "end-time": string,
  "status": {
    object (Status)
  }
}
필드
start-time

string (Timestamp format)

출력 전용입니다. 카탈로그 새로고침이 시작된 경우(진행 중인 새로고침 포함)

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

end-time

string (Timestamp format)

출력 전용입니다. 카탈로그 새로고침이 종료되면 진행 중인 새로고침을 설정 해제합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

status

object (Status)

출력 전용입니다. 마지막 백그라운드 메타데이터 새로고침 작업의 상태입니다. 진행 중인 새로고침의 경우 설정되지 않습니다.

CrossCloudCacheOptions

데이터 및 메타데이터 파일의 크로스 클라우드 캐싱을 위한 구성 옵션입니다.

JSON 표현
{
  "enabled": boolean
}
필드
enabled

boolean

(선택사항) 데이터 및 메타데이터 파일의 크로스 클라우드 캐싱이 사용 설정되었는지 여부를 지정합니다. 이는 BigQuery를 통한 쿼리에만 영향을 미칩니다.

이 값이 true이면 읽기 데이터와 메타데이터가 캐시에 저장되므로 크로스 클라우드 쿼리의 성능이 향상되고 네트워크 이그레스 비용이 감소할 수 있습니다.

이 값이 false이면 크로스 클라우드 캐싱이 사용 중지됩니다.

메서드

create

Iceberg REST 카탈로그를 만듭니다.

delete

Iceberg REST 카탈로그를 삭제합니다.

failover

카탈로그를 새 기본 복제본 리전으로 장애 조치합니다.

get

Iceberg REST 카탈로그 구성 옵션을 반환합니다.

list

Iceberg REST 카탈로그를 나열합니다.

patch

Iceberg REST 카탈로그 구성 옵션을 업데이트합니다.