discovering-gcp-data-assets

Discovers and inspects Google Cloud data assets using Dataplex search and context lookup.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/DingJun1028/esggo-kv --skill discovering-gcp-data-assets-dingjun1028
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: discovering-gcp-data-assets
Source: https://github.com/DingJun1028/esggo-kv/tree/main/.agents/skills/discovering-gcp-data-assets
Command: npx skills add https://github.com/DingJun1028/esggo-kv --skill discovering-gcp-data-assets-dingjun1028

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Locating the right data asset in Google Cloud is difficult when you only have a keyword or business topic, and retrieving schema or governance metadata often requires knowing exact resource IDs. This Skill guides an agent through Dataplex catalog search and context lookup to find BigQuery, Spanner, BigLake, Cloud Storage, and other GCP assets and retrieve their full metadata. ## Core Features & Use Cases - Semantic and Keyword Search: Search the Dataplex catalog by natural language intent (e.g., "Q4 product sales data") or precise technical filters like name:, projectid:, location=, and fully_qualified_name=. - Deep Metadata Lookup: Retrieve schema, business context, and governance details for any discovered asset using its full projects/... entry name via the context lookup command. - Loop-Safe Troubleshooting: Built-in stop rules, query variation limits, and fallbacks to native tools like bq show prevent endless search loops when assets are missing or unindexed. - Use Case: A data analyst knows a dataset relates to "customer orders" but not the table ID. The Skill runs a semantic Dataplex search, resolves the full entry name, and returns the complete schema and column descriptions. ## Quick Start Find the BigQuery table containing customer order data in my GCP project and show me its schema and metadata.

Frequently Asked Questions about discovering-gcp-data-assets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a BigQuery table when I only know the topic?▼

Use Dataplex semantic search with a natural language query describing the data, such as "Q4 product sales data". The search returns full entry names, which you then pass to the context lookup command to retrieve schema and metadata.

What is the difference between Dataplex semantic and keyword search?▼

Semantic search interprets natural language intent and handles synonyms and plurals automatically, using uppercase AND/OR operators. Keyword search matches exact technical strings like name:order_v2, is case-insensitive for operators, and requires singular terms.

Why does Dataplex context lookup fail with NOT_FOUND?▼

Lookup fails when you pass a short table ID instead of the full projects/... entry name, or when the asset's project has not synchronized metadata with the Dataplex catalog. Fall back to native tools like bq show for direct inspection.

Can I search public BigQuery datasets with Dataplex?▼

No, assets in the bigquery-public-data project are not fully indexed in the Dataplex catalog, so lookup will fail. Inspect public datasets directly using the bq CLI or BigQuery MCP tools instead.

What permissions are required for Dataplex entry search?▼

The project passed via --project must have the Dataplex API enabled, and the caller needs the dataplex.entries.get permission. Without these, searches fail with PERMISSION_DENIED errors.

What should I do when Dataplex search returns no results?▼

Try at most three query variations, such as switching AND/OR clauses, removing projectid or location filters, or using fully_qualified_name. If still empty, stop and ask the user for the project, dataset, or instance ID.