Method: dataproductsharing.v1.projects.catalogs.publishDataProduct

将 Knowledge Catalog 数据产品或 Iceberg 目录发布到 SAP BDC。

HTTP 请求

POST https://biglake.googleapis.com/dataproductsharing/v1/{connectionCatalog=projects/*/catalogs/*}:publishDataProduct

网址采用 gRPC 转码语法。

路径参数

参数
connectionCatalog

string

必需。包含 SAP BDC 注册配置的 Delta Sharing 目录。格式：projects/{project}/catalogs/{catalog}

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "share": string,
  "sapFederatedIdentity": string,
  "sapFederatedIdentityProvider": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "icebergCatalog": {
    object (IcebergCatalogReference)
  },
  "dataProduct": {
    object (DataProductReference)
  }
  // End of mutually exclusive fields.
}
字段
share

string

必需。分享的预期名称，将发布到 SAP BDC。
sapFederatedIdentity

string

可选。已弃用。请改用 sapFederatedIdentityProvider。
sapFederatedIdentityProvider

string

可选。必需。表示 SAP 的联合身份提供方的工作负载身份联合 (WIF) 提供方资源名称。示例：

projects/123456789012/locations/global/workloadIdentityPools/sap-bdc-pool/providers/sap-bdc-provider

查询 LakeHouse 表时，SAP BDC 将使用此联合身份池中的身份。SAP 将按如下方式构建主体主体：

principal://iam.googleapis.com/projects//locations//workloadIdentityPools//subject/.

其中 是从连接器端点提取的 SAP BDC 租户的 UUID，例如：https://123e4567-e89b-12d3-a456-426614174000.sharing.hdl..。
必需。要发布的表列表或 Knowledge Catalog 数据产品。以下是互斥字段的列表。在响应中，最多只能设置以下字段之一：
icebergCatalog

object (IcebergCatalogReference)

要发布其表的 BigLake Iceberg REST 目录。
dataProduct

object (DataProductReference)

要发布的 Knowledge Catalog 数据产品。已发布分享的标题、简短说明和说明将自动从 Knowledge Catalog 数据产品元数据中填充。
互斥字段的结束。

响应正文

如果成功，则响应正文为空。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 connectionCatalog 资源的以下 IAM 权限：

  • biglake.catalogs.update

需要拥有 catalog 资源的以下 IAM 权限：

  • biglake.catalogs.get

如需了解详情，请参阅 IAM 文档。

IcebergCatalogReference

对 Iceberg REST Catalog 的引用。

JSON 表示法 
{
  "catalog": string,
  "title": string,
  "shortDescription": string,
  "description": string
}
字段
catalog

string

必需。完全限定的 BigLake 目录路径。格式：projects/{project}/catalogs/{catalog}
title

string

必需。已发布共享内容的标题。
shortDescription

string

必需。已发布分享的简短说明。
description

string

可选。已发布分享的详细说明。

DataProductReference

对 Knowledge Catalog 数据产品的引用。

JSON 表示法 
{
  "dataProduct": string
}
字段
dataProduct

string

必需。Knowledge Catalog 数据产品的完全限定资源名称。格式：projects/{project}/locations/{location}/dataProducts/{dataProduct}