Pular para o conteúdo principal

Visão geral

A integração OneSignal + Azure Synapse permite a sincronização de eventos personalizados do seu workspace Azure Synapse Analytics para o OneSignal para acionar campanhas de mensagens automatizadas e Journeys com base no comportamento do usuário. Azure Synapse Analytics é o serviço de análise baseado em nuvem da Microsoft que combina integração de dados, data warehousing e análises.

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)

Azure Synapse

  • Workspace Azure Synapse com acesso ao SQL pool
  • Usuário de banco de dados com permissões apropriadas
  • Tabelas de eventos contendo dados comportamentais estruturados
  • Acesso ao firewall para endereços IP do OneSignal

Configuração

1

Criar login dedicado para o OneSignal

Crie um login dedicado e conta de usuário com uma senha forte e única:
Substitua <your-database> pelo nome real do seu banco de dados contendo dados de eventos.
2

Conceder permissões de leitura

Forneça acesso somente leitura aos seus dados de eventos:
Substitua <your-schema> pelo nome real do seu schema contendo dados de eventos. Repita este comando para cada schema que você deseja que o OneSignal acesse.
3

Configurar acesso ao firewall

Configure o firewall do Azure Synapse para permitir endereços IP do OneSignal.Use o Portal de Gerenciamento do Windows Azure ou execute sp_set_firewall_rule no banco de dados primário:
Entre em contato com o suporte do OneSignal para obter os intervalos de endereços IP atuais para sua região.
4

Conectar ao OneSignal

No OneSignal, vá para Data > Integrations e clique em Add Integration.Selecione Azure Synapse e forneça os seguintes detalhes de conexão:
  • Host: O hostname do seu endpoint SQL do Synapse
  • Port: 1433 (padrão)
  • Database: O nome do seu banco de dados
  • Username: CENSUS
  • Password: A senha da Etapa 1

Mapeamento de dados de evento

Mapeie seu para o formato de eventos personalizados do OneSignal:

Exemplo de esquema de tabela de eventos

Modo de consulta SQL

Escreva consultas SQL personalizadas para transformar seus dados de eventos:

Recursos específicos do Azure

Arquitetura distribuída

  • Eventos distribuídos por user_id para desempenho ideal de consulta
  • Índices columnstore clusterizados para cargas de trabalho de análise
  • Processamento paralelo massivo (MPP) para dados de eventos em larga escala

Integração com o ecossistema Azure

  • Conecte-se ao Azure Data Factory para pipelines de eventos automatizados
  • Integre com Azure Event Hubs para streaming de eventos em tempo real
  • Aproveite o Azure Active Directory para autenticação

Configuração avançada de rede

O OneSignal pode se conectar com sucesso a instâncias do Azure Synapse que estão usando controles avançados de rede, incluindo restrições de região, listas de permissão de endereços IP ou tunelamento SSH. Para mais informações sobre como configurar o acesso à rede, entre em contato com seu administrador do Azure Synapse ou suporte do OneSignal.

Limitações

  • Baseado no protocolo de conexão do driver JDBC do SQL Server
  • Requer regras de firewall explícitas para endereços IP do OneSignal
  • Consultas complexas podem impactar o desempenho e os custos do SQL pool
  • Operações JSON requerem indexação cuidadosa para desempenho ideal

FAQ

Posso me conectar a vários schemas do Azure Synapse?

Sim, você pode conceder ao usuário CENSUS acesso a vários schemas executando a instrução GRANT SELECT, VIEW DEFINITION ON SCHEMA::<schema> para cada schema contendo dados de eventos.

Como configuro o acesso ao firewall para o OneSignal?

Use o Portal de Gerenciamento do Azure ou sp_set_firewall_rule para adicionar os endereços IP do OneSignal. Entre em contato com o suporte do OneSignal para os intervalos de IP atuais.

Qual é a diferença entre a integração do Azure Synapse e do SQL Server?

O Azure Synapse usa o mesmo driver JDBC do SQL Server, mas inclui recursos de arquitetura distribuída e requer configuração específica de firewall para acesso à nuvem.