Integrações de armazenamento de data warehouse

1. Crie uma entidade de serviço e conceda acesso às APIs do Fabric.
2. Configure um espaço de trabalho compartilhado e conceda à entidade de serviço acesso a ele.
3. No espaço de trabalho compartilhado do Fabric que você criou na etapa 2, configure as tabelas ou views que deseja sincronizar com a Braze.
4. Crie uma nova integração no dashboard da Braze.
5. Teste a integração e inicie a sincronização.

Etapa 1.1: Configurar a entidade de serviço e conceder acesso

A Braze se conectará ao seu warehouse do Fabric usando uma entidade de serviço com autenticação Entra ID. Você criará uma nova entidade de serviço para a Braze usar e concederá acesso aos recursos do Fabric conforme necessário. A Braze precisará dos seguintes dados para se conectar:

• ID do locatário (também chamado de diretório) da sua conta do Azure
• ID da entidade principal (também chamada de ID do aplicativo) da entidade de serviço
• Segredo do cliente para autenticação da Braze

1. No portal do Azure, navegue até o centro de administração do Microsoft Entra e, em seguida, Registros de app
2. Selecione + Novo registro em Identidade > Aplicativos > Registros de app.
3. Digite um nome e selecione Accounts in this organizational directory only como o tipo de conta compatível. Em seguida, selecione Registrar.
4. Selecione o aplicativo (entidade de serviço) que você acabou de criar, depois navegue até Certificados e segredos > + Novo segredo do cliente.
5. Digite uma descrição para o segredo e defina um período de vencimento. Em seguida, selecione Adicionar.
6. Anote o segredo do cliente criado para usar na configuração da Braze.

Etapa 1.2: Conceder acesso aos recursos do Fabric

Você fornecerá acesso para que a Braze se conecte à sua instância do Fabric. No portal de administração do Fabric, navegue até Configurações > Governança e insights > Portal de administração > Configurações do locatário.

• Nas Configurações do desenvolvedor, ative a opção As entidades de serviço podem usar APIs do Fabric para que a Braze possa se conectar usando o Microsoft Entra ID.
• Nas Configurações do OneLake, ative a opção Os usuários podem acessar dados armazenados no OneLake com apps externos ao Fabric para que a entidade de serviço possa acessar os dados de um app externo.

Etapa 1.3: Configurar um espaço de trabalho compartilhado e conceder acesso

Todos os recursos do Fabric que você deseja conectar à Braze devem ser colocados em um espaço de trabalho compartilhado. Se você estiver usando apenas o Meu Espaço de Trabalho padrão, crie um novo espaço de trabalho compartilhado:

1. No menu de navegação, selecione Espaços de trabalho e, em seguida, selecione + Novo espaço de trabalho.
2. Insira um Nome para o espaço de trabalho e selecione Aplicar.

Depois de ter um espaço de trabalho compartilhado, conceda à entidade de serviço o acesso:

1. Selecione o espaço de trabalho e, em seguida, selecione Gerenciar acesso.
2. Selecione + Adicionar pessoas ou grupos.
3. Pesquise e selecione o nome da entidade de serviço que você criou na Etapa 1.1. Se ela não aparecer, confirme que você ativou a configuração As entidades de serviço podem usar APIs do Fabric na Etapa 1.2.
4. No menu suspenso de função, selecione Colaborador.

A entidade de serviço agora pode acessar os recursos do warehouse do Fabric neste espaço de trabalho por meio dos endpoints SQL, incluindo o warehouse que você usará para a Braze.

Etapa 1.4: Preparar a tabela

A Braze oferece suporte a tabelas e views em Fabric Warehouses. Se precisar criar um novo warehouse, crie-o dentro do espaço de trabalho compartilhado da Etapa 1.3. Acesse Criar > Data Warehouse > Warehouse no console do Fabric.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name] 
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required  
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, email is used as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

Você pode nomear o warehouse, o esquema e a tabela ou view como quiser, mas os nomes das colunas devem corresponder à definição anterior.

• UPDATED_AT - A hora em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no limite exato do timestamp podem ser ressincronizadas se novas linhas compartilharem o mesmo timestamp.
• Colunas de identificador de usuário - Sua tabela pode conter uma ou mais colunas de identificador de usuário. Cada linha deve conter apenas um identificador (external_id, a combinação de alias_name e alias_label, braze_id, email ou phone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificadores.
  • EXTERNAL_ID - Identifica o usuário que você deseja atualizar. Esse valor deve corresponder ao valor external_id usado na Braze.
  • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador exclusivo e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_label.
  • BRAZE_ID - O identificador de usuário da Braze. Ele é gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da Ingestão de Dados na Nuvem. Para criar novos usuários, especifique um ID de usuário externo ou um alias de usuário.
  • EMAIL - O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade. Se você incluir tanto e-mail quanto telefone, o e-mail será usado como identificador principal.
  • PHONE - O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade.
• PAYLOAD - Uma string JSON dos campos que você deseja sincronizar com o usuário na Braze.

Etapa 1.5: Obter a string de conexão do warehouse

Você precisará do endpoint SQL do seu warehouse para que a Braze possa se conectar. Para recuperá-lo, acesse o espaço de trabalho no Fabric e, na lista de itens, passe o mouse sobre o nome do warehouse e selecione Copiar string de conexão SQL.

Etapa 1.6: Permitir IPs da Braze no firewall (opcional)

Dependendo da configuração da sua conta Microsoft Fabric, talvez seja necessário permitir os seguintes endereços IP no seu firewall para permitir o tráfego da Braze. Para saber mais sobre como ativar esse recurso, consulte a documentação relevante sobre o Entra Conditional Access.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)

Etapa 2.1: Configurar uma sincronização de Ingestão de Dados na Nuvem

Você criará uma nova sincronização de dados para o Microsoft Fabric. No dashboard da Braze, acesse Configurações de Dados > Ingestão de Dados na Nuvem, selecione Criar Nova Sincronização de Dados e, em seguida, selecione Importação do Microsoft Fabric.

Etapa 2.2: Adicionar informações de conexão do Microsoft Fabric e tabela de origem

Insira as informações das credenciais do seu warehouse Microsoft Fabric e da tabela de origem e prossiga para a próxima etapa.

• Nome das credenciais é um rótulo para essas credenciais na Braze; você pode definir um valor útil aqui
• Consulte as etapas na seção 1 para obter detalhes sobre como recuperar o Tenant ID, o Principal ID, o Client Secret e a Connection String

Etapa 2.3: Configurar detalhes da sincronização

Em seguida, configure os seguintes detalhes para sua sincronização:

• Nome da sincronização
• Tipo de dados - Os tipos de dados suportados são atributos personalizados, eventos personalizados, eventos de compra, catálogos e exclusões de usuários. O tipo de dados de uma sincronização não pode ser alterado após a criação.
• Frequência de sincronização - A frequência pode variar de cada 15 minutos a uma vez por mês. Usaremos o fuso horário configurado no seu dashboard da Braze para agendar a sincronização recorrente.
  • As sincronizações não recorrentes podem ser disparadas manualmente ou por meio da API

Etapa 2.4: Configurar preferências de notificação

Em seguida, insira os e-mails de contato. Usaremos essas informações de contato para notificá-lo sobre quaisquer erros de integração, como remoção inesperada de acesso à tabela, ou alertar quando linhas específicas não forem atualizadas.

Por padrão, os e-mails de contato receberão apenas notificações de erros globais ou no nível da sincronização, como tabelas ausentes, permissões e outros. Os erros globais indicam problemas críticos com a conexão que impedem a execução das sincronizações. Esses problemas podem incluir:

• Problemas de conectividade
• Falta de recursos
• Problemas de permissões
• (Somente para sincronizações de catálogos) A camada do catálogo está sem espaço

Você também pode configurar alertas para problemas no nível de linha ou optar por receber um alerta sempre que uma sincronização for executada com êxito.

Depois que todos os detalhes de configuração da sua sincronização forem inseridos, selecione Testar conexão. Se for bem-sucedido, você verá uma prévia dos dados. Se, por algum motivo, não for possível conectar, exibiremos uma mensagem de erro para ajudá-lo a solucionar o problema.

Você pode configurar várias integrações com a Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar as credenciais existentes se estiver se conectando à mesma conta do Fabric.

Se você reutilizar o mesmo usuário em várias integrações, não será possível excluir o usuário no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.

Quando ativada, sua sincronização será executada de acordo com a programação configurada durante a instalação. Se você quiser executar a sincronização fora da programação normal de testes ou buscar os dados mais recentes, selecione Sincronizar agora. Essa execução não afetará as sincronizações futuras programadas regularmente.