Microsoft Fabric

Visão geral

A integração OneSignal + Microsoft Fabric permite sincronização automática de eventos personalizados do seu lakehouse ou warehouse Fabric para o OneSignal para acionar campanhas de mensagens automatizadas e Journeys com base no comportamento do usuário. Microsoft Fabric é uma plataforma de análise unificada que reúne engenharia de dados, ciência de dados, análise em tempo real e inteligência de negócios em um único ambiente.

Requisitos

Acesso a Event Streams para eventos de mensagem de saída (Limitações de plano e excedentes se aplicam)
Acesso a Custom Events para sincronização de eventos de entrada (Limitações de plano e excedentes se aplicam)
Plano de Conta Atualizado (não disponível em apps gratuitos)

Capacidade Microsoft Fabric com acesso ao workspace
Service Principal com permissões apropriadas
SQL Endpoint (Warehouse ou Lakehouse) contendo dados de eventos
Acesso a API externa habilitado nas configurações do tenant

Configuração

Criar service principal no Azure

Crie um novo service principal para o OneSignal acessar seus recursos Fabric:

Faça login no portal do Azure
Navegue até Microsoft Entra ID > App registrations
Clique em + New registration
Insira o nome: “OneSignal Fabric Integration”
Selecione Accounts in this organizational directory only
Clique em Register
Anote o Application (client) ID e Directory (tenant) ID
Em Certificates & secrets, crie um novo client secret
Anote o client secret value

Configurar configurações do tenant Fabric

Habilite acesso externo para service principals:

No Microsoft Fabric, clique em Settings > Admin portal
Vá para Tenant settings
Em Developer settings, habilite Service principals can use Fabric APIs
Em OneLake settings, habilite Users can access data stored in OneLake with apps external to Fabric

Conceder acesso ao workspace

Adicione o service principal ao seu workspace Fabric:

Navegue até seu workspace (crie workspace compartilhado se estiver usando “My Workspace”)
Clique em Manage Access > + Add people or groups
Selecione seu service principal
Defina a função como Contributor

Obter SQL endpoint

Obtenha a string de conexão SQL para sua fonte de dados:

No seu workspace, passe o mouse sobre seu warehouse/lakehouse
Clique em … > Settings
Copie a SQL connection string (este é seu hostname)

Conectar ao OneSignal

No OneSignal, vá para Data > Integrations e clique em Add Integration.Selecione Microsoft Fabric e forneça:

Hostname: SQL endpoint do Passo 4
Database/Catalog: Seu nome de lakehouse ou warehouse
Tenant ID: Directory ID do Passo 1
Client ID: Application ID do Passo 1
Client Secret: Secret value do Passo 1

Mapeamento de dados de evento

Mapeie seu para o formato de eventos personalizados do OneSignal:

Campo OneSignal	Descrição	Obrigatório
`name`	`event_name`	Identificador de evento	Sim
`external_id`	`user_id`	Identificador de usuário	Sim
`timestamp`	`event_timestamp`	Quando o evento ocorreu	Não
`properties`	`event_data`	Não

A Sync Key é a coluna que você designa como o identificador exclusivo de cada linha durante a sincronização. O OneSignal a utiliza para detectar se uma linha já foi processada, de modo que ressincronizar seus dados não crie eventos duplicados. Escolha uma coluna com um valor de texto exclusivo por linha. Não use um booleano nem um valor que se repita entre as linhas.

Esquema de Tabela de Evento de Exemplo

-- 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 Processamento

Modo de Consulta SQL

Escreva consultas SQL personalizadas para transformar seus dados 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 Tabela

Sincronize tabelas ou visualizações inteiras diretamente do seu workspace Fabric. O OneSignal mapeará automaticamente as colunas para campos de evento.

Limitações

Requer capacidade Fabric (não disponível em trial)
SQL endpoints devem ser acessíveis a serviços externos
Grandes conjuntos de resultados podem impactar o desempenho de sincronização

FAQ

Como otimizo o desempenho de consulta?

Use particionamento e indexação em suas tabelas Fabric. Considere criar visualizações materializadas para dados de eventos acessados com frequência.

Posso sincronizar de lakehouses e warehouses?

Sim, o OneSignal suporta qualquer recurso Fabric que exponha um SQL endpoint, incluindo lakehouses, warehouses e SQL analytics endpoints.

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

Microsoft Fabric

Visão geral

Requisitos