egutierrez
212875ed0d
- .claude/agents/fn-orquestador/SKILL.md - .claude/commands/fn_claude.md - .claude/rules/INDEX.md - .claude/rules/cpp_apps.md - .claude/rules/ids_naming.md - CHANGELOG.md - apps/dag_engine/README.md - apps/dag_engine/api.go - apps/dag_engine/dags_migrated/example.yaml - apps/dag_engine/dags_migrated/example_lineage_tracking.yaml - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.1 KiB
2.1 KiB
name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
| name | kind | lang | domain | version | purity | signature | description | tags | uses_functions | uses_types | returns | returns_optional | error_type | imports | params | output | tested | tests | test_file_path | file_path | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| bq_preview_rows | function | py | infra | 1.0.0 | impure | def bq_preview_rows(client: BQClient, dataset_id: str, table_id: str, max_results: int = 10) -> dict | Obtiene una muestra de filas de una tabla BigQuery sin ejecutar query SQL, sin coste de procesamiento. Usa client._client.list_rows() del SDK oficial. |
|
false | error_go_core |
|
|
dict con: columns (lista de nombres de columnas), rows (lista de listas con valores), total_rows (int con total de filas en la tabla completa) | false | python/functions/bigquery/tables.py |
Ejemplo
from bigquery import bq_auth, bq_preview_rows
client = bq_auth("mi-proyecto")
preview = bq_preview_rows(client, "ventas_ds", "transacciones", max_results=5)
print(preview["columns"]) # ["id", "fecha", "monto", "pais"]
print(f"Total filas: {preview['total_rows']}")
for row in preview["rows"]:
print(row) # [1, datetime.date(2024, 1, 15), 99.5, "MX"]
Notas
list_rows() usa la Storage Read API internamente y NO genera un job de query — por tanto no se contabiliza en el uso de bytes procesados. Ideal para inspeccionar rapidamente la estructura y contenido de una tabla. El orden de las filas retornadas no esta garantizado (depende del almacenamiento interno de BigQuery). Para muestras reproducibles o con filtros, usar una query SQL con LIMIT. total_rows refleja el conteo de la tabla en el momento de la llamada a get_table(), que puede tener un pequeno retraso respecto al dato real.