Saltar al contenido principal

​
Descripción general

La integración OneSignal + SingleStore habilita la sincronización de eventos personalizados desde tu base de datos SingleStore a OneSignal para activar campañas de mensajería automatizadas y Journeys basados en el comportamiento del usuario. SingleStore es una base de datos SQL distribuida diseñada para análisis en tiempo real y aplicaciones de alto rendimiento.

​
Requisitos

​
SingleStore

  • SingleStoreDB Cloud o SingleStoreDB v7.1+
  • Usuario de base de datos con permisos apropiados
  • Tablas de eventos conteniendo datos de comportamiento estructurados
  • Conectividad de red desde OneSignal a tu clúster de SingleStore

​
Configuración

1

Crear usuario dedicado para OneSignal

Crea una cuenta de usuario dedicada con una contraseña fuerte y única:
-- Crear usuario census con la capacidad de iniciar sesión con contraseña
CREATE USER CENSUS IDENTIFIED BY '<strong-unique-password>';
2

Otorgar permisos a datos de eventos

Proporciona acceso de solo lectura a esquemas que contienen tus datos de eventos:
-- Otorgar acceso de solo lectura al esquema con datos de eventos
GRANT SELECT ON analytics.* TO CENSUS;

-- Repetir para esquemas adicionales si es necesario
GRANT SELECT ON events.* TO CENSUS;
Si tienes múltiples esquemas conteniendo datos de eventos, repite la declaración GRANT SELECT para cada esquema.
3

Conectar a OneSignal

In OneSignal, go to Data > Integrations and click Add Integration.Selecciona SingleStore y proporciona los siguientes detalles de conexión:
  • Host: Tu endpoint de clúster de SingleStore
  • Port: 3306 (predeterminado)
  • Database: El nombre de tu base de datos
  • Username: CENSUS
  • Password: La contraseña del Paso 1

​
Event data mapping

Map your to OneSignal’s custom events format:
OneSignal FieldDescriptionRequired
nameevent_nameEvent identifierYes
external_iduser_idUser identifierYes
timestampevent_timestampWhen event occurredNo
propertiesevent_dataNo

​
Esquema de Tabla de Eventos de Ejemplo

-- Ejemplo de tabla de eventos de SingleStore
CREATE TABLE analytics.user_events (
    event_id BIGINT AUTO_INCREMENT PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    event_timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    event_data JSON,
    session_id VARCHAR(255),
    device_type VARCHAR(50)
);

​
Modo de Consulta SQL

Escribe consultas SQL personalizadas para transformar tus datos de eventos: 
-- Ejemplo: Eventos recientes de alto valor
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    AND JSON_EXTRACT_STRING(event_data, 'value') > '100'
ORDER BY event_timestamp DESC;

​
Configuración de Red Avanzada

OneSignal puede conectarse exitosamente a instancias de SingleStore que están usando controles de red avanzados incluyendo restricciones de región y listas de permitidos de direcciones IP. Para más información sobre configurar acceso de red, contacta a tu administrador de SingleStore o soporte de OneSignal.

​
Limitaciones

  • Las consultas de análisis en tiempo real pueden impactar el rendimiento del clúster durante períodos de alto tráfico
  • Las operaciones JSON deberían optimizarse para ejecución distribuida

​
FAQ

​
¿Puedo conectarme a múltiples esquemas de SingleStore?

Sí, puedes otorgar al usuario CENSUS acceso a múltiples esquemas ejecutando la declaración GRANT SELECT para cada esquema conteniendo datos de eventos.

​
¿OneSignal soporta SingleStore Cloud?

Sí, OneSignal soporta tanto SingleStoreDB Cloud como instalaciones on-premises de SingleStoreDB v7.1+.