Microsoft Fabric

Resumen

La integración de OneSignal + Microsoft Fabric permite la sincronización automática de eventos personalizados desde tu lakehouse o warehouse de Fabric a OneSignal para activar campañas de mensajería automatizadas y Journeys basados en comportamiento de usuario. Microsoft Fabric es una plataforma de análisis unificada que reúne ingeniería de datos, ciencia de datos, análisis en tiempo real e inteligencia de negocios en un solo entorno.

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)

Capacidad de Microsoft Fabric con acceso a workspace
Service Principal con permisos apropiados
SQL Endpoint (Warehouse o Lakehouse) que contenga datos de eventos
Acceso a API externa habilitado en configuración de tenant

Configuración

Crear service principal en Azure

Crea un nuevo service principal para que OneSignal acceda a tus recursos de Fabric:

Inicia sesión en el portal de Azure
Navega a Microsoft Entra ID > App registrations
Haz clic en + New registration
Ingresa el nombre: “OneSignal Fabric Integration”
Selecciona Accounts in this organizational directory only
Haz clic en Register
Anota el Application (client) ID y el Directory (tenant) ID
En Certificates & secrets, crea un nuevo client secret
Anota el client secret value

Configurar ajustes de tenant de Fabric

Habilita el acceso externo para service principals:

En Microsoft Fabric, haz clic en Settings > Admin portal
Ve a Tenant settings
En Developer settings, habilita Service principals can use Fabric APIs
En OneLake settings, habilita Users can access data stored in OneLake with apps external to Fabric

Otorgar acceso a workspace

Agrega el service principal a tu workspace de Fabric:

Navega a tu workspace (crea workspace compartido si usas “My Workspace”)
Haz clic en Manage Access > + Add people or groups
Selecciona tu service principal
Establece el rol a Contributor

Obtener SQL endpoint

Obtén la cadena de conexión SQL para tu fuente de datos:

En tu workspace, pasa el cursor sobre tu warehouse/lakehouse
Haz clic en … > Settings
Copia la SQL connection string (este es tu hostname)

Conectar a OneSignal

In OneSignal, go to Data > Integrations and click Add Integration.Selecciona Microsoft Fabric y proporciona:

Hostname: SQL endpoint del Paso 4
Database/Catalog: Nombre de tu lakehouse o warehouse
Tenant ID: Directory ID del Paso 1
Client ID: Application ID del Paso 1
Client Secret: Secret value del Paso 1

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

The Sync Key is the column you designate as the unique identifier for each row during sync. OneSignal uses it to detect whether a row has already been processed, so re-syncing your data doesn’t create duplicate events. Choose a column with a unique text value per row. Don’t use a boolean or a value that repeats across rows.

Ejemplo de esquema de tabla de eventos

-- Example Fabric table structure
CREATE TABLE user_events (
    event_name STRING,
    user_id STRING,
    event_time TIMESTAMP,
    properties JSON,
    session_id STRING,
    device_type STRING
);

Modos de procesamiento

Modo de consulta SQL

Escribe consultas SQL personalizadas para transformar tus datos de Fabric antes de sincronizar:

SELECT
    event_name,
    user_id,
    event_time,
    TO_JSON(STRUCT(
        session_id,
        device_type,
        product_id
    )) as properties
FROM user_events
WHERE event_time >= CURRENT_DATE - INTERVAL 7 DAYS

Modo de tabla

Sincroniza tablas completas o vistas directamente desde tu workspace de Fabric. OneSignal mapeará automáticamente las columnas a campos de eventos.

Limitaciones

Requiere capacidad de Fabric (no disponible en prueba)
Los SQL endpoints deben ser accesibles para servicios externos
Conjuntos de resultados grandes pueden impactar el rendimiento de sincronización

Preguntas frecuentes

¿Cómo optimizo el rendimiento de consultas?

Usa particionamiento e indexación en tus tablas de Fabric. Considera crear vistas materializadas para datos de eventos consultados frecuentemente.

¿Puedo sincronizar desde lakehouses y warehouses?

Sí, OneSignal soporta cualquier recurso de Fabric que exponga un SQL endpoint, incluyendo lakehouses, warehouses y SQL analytics endpoints.

Primeros pasos & configuraciones

Canales de mensajería

Journeys

Audiencia & eventos personalizados

Analítica & Integraciones

Privacidad & Seguridad

Microsoft Fabric

Resumen

Requisitos