egutierrez
9a28d08e38
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.
2.6 KiB
2.6 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_update_collection_graph | function | py | infra | 1.0.0 | impure | def metabase_update_collection_graph(client: MetabaseClient, graph: dict, namespace: str | None = None) -> dict | Actualiza el grafo de permisos de colecciones en Metabase. Endpoint: PUT /api/collection/graph. El campo revision en el graph es obligatorio — el servidor rechaza con 409 si no coincide con el actual. Soporta namespace para snippet collections. |
|
false | error_go_core |
|
dict: nuevo grafo tras la actualización con revision incrementado | false | python/functions/metabase/permissions.py |
Ejemplo
graph = metabase_get_collection_graph(client)
# Dar acceso write al grupo 3 sobre la colección 5
graph["groups"]["3"]["5"] = "write"
updated = metabase_update_collection_graph(client, graph)
print("nueva revision:", updated["revision"])
# Para snippet collections:
graph = metabase_get_collection_graph(client, namespace="snippets")
graph["groups"]["3"]["root"] = "write"
updated = metabase_update_collection_graph(client, graph, namespace="snippets")
Control de concurrencia por revision
El campo graph["revision"] es el mecanismo de optimistic locking nativo de Metabase.
Patrón obligatorio:
graph = metabase_get_collection_graph(client)— GET fresco- Modificar
graph["groups"][group_id][collection_id] = "read" | "write" | "none" graph = metabase_update_collection_graph(client, graph)— PUT con revision
Nunca cachear el graph. Si otro proceso modificó el graph entre el GET y el PUT, Metabase devuelve HTTP 409 Conflict y el caller debe reintentar desde el GET.
Niveles de acceso para colecciones
"write"— el grupo puede ver y editar contenido de la colección"read"— el grupo puede ver pero no editar"none"— sin acceso (la colección es invisible para el grupo)
El campo "root" como collection_id hace referencia a la colección raíz "Our analytics".