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)
  },

  // Union field config can be only one of the following:
  "sapConfig": {
    object (SapConfig)
  }
  // End of list of possible types for union field config.
}
字段
name

string

标识符。资源名称。格式：projects/{project}/catalogs/{catalog}
location

string

必需。不可变。用户提供的目录 Google Cloud 位置。该字段不可更改。
createTime

string (Timestamp format)

仅限输出。目录的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。目录的上次修改时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“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)

可选。联合目录的配置选项。
联合字段 config。目录的配置。必须设置一个字段，以确定目录的类型。config 只能是下列其中一项：
sapConfig

object (SapConfig)

可选。用于连接到 SAP Business Data Cloud (BDC) 的目录的配置。

SapConfig

SAP Business Data Cloud (BDC) 的配置。

JSON 表示法 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
字段
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

可选。如需创建连接到 SAP BDC 的目录资源，请按照以下 3 步流程操作：1. 将 SapConfig 设置为空。将 `SapConfig` 设置为空。这会使用 GCP 服务账号 serviceAccount 创建目录资源。2. 在 SAP BDC 实例中，使用此 serviceAccount 按照注册流程操作，并创建 BDC 连接器。您将收到来自 SAP 的 connectorEndpoint 和 invitationCode。3. 使用 SAP 提供的这些额外字段，使用 SapBdcEnrollmentConfig 更新之前创建的 BigLake 目录资源。设置 SapBdcEnrollmentConfig 后，该配置将不可变。
sapRegion

string

可选。不可变。用于 SAP BDC API 的 Google Cloud 区域。当目录的元数据存储在多区域（例如“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

可选。包含端点和代码的组合邀请网址。
federatedIdentityIssuer

string

仅限输出。Lakehouse 支持与 SAP BDC 共享数据产品。启用共享后，SAP BDC 将通过联合身份访问底层资源。此字段表示联合身份的签发者。

更具体地说，应按如下方式创建身份池和提供方：

$ 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=""

然后，应将该池添加到共享资源的 IAM 政策中，以便 SAP BDC 可以访问这些资源：

$ 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)

可选。从远程目录刷新元数据的间隔。如果未设置，但需要刷新，系统将使用默认值。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

RefreshStatus

远程目录后台刷新状态。

JSON 表示法 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
字段
startTime

string (Timestamp format)

仅限输出。目录刷新开始时间，包括正在进行的刷新。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

仅限输出。目录刷新结束时间，对于正在进行的刷新，此字段未设置。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“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
}
字段
serviceDirectoryName

string

可选。用于通过跨云互连经由专用网络连接路由流量的 Service Directory 资源名称，格式为 projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}。

方法

create

 创建新的 DeltaSharing 目录。

delete

 删除由资源名称指定的现有 DeltaSharing 目录。

get

 获取由资源名称指定的目录。

list

 列出指定项目中的所有 DeltaSharing 目录。

patch

 更新现有的 DeltaSharing 目录。