SQL Server

​

Descripción general

​

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)

​

SQL Server

• Instancia de SQL Server con acceso de red
• Usuario de base de datos con permisos apropiados
• Tablas de eventos conteniendo datos de comportamiento estructurados
• Conectividad de red desde OneSignal a tu instancia de SQL Server

​

Configuración

-- Crear usuario census con la capacidad de iniciar sesión con contraseña
CREATE USER CENSUS WITH PASSWORD = '<strong-unique-password>';

-- Dar al usuario census la capacidad de conectarse a la base de datos
GRANT CONNECT TO CENSUS;

-- Dar al usuario census la capacidad de leer tablas dentro de la base de datos
EXEC sp_addrolemember 'db_datareader', CENSUS;

-- Otorgar al usuario census capacidad de leer datos dentro de un esquema
-- Ejecuta esto para cada esquema que pretendes que OneSignal acceda
GRANT SELECT, VIEW DEFINITION ON SCHEMA::<your-schema> TO CENSUS;

-- Crear un esquema de contabilidad privado donde Census puede almacenar el estado de sincronización
CREATE SCHEMA CENSUS AUTHORIZATION CENSUS;

-- Dar al usuario census acceso completo al esquema de contabilidad
GRANT ALTER, DELETE, EXECUTE, INSERT, REFERENCES, SELECT,
          UPDATE, VIEW DEFINITION ON SCHEMA::CENSUS TO CENSUS;

-- Dar al usuario census la capacidad de crear tablas dentro de la base de datos
GRANT CREATE TABLE TO CENSUS;

​

Event data mapping

​

Ejemplo de esquema de tabla de eventos

-- Ejemplo de tabla de eventos de SQL Server
CREATE TABLE analytics.user_events (
    event_id BIGINT IDENTITY(1,1) PRIMARY KEY,
    event_name NVARCHAR(100) NOT NULL,
    user_id NVARCHAR(255) NOT NULL,
    event_timestamp DATETIME2 DEFAULT GETUTCDATE(),
    event_data NVARCHAR(MAX),
    session_id NVARCHAR(255),
    device_type NVARCHAR(50)
);

​

Modo de consulta SQL

-- Ejemplo: Eventos recientes de alto valor
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= DATEADD(day, -7, GETUTCDATE())
    AND JSON_VALUE(event_data, '$.value') > 100
ORDER BY event_timestamp DESC;

​

Configuración de red avanzada

​

Opciones de motor de sincronización

​

Motor de Sincronización Básico

• Acceso de solo lectura a tus datos de eventos
• Seguimiento de estado gestionado por infraestructura de OneSignal
• Configuración más simple con permisos mínimos

​

Motor de Sincronización Avanzado

• Rendimiento mejorado con seguimiento de estado local
• Requiere permisos adicionales para crear tablas
• Recomendado para procesamiento de eventos de alto volumen

​

Limitaciones

• Las consultas complejas pueden impactar el rendimiento de la base de datos durante períodos de alto tráfico
• Las operaciones JSON requieren SQL Server 2016 o posterior para rendimiento óptimo
• Todos los permisos se otorgan a nivel de base de datos especificado durante la configuración

​

FAQ

​

¿Puedo conectarme a múltiples esquemas de SQL Server?

​

¿Qué versiones de SQL Server están soportadas?

​

¿Necesito usar el Motor de Sincronización Avanzado?