PostgreSQL

​

Resumen

​

Requisitos

• Access to Event Streams for outbound message events (Plan limitations and overages apply)
• Access to Custom Events for inbound event syncing (Plan limitations and overages apply)
• Updated Account Plan (not available on free apps)

​

PostgreSQL

• PostgreSQL 9.6+ o base de datos compatible
• Usuario de base de datos con permisos apropiados
• Acceso de red desde OneSignal a tu instancia de PostgreSQL
• Tablas de eventos que contengan datos comportamentales estructurados

​

Configuración

-- Crear usuario OneSignal con contraseña fuerte
CREATE USER CENSUS WITH PASSWORD '<strong-unique-password>';

-- Crear schema de contabilidad privado para estado de sincronización (omitir si modo solo lectura)
CREATE SCHEMA CENSUS;

-- Otorgar acceso completo a schema de contabilidad (omitir si modo solo lectura)
GRANT ALL ON SCHEMA CENSUS TO CENSUS;

-- Asegurar acceso a objetos existentes en schema de contabilidad (omitir si modo solo lectura)
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA CENSUS TO CENSUS;

-- Otorgar acceso a schema (repetir para cada schema con datos de eventos)
GRANT USAGE ON SCHEMA "<your_schema>" TO CENSUS;

-- Otorgar acceso de lectura a tablas existentes
GRANT SELECT ON ALL TABLES IN SCHEMA "<your_schema>" TO CENSUS;

-- Otorgar acceso de lectura a tablas futuras
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_schema>" GRANT SELECT ON TABLES TO CENSUS;

-- Otorgar permisos de ejecución en funciones
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<your_schema>" TO CENSUS;
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_schema>" GRANT EXECUTE ON FUNCTIONS TO CENSUS;

​

Event data mapping

​

Ejemplo de Schema de Tabla de Eventos

-- Ejemplo de tabla de eventos PostgreSQL
CREATE TABLE analytics.user_events (
    event_id SERIAL PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    event_timestamp TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    event_data JSONB,
    session_id VARCHAR(255),
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

​

Modo de Consulta SQL

-- Ejemplo: Eventos de compra recientes
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= NOW() - INTERVAL '7 days'
    AND event_name = 'purchase'
ORDER BY event_timestamp DESC;

​

Configuración Avanzada de Red

• Listas de Permitidos de IP: Agrega las direcciones IP de OneSignal a tu firewall y pg_hba.conf
• Tunelización SSH: Conéctate a través de un host bastión para redes privadas
• Configuración VPC: Conexión directa dentro de entornos en la nube
• Cifrado TLS: Conexiones seguras usando SSL/TLS

​

Configuración de Túnel SSH

1. Crear usuario SSH: Configura un usuario dedicado en tu host SSH
2. Configurar túnel: Habilita “Use SSH Tunnel” en la configuración de integración de OneSignal
3. Instalar par de claves: Agrega la clave pública de OneSignal a ~/.ssh/authorized_keys
4. Probar conexión: Verifica la conectividad del túnel

​

Notas

• Múltiples Schemas: Repite las concesiones de permisos para cada schema que contenga datos de eventos
• Vistas con Referencias Entre Schemas: Pueden requerir permisos de lectura adicionales en versiones antiguas de PostgreSQL
• Azure PostgreSQL: Usa el formato username@hostname para instancias de Azure
• AWS RDS: Usa el formato estándar username
• Rendimiento: Considera usar réplicas de lectura para procesamiento de eventos a gran escala

​

Limitaciones

• Evita conectar a bases de datos de producción debido a la sobrecarga de consultas analíticas
• Las consultas complejas entre schemas pueden requerir permisos adicionales
• Se recomienda agrupación de conexiones para procesamiento de eventos de alta frecuencia

​

FAQ

​

¿Debería usar modo solo lectura?

​

¿Cómo manejo múltiples schemas de eventos?