Amazon Redshift

Descripción general

La integración de OneSignal + Amazon Redshift habilita la sincronización de eventos personalizados desde su almacén de datos Redshift a OneSignal para activar campañas de mensajería automatizadas y Journeys basados en el comportamiento del usuario. Amazon Redshift es un servicio de almacén de datos completamente administrado y a escala de petabytes que hace que sea rentable analizar grandes volúmenes de datos usando sus herramientas de inteligencia empresarial existentes.

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)

Clúster de Redshift con acceso de red
Usuario de base de datos con permisos apropiados
Tablas de eventos que contengan datos de comportamiento estructurados
Conectividad de red desde OneSignal a su clúster de Redshift

Configuración

Crear usuario dedicado para OneSignal

Cree una cuenta de usuario dedicada con permisos apropiados:

-- Crear usuario de OneSignal con contraseña fuerte
CREATE USER CENSUS WITH PASSWORD '<contraseña-fuerte-única>';

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

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

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

Otorgar permisos a datos de eventos

Proporcione acceso de lectura a esquemas que contengan sus datos de eventos:

-- Otorgar acceso al esquema (repetir para cada esquema 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;

Configurar acceso de red

Agregue las direcciones IP de OneSignal a sus grupos de seguridad de Redshift. Redshift previene el acceso externo por defecto.Puede encontrar las direcciones IP de OneSignal para su región en la configuración de integración. Para obtener más información, visite el Centro de ayuda de AWS Redshift.

Conectar a OneSignal

In OneSignal, go to Data > Integrations and click Add Integration.

Seleccione Amazon Redshift de la lista
Ingrese sus detalles de conexión:
- Host: Su endpoint de clúster Redshift
- Port: Usualmente 5439
- Database: Nombre de su base de datos
- Username: CENSUS
- Password: La contraseña que creó
Pruebe la conexión
Configure qué tablas contienen sus datos de eventos

Event data mapping

Map your to OneSignal’s custom events format:

OneSignal Field	Description	Required
`name`	`event_name`	Event identifier	Yes
`external_id`	`user_id`	User identifier	Yes
`timestamp`	`event_timestamp`	When event occurred	No
`properties`	`event_data`	No

Esquema de tabla de eventos de ejemplo

-- Tabla de eventos de Redshift de ejemplo
CREATE TABLE analytics.user_events (
    event_id BIGINT IDENTITY(1,1),
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    event_timestamp TIMESTAMP DEFAULT GETDATE(),
    event_data SUPER,
    session_id VARCHAR(255),
    created_at TIMESTAMP DEFAULT GETDATE()
)
DISTKEY(user_id)
SORTKEY(event_timestamp);

Modo de consulta SQL

Escriba consultas SQL personalizadas para transformar sus 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 >= DATEADD(day, -7, GETDATE())
    AND JSON_EXTRACT_PATH_TEXT(event_data, 'value')::NUMERIC > 100
ORDER BY event_timestamp DESC;

Integración con dbt

Si está usando dbt con Redshift, asegúrese de que OneSignal retenga el acceso después de cada ejecución de dbt:

Opción 1: Permisos detallados

Agregue post-hooks en su proyecto dbt para otorgar acceso después de que cada modelo se construya:

-- En su modelo dbt
{{ config(
    post_hook="GRANT SELECT ON {{ this }} TO CENSUS"
) }}

Opción 2: Privilegios predeterminados (Recomendado)

Otorgue permisos predeterminados para su usuario de producción de dbt:

-- Debe ser ejecutado por el superusuario de Redshift
ALTER DEFAULT PRIVILEGES FOR USER "<your_dbt_run_user>"
IN SCHEMA "<your_dbt_target_schema>"
GRANT SELECT ON TABLES TO CENSUS;

Configuración de red avanzada

Configuración de túnel SSH

Para clústeres de Redshift en redes privadas:

Crear usuario SSH: Configure un usuario dedicado en su host SSH
Configurar túnel: Habilite “Use SSH Tunnel” en la configuración de integración de OneSignal
Instalar par de claves: Agregue la clave pública de OneSignal a ~/.ssh/authorized_keys
Probar conexión: Verifique la conectividad del túnel

Implementación de VPC

Para Redshift dentro de AWS VPC: OneSignal usa el comando UNLOAD para la extracción eficiente de datos masivos. Las implementaciones de VPC requieren un S3 VPC Endpoint para permitir que Redshift se comunique con S3. Configurar S3 VPC Endpoint:

Navegue al servicio VPC en la consola de AWS
Cree un VPC Endpoint para el servicio S3
Asocie con su subred de Redshift
Configure las tablas de enrutamiento

Optimización de rendimiento

Claves de distribución y ordenamiento

Optimice sus tablas de eventos para cargas de trabajo analíticas:

-- Distribuir por user_id para consultas centradas en el usuario
CREATE TABLE analytics.user_events (
    -- columnas
)
DISTKEY(user_id)
SORTKEY(event_timestamp, event_name);

Almacenamiento columnar

Aproveche el almacenamiento columnar de Redshift para análisis:

Compresión: Redshift comprime automáticamente las columnas
Mapas de zona: Mejore el rendimiento de consultas con datos ordenados
Orientado a columnas: Eficiente para consultas analíticas en datos de eventos

Limitaciones

Múltiples esquemas requieren otorgamientos de permisos separados
Las vistas que hacen referencia a tablas de esquema cruzado necesitan permisos adicionales
El acceso a procedimientos almacenados complejos puede requerir configuración adicional
Las implementaciones de VPC requieren configuración de S3 VPC Endpoint

Preguntas frecuentes

¿Cómo maneja OneSignal grandes conjuntos de datos de eventos?

OneSignal usa el comando UNLOAD de Redshift para la extracción eficiente de datos masivos, que está optimizado para cargas de trabajo analíticas a gran escala.

¿Puedo usar el modo de solo lectura?

Sí, puede omitir la creación del esquema de contabilidad y usar el modo de solo lectura si prefiere una configuración más simple y no puede permitir que OneSignal cree tablas.

¿Qué hay de la compatibilidad con dbt?

OneSignal proporciona patrones de integración de dbt específicos para garantizar que los permisos se mantengan después de las ejecuciones de dbt. Use post-hooks o privilegios predeterminados según su configuración.

Primeros pasos & configuraciones

Canales de mensajería

Journeys

Audiencia & eventos personalizados

Analítica & Integraciones

Privacidad & Seguridad

Amazon Redshift

Descripción general

Requisitos

Amazon Redshift

Configuración

Event data mapping

Esquema de tabla de eventos de ejemplo

Modo de consulta SQL

Integración con dbt

Opción 1: Permisos detallados

Opción 2: Privilegios predeterminados (Recomendado)

Configuración de red avanzada

Configuración de túnel SSH

Implementación de VPC

Optimización de rendimiento

Claves de distribución y ordenamiento

Almacenamiento columnar

Limitaciones

Preguntas frecuentes

¿Cómo maneja OneSignal grandes conjuntos de datos de eventos?

¿Puedo usar el modo de solo lectura?

¿Qué hay de la compatibilidad con dbt?

​Descripción general

​Requisitos

​Amazon Redshift

​Configuración

​Event data mapping

​Esquema de tabla de eventos de ejemplo

​Modo de consulta SQL

​Integración con dbt

​Opción 1: Permisos detallados

​Opción 2: Privilegios predeterminados (Recomendado)

​Configuración de red avanzada

​Configuración de túnel SSH

​Implementación de VPC

​Optimización de rendimiento

​Claves de distribución y ordenamiento

​Almacenamiento columnar

​Limitaciones

​Preguntas frecuentes

​¿Cómo maneja OneSignal grandes conjuntos de datos de eventos?

​¿Puedo usar el modo de solo lectura?

​¿Qué hay de la compatibilidad con dbt?

Descripción general

Requisitos

Amazon Redshift

Configuración

Event data mapping

Esquema de tabla de eventos de ejemplo

Modo de consulta SQL

Integración con dbt

Opción 1: Permisos detallados

Opción 2: Privilegios predeterminados (Recomendado)

Configuración de red avanzada

Configuración de túnel SSH

Implementación de VPC

Optimización de rendimiento

Claves de distribución y ordenamiento

Almacenamiento columnar

Limitaciones

Preguntas frecuentes

¿Cómo maneja OneSignal grandes conjuntos de datos de eventos?

¿Puedo usar el modo de solo lectura?

¿Qué hay de la compatibilidad con dbt?