Saltar al contenido principal

Conectar tu Base de Datos

Superset necesita conectarse a tus bases de datos para visualizar la informacion.

Bases de datos soportadas​

SQL​

  • PostgreSQL (recomendada)
  • MySQL / MariaDB
  • SQL Server
  • Oracle
  • SQLite

Cloud Data Warehouses​

  • Google BigQuery
  • Amazon Redshift
  • Snowflake
  • Databricks

OLAP / Analytics​

  • ClickHouse
  • Apache Druid
  • Trino / Presto
  • Apache Pinot

Pasos para conectar​

1. Accede a Database Connections​

  • Haz clic en Settings (engranaje)
  • Selecciona Database Connections

2. Agrega una base de datos​

  1. Clic en + Database
  2. Selecciona el tipo de base de datos
  3. Puedes usar el wizard o conexion manual

3. Configuracion PostgreSQL​

Host: tu-servidor.com
Port: 5432
Database: nombre_db
Username: usuario
Password: contraseña

SQLAlchemy URI:

postgresql://usuario:contraseña@host:5432/nombre_db

4. Configuracion MySQL​

Host: tu-servidor.com
Port: 3306
Database: nombre_db
Username: usuario
Password: contraseña

SQLAlchemy URI:

mysql://usuario:contraseña@host:3306/nombre_db

5. Configuracion BigQuery​

  1. Crea una Service Account en Google Cloud
  2. Descarga el archivo JSON de credenciales
  3. En Superset, sube el JSON en la configuracion

URI:

bigquery://proyecto

Conectar a otra app de Deployalo​

Si tienes otra app en Deployalo (n8n, NocoDB, WordPress, etc.):

Opcion 1: IP publica​

  1. Ve al panel de tu otro deployment
  2. Copia la IP del servidor
  3. Usa esa IP como host en Superset

Opcion 2: Exponer puerto de DB (avanzado)​

Por seguridad, las DBs no estan expuestas por defecto. Contacta soporte si necesitas esta configuracion.

Configuracion avanzada​

SSL​

Para conexiones seguras, activa SSL en las opciones avanzadas:

postgresql://usuario:contraseña@host:5432/db?sslmode=require

Timeout​

Si tus queries tardan mucho:

  1. Ve a la configuracion de la database
  2. Busca "SQL Lab settings"
  3. Aumenta el timeout (default: 30s)

Async queries​

Para queries muy largas, habilita ejecucion asincrona en la configuracion de la database.

Crear un Dataset​

Una vez conectada la DB, crea datasets para visualizar:

Desde una tabla​

  1. Ve a Data > Datasets
  2. Clic en + Dataset
  3. Selecciona Database > Schema > Table
  4. Clic en Create Dataset and Create Chart

Desde una query SQL​

  1. Ve a SQL > SQL Lab
  2. Escribe tu query
  3. Ejecuta para probar
  4. Clic en Save > Save as Dataset

Seguridad​

  • Crea un usuario de solo lectura para Superset
  • No uses credenciales de admin/root
  • Limita acceso a las tablas necesarias
  • Usa SSL si esta disponible

Solucion de problemas​

"Connection refused"​

  • Verifica que el host/puerto sean correctos
  • Confirma que el firewall permita la conexion

"Access denied"​

  • Verifica usuario y contraseña
  • Confirma permisos en la base de datos

"Unknown database"​

  • Verifica el nombre exacto de la base de datos
  • Confirma que el usuario tenga acceso a ese database