REST Resource: deltasharing.v1.projects.catalogs

리소스: DeltaSharingCatalog

DeltaSharing 카탈로그를 나타냅니다.

JSON 표현 
{
  "name": string,
  "location": string,
  "createTime": string,
  "updateTime": string,
  "serviceAccount": string,
  "refreshOptions": {
    object (RefreshOptions)
  },
  "refreshStatus": {
    object (RefreshStatus)
  },
  "federatedCatalogOptions": {
    object (FederatedCatalogOptions)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "sapConfig": {
    object (SapConfig)
  }
  // End of mutually exclusive fields.
  "encryptionConfig": {
    object (EncryptionConfig)
  }
}
필드
name

string

식별자. 리소스 이름입니다. 형식: projects/{project}/catalogs/{catalog}
location

string

필수 항목입니다. 변경할 수 없습니다. 사용자가 제공한 카탈로그의 GCP 위치입니다. 이 필드는 변경할 수 없습니다.
createTime

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"입니다.
updateTime

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"입니다.
serviceAccount

string

출력 전용입니다. SAP 등록에 사용되며 Delta Sharing 카탈로그 리소스 생성의 부작용으로 생성되는 서비스 계정입니다.
refreshOptions

object (RefreshOptions)

(선택사항) Delta Sharing 카탈로그를 새로고침하는 옵션을 구성합니다.
refreshStatus

object (RefreshStatus)

출력 전용입니다. 백그라운드 카탈로그 새로고침의 상태입니다.
federatedCatalogOptions

object (FederatedCatalogOptions)

(선택사항) 제휴 카탈로그의 구성 옵션입니다.
카탈로그 구성입니다. 정확히 하나의 필드를 설정해야 하며, 이 필드가 카탈로그의 유형을 결정합니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
sapConfig

object (SapConfig)

(선택사항) SAP Business Data Cloud (BDC)에 연결되는 카탈로그의 구성입니다.
상호 배타적 필드의 끝입니다.
encryptionConfig

object (EncryptionConfig)

(선택사항) 맞춤 암호화 구성 (예: Cloud KMS 키)

SapConfig

SAP Business Data Cloud (BDC) 구성

JSON 표현 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
필드
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

(선택사항) SAP BDC에 연결되는 카탈로그 리소스를 만들려면 다음 3단계 프로세스를 따르세요. 1. SapConfig를 빈 값으로 설정합니다. 이렇게 하면 GCP 서비스 계정(serviceAccount)이 있는 카탈로그 리소스가 생성됩니다. 2. SAP BDC 인스턴스에서 이 serviceAccount를 사용하여 등록 프로세스를 따르고 BDC 커넥터를 만듭니다. SAP에서 connectorEndpoint 및 invitationCode을 받게 됩니다. 3. SAP에서 제공하는 이러한 추가 필드를 사용하여 이전에 SapBdcEnrollmentConfig로 만든 BigLake 카탈로그 리소스를 업데이트합니다. SapBdcEnrollmentConfig는 설정되면 변경할 수 없습니다.
sapRegion

string

(선택사항) 변경할 수 없습니다. SAP BDC API에 사용할 GCP 리전입니다. 카탈로그의 메타데이터가 멀티 리전 (예: 'us')에 저장되어 있지만 실제 SAP BDC 인스턴스가 단일 리전 (예: 'us-central1')에 있는 경우 이 필드를 명시적으로 설정하여 해당 단일 리전을 가리켜야 합니다. 설정하지 않으면 카탈로그 생성 중에 제공된 위치가 기본적으로 사용됩니다.

SapBdcEnrollmentConfig

SAP에서 수신한 등록 구성을 포함합니다.

JSON 표현 
{
  "connectorEndpoint": string,
  "invitationCode": string,
  "invitationUrl": string,
  "federatedIdentityIssuer": string
}
필드
connectorEndpoint

string

(선택사항) 고유한 SAP BDC 커넥터 엔드포인트입니다.
invitationCode

string

(선택사항) SAP의 초대 코드입니다.
invitationUrl

string

(선택사항) 엔드포인트와 코드가 모두 포함된 결합된 초대 URL입니다.
federatedIdentityIssuer

string

출력 전용입니다. Lakehouse는 SAP BDC와의 데이터 제품 공유를 지원합니다. 공유가 사용 설정되면 SAP BDC가 제휴 ID를 통해 기본 리소스에 액세스합니다. 이 필드는 제휴 ID의 발급자를 나타냅니다.

구체적으로 ID 풀과 프로바이더는 다음과 같이 만들어야 합니다.

$ gcloud iam workload-identity-pools create sap-bdc-pool \ --location="global" \ --display-name="SAP BDC Pool"

$ gcloud iam workload-identity-pools providers create-oidc sap-bdc-provider \ --location="global" \ --workload-identity-pool="sap-bdc-pool" \ --issuer-uri=""

그런 다음 SAP BDC가 액세스할 수 있도록 공유 리소스의 IAM 정책에 풀을 추가할 수 있습니다.

$ gcloud projects add-iam-policy-binding PROJECT_ID \ --role="roles/biglake.viewer" \ --member="principal://iam.googleapis.com/projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/sap-bdc-pool/subject/{TENANT_UUID}"

여기서 TENANT_UUID는 SAP BDC 인스턴스에서 찾을 수 있습니다.

RefreshOptions

Delta Sharing 카탈로그를 새로고침하는 옵션을 구성합니다.

JSON 표현 
{
  "refreshSchedule": {
    object (RefreshSchedule)
  }
}
필드
refreshSchedule

object (RefreshSchedule)

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

RefreshSchedule

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

JSON 표현 
{
  "refreshInterval": string
}
필드
refreshInterval

string (Duration format)

(선택사항) 원격 카탈로그에서 메타데이터를 새로고침하는 간격입니다. 설정하지 않았지만 새로고침을 원하는 경우 시스템 기본값이 사용됩니다.

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

RefreshStatus

원격 카탈로그 백그라운드 새로고침 상태입니다.

JSON 표현 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
필드
startTime

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"입니다.
endTime

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)

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

FederatedCatalogOptions

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

JSON 표현 
{
  "serviceDirectoryName": string,
  "crossCloudCacheOptions": {
    object (CrossCloudCacheOptions)
  }
}
필드
serviceDirectoryName

string

(선택사항) Cross-Cloud Interconnect를 통해 비공개 네트워크 연결로 트래픽을 라우팅하기 위한 서비스 디렉터리 리소스 이름입니다(projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId} 형식).
crossCloudCacheOptions

object (CrossCloudCacheOptions)

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

CrossCloudCacheOptions

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

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

boolean

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

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

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

EncryptionConfig

맞춤 암호화 구성 (예: Cloud KMS 키)

JSON 표현 
{
  "kmsKeyName": string
}
필드
kmsKeyName

string

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

메서드

create

 새 DeltaSharing 카탈로그를 만듭니다.

delete

 리소스 이름으로 지정된 기존 DeltaSharing 카탈로그를 삭제합니다.

get

 리소스 이름으로 지정된 카탈로그를 가져옵니다.

list

 지정된 프로젝트의 모든 DeltaSharing 카탈로그를 나열합니다.

patch

 기존 DeltaSharing 카탈로그를 업데이트합니다.