Integración con dbt

Importa modelos dbt, documentación de columnas, descripciones y linaje desde los artefactos de tu proyecto dbt — dos formas de integrar.

Metaustral lee los artefactos dbt (manifest.json y opcionalmente catalog.json) para crear activos del catálogo a partir de tus modelos y fuentes dbt. Puedes conectar mediante URL o subir los archivos directamente.

Qué importa Metaustral desde dbt

• Modelos y fuentes → se crean como activos TABLE o VIEW en el catálogo.
• Documentación de columnas → las descripciones de schema.yml se convierten en metadatos a nivel de columna.
• Descripciones de modelos → el campo description en schema.yml rellena la descripción del activo.
• Linaje (DAG) → el grafo de dependencias de dbt (depends_on) se traduce en aristas de linaje en Metaustral.
• Tipos de columna (opcional) → desde catalog.json, generado por dbt docs generate. Agrega los tipos de columna reales de la base de datos.

Opción 1 — Mediante Integrations (URL del manifest)

Si tu pipeline de CI/CD publica manifest.json en una URL pública o autenticada (p. ej. un bucket S3, registro de artefactos o hosting estático), regístrala como conexión en Integrations. Este modo admite Importaciones programadas — Metaustral descarga el manifest más reciente automáticamente en cada ejecución.

Opción 2 — Mediante Imports (subida de archivos)

Ve a Import → From a file → dbt project. Sube tus archivos:

• manifest.json (requerido) — generado por dbt compile o dbt run. Contiene modelos, fuentes, documentación de columnas y el DAG de dependencias.
• catalog.json (opcional) — generado por dbt docs generate. Enriquece la importación con tipos de columna reales de tu base de datos.

Tras subir los archivos, Metaustral muestra una previsualización de los activos y el linaje a crear. Haz clic en Execute import para aplicar.