discovering-gcp-data-assets

Searches Dataplex catalog and retrieves schema metadata for Google Cloud data assets.

9|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/jerrylin96/dotgemini --skill discovering-gcp-data-assets-jerrylin96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discovering-gcp-data-assets
Source: https://github.com/jerrylin96/dotgemini/tree/main/skills/discovering-gcp-data-assets
Command: npx skills add https://github.com/jerrylin96/dotgemini --skill discovering-gcp-data-assets-jerrylin96

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 topic, and retrieving full schema and governance metadata requires knowing exact resource identifiers. This Skill guides discovery through the Dataplex Universal Catalog so you can find BigQuery tables, Spanner databases, BigLake tables, and other GCP assets without knowing their IDs upfront. ## Core Features & Use Cases - Semantic and Keyword Search: Query the Dataplex catalog using natural language intent (e.g., "Q4 product sales data") or precise technical filters like name:, column:, system=, and fully_qualified_name=. - Deep Metadata Lookup: Retrieve full schema, business context, and governance metadata for any asset using the Dataplex Lookup Context command with full entry names. - Public Dataset Handling: Directly inspect bigquery-public-data assets with the bq CLI when Dataplex lookup is unavailable. - Use Case: A data analyst knows they need "customer orders data" but not the table name. The Skill searches Dataplex semantically, 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 full 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 the complete schema and metadata.

How to search Dataplex catalog with gcloud CLI?

Run gcloud dataplex entries search with your query, a --project flag for attribution, and optionally --semantic-search for natural language. Keyword searches support filters like name:, column:, system=bigquery, and location= to narrow results.

Why does Dataplex search return no results for my table?

Missing results usually mean the asset is not indexed in the Universal Catalog or the query uses plural keywords. Convert terms to singular, try the fully_qualified_name= filter, or fall back to native tools like bq show if you know the exact resource ID.

Can I use Dataplex lookup on bigquery-public-data tables?

No, Dataplex Lookup Context fails for assets in the bigquery-public-data project because their metadata is not fully synchronized. Inspect these 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 user needs the dataplex.entries.get permission. Without these, searches fail with PERMISSION_DENIED errors.

Why does context lookup fail with NOT_FOUND after a successful search?

This happens when short table IDs are passed instead of full entry names starting with projects/, or when the asset's project has not synchronized metadata with Dataplex. Use the exact entry name from search results or fall back to native inspection tools.