Saltar a contenido

Fracttal ETL Hub Documentation

Bienvenido a la documentación completa del Fracttal ETL Hub, una plataforma avanzada de integración de datos que permite conectar múltiples sistemas empresariales de manera eficiente y escalable.

¿Qué es Fracttal ETL Hub?

Fracttal ETL Hub es una solución ETL (Extract, Transform, Load) basada en configuraciones JSON que implementa el protocolo JSON-RPC 2.0. La plataforma ofrece:

  • 18+ tipos de conexiones nativas a sistemas empresariales
  • 40+ operadores de transformación basados en JSON Logic
  • Sistema de eventos dinámicos para flujos de trabajo complejos
  • Orquestación con Apache Airflow 2.9.3
  • Validación automática de configuraciones

Metodología Atomic Design

Organizamos nuestra documentación siguiendo la metodología Atomic Design, adaptada para ETL:

ÁTOMOS - Elementos Básicos

Los componentes más pequeños e indivisibles del sistema ETL.

  • Conexiones

    Tipos de conexión fundamental: Database, Fracttal API, HTTP/REST, Google Sheets, Email

    Explorar Átomos de Conexión

  • Operadores

    Operadores básicos: format_date, case, rename, substring, switch

    Ver Operadores

  • Tipos de Datos

    Tipos fundamentales: String, Number, Boolean, Array

    Tipos de Datos

MOLÉCULAS - Patrones Funcionales

Combinaciones de átomos que trabajan juntos para crear funcionalidades específicas.

  • Patrones de Source

    Database Filter, API Pagination, File Reader - Extracción optimizada de datos

    Patrones de Source

  • Cadenas de Transform

    Data Cleaning, Date Formatting, Text Processing - Transformación de datos

    Transformaciones

  • Outputs de Target

    Database Insert, API Send, File Export - Carga de datos procesados

    Outputs

ETL - Flujos Completos de ETL

Configuraciones completas que resuelven casos de uso específicos del negocio.

  • Casos de Negocio

    Order Synchronization, User Migration, Inventory Update - Soluciones empresariales

    Casos de Negocio

  • Patrones de Integración

    CRM to ERP, API to Database, File to API - Integraciones entre sistemas

    Integraciones

  • Workflows

    Daily Reports, Real-time Sync, Batch Processing - Flujos automatizados

    Workflows

Guía de Navegación

Para Principiantes

  1. Comienza con Getting Started
  2. Explora los Átomos básicos
  3. Practica con ejemplos simples

Para Desarrolladores

  1. Domina las Moléculas
  2. Combina patrones para casos específicos
  3. Consulta la API Reference

Para Arquitectos

  1. Estudia los ETL completos
  2. Implementa casos de negocio complejos
  3. Optimiza con mejores prácticas

Configuración Rápida

Estructura JSON Base

{
  "id": "uuid1",
  "jsonrpc": "2.0",
  "method": "etl.etl_update", 
  "params": {
    "id": "uuid2",
    "config": {
      "source": { /* configuración de origen */ },
      "transform": { /* lógica de transformación */ },
      "target": { /* configuración de destino */ }
    },
    "environment": "production"
  }
}

Ejemplo Básico: Base de Datos → API

{
  "source": {
    "id_type": 1,
    "feature": "filter_table_by_date_column",
    "parameters": {"table": "orders"}
  },
  "transform": {
    "rename": [
      [{"var": "id"}, "order_id", "string"],
      [{"var": "status"}, "order_status", "string"]
    ]
  },
  "target": {
    "id_type": 2,
    "feature": "create_work_orders"
  }
}

Conexiones Disponibles

Tipo ID Sistema Descripción
Database 1 Database SQL Server, MySQL, PostgreSQL, Oracle
Fracttal 2 Fracttal API nativa con 15+ managers especializados
Google Sheets 3 Google Sheets Integración con Google Sheets API
HTTP/REST 4 HTTP/REST Cliente HTTP robusto con reintentos
Email 5 Email SendGrid para envío de emails
SMS 6 SMS Twilio para mensajería SMS
Azure 7 Azure Servicios de Microsoft Azure
AWS 8 AWS Amazon Web Services (S3, etc.)
JIRA 9 JIRA Atlassian JIRA API
SOAP 10 SOAP Servicios web SOAP con Zeep

Ver todas las conexiones →

Casos de Uso Populares

  • Sincronización de Datos: Mantener sistemas empresariales actualizados
  • Migración de Datos: Transferir información entre plataformas
  • Reportes Automatizados: Generar informes periódicos automáticamente
  • Integración API: Conectar servicios web de terceros
  • Procesamiento por Lotes: Manejar grandes volúmenes de datos
  • Tiempo Real: Sincronización inmediata de cambios críticos

Recursos de Aprendizaje

Documentación Técnica

Ejemplos Prácticos

Contribución

¡Empieza Ahora

¿Listo para crear tu primer ETL?

Comenzar → Ver Ejemplos →

ETL Básico

{
  "id": "uuid-1",
  "jsonrpc": "2.0",
  "method": "etl.etl_update",
  "params": {
    "id": "uuid-2",
    "config": {
      "source": {
        "connection": {"id_type": 1, "name": "Database"},
        "operation": "list_table",
        "parameters": {"table": "users"}
      },
      "transform": {
        "rename": [
          [{"var": "name"}, "full_name", "string"]
        ]
      },
      "target": {
        "connection": {"id_type": 3, "name": "Google Sheets"},
        "operation": "append",
        "parameters": {"spreadsheet_id": "123456"}
      }
    },
    "environment": "production"
  }
}

Soporte

Consejos Rápidos

  • Usa el buscador para encontrar conexiones específicas
  • Todas las configuraciones siguen el esquema JSON-RPC 2.0
  • Los entornos válidos son production y develop
  • Los UUIDs deben ser únicos por configuración

Importante

Recuerda validar todas las configuraciones antes de desplegar a producción.