---
name: bq_list_tables
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def bq_list_tables(client: BQClient, dataset_id: str) -> list[dict]"
description: "Lista todas las tablas (y vistas) de un dataset BigQuery con informacion resumida. Usa client._client.list_tables() del SDK oficial."
tags: [bigquery, gcp, table, list, google-cloud, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [google-cloud-bigquery]
params:
  - name: client
    desc: "cliente autenticado BQClient obtenido con bq_auth"
  - name: dataset_id
    desc: "ID del dataset a listar"
output: "lista de dicts, uno por objeto del dataset. Cada dict contiene: table_id (nombre), full_id (project.dataset.table), type (TABLE, VIEW, MATERIALIZED_VIEW, EXTERNAL)"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/bigquery/tables.py"
---

## Ejemplo

```python
from bigquery import bq_auth, bq_list_tables

client = bq_auth("mi-proyecto")

tablas = bq_list_tables(client, "ventas_ds")
for t in tablas:
    print(t["table_id"], t["type"])
    # transacciones TABLE
    # vista_mensual VIEW

# Filtrar solo tablas fisicas
solo_tablas = [t for t in tablas if t["type"] == "TABLE"]
```

## Notas

Retorna objetos resumidos (`ListTableItem`), no los metadatos completos. Para obtener schema, estadisticas y configuracion completa usar `bq_get_table`. El listado incluye tablas, vistas, vistas materializadas y tablas externas (EXTERNAL). El orden de retorno no esta garantizado.
