genai-toolbox/docs/en/resources/tools/postgres/postgres-list-tables.md

title, type, weight, description, aliases

title	type	weight	description	aliases
postgres-list-tables	docs	1	The "postgres-list-tables" tool lists schema information for all or specified tables in a Postgres database.	/resources/tools/postgres-list-tables

About

The postgres-list-tables tool retrieves schema information for all or specified tables in a Postgres database. It's compatible with any of the following sources:

• alloydb-postgres
• cloud-sql-postgres
• postgres

postgres-list-tables lists detailed schema information (object type, columns, constraints, indexes, triggers, owner, comment) as JSON for user-created tables (ordinary or partitioned). The tool takes the following input parameters: * table_names (optional): Filters by a comma-separated list of names. By default, it lists all tables in user schemas.* output_format (optional): Indicate the output format of table schema. simple will return only the table names, detailed will return the full table information. Default: detailed.

Example

tools:
  postgres_list_tables:
    kind: postgres-list-tables
    source: postgres-source
    description: Use this tool to retrieve schema information for all or
    specified tables. Output format can be simple (only table names) or detailed.

Reference

field	type	required	description
kind	string	true	Must be "postgres-list-tables".
source	string	true	Name of the source the SQL should execute on.
description	string	true	Description of the tool that is passed to the agent.