SuperAPI AI 工具集

manage-zerocopy-sapbdc

数据与分析

查看项目

更新于 10-16 06:04

技能介绍

用途

本技能管理 SAP BDC 与 Snowflake 零拷贝集成及连接器的端到端生命周期,包括设置、消费、发布、分析和故障排查。

适用场景

  • 用户要求创建、连接或注册 SAP BDC 零拷贝连接器
  • 用户希望在 Snowflake 中消费或挂载 SAP BDC 共享数据产品
  • 用户希望将 Snowflake 数据作为数据产品发布回 SAP BDC
  • 用户要求探索、查询或联接已挂载的 SAP 数据产品中的数据
  • 用户需要排查 SAP BDC 连接器状态、权限或连接问题

不适用于:非 SAP 的通用 Snowflake 数据共享、SAP HANA 直连、SAP BTP 非 BDC 服务。

前置条件

  • ORGADMIN 必须已接受 SAP® BDC Connect for Snowflake 条款(Snowsight 中 Admin » Terms » Snowflake Marketplace 部分),每个 Snowflake 组织只需执行一次
  • SAP Business Data Cloud(BDC)设置必须已完成
  • 角色必须在目标 schema 上具有 CREATE ZEROCOPY CONNECTOR 权限
  • 发布场景:账户需具有 CREATE SHARE 权限

使用方式

每次调用该技能时,会先呈现菜单供用户选择意图:

  1. 创建新的零拷贝连接器——设置新连接器并向 SAP BDC 注册
  2. 消费共享数据产品——将共享的 SAP BDC 数据产品挂载为 Snowflake 中的目录链接数据库
  3. 发布数据产品——将 Snowflake 数据库作为新数据产品共享回 SAP BDC
  4. 分析共享数据——探索、查询和联接已挂载在 Snowflake 中的 SAP BDC 数据产品
  5. 故障排查——诊断并修复连接器状态错误、权限问题和连接问题

根据选择路由到对应子技能:选项 1 加载 create-connector/INSTRUCTIONS.md;选项 2 加载 consume/INSTRUCTIONS.md;选项 3 加载 publish/INSTRUCTIONS.md;选项 4 加载 analyze/INSTRUCTIONS.md;选项 5 加载 troubleshoot/INSTRUCTIONS.md。

连接器状态

  • NEW:刚创建,未尝试连接;允许 CONNECT、DROP
  • CONNECTING:连接进行中(异步);等待
  • CONNECTED:活动连接;允许 DISCONNECT(须先禁用 share-back 并删除 CLD)、创建 CLD、发布
  • CONNECT_ERROR:连接失败;允许 CONNECT(重试)、DROP
  • DISCONNECTING:断开进行中(异步);等待
  • DISCONNECTED:连接已断开;允许 CONNECT(重连)、DROP
  • DISCONNECT_ERROR:断开失败;允许 DISCONNECT(重试)、DROP
  • DELETED:连接器已删除(永久,无 UNDROP);无可用操作

关键 SQL 命令

  • CREATE ZEROCOPY CONNECTOR <name> PARTNER = SAP_BDC:创建连接器
  • SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME():为 SAP for Me 注册推导账户 URL
  • ALTER ZEROCOPY CONNECTOR <name> CONNECT WITH CONFIG = (INVITATION_LINK = '...'):建立连接
  • DESC ZEROCOPY CONNECTOR <name>:检查连接器状态
  • SHOW ZEROCOPY CONNECTORS IN SCHEMA <db>.<schema>:列出所有连接器
  • SELECT SYSTEM$ZEROCOPY_CONNECTOR_LIST_SHARES('<db>.<schema>.<connector>'):列出可用的 SAP 数据产品
  • ALTER ZEROCOPY CONNECTOR <name> SET SHARE_BACK = TRUE:启用发布
  • ALTER ZEROCOPY CONNECTOR <name> ADD SHARE <share>:关联用于发布的共享
  • ALTER ZEROCOPY CONNECTOR <name> DISCONNECT:断开连接(须先禁用 share-back 并删除 CLD)
  • DROP ZEROCOPY CONNECTOR <name>:删除连接器(须处于 NEW/CONNECT_ERROR/DISCONNECT_ERROR/DISCONNECTED 状态)

所需权限

  • CREATE ZEROCOPY CONNECTOR(Schema):创建连接器
  • OPERATE(Connector):连接、断开和发布数据产品(SYSTEM$SAP_PUBLISH_DATA_PRODUCT)
  • USAGE(Connector):创建 CLD(还需账户级 CREATE DATABASE)、添加/移除共享(还需共享的 OWNERSHIP)
  • MODIFY(Connector):设置/取消属性(comment、share_back 等)
  • MONITOR(Connector):描述连接器、显示连接器、列出共享(连接器上任意权限即可)
  • OWNERSHIP(Connector):重命名或删除连接器
  • CREATE DATABASE(Account):创建目录链接数据库(还需连接器上的 USAGE)
  • CREATE SHARE(Account):将数据发布回 SAP BDC

示例

  • 示例 1:创建并注册连接器——用户请求创建新零拷贝连接器并向 SAP BDC 注册;助手询问数据库/schema/连接器名称,运行 CREATE ZEROCOPY CONNECTOR,提供用于 SAP for Me 注册的账户 URL,然后使用邀请链接连接。
  • 示例 2:消费数据产品——用户请求挂载 SAP 的 Workforce Persons 数据产品;助手列出可用共享,创建目录链接数据库,确认表可访问并生成语义视图。
  • 示例 3:将 Snowflake 数据发布到 SAP——用户请求将 ANALYTICS_DB.SALES schema 发布到 SAP BDC;助手启用 share-back,验证 Iceberg V3 表,生成 MINIMAL CSN Interop v1.0(SDK 兼容,无选项、无审查),创建共享,发布数据产品。
  • 示例 4:故障排查——用户反馈连接器卡在 CONNECT_ERROR;助手运行 DESC ZEROCOPY CONNECTOR,检查权限,验证邀请链接,提供修复步骤。

停止点

步骤 1 之后:路由到所选子技能。

输出

取决于所选用例——参见各子技能输出。