bigtable-list-schemas

The “bigtable-list-schemas” tool lists all Bigtable schemas, including table column families, logical views, and materialized views with dynamically resolved column schemas.

About

The bigtable-list-schemas tool retrieves comprehensive schema information for all resources within a Google Cloud Bigtable instance. It provides Large Language Models (LLMs) with full visibility into:

  • Tables: Table names along with their configured column family definitions (FamilyList).
  • Logical Views & Materialized Views: View definitions (LogicalViewID, MaterializedViewID, and GoogleSQL Query) alongside dynamically resolved column schemas (name and type) extracted from the view query.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Bigtable Source

Parameters

bigtable-list-schemas accepts the following parameters:

  • limit (integer): Optional maximum number of tables to return (default: 20).

Example

kind: tool
name: bigtable_list_schemas
type: bigtable-list-schemas
source: my-bigtable-source
description: List all Bigtable tables, column families, and SQL view column schemas.

Output Format

The tool returns a structured JSON payload containing tables, logical_views, and materialized_views:

{
  "tables": [
    {
      "table_name": "users",
      "info": {
        "FamilyList": ["profile", "activity"]
      }
    }
  ],
  "logical_views": [
    {
      "LogicalViewID": "active_users_view",
      "Query": "SELECT _key, CAST(profile['name'] AS STRING) AS name FROM users",
      "columns": [
        {
          "name": "_key",
          "type": "BYTES"
        },
        {
          "name": "name",
          "type": "STRING"
        }
      ]
    }
  ],
  "materialized_views": []
}

Reference

fieldtyperequireddescription
typestringtrueMust be bigtable-list-schemas.
sourcestringtrueName of the Bigtable source to execute on.
descriptionstringfalseCustom description of the tool passed to the LLM.



Last modified August 14, 2026: chore(main): release 1.9.0 (#3744) (5de8f13)