Apache Superset guía

Abrir la interfaz web

http://superset.tigo.internal

Acceder con SSO corporativo TIGO o con credenciales provistos por el equipo de plataforma.

1. Ir a Data › Datasets → + Dataset
2. Seleccionar la base de datos (ej: Trino - TIGO)
3. Seleccionar el Schema (ej: analytics)
4. Seleccionar la tabla (ej: ventas_mensuales)
5. Clic en Add Dataset and Create Chart

Para lógica más compleja, crear dataset virtual:

1. Data › Datasets → + Dataset
2. Alternativamente, desde SQL Lab: ejecutar query → Explore
3. O crear Virtual Dataset con SQL propio:

-- Ejemplo de dataset virtual en Superset
SELECT
    DATE_TRUNC('month', fecha) AS mes,
    pais,
    categoria,
    SUM(monto) AS total_ventas,
    COUNT(DISTINCT cliente_id) AS clientes_unicos
FROM hive.analytics.ventas
WHERE fecha >= DATE '2025-01-01'
GROUP BY 1, 2, 3

Después de crear o editar un dataset:

Datos requeridos:

Dataset:  ventas_mensuales
Metrics:  SUM(total_ventas)     → eje Y
Dimensions: mes                 → eje X
Series: pais                    → para stacking / agrupación
Filters: pais IN ('CO', 'GT', 'HN', 'SV', 'NI', 'PA', 'PY', 'BO')

Opciones de personalización:

Sort By:       SUM(total_ventas) DESC
Row Limit:     100
Bar Stacking:  Enabled
Show Legend:   True
X Axis Label:  Mes
Y Axis Label:  Ventas (USD)

1. Ir a Dashboards → + Dashboard
2. Dar nombre y descripción
3. Clic en Edit Dashboard
4. Arrastrar Charts desde el panel derecho al canvas
5. Redimensionar y reacomodar con drag & drop
6. Agregar Filters en la barra superior
7. Clic en Save → luego Publish

Agregar filtro nativo:

1. En modo edit → clic en Filters (ícono arriba derecha)
2. + Add/Edit Filters → seleccionar tipo:

Native Filters (recomendado):
- Aplican a todos los charts del dashboard automáticamente
- Se definen una vez y reutilizan en múltiples dashboards
- Permiten scope específico por chart

Chart Filters:
- Se definen dentro de cada chart individual
- Filtros estáticos que no cambian en runtime

Ejecutar query sobre Trino

-- Seleccionar la conexión: Trino - TIGO
-- Seleccionar el Schema: hive.analytics

SELECT
    pais,
    DATE_TRUNC('month', fecha) AS mes,
    SUM(monto) AS total_ventas
FROM ventas
WHERE fecha BETWEEN '2026-01-01' AND '2026-03-31'
GROUP BY 1, 2
ORDER BY 1, 2;

-- Usar parámetros dinámicos en SQL Lab
SELECT *
FROM hive.analytics.ventas
WHERE pais = '{{ country }}'
  AND fecha BETWEEN '{{ start_date }}' AND '{{ end_date }}'
LIMIT 1000

Activar Templating: Settings › Feature Flags › ENABLE_TEMPLATE_PROCESSING

Limitar datos que ve cada usuario según su país/área:

1. Security › Row Level Security → + RLS Rule
2. Configurar regla:

Tables:    ventas_mensuales (dataset)
Roles:     Gamma_Colombia
Group Key: pais
Clause:    pais = 'CO'

1. Settings › Database Connections → + Database
2. Seleccionar driver (Trino, PostgreSQL, etc.)
3. Configurar:

Conexión a Trino TIGO

Display Name: Trino - TIGO
SQLAlchemy URI: trino://[email protected]:8443/hive

Conexión a PostgreSQL TIGO

Display Name: PostgreSQL - TIGO
SQLAlchemy URI: postgresql://user:[email protected]:5432/analytics

Exportar dashboard (para backup o compartir)

1. En Dashboards, seleccionar el dashboard
2. Actions (⋮) → Export
3. Descarga un .zip con el dashboard + datasets + charts

Importar dashboard

1. Dashboards → Import (icono arriba derecha)
2. Seleccionar el .zip exportado
3. Mapear las conexiones de DB si cambia el entorno

Limpiar caché de un chart:

1. Abrir el chart → ⋮ More → Force Refresh