Files
fn_registry/python/functions/metabase/metabase_get_collection_graph.md
egutierrez 4300f1242d feat(metabase): expansion de funciones Python — documents, collections, permissions, validation
Añade un conjunto amplio de funciones al paquete python/functions/metabase:
- Nuevos modulos: collections.py, documents.py, maintenance.py, permissions.py, validation.py (+ test).
- Ampliacion de cards.py, dashboards.py, client.py e __init__.py para exponer las nuevas operaciones.
- Funciones de documentos (create/get/update/delete/archive/copy/move + comentarios), grupos y memberships, permission/collection graphs, copy/move de cards y dashboards, validacion de MBQL/SQL y payloads, actualizacion segura de dashboards y fix_null_ratio.
- .md por funcion con frontmatter para que fn index los registre.
- Actualiza pyproject.toml y uv.lock con las dependencias resultantes.

Impacto: ampliamente mas cobertura de la API de Metabase desde el registry, reutilizable por apps y analisis. No toca Go ni frontend.
2026-04-13 23:31:42 +02:00

1.7 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
metabase_get_collection_graph function py infra 1.0.0 impure def metabase_get_collection_graph(client: MetabaseClient, namespace: str | None = None) -> dict Obtiene el grafo de permisos de colecciones de Metabase. Endpoint: GET /api/collection/graph. Soporta namespace opcional para snippet collections. El campo revision es crítico para concurrency control en el PUT posterior.
metabase
permissions
collections
graph
access-control
api
python
false error_go_core
name desc
client instancia autenticada de MetabaseClient con permisos de superusuario
name desc
namespace namespace opcional: 'snippets' para snippet collections, None para colecciones regulares
dict: grafo con revision (int) y groups (group_id -> collection_id -> 'read' | 'write' | 'none'). El campo revision es obligatorio para el PUT. false
python/functions/metabase/permissions.py

Ejemplo

# Colecciones regulares
graph = metabase_get_collection_graph(client)
print("revision:", graph["revision"])
for group_id, colls in graph["groups"].items():
    for coll_id, access in colls.items():
        print(f"group={group_id} collection={coll_id}: {access}")

# Snippet collections
snippet_graph = metabase_get_collection_graph(client, namespace="snippets")

Notas

Siempre hacer GET fresco justo antes del PUT. El revision es el mecanismo de concurrency control nativo de Metabase — ver metabase_update_collection_graph para el patrón completo. Los niveles de acceso son "read", "write" y "none".