SuperAPI AI 工具集

discovering-gcp-data-assets

数据与分析

查看项目

更新于 10-16 05:49

技能介绍

用途:在 Google Cloud 中查找并检查数据资产。适用于用户提出发现、探索或定位数据资产的请求。

主要流程分四步:

  1. 优先使用对话中已创建或提及的资产,跳过后续搜索步骤。
  2. 公共数据集(bigquery-public-data 项目)需跳过搜索,直接用 bq CLI 或 BigQuery MCP 工具检查;其他 BigQuery、Cloud Storage、Spanner、BigLake Iceberg 及通用 GCP 资产必须进入 Dataplex 目录搜索,以获取完整 Entry Name。
  3. 执行发现搜索:语义搜索用 search_entries MCP 工具或 gcloud dataplex entries search "<自然语言查询>" --project="<PROJECT_ID>" --semantic-search --limit=50;关键词搜索用 gcloud dataplex entries search "<关键词查询>" --project="<PROJECT_ID>" --limit=50。--project 必须始终提供,用于授权与归属,不限制搜索范围,且项目需启用 Dataplex API 并具备 dataplex.entries.get 权限。查询语法区分语义与关键词模式,如语义用 labels.、关键词用 label.,布尔运算符大小写要求不同,支持 name、displayname、projectid、parent、location、column、system、type、labels、createtime、fully_qualified_name 等限定符。
  4. 使用 lookup_context MCP 工具或 gcloud dataplex context lookup --resources="<完整条目名>" 获取 schema 与深度元数据,--resources 必须是搜索结果返回的以 projects/ 开头的完整名称。

限制与排错:搜索结果可能因元数据未入库而缺失,最多尝试 3 次查询变体后应停止并询问用户;超过 10 条结果时展示前 5 条并请求澄清;不得重复执行相同查询;若 Context Lookup 对公共数据集返回 NOT_FOUND,可回退到 bq CLI 等原生工具直接检查;原生工具也报 Not Found 时停止,请用户核对项目与表 ID。--project 缺失或权限不足会分别报 Must be specified 与 PERMISSION_DENIED。