← Metaustral | Documentation Documentación

1. Introduction

1. Introducción

Understand the foundation: what a data catalog is, why it matters, and the business value it delivers.

Comprende las bases: qué es un catálogo de datos, por qué importa y el valor de negocio que entrega.

1.1 What is a Data Catalog?

1.1 ¿Qué es un catálogo de datos?

A data catalog is an organized inventory of all the information assets inside an organization — tables, views, dashboards, KPIs, reports, and datasets. It acts as a single source of truth that answers the most common data questions: What data do we have? What does this field mean? Who owns it? Where does it come from?

Un catálogo de datos es un inventario organizado de todos los activos de información de una organización: tablas, vistas, dashboards, KPIs, reportes y datasets. Funciona como fuente única de verdad que responde las preguntas más frecuentes sobre datos: ¿Qué datos tenemos? ¿Qué significa este campo? ¿Quién lo posee? ¿De dónde viene?

Metaustral catalog view
The Metaustral catalog — search, filter by type/status/domain, and see every asset with its owner, tags, sensitivity label, and data quality score.
El catálogo de Metaustral — busca, filtra por tipo/estado/dominio y visualiza cada activo con su propietario, etiquetas, nivel de sensibilidad y score de calidad.

1.2 Why Organizations Need a Data Catalog

1.2 Por qué las organizaciones necesitan un catálogo de datos

As organizations grow, data becomes scattered across dozens of databases, dashboards, and tools. Without a catalog, teams face recurring problems:

A medida que las organizaciones crecen, los datos se dispersan en decenas de bases de datos, dashboards y herramientas. Sin un catálogo, los equipos enfrentan problemas recurrentes:

  • Data silos: each team keeps its own private copy of information.
  • Duplicated effort: analysts spend 60–80% of their time finding and cleaning data instead of analyzing it.
  • Broken trust: inconsistent definitions generate conflicting reports.
  • Compliance risk: no visibility over sensitive data or who accesses it.
  • Slow onboarding: new team members need weeks to understand the data landscape.
  • Silos de datos: cada equipo mantiene su propia copia privada de la información.
  • Esfuerzo duplicado: los analistas gastan el 60–80% de su tiempo buscando y limpiando datos en vez de analizarlos.
  • Pérdida de confianza: definiciones inconsistentes generan reportes contradictorios.
  • Riesgo de compliance: sin visibilidad sobre datos sensibles ni quién los accede.
  • Onboarding lento: los nuevos integrantes tardan semanas en entender el ecosistema de datos.

1.3 Benefits of Centralized Metadata Management

1.3 Beneficios de la gestión centralizada de metadatos

BenefitImpact BeneficioImpacto
DiscoverabilityAnyone can find any data asset in seconds using search and filters. DescubribilidadCualquier persona puede encontrar cualquier activo en segundos con búsqueda y filtros.
Shared definitionsBusiness glossaries align teams on what each term means. Definiciones compartidasLos glosarios de negocio alinean a los equipos sobre qué significa cada término.
GovernanceOwnership, sensitivity, and audit logs create accountability. GobernanzaLa propiedad, sensibilidad e historial de auditoría crean responsabilidad.
Lineage visibilityUnderstand the full journey of data from source to report. Visibilidad de linajeEntiende el recorrido completo de los datos desde el origen hasta el reporte.
Quality awarenessData Quality Scores highlight which assets need attention. Conciencia de calidadLos scores de calidad destacan qué activos necesitan atención.

2. What is Metaustral?

2. ¿Qué es Metaustral?

Enterprise-grade data governance — without the enterprise price tag or months of implementation.

Gobernanza de datos de nivel enterprise — sin el precio enterprise ni meses de implementación.

2.1 The Problem We Solve

2.1 El problema que resolvemos

Traditional data catalog tools were built for large enterprises with dedicated data engineering teams, six-figure budgets, and months to spare for implementation. The result: most mid-sized companies simply go without — their data remains undocumented, ungoverned, and inaccessible to the people who need it most.

Las herramientas tradicionales de catálogo de datos fueron construidas para grandes empresas con equipos de ingeniería de datos dedicados, presupuestos de seis cifras y meses disponibles para la implementación. El resultado: la mayoría de las empresas medianas simplemente prescinden de ellas — sus datos quedan sin documentar, sin gobernar e inaccesibles para quienes más los necesitan.

Metaustral changes that equation. It delivers the same capabilities — automated discovery, lineage mapping, data quality scoring, audit trails, AI-powered search — in a product you can set up in minutes and that your entire team can use on day one without training.

Metaustral cambia esa ecuación. Entrega las mismas capacidades — descubrimiento automatizado, mapeo de linaje, scoring de calidad, historial de auditoría, búsqueda con IA — en un producto que puedes configurar en minutos y que todo tu equipo puede usar desde el primer día sin necesidad de capacitación.

2.2 Why Metaustral?

2.2 ¿Por qué Metaustral?

What others charge forLo que otros cobran How Metaustral delivers itCómo lo entrega Metaustral
6–12 months of implementation6–12 meses de implementación Operational in minutes — no professional services requiredOperativo en minutos — sin servicios profesionales
Dedicated data engineering team to maintain itEquipo de ingeniería de datos dedicado para mantenerlo Any admin can manage it from a single web panelCualquier administrador lo gestiona desde un panel web
Enterprise licenses starting at $50,000/yearLicencias enterprise desde $50,000/año Plans starting free — scale as you growPlanes desde gratuito — escala a medida que creces
Complex integrations and vendor lock-inIntegraciones complejas y dependencia del proveedor Connect to your existing databases in one clickConecta tus bases de datos existentes en un clic
Months of user trainingMeses de capacitación de usuarios Intuitive UI — analysts are productive on day oneUI intuitiva — los analistas son productivos desde el día uno
💡
Built for real teamsConstruido para equipos reales Whether you're a 3-person startup or a 500-person company, Metaustral fits. The Free plan lets you start documenting your most critical assets today — no credit card, no sales call required. Ya seas una startup de 3 personas o una empresa de 500, Metaustral se adapta. El plan Free te permite comenzar a documentar tus activos más críticos hoy — sin tarjeta de crédito, sin llamada de ventas.

2.3 Plans & Limits

2.3 Planes y límites

Plan Data AssetsActivos de datos DB ConnectionsConexiones BD UsersUsuarios
Free Free Up to 5Hasta 5 NoneNinguna 1 admin1 admin
Starter Starter Up to 100Hasta 100 11 Up to 3Hasta 3
Pro Pro Up to 5,000Hasta 5.000 UnlimitedIlimitadas Up to 30Hasta 30
Enterprise Enterprise Unlimited + AI + On-Premise AgentIlimitados + IA + Agente on-premise UnlimitedIlimitadas UnlimitedIlimitados
ℹ️
Downgrade safetySeguridad al bajar de plan If you downgrade to a plan with fewer assets, existing assets are preserved. You won't be able to create new ones until you're within the limit. Si bajas a un plan con menos activos, los existentes se conservan. No podrás crear nuevos hasta estar dentro del límite.

2.4 Typical Use Cases

2.4 Casos de uso típicos

  • Data governance programs: assign owners, stewards, and sensitivity to every asset — without a dedicated data governance tool costing six figures.
  • Self-service analytics: enable analysts to find and understand datasets without asking the data team, reducing back-and-forth by hours each week.
  • Regulatory compliance: track sensitive PII columns and audit every change with a full log — ready for SOX, GDPR, or HIPAA reviews.
  • Onboarding acceleration: new team members explore the catalog to understand the data landscape in hours, not weeks — saving days of senior engineer time.
  • Impact analysis: use data lineage to understand which reports break when a source table changes, before making the change.
  • Metadata synchronization: keep the catalog up to date automatically with scheduled imports — no manual work required.
  • Programas de gobernanza de datos: asigna propietarios, administradores y sensibilidad a cada activo — sin una herramienta de gobernanza dedicada que cueste seis cifras.
  • Analytics de autoservicio: permite que los analistas encuentren y entiendan datasets sin preguntarle al equipo de datos, reduciendo el intercambio de mensajes en horas por semana.
  • Compliance regulatorio: rastrea columnas PII sensibles y audita cada cambio con un registro completo — listo para revisiones SOX, GDPR o HIPAA.
  • Aceleración del onboarding: los nuevos integrantes exploran el catálogo para entender el ecosistema en horas, no semanas — ahorrando días de tiempo de ingenieros senior.
  • Análisis de impacto: usa el linaje de datos para entender qué reportes se rompen cuando cambia una tabla de origen, antes de hacer el cambio.
  • Sincronización de metadatos: mantén el catálogo actualizado automáticamente con importaciones programadas — sin trabajo manual.

3. Getting Started

3. Primeros pasos

Go from zero to your first documented data asset in under 5 minutes.

De cero a tu primer activo de datos documentado en menos de 5 minutos.

3.1 Create Your Account

3.1 Crea tu cuenta

Go to the registration page

Entra a la página de registro

Visit /register and fill in your company name, email, and password. Each registration creates an isolated workspace (tenant) for your organization.

Visita /register y completa tu nombre de empresa, correo y contraseña. Cada registro crea un espacio de trabajo aislado (tenant) para tu organización.

Sign in

Inicia sesión

Use your email and password at /login. The platform issues a 30-minute access token (auto-refreshed) and a 7-day refresh token stored locally.

Usa tu correo y contraseña en /login. La plataforma emite un token de acceso de 30 minutos (auto-renovado) y un token de refresco de 7 días almacenado localmente.

Access the Admin panel

Accede al panel de administración

As the account creator, you have the Admin role. Navigate to /admin to manage users, connections, and catalog settings.

Como creador de la cuenta, tienes el rol de Admin. Navega a /admin para gestionar usuarios, conexiones y configuración del catálogo.

3.2 Create Your First Data Asset

3.2 Crea tu primer activo de datos

From the catalog view (/app), click + New. Choose an asset type (Table, Dashboard, KPI, etc.), fill in the name, description, owner, domain, and tags, then save. Your first asset is now in the catalog.

Desde la vista del catálogo (/app), haz clic en + Nuevo. Elige un tipo de activo (Tabla, Dashboard, KPI, etc.), completa el nombre, descripción, propietario, dominio y etiquetas, y guarda. Tu primer activo ya está en el catálogo.

3.3 Invite Users

3.3 Invita usuarios

From the Admin panel, go to the Users tab. Enter an email, choose a role (Admin, Editor, or Viewer) and send the invite. User limits depend on your plan (3 on Starter, 30 on Pro, unlimited on Enterprise).

Desde el panel de administración, ve a la pestaña Usuarios. Ingresa un correo, elige un rol (Admin, Editor o Viewer) y envía la invitación. Los límites de usuarios dependen de tu plan (3 en Starter, 30 en Pro, ilimitados en Enterprise).

3.4 Explore the Catalog

3.4 Explora el catálogo

The catalog view (/app) lets you search by name, filter by asset type, status, domain, or tag. Click any asset to open its detail page with full metadata, column documentation, lineage graph, and quality score.

La vista del catálogo (/app) te permite buscar por nombre, filtrar por tipo de activo, estado, dominio o etiqueta. Haz clic en cualquier activo para abrir su página de detalle con metadatos completos, documentación de columnas, grafo de linaje y score de calidad.

Catalog browse view
Browsing the catalog: asset type filters on the left, grid of assets with owner, domain, column count, quality score badge, and status chip.
Explorando el catálogo: filtros por tipo a la izquierda, cuadrícula de activos con propietario, dominio, cantidad de columnas, badge de calidad y etiqueta de estado.

4. Data Assets

4. Activos de datos

The core objects of the catalog — everything you document, discover, and govern.

Los objetos centrales del catálogo — todo lo que documentas, descubres y gobiernas.

4.1 Asset Types

4.1 Tipos de activos

TypeTipo DescriptionDescripción Has columnsTiene columnas
TABLETABLE Database tableTabla de base de datos Yes
VIEWVIEW Database viewVista de base de datos Yes
DASHBOARDDASHBOARD BI visualization panelPanel de visualización BI NoNo
KPIKPI Key performance indicatorIndicador clave de rendimiento NoNo
REPORTREPORT Report or documentReporte o documento NoNo
DATASETDATASET Generic dataset (file, API, etc.)Dataset genérico (archivo, API, etc.) NoNo

4.2 Asset Lifecycle

4.2 Ciclo de vida del activo

graph LR A([draft]) --> B([active]) B --> C([deprecated]) C --> D([archived]) B --> D style A fill:#334155,stroke:#6366f1,color:#f1f5f9 style B fill:#065f46,stroke:#10b981,color:#f1f5f9 style C fill:#78350f,stroke:#f59e0b,color:#f1f5f9 style D fill:#1f2937,stroke:#6b7280,color:#9ca3af

Asset lifecycle: draft → active → deprecated → archived

Ciclo de vida: borrador → activo → deprecado → archivado

Asset detail page
Asset detail page — metadata header with status, sensitivity, domain, quality score badge, and a breakdown of score points by field (description, owner, steward, domain, category, tags, column docs).
Página de detalle del activo — encabezado con estado, sensibilidad, dominio, badge de score de calidad y desglose de puntos por campo (descripción, propietario, steward, dominio, categoría, etiquetas, documentación de columnas).

4.3 Asset Ownership

4.3 Propiedad del activo

  • Owner: the person (or team) responsible for producing and maintaining the data.
  • Steward: the person responsible for ensuring metadata quality and documentation accuracy.
  • Propietario (Owner): la persona (o equipo) responsable de producir y mantener el dato.
  • Administrador de datos (Steward): la persona responsable de asegurar la calidad de los metadatos y la exactitud de la documentación.

4.4 Tags, Domain & Classification

4.4 Etiquetas, dominio y clasificación

  • Tags: free-form labels for filtering (e.g. finance, pii).
  • Domain: the business area the asset belongs to (e.g. Sales, Marketing, HR).
  • Category: a sub-grouping within a domain.
  • Sensitivity: one of public, internal, confidential, or restricted.
  • Etiquetas (Tags): etiquetas de forma libre para filtrado (ej: finanzas, pii).
  • Dominio: el área de negocio a la que pertenece el activo (ej: Ventas, Marketing, RRHH).
  • Categoría: una sub-agrupación dentro de un dominio.
  • Sensibilidad: una de public, internal, confidential o restricted.

5. Metadata Discovery

5. Descubrimiento de metadatos

Connect your databases and let Metaustral automatically discover tables, views, and columns.

Conecta tus bases de datos y deja que Metaustral descubra automáticamente tablas, vistas y columnas.

5.1 Supported Data Sources

5.1 Fuentes de datos soportadas

🗄️ SQL Server 🐬 MySQL 🐘 PostgreSQL ❄️ Snowflake ☁️ BigQuery 🧱 Databricks
EngineMotor Default portPuerto Auth methodAutenticación
SQL ServerSQL Server14331433 Username + PasswordUsuario + Contraseña
MySQLMySQL33063306 Username + PasswordUsuario + Contraseña
PostgreSQLPostgreSQL54325432 Username + PasswordUsuario + Contraseña
SnowflakeSnowflake443443 Username + Password + Warehouse + RoleUsuario + Contraseña + Warehouse + Rol
BigQueryBigQuery Service Account JSON keyJSON de cuenta de servicio
DatabricksDatabricks443443 Host + HTTP Path + Personal Access TokenHost + HTTP Path + Token de acceso personal
⚠️
Plan requirementRequisito de plan Database connections require the Starter plan or above. The Free plan supports manual asset creation only. Las conexiones a bases de datos requieren el plan Starter o superior. El plan Free solo admite creación manual de activos.

5.2 Connecting a Database

5.2 Conectar una base de datos

Open Connections

Abre Conexiones

In the Admin panel (/admin), go to Connections → New connection.

En el panel de administración (/admin), ve a Conexiones → Nueva conexión.

Fill in credentials

Completa las credenciales

Select the engine type and enter host, port, database, and credentials. Passwords are encrypted with Fernet symmetric encryption before being saved — never stored in plain text.

Selecciona el tipo de motor e ingresa host, puerto, base de datos y credenciales. Las contraseñas se cifran con Fernet antes de guardarse — nunca en texto plano.

Test the connection

Prueba la conexión

Click Test connection. Metaustral runs a SELECT 1 query and reports success or the error detail.

Haz clic en Probar conexión. Metaustral ejecuta una consulta SELECT 1 e informa el resultado o el detalle del error.

Discover and import

Descubre e importa

Use Discovery to browse schemas → tables → columns. Select what to import and click Import to catalog.

Usa Descubrimiento para navegar esquemas → tablas → columnas. Selecciona qué importar y haz clic en Importar al catálogo.

graph LR DB[(Your database)] -->|Encrypted credentials| DE[Metaustral\nDiscovery Engine] DE -->|INFORMATION_SCHEMA| SC[Schemas] SC --> T[Tables / Views] T --> C[Catalog Assets] style DB fill:#1e293b,stroke:#6366f1,color:#f1f5f9 style DE fill:#312e81,stroke:#818cf8,color:#f1f5f9 style SC fill:#1e293b,stroke:#6366f1,color:#94a3b8 style T fill:#1e293b,stroke:#6366f1,color:#94a3b8 style C fill:#065f46,stroke:#10b981,color:#f1f5f9

Discovery flow: your database → Metaustral engine → catalog assets

Flujo de descubrimiento: tu base de datos → motor Metaustral → activos del catálogo

DB Connections panel
The DB Connections panel in the Admin area — where you add, test, and manage your database connections before running discovery.
El panel de Conexiones BD en el área de administración — donde agregas, pruebas y gestionas tus conexiones de base de datos antes de ejecutar el descubrimiento.

5.3 Automatic Metadata Discovery

5.3 Descubrimiento automático de metadatos

Metaustral reads the INFORMATION_SCHEMA of your database to discover tables, views, and their columns. For Databricks, it supports both Unity Catalog (3-level namespace: catalog.schema.table) and the legacy Hive metastore. No data is ever read from your tables — only schema definitions.

Metaustral lee el INFORMATION_SCHEMA de tu base de datos para descubrir tablas, vistas y sus columnas. Para Databricks, soporta tanto Unity Catalog (espacio de nombres de 3 niveles: catalog.schema.table) como el metastore Hive legacy. Nunca se leen datos de tus tablas — solo definiciones de esquema.

5.4 Scheduled Synchronization

5.4 Sincronización programada

Create import schedules to keep your catalog synchronized automatically. Each run uses a smart merge: new tables are created, existing ones updated, and tables no longer present in the source are marked inactive (not deleted). Available frequencies: Daily, Weekly (selected day), Monthly (selected day).

Crea programaciones de importación para mantener tu catálogo sincronizado automáticamente. Cada ejecución usa una estrategia de fusión inteligente (smart merge): las tablas nuevas se crean, las existentes se actualizan, y las tablas que ya no están en el origen se marcan inactivas (no se eliminan). Frecuencias disponibles: Diaria, Semanal (día seleccionado), Mensual (día seleccionado).

6. Data Lineage

6. Linaje de datos

Trace data as it flows from source tables to dashboards and reports.

Rastrea los datos a medida que fluyen desde las tablas de origen hasta dashboards y reportes.

6.1 What is Data Lineage?

6.1 ¿Qué es el linaje de datos?

Data lineage is the documented history of how data moves and transforms across systems. It answers: "This KPI is broken — which upstream table did it come from?" or "If I change this table, which dashboards will be affected?"

El linaje de datos es el historial documentado de cómo los datos se mueven y transforman a través de los sistemas. Responde: "Este KPI está roto — ¿de qué tabla upstream proviene?" o "Si cambio esta tabla, ¿qué dashboards se verán afectados?"

6.2 How Lineage Works in Metaustral

6.2 Cómo funciona el linaje en Metaustral

Lineage is expressed as directed edges between catalog assets. Each edge has a source, a target, an optional transformation type (e.g. "ETL", "SQL view", "dbt model"), and a free-text description. From any asset's detail page, you can view both upstream and downstream dependencies. Editors and above can create or delete lineage edges.

El linaje se expresa como aristas dirigidas entre activos del catálogo. Cada arista tiene un origen, un destino, un tipo de transformación opcional (ej: "ETL", "SQL view", "dbt model") y una descripción de texto libre. Desde la página de detalle de cualquier activo, puedes ver tanto las dependencias upstream como downstream. Los editores y superiores pueden crear o eliminar aristas de linaje.

graph LR A[("orders\ntable")] -->|ETL| B[("orders_daily\nview")] B -->|SQL| C[("Revenue\nKPI")] B -->|dbt model| D[("Sales\nDashboard")] C --> E[("Monthly\nReport")] style A fill:#1e3a5f,stroke:#6366f1,color:#f1f5f9 style B fill:#1e3a5f,stroke:#6366f1,color:#f1f5f9 style C fill:#065f46,stroke:#10b981,color:#f1f5f9 style D fill:#065f46,stroke:#10b981,color:#f1f5f9 style E fill:#312e81,stroke:#818cf8,color:#f1f5f9

Example: raw table → aggregated view → KPI and dashboard → report

Ejemplo: tabla cruda → vista agregada → KPI y dashboard → reporte

6.3 Business Benefits

6.3 Beneficios de negocio

  • Impact analysis: before changing a table, see which downstream assets depend on it.
  • Root cause analysis: when a report breaks, trace the data pipeline upstream to find the issue.
  • Compliance: demonstrate the full chain of data movement for sensitive datasets.
  • Trust: analysts understand where their numbers come from.
  • Análisis de impacto: antes de cambiar una tabla, ve qué activos downstream dependen de ella.
  • Análisis de causa raíz: cuando un reporte falla, rastrea el pipeline de datos upstream para encontrar el origen del problema.
  • Compliance: demuestra la cadena completa de movimiento de datos para datasets sensibles.
  • Confianza: los analistas entienden de dónde vienen sus números.

7. ERD Diagrams

7. Diagramas ERD

Visualize foreign-key relationships between tables as auto-generated entity-relationship diagrams.

Visualiza relaciones de clave foránea entre tablas como diagramas entidad-relación generados automáticamente.

7.1 What is an ERD?

7.1 ¿Qué es un ERD?

An Entity Relationship Diagram (ERD) shows how database tables are connected through foreign-key constraints. It answers questions like "Which tables reference the customers table?" or "What does the orders schema look like structurally?" An ERD is the fastest way to onboard new team members on a database schema and to document the data model for compliance or architecture review.

Un Diagrama Entidad-Relación (ERD) muestra cómo las tablas de base de datos están conectadas a través de restricciones de clave foránea. Responde preguntas como "¿Qué tablas referencian la tabla customers?" o "¿Cómo es la estructura del esquema de orders?" Un ERD es la forma más rápida de incorporar nuevos miembros del equipo a un esquema de base de datos y documentar el modelo de datos para compliance o revisión arquitectónica.

7.2 ERDs in Metaustral

7.2 ERDs en Metaustral

ERD diagrams appear on the detail page of TABLE assets only — as a dedicated ERD tab between Lineage and Glossary. Relations are stored in a separate erd_relations table, independent of the lineage graph, so adding or deleting ERD edges never affects your lineage data.

Los diagramas ERD aparecen en la página de detalle de activos tipo TABLE únicamente — como una pestaña ERD dedicada entre Linaje y Glosario. Las relaciones se almacenan en una tabla separada erd_relations, independiente del grafo de linaje, de modo que agregar o eliminar aristas ERD nunca afecta los datos de linaje.

erDiagram CUSTOMERS ||--o{ ORDERS : "customer_id" ORDERS ||--|{ ORDER_ITEMS : "order_id" PRODUCTS ||--o{ ORDER_ITEMS : "product_id"

Example ERD: customers → orders → order_items ← products

Ejemplo de ERD: customers → orders → order_items ← products

7.3 Automatic FK Detection

7.3 Detección automática de FK

When you import tables from a connected database, Metaustral automatically detects foreign-key constraints and creates ERD relations for them. Detected relations are marked with an AUTO badge. Detection is supported for:

Al importar tablas desde una base de datos conectada, Metaustral detecta automáticamente las restricciones de clave foránea y crea relaciones ERD para ellas. Las relaciones detectadas se marcan con un badge AUTO. La detección es compatible con:

  • SQL Server — via sys.foreign_key_columns
  • MySQL — via INFORMATION_SCHEMA.KEY_COLUMN_USAGE
  • PostgreSQL — via information_schema.table_constraints
  • SQL Server — vía sys.foreign_key_columns
  • MySQL — vía INFORMATION_SCHEMA.KEY_COLUMN_USAGE
  • PostgreSQL — vía information_schema.table_constraints
ℹ️
Cloud DWHsDWHs en la nube Snowflake, BigQuery, and Databricks do not enforce FK constraints at the engine level, so automatic detection is not available for those connectors. You can still add relations manually. Snowflake, BigQuery y Databricks no refuerzan restricciones FK a nivel de motor, por lo que la detección automática no está disponible para esos conectores. Puedes agregar relaciones manualmente igualmente.

7.4 Manual Relations

7.4 Relaciones manuales

Editors and admins can add relations manually from the ERD tab. Click + Add relation, search for the related table, optionally specify the FK and PK column names, choose a cardinality type (many-to-one, one-to-many, one-to-one, many-to-many), and optionally add a label. Manually added relations are marked with a MANUAL badge and can be deleted at any time.

Los editores y administradores pueden agregar relaciones manualmente desde la pestaña ERD. Haz clic en + Agregar relación, busca la tabla relacionada, especifica opcionalmente los nombres de las columnas FK y PK, elige un tipo de cardinalidad (muchos a uno, uno a muchos, uno a uno, muchos a muchos) y agrega opcionalmente una etiqueta. Las relaciones agregadas manualmente se marcan con un badge MANUAL y pueden eliminarse en cualquier momento.

💡
Best practiceBuena práctica Open the ERD tab on your most important fact tables (orders, transactions, events) first — they typically have the most FK relationships and give the clearest view of your data model. Abre la pestaña ERD primero en tus tablas de hechos más importantes (órdenes, transacciones, eventos) — generalmente tienen las más relaciones FK y brindan la vista más clara de tu modelo de datos.

8. Glossaries

8. Glosarios

Define shared business terminology and link it directly to catalog assets.

Define la terminología de negocio compartida y vincúlala directamente a los activos del catálogo.

8.1 What are Glossaries?

8.1 ¿Qué son los glosarios?

A business glossary is a collection of standardized term definitions used across your organization. Without one, the same concept can mean different things to different teams — "active customer" might be defined differently by Marketing, Sales, and Finance, leading to conflicting reports.

Un glosario de negocio es una colección de definiciones estandarizadas de términos usados en toda la organización. Sin uno, el mismo concepto puede significar cosas diferentes para distintos equipos — "cliente activo" puede estar definido de manera diferente por Marketing, Ventas y Finanzas, generando reportes contradictorios.

8.2 How Glossaries Work in Metaustral

8.2 Cómo funcionan los glosarios en Metaustral

Each glossary has a name, an optional description, and a list of terms — each term has a name and a definition. Glossaries are created and managed from the Admin panel. Any catalog asset can be linked to a glossary, so its terms appear directly on the asset's detail page.

Cada glosario tiene un nombre, una descripción opcional y una lista de términos — cada término tiene un nombre y una definición. Los glosarios se crean y gestionan desde el panel de administración. Cualquier activo del catálogo puede vincularse a un glosario, y sus términos aparecen directamente en la página de detalle del activo.

💡
Best practiceBuena práctica Create one glossary per business domain (Finance, Sales, HR) and link the relevant tables and dashboards to each. Crea un glosario por dominio de negocio (Finanzas, Ventas, RRHH) y vincula las tablas y dashboards relevantes a cada uno.

9. Data Quality Score

9. Score de calidad de datos

An automatic completeness score that shows how well each asset is documented.

Un score de completitud automático que muestra qué tan bien está documentado cada activo.

9.1 Why It Matters

9.1 Por qué importa

A catalog with undocumented assets provides little value. The Data Quality Score gives every asset a 0–100 score based on metadata completeness, making it easy to prioritize documentation efforts and surface assets that need attention. The Admin dashboard shows the overall tenant quality score — the average across all assets in your workspace.

Un catálogo con activos sin documentar aporta poco valor. El Score de calidad asigna a cada activo un score de 0 a 100 basado en la completitud de sus metadatos, facilitando la priorización del esfuerzo de documentación. El dashboard de administración muestra el score general del tenant — el promedio de todos los activos en tu espacio de trabajo.

9.2 Score Calculation

9.2 Cálculo del score

FieldCampo PointsPuntos ConditionCondición
DescriptionDescripción 2525 Present and >10 charactersPresente y de más de 10 caracteres
Owner nameNombre del propietario 2020 Not emptyNo vacío
DomainDominio 1515 Not emptyNo vacío
Column documentation
(TABLE / VIEW only)
Documentación de columnas
(solo TABLE / VIEW)
1515 Proportional to % of columns with descriptions Proporcional al % de columnas con descripción
Steward nameNombre del steward 1010 Not emptyNo vacío
CategoryCategoría 1010 Not emptyNo vacío
TagsEtiquetas 55 At least one tagAl menos una etiqueta
ℹ️
Column scoreScore de columnas For tables and views, the 15-point column score is proportional: if 6 of 10 active columns have descriptions, the column score is 9 points (60% × 15). For other asset types, all 15 points are awarded automatically. Para tablas y vistas, los 15 puntos de columnas son proporcionales: si 6 de 10 columnas activas tienen descripción, el score de columnas es 9 puntos (60% × 15). Para otros tipos de activos, los 15 puntos se otorgan automáticamente.
Quality score breakdown
The Score breakdown panel on an asset's detail page — each field shows how many points it contributed toward the total 100-point quality score.
El panel de desglose del score en la página de detalle del activo — cada campo muestra cuántos puntos aportó al total de 100 puntos del score de calidad.

10. Audit History Pro Enterprise

10. Historial de auditoría Pro Enterprise

A complete log of every write action in your workspace.

Un registro completo de cada acción de escritura en tu espacio de trabajo.

10.1 What is Tracked

10.1 Qué se registra

Every create, update, and delete action on catalog assets is recorded with: action type (e.g. create_item, update_item), resource type and ID, the user email who performed it, a JSON payload with field values, and an exact UTC timestamp. Logs are filterable by action and resource type and paginated up to 200 records per request.

Cada acción de creación, actualización y eliminación en los activos del catálogo se registra con: tipo de acción (ej: create_item, update_item), tipo de recurso e ID, el correo del usuario que la realizó, un payload JSON con los valores de campo, y un timestamp UTC exacto. Los logs se pueden filtrar por acción y tipo de recurso, paginados hasta 200 registros por solicitud.

10.2 How Audit Logs Help Governance

10.2 Cómo los logs de auditoría ayudan a la gobernanza

  • Accountability: every change has a named actor and timestamp — no anonymous modifications.
  • Regulatory compliance: demonstrate to auditors (SOX, GDPR, HIPAA) that changes to sensitive data assets are tracked.
  • Incident investigation: the audit log tells you exactly who changed what and when.
  • Responsabilidad: cada cambio tiene un actor identificado y un timestamp — sin modificaciones anónimas.
  • Compliance regulatorio: demuestra a los auditores (SOX, GDPR, HIPAA) que los cambios en activos sensibles están rastreados.
  • Investigación de incidentes: el log de auditoría dice exactamente quién cambió qué y cuándo.
⚠️
Plan requirementRequisito de plan Audit History is available on Pro and Enterprise plans only. El Historial de auditoría está disponible solo en los planes Pro y Enterprise.

11. User Roles & Permissions

11. Roles de usuario y permisos

Control who can see, edit, and manage data in your workspace.

Controla quién puede ver, editar y gestionar datos en tu espacio de trabajo.

👁️Viewer
  • Browse catalog
  • Search assets
  • View asset details
  • View lineage
  • View glossaries
  • Explorar catálogo
  • Buscar activos
  • Ver detalles del activo
  • Ver linaje
  • Ver glosarios
✏️Editor
  • All Viewer actions
  • Create / edit assets
  • Manage columns
  • Create lineage edges
  • Manage glossaries
  • Todo lo de Viewer
  • Crear / editar activos
  • Gestionar columnas
  • Crear aristas de linaje
  • Gestionar glosarios
🛡️Admin
  • All Editor actions
  • Delete assets
  • Manage users
  • Manage DB connections
  • View audit logs
  • Configure discovery
  • Todo lo de Editor
  • Eliminar activos
  • Gestionar usuarios
  • Gestionar conexiones
  • Ver logs de auditoría
  • Configurar descubrimiento
ActionAcción ViewerEditorAdmin
Browse catalogExplorar catálogo
Create / edit assetsCrear / editar activos
Delete assetsEliminar activos
Manage lineageGestionar linaje
Manage glossariesGestionar glosarios
Manage usersGestionar usuarios
Configure connectionsConfigurar conexiones
View audit logsVer logs de auditoría
Use AI moduleUsar módulo de IAEnterprise
Admin control panel
The Admin Control Panel — overview of total assets, users, average quality score, and quality distribution across Excellent / Good / Fair / Poor levels, with assets that need attention highlighted.
El Panel de Control de Administración — resumen de activos totales, usuarios, score de calidad promedio y distribución de calidad en niveles Excelente / Bueno / Regular / Deficiente, con activos que necesitan atención destacados.

12. AI Module Enterprise

12. Módulo de IA Enterprise

Ask questions about your catalog in natural language and get instant, context-aware answers.

Haz preguntas sobre tu catálogo en lenguaje natural y obtén respuestas instantáneas con contexto.

Enterprise onlySolo Enterprise Requires an Anthropic API key configured by your administrator in the superadmin settings panel. Requiere una clave API de Anthropic configurada por el administrador en el panel de configuración de superadmin.

12.1 Natural Language Search

12.1 Búsqueda en lenguaje natural

Instead of navigating filters, you can ask the AI assistant questions like you would ask a colleague. The assistant has full context of your catalog — all asset names, types, descriptions, owners, tags, and glossary terms — and answers based on what is actually documented in your workspace.

En vez de navegar filtros, puedes hacerle preguntas al asistente de IA como se las harías a un colega. El asistente tiene contexto completo de tu catálogo — todos los nombres de activos, tipos, descripciones, propietarios, etiquetas y términos del glosario — y responde basándose en lo que está realmente documentado en tu espacio de trabajo.

💬
Example questions:
"Which tables contain customer data?"
"What is the source of the Monthly Revenue KPI?"
"Show me all assets owned by the Finance team."
"Which tables are marked as confidential?"
Ejemplos de preguntas:
"¿Qué tablas contienen datos de clientes?"
"¿Cuál es el origen del KPI de Ingresos Mensuales?"
"Muéstrame todos los activos del equipo de Finanzas."
"¿Qué tablas están marcadas como confidenciales?"

12.2 How it Works

12.2 Cómo funciona

When you submit a question, Metaustral builds a context snapshot of your catalog and sends it along with your question to Claude Haiku (Anthropic). The model returns a natural language answer displayed in the chat interface. No raw data from your databases is ever sent — only catalog metadata.

Cuando envías una pregunta, Metaustral construye un snapshot del contexto de tu catálogo y lo envía junto con tu pregunta a Claude Haiku (Anthropic). El modelo devuelve una respuesta en lenguaje natural mostrada en la interfaz de chat. Nunca se envían datos reales de tus bases de datos — solo metadatos del catálogo.

sequenceDiagram participant U as User participant M as Metaustral participant AI as Claude Haiku (Anthropic) U->>M: "Which tables contain PII data?" M->>M: Build catalog context snapshot M->>AI: Question + catalog metadata AI-->>M: Natural language answer M-->>U: Display answer in chat M->>M: Log usage (tokens, cost)

AI module: user question → catalog context → Claude Haiku → answer

Módulo IA: pregunta del usuario → contexto del catálogo → Claude Haiku → respuesta

13. On-Premise Agent Enterprise

13. Agente on-premise Enterprise

Discover metadata from databases that cannot be accessed directly from the cloud.

Descubre metadatos de bases de datos que no pueden ser accedidas directamente desde la nube.

13.1 Why Organizations Need It

13.1 Por qué las organizaciones lo necesitan

Many organizations operate databases inside private networks that cannot be reached from the cloud. The on-premise agent solves this by running inside the private network: it connects to the local database, discovers the metadata, and pushes it to Metaustral's cloud API — without ever exposing the database to the internet.

Muchas organizaciones operan bases de datos dentro de redes privadas que no pueden ser alcanzadas desde la nube. El agente on-premise resuelve esto ejecutándose dentro de la red privada: se conecta a la base de datos local, descubre los metadatos y los envía a la API en la nube de Metaustral — sin exponer nunca la base de datos a internet.

13.2 Security Considerations

13.2 Consideraciones de seguridad

  • Outbound-only: the agent initiates outbound HTTPS requests to Metaustral's API. No inbound firewall ports need to be opened.
  • Metadata-only: the agent reads only schema definitions (table names, column names, data types) — never actual row data.
  • Credential isolation: database credentials are stored in a local .env file and are never transmitted to the cloud.
  • Solo tráfico saliente: el agente inicia solicitudes HTTPS salientes a la API de Metaustral. No es necesario abrir puertos de firewall entrantes.
  • Solo metadatos: el agente lee únicamente definiciones de esquema — nunca datos reales de filas.
  • Aislamiento de credenciales: las credenciales se almacenan en un archivo .env local y nunca se transmiten a la nube.

13.3 Architecture Overview

13.3 Resumen de arquitectura

graph TB subgraph cloud["☁️ Cloud — Metaustral"] API[Metaustral API] CAT[(Catalog)] API --> CAT end subgraph private["🔒 Private Network"] AGENT[On-Premise Agent\nPython script] DB[(Internal Database)] AGENT -->|INFORMATION_SCHEMA| DB end AGENT -->|HTTPS outbound only| API style cloud fill:#1a1f3a,stroke:#6366f1,color:#f1f5f9 style private fill:#0f1e1a,stroke:#10b981,color:#f1f5f9 style AGENT fill:#065f46,stroke:#10b981,color:#f1f5f9 style DB fill:#1e293b,stroke:#6366f1,color:#f1f5f9 style API fill:#312e81,stroke:#818cf8,color:#f1f5f9 style CAT fill:#1e293b,stroke:#6366f1,color:#f1f5f9

On-premise agent: inside private network → outbound HTTPS → Metaustral cloud API

Agente on-premise: dentro de la red privada → HTTPS saliente → API en la nube de Metaustral

The agent can run once (on-demand) or on a recurring interval (e.g. every hour). Each run syncs the metadata and reports the result to the platform's run history.

El agente puede ejecutarse una vez (bajo demanda) o en un intervalo recurrente (ej: cada hora). Cada ejecución sincroniza los metadatos e informa el resultado al historial de ejecuciones de la plataforma.

FAQ

Common questions about Metaustral.

Preguntas comunes sobre Metaustral.

A data catalog is an organized inventory of all your company's information assets: tables, views, dashboards, KPIs, reports, and datasets. It allows anyone on the team to understand what data exists, what it means, who owns it, and how it is related. Un catálogo de datos es un inventario organizado de todos los activos de información de tu empresa: tablas, vistas, dashboards, KPIs, reportes y datasets. Permite que cualquier persona del equipo entienda qué datos existen, qué significan, quién los posee y cómo están relacionados entre sí.
Configure your database credentials from the admin panel. The system connects securely, reads available schemas, and shows you the tables and views you can import to the catalog with one click, including their columns and data types. Supported: SQL Server, MySQL, PostgreSQL, Snowflake, BigQuery, and Databricks. Configura las credenciales de tu base de datos desde el panel de administración. El sistema se conecta de forma segura, lee los esquemas disponibles y te muestra las tablas y vistas que puedes importar al catálogo con un solo clic, incluyendo sus columnas y tipos de datos. Motores soportados: SQL Server, MySQL, PostgreSQL, Snowflake, BigQuery y Databricks.
Free plan: 1 admin. Starter: up to 3 users. Pro: up to 30 users. Enterprise: unlimited. Each user has a role: Admin (manages everything), Editor (creates and edits assets), or Viewer (read-only). Plan Free: 1 admin. Starter: hasta 3 usuarios. Pro: hasta 30 usuarios. Enterprise: ilimitados. Cada usuario tiene un rol: Admin (gestiona todo), Editor (crea y edita activos) o Viewer (solo consulta).
Yes. Each company has its own isolated space. Database connection passwords are encrypted with Fernet symmetric encryption before being saved. The catalog only stores metadata — never the actual content of your databases. Sí. Cada empresa tiene su propio espacio aislado. Las contraseñas de conexiones se cifran con Fernet antes de guardarse. El catálogo almacena únicamente metadatos — nunca el contenido real de tus bases de datos.
SQL Server, MySQL, PostgreSQL, Snowflake, BigQuery, and Databricks for automatic discovery. Any asset type (dashboards, KPIs, reports, datasets) can be manually documented regardless of the engine you use. SQL Server, MySQL, PostgreSQL, Snowflake, BigQuery y Databricks para descubrimiento automático. Cualquier tipo de activo (dashboards, KPIs, reportes, datasets) puede documentarse manualmente sin importar el motor que uses.
Yes, with the on-premise agent available exclusively on the Enterprise plan. It is a lightweight Python script installed on your internal network. It connects to your local database, discovers metadata, and sends it securely to the cloud. Your database is never exposed to the internet. Sí, con el agente on-premise disponible exclusivamente en el plan Enterprise. Es un script Python liviano instalado en tu red interna. Se conecta a tu base de datos local, descubre los metadatos y los envía de forma segura a la nube. Tu base de datos nunca queda expuesta a internet.
Yes. You can upgrade or downgrade at any time. If you downgrade and have more assets than the new plan allows, existing ones are preserved but you won't be able to create new ones until you're within the limit. Sí. Puedes hacer upgrade o downgrade cuando quieras. Si bajas de plan y tienes más activos de los permitidos, los existentes se conservan pero no podrás crear nuevos hasta estar dentro del límite.
Yes. The platform is fully available in Spanish and English. Support is offered in both languages. Sí. La plataforma está completamente disponible en español e inglés. El soporte también se ofrece en ambos idiomas.