Ingestão de dados na nuvem para Microsoft Fabric
Esta página reúne tudo o que você precisa para sincronizar dados do Microsoft Fabric com a Braze usando a ingestão de dados na nuvem (CDI): os recursos a criar no Fabric, como conectar a fonte e criar uma sincronização na Braze, a tabela de origem para cada tipo de dado e a solução de problemas específica do Fabric.
Visão geral da configuração
- Configure a autenticação para a Braze usando um dos métodos de autenticação compatíveis e conceda acesso às APIs do Fabric.
- Configure um espaço de trabalho compartilhado e conceda acesso a ele à entidade de serviço.
- No espaço de trabalho compartilhado do Fabric, configure as tabelas ou visualizações que você deseja sincronizar com a Braze.
- Crie uma nova fonte e uma nova sincronização no dashboard da Braze.
- Valide a integração e inicie a sincronização.
Etapa 1: Configurar a autenticação
A Braze se conecta ao seu warehouse do Fabric com o seguinte método de autenticação:
| Método | Como a Braze faz a autenticação | O que você insere na Braze |
|---|---|---|
| Service principal | Braze authenticates as a Microsoft Entra ID service principal with a client secret. | Tenant ID, Principal ID, and Client Secret |
Service principal
A Braze se conecta ao seu warehouse do Fabric usando uma entidade de serviço com autenticação do Microsoft Entra ID. Crie uma nova entidade de serviço para a Braze usar e conceda a ela acesso aos recursos do Fabric nas etapas a seguir. A Braze precisa dos seguintes detalhes para se conectar:
- ID do locatário (também chamado de diretório) da sua conta Azure
- ID da entidade de segurança (também chamado de ID do aplicativo) para a entidade de serviço
- Segredo do cliente para a Braze autenticar
Para registrar um aplicativo, você precisa de permissão para criar registros de aplicativo no Microsoft Entra ID. Se você não tiver essa permissão, peça a um administrador do Entra para concluir esta etapa e compartilhar as credenciais com você.
- No portal do Azure, navegue até o centro de administração do Microsoft Entra e, em seguida, App Registrations.
- Selecione + New registration em Identity > Applications > App registrations
- Insira um nome e selecione
Accounts in this organizational directory onlycomo o tipo de conta compatível. Em seguida, selecione Register. - Selecione o app (service principal) que você acabou de criar e navegue até Certificates & secrets > + New client secret
- Insira uma descrição para o segredo e defina um período de vencimento para o segredo. Em seguida, selecione Add.
- Anote o segredo do cliente criado para usar na configuração da Braze.

O Azure não permite vencimento ilimitado para segredos de entidades de serviço. Lembre-se de renovar as credenciais antes do vencimento para manter o fluxo de dados para a Braze.
Etapa 2: Conceda acesso aos recursos do Fabric
Forneça acesso para que a Braze se conecte à sua instância do Fabric. No portal de administração do Fabric, acesse Configurações > Governança e insights > Portal de administração > Configurações do locatário.
- Em Configurações do desenvolvedor, ative As entidades de serviço podem usar as APIs do Fabric para que a Braze possa se conectar usando o Microsoft Entra ID.
- Em Configurações do OneLake, ative Os usuários podem acessar dados armazenados no OneLake com apps externos ao Fabric para que a entidade de serviço possa acessar dados de um app externo.
Etapa 3: Configure um espaço de trabalho compartilhado e conceda acesso
Todos os recursos do Fabric que você quer conectar à Braze precisam estar em um espaço de trabalho compartilhado. Se você só usou o espaço de trabalho padrão My Workspace, crie um novo espaço de trabalho compartilhado:
- No menu de navegação, selecione Workspaces e, em seguida, + New workspace.
- Insira um Name para o espaço de trabalho e selecione Apply.
Depois de ter um espaço de trabalho compartilhado, conceda acesso à entidade de serviço:
- Selecione o espaço de trabalho e, em seguida, Manage Access.
- Selecione + Add people or groups.
- Pesquise e selecione o nome da entidade de serviço que você criou na Etapa 1. Se ela não aparecer, confirme se você ativou a configuração Service principals can use Fabric APIs na Etapa 2.
- No menu suspenso de função, selecione Contributor.
Agora, a entidade de serviço pode acessar os recursos de warehouse do Fabric neste espaço de trabalho por meio dos endpoints SQL deles, incluindo o warehouse que será usado com a Braze.
Etapa 4: Configure sua tabela de origem
As etapas desta seção criam uma tabela com uma coluna PAYLOAD. Se você planeja moldar seus dados na etapa Definição de dados, pode usar uma tabela ou exibição existente. Nesse caso, pule a etapa de criação da tabela e conceda à Braze acesso de leitura às tabelas ou exibições que deseja sincronizar. Para comparar as opções, consulte Escolha uma opção de definição de dados.
A Braze aceita tanto tabelas quanto exibições em warehouses do Fabric. Se precisar criar um novo warehouse, crie-o no espaço de trabalho compartilhado da Etapa 3. Acesse Create > Data Warehouse > Warehouse no console do Fabric.
Você pode dar o nome que quiser ao warehouse, ao esquema e à tabela ou exibição. Mas os nomes das colunas devem corresponder às definições nas guias a seguir.

Se você usar uma coluna PAYLOAD, sua tabela ou exibição de origem pode incluir colunas que não aparecem nas guias a seguir (por exemplo, de auditoria ou hashing). A Braze lê apenas as colunas descritas nessas guias. As demais colunas não são usadas durante as sincronizações da ingestão de dados na nuvem.
Selecione a guia do tipo de dados que você deseja sincronizar.
Atributos do usuário, eventos personalizados e eventos de compra usam o mesmo formato de tabela de origem. Só o conteúdo de PAYLOAD muda.
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
UPDATED_AT- O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.- 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 dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificador.EXTERNAL_ID- Identifica o usuário que você deseja atualizar. Deve corresponder ao valor deexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador exclusivo, ealias_labelespecifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. Ele é gerado pelo SDK da Braze. Não é possível criar novos usuários 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 nas atualizações. Se você incluir tanto o e-mail quanto o 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 nas atualizações.
PAYLOAD- É uma string JSON com os campos que você deseja sincronizar com o usuário na Braze.
Nas sincronizações de atributos, PAYLOAD segue o formato do objeto de atributos do usuário. Você pode incluir atributos personalizados aninhados, arrays de objetos e status de grupos de inscrições. Para ver exemplos de carga útil, consulte Configuração da tabela.
Os eventos personalizados usam a mesma tabela de origem que os atributos do usuário. Crie a tabela mostrada na guia Atributos do usuário e preencha PAYLOAD com um objeto de eventos.
Para sincronizar eventos, é necessário informar o nome do evento. Formate o campo time como uma string ISO 8601 ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Se o campo time não estiver presente, a Braze usa o valor da coluna UPDATED_AT como horário do evento. Os demais campos, incluindo app_id e properties, são opcionais.
Você pode sincronizar um evento por linha.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
Os eventos de compra usam a mesma tabela de origem que os atributos do usuário. Crie a tabela mostrada na guia Atributos do usuário e preencha PAYLOAD com um objeto de compras.
Para sincronizar eventos de compra, é necessário informar product_id, currency e price. Formate o campo opcional time como uma string ISO 8601 ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Se o campo time não estiver presente, a Braze usa o valor da coluna UPDATED_AT como horário do evento. Os demais campos, incluindo app_id, quantity e properties, são opcionais.
Você pode sincronizar um evento de compra por linha.
{
"app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
"product_id" : "Completed Order",
"currency" : "USD",
"price" : 219.98,
"time" : "2013-07-16T19:20:30+01:00",
"properties" : {
"products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
{ "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
]
}
}
Antes de criar uma sincronização de catálogo, crie o catálogo de destino na Braze. Para ver o fluxo de trabalho completo de catálogos, consulte Sincronizar e excluir dados de catálogo.
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
UPDATED_AT DATETIME2(6) NOT NULL,
PAYLOAD VARCHAR NOT NULL,
ID VARCHAR NOT NULL,
DELETED BIT
)
GO
O nome da integração deve ser exatamente igual ao nome do catálogo que você criou na Braze.
A Braze recomenda criar uma exibição a partir dos dados do catálogo para que a tabela de origem seja totalmente atualizada a cada sincronização. Por exemplo, se você tiver uma tabela de dados de produtos (product_catalog) com id e quatro atributos adicionais, poderá sincronizar a seguinte exibição:
CREATE VIEW [braze].[user_update_example]
AS SELECT
id as ID,
CURRENT_TIMESTAMP as UPDATED_AT,
JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD
FROM [braze].[product_catalog] ;
Antes de criar uma sincronização de objetos de dados, crie o tipo de objeto de dados e os campos dele na Braze. Para ver o fluxo de trabalho completo, consulte Sincronizar objetos de dados.
CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNTS_SYNC]
(
UPDATED_AT DATETIME2(6) NOT NULL,
OBJECT_ID VARCHAR NOT NULL,
PAYLOAD VARCHAR NOT NULL,
--the data object record associated with this OBJECT_ID should be deleted
DELETED BIT
)
GO
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
DATETIME2 | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
PAYLOAD |
VARCHAR | REQUIRED |
DELETED |
BIT | NULLABLE |
UPDATED_AT- O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.OBJECT_ID- O identificador do registro do objeto de dados. Ele deve corresponder ao valor deobject_idusado na Braze para esse tipo de objeto de dados.PAYLOAD- Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.DELETED- Quando fortrue, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou comofalsenas linhas que você quer criar ou atualizar.
Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.
A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.
Por exemplo, um valor de PAYLOAD para uma conta com os campos name e team_id fica assim:
{"name": "Acme Corp", "team_id": 42}
Na etapa Definição de dados, selecione o tipo de dados Objetos de dados e escolha seu Tipo de objeto de dados. As sincronizações de objetos de dados aceitam Tabela e SQL.
Use esta sincronização para conectar usuários a registros de objetos de dados, por exemplo, para vincular usuários às contas a que pertencem. Crie o relacionamento na Braze antes de sincronizá-lo.
CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNT_USERS_SYNC]
(
UPDATED_AT DATETIME2(6) NOT NULL,
OBJECT_ID VARCHAR NOT NULL,
--at least one of external_id, alias_name and alias_label, email, or phone is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR,
EMAIL VARCHAR,
PHONE VARCHAR,
PAYLOAD VARCHAR,
DELETED BIT
)
GO
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
DATETIME2 | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
EXTERNAL_ID |
VARCHAR | NULLABLE |
ALIAS_NAME |
VARCHAR | NULLABLE |
ALIAS_LABEL |
VARCHAR | NULLABLE |
EMAIL |
VARCHAR | NULLABLE |
PHONE |
VARCHAR | NULLABLE |
PAYLOAD |
VARCHAR | NULLABLE |
DELETED |
BIT | NULLABLE |
Cada linha precisa de OBJECT_ID e de pelo menos um identificador de usuário: EXTERNAL_ID, a combinação de ALIAS_NAME e ALIAS_LABEL, EMAIL ou PHONE. Use PAYLOAD para quaisquer campos definidos no próprio relacionamento.

Diferente das sincronizações de atributos do usuário, BRAZE_ID não é aceito nas sincronizações de relacionamentos de usuários. Use um dos identificadores listados anteriormente.
UPDATED_AT- O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.OBJECT_ID- O identificador do registro do objeto de dados. Ele deve corresponder ao valor deobject_idusado na Braze para esse tipo de objeto de dados.PAYLOAD- Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.DELETED- Quando fortrue, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou comofalsenas linhas que você quer criar ou atualizar.
Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.
A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.
Na etapa Definição de dados, selecione o tipo de dados Relacionamentos entre usuários e objetos de dados e escolha um Nome do relacionamento, como User (Account-User).
Use esta sincronização para conectar registros de objetos de dados entre si, por exemplo, para vincular contas às suas contas principais. Crie o relacionamento na Braze antes de sincronizá-lo.
CREATE OR ALTER TABLE [warehouse].[schema].[ACCOUNT_SUBACCOUNTS_SYNC]
(
UPDATED_AT DATETIME2(6) NOT NULL,
OBJECT_ID VARCHAR NOT NULL,
RELATED_OBJECT_ID VARCHAR NOT NULL,
PAYLOAD VARCHAR,
DELETED BIT
)
GO
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
DATETIME2 | REQUIRED |
OBJECT_ID |
VARCHAR | REQUIRED |
RELATED_OBJECT_ID |
VARCHAR | REQUIRED |
PAYLOAD |
VARCHAR | NULLABLE |
DELETED |
BIT | NULLABLE |
OBJECT_ID é o registro de onde o relacionamento parte, e RELATED_OBJECT_ID é o registro para o qual ele aponta. Os dois são obrigatórios em todas as linhas. Use PAYLOAD para quaisquer campos definidos no próprio relacionamento.
UPDATED_AT- O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.OBJECT_ID- O identificador do registro do objeto de dados. Ele deve corresponder ao valor deobject_idusado na Braze para esse tipo de objeto de dados.PAYLOAD- Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.DELETED- Quando fortrue, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou comofalsenas linhas que você quer criar ou atualizar.
Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.
A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.
Na etapa Definição de dados, selecione o tipo de dados Relacionamentos entre objetos de dados e escolha um Nome do relacionamento, como Subaccount (Account-Account).
Os gatilhos do Canvas viabilizam a personalização zero-copy. Para ver a configuração do Canvas de destino e as considerações, consulte Personalização zero-copy.
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
UPDATED_AT DATETIME2(6) NOT NULL,
PROPERTIES VARCHAR NOT NULL,
--at least one of external_id or alias_name and alias_label is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR
)
GO
As sincronizações de disparo de Canvas diferem de outras sincronizações de dados de usuários de três maneiras:
- Só há suporte para os identificadores ID externo ou alias de usuário. E-mail e números de telefone não são identificadores compatíveis.
- Só é possível sincronizar usuários que já existem na Braze. Não é possível criar novos usuários.
PROPERTIESsubstitui a colunaPAYLOAD. Essa coluna é uma string JSON com os campos que você quer usar como propriedades de entrada no Canvas para personalização.
Sua tabela de disparos de Canvas precisa das seguintes colunas:
UPDATED_AT- O momento em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. As linhas com o timestamp exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo timestamp.EXTERNAL_IDouALIAS_NAMEeALIAS_LABELcomo coluna de identificador de usuário. Essas colunas identificam os usuários para os quais você quer disparar o envio de mensagens do Canvas.EXTERNAL_ID- Identifica o usuário que vai entrar no Canvas. Esse valor deve corresponder ao valor deexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.
PROPERTIES- Uma string JSON com os campos que ficarão disponíveis como propriedades de personalização no seu Canvas. Ela deve conter informações específicas do usuário.

As propriedades não são obrigatórias para todas as linhas ou usuários. No entanto, os valores das propriedades precisam ser uma string JSON válida. Insira uma string vazia {} se não houver propriedades para a linha.
Crie uma entidade de serviço e conceda as permissões. Se você já tiver credenciais de outra sincronização, pode reutilizá-las. Só confirme que elas têm acesso à tabela de gatilhos do Canvas.
Para começar, selecione o tipo de dados Gatilhos do Canvas ao criar uma nova sincronização.
As tabelas de origem para exclusões de usuários devem incluir um ou mais tipos de identificador de usuário e um carimbo de data/hora UPDATED_AT. Colunas de carga útil não são compatíveis com dados de exclusão de usuários.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. As linhas que estiverem exatamente no carimbo de data/hora limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.- Colunas de identificador de usuário - Cada linha deve conter apenas um identificador:
external_id, a combinação dealias_nameealias_label, oubraze_id. Uma tabela de origem pode conter colunas para um, dois ou todos os três tipos de identificador.EXTERNAL_ID- Identifica o usuário que você deseja atualizar. Deve corresponder ao valor deexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador exclusivo, ealias_labelespecifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. Ele é gerado pelo SDK da Braze, e não é possível criar novos usuários usando um ID da Braze 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.

Não inclua uma coluna PAYLOAD na sua tabela para remoção de usuários. Para evitar a remoção acidental e permanente de usuários, a sincronização falha se uma coluna de carga útil for fornecida na tabela de origem. Quaisquer outras colunas são permitidas, mas são ignoradas pela Braze.
CREATE OR ALTER TABLE [warehouse].[schema].[users_deletes]
(
UPDATED_AT DATETIME2(6) NOT NULL,
--at least one of external_id, alias_name and alias_label, 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
)
GO
Na página Criar sincronização de importação, defina o Tipo de dados como Excluir usuários para que as ações corretas sejam executadas durante a integração. Para saber mais, consulte Excluir usuários com a ingestão de dados na nuvem.

A exclusão de perfis de usuário não pode ser desfeita. A ação de exclusão remove usuários permanentemente, o que pode causar discrepâncias nos seus dados. Para mais detalhes, consulte Efeitos da exclusão de perfis de usuário.
Etapa 5: Obter a string de conexão do warehouse
Para recuperar o endpoint SQL do seu warehouse, acesse o espaço de trabalho no Fabric, passe o mouse sobre o nome do warehouse na lista de itens e selecione Copiar string de conexão SQL.

Etapa 6: Permitir os IPs da Braze no seu firewall (opcional)
Dependendo da configuração da sua conta do Microsoft Fabric, talvez seja necessário permitir os seguintes endereços IP no seu firewall para liberar o tráfego da Braze. Para saber como ativar isso, consulte a documentação sobre o Acesso Condicional do Entra.
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estes são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 7: Criar uma nova fonte no dashboard da Braze
No dashboard da Braze, acesse Configurações de dados > Ingestão de dados na nuvem > Fontes, selecione Adicionar fonte de dados e depois selecione Microsoft Fabric.
Etapa 7.1: Adicionar as informações de conexão do Microsoft Fabric
Escolha um nome para sua fonte e insira suas credenciais e a configuração do Microsoft Fabric.
- Nome das credenciais é um rótulo para essas credenciais na Braze. Você pode definir um valor que ajude a identificá-las.
- Insira as credenciais do método de autenticação que você configurou na Etapa 1. Insira Tenant ID, Principal ID, and Client Secret.
- Para String de conexão, consulte a Etapa 5.
Etapa 7.2: Testar a conexão e conectar à fonte
Em seguida, selecione Testar conexão. Se o teste for bem-sucedido, conclua as configurações restantes e clique em Conectar à fonte. Se a conexão falhar, aparecerá uma mensagem de erro para ajudar você a solucionar o problema.

É necessário testar uma fonte com sucesso antes de criá-la. Se você fechar a página de criação, sua fonte não será salva.
Etapa 8: Criar uma nova sincronização no dashboard da Braze
Acesse Configurações de dados > Ingestão de dados na nuvem > Sincronizações e selecione Criar sincronização de dados.
Configurar os detalhes da sincronização e definir seus dados
Insira um nome para sua sincronização. Em seguida, selecione uma fonte ativa e um tipo de dados de sincronização. Depois, selecione um modo de sincronização e defina seus dados. Então, selecione Prévia e validação.
Depois que a validação for bem-sucedida, uma prévia dos dados será exibida. Selecione Próximo: Notificações para continuar. Se a validação falhar, uma mensagem de erro será exibida para ajudar a solucionar o problema.

Você precisa validar uma sincronização com sucesso antes de avançar para as próximas etapas. Se precisar fechar a página de criação da sincronização, selecione Salvar como rascunho para manter seu trabalho em andamento.
Adicionar preferências de notificação
Insira um ou mais e-mails de contato para receber notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como a perda inesperada de acesso a uma tabela.
Os e-mails de contato recebem apenas notificações de erros globais ou no nível da sincronização, como tabelas ausentes, problemas de permissões e outros. Eles não recebem notificações de problemas no nível da linha. Os erros globais indicam problemas críticos na conexão que impedem a execução das sincronizações.
Esses problemas podem incluir:
- Problemas de conectividade
- Falta de recursos
- Problemas de permissões
- O nível do catálogo está sem espaço (somente sincronizações de catálogo)
Definir o cronograma
Por fim, configure a sincronização como não recorrente ou recorrente.
As sincronizações não recorrentes são executadas somente quando você seleciona Sincronizar agora no dashboard ou chama o endpoint Disparar uma sincronização.
As sincronizações recorrentes podem ser executadas com frequência de até uma vez a cada 5 minutos ou com intervalo de até uma vez por mês. Por padrão, o intervalo mais curto que você pode definir no dashboard é de 15 minutos. Isso ajuda a gerenciar os custos de computação e o volume de solicitações do seu data warehouse. Para sincronizar a cada 5 minutos, entre em contato com o suporte da Braze ou com seu gerente de sucesso do cliente. A Braze agenda as sincronizações recorrentes em UTC.

Você precisa validar uma integração com sucesso antes que ela possa passar do estado Rascunho para Ativo. Se você fechar a página de criação, sua integração será salva, e você poderá voltar à página de detalhes para fazer alterações e validá-la.
Executar a sincronização
Depois de ativada, a sincronização é executada no cronograma configurado durante a configuração. Se quiser executar a sincronização fora do cronograma ou buscar os dados mais recentes, selecione Sincronizar agora. Essa execução não afeta as próximas sincronizações agendadas. Para iniciar uma sincronização automaticamente quando seus dados forem atualizados, chame o endpoint Disparar uma sincronização a partir do seu pipeline.
Configurar integrações ou usuários adicionais (opcional)
Você pode configurar várias integrações com a Braze. Ao criar sincronizações adicionais, é possível reutilizar credenciais existentes se a conexão for com a mesma conta do Fabric.
Se você reutilizar o mesmo usuário em várias integrações, não poderá excluí-lo no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.
Usar o Microsoft Fabric como uma fonte conectada
Uma fonte conectada é uma alternativa de cópia zero à sincronização de dados com a Braze. A Braze consulta diretamente seu data warehouse do Fabric para criar segmentos CDI, sem copiar os dados subjacentes. Para saber mais sobre conceitos, limitações e implicações de custo, consulte Fontes conectadas.
Etapa 1: Configurar a autenticação e conceder acesso
Siga a mesma configuração descrita na Etapa 1, na Etapa 2 e na Etapa 3. Depois, obtenha a string de conexão do data warehouse conforme descrito na Etapa 5 e permita os IPs da Braze conforme descrito na Etapa 6.
No seu espaço de trabalho do Fabric, configure os dados de origem e conceda permissões à sua entidade de serviço. A fonte conectada pode referenciar uma ou mais tabelas. Portanto, confira se a entidade de serviço da Braze tem permissão para acessar todas as tabelas que você deseja incluir na fonte conectada.
Etapa 2: Criar a fonte conectada na Braze
Acesse Configurações de dados > Ingestão de dados na nuvem > Fontes conectadas, selecione Adicionar fonte de dados e, em seguida, selecione Microsoft Fabric.
Em Configurar fonte, insira o seguinte:
- Credenciais: Nome das credenciais, String de conexão e os campos do seu método de autenticação. Insira Tenant ID, Principal ID, and Client Secret.
- Configuração: Banco de dados e Esquema
Se a opção Conectar com túnel SSH estiver disponível no seu espaço de trabalho e for necessária para sua configuração, insira também Host do túnel, Porta do túnel e Nome de usuário do túnel.
Escolha um nome para a fonte conectada. Esse nome aparece na lista de fontes disponíveis quando você cria uma nova extensão de segmento CDI.
Configure um tempo máximo de execução para essa fonte. A Braze interrompe automaticamente todas as consultas que excederem o tempo máximo de execução. O tempo máximo permitido é de 60 minutos. Um tempo de execução menor reduz os custos na sua conta do Microsoft Fabric. Essa configuração se aplica às consultas executadas por essa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Se as consultas estiverem atingindo o tempo limite com frequência e você tiver definido um tempo máximo de execução de 60 minutos, tente otimizar o tempo de execução da consulta ou aumentar a capacidade do Fabric.
Selecione Testar conexão para verificar se a lista de tabelas visíveis para o usuário corresponde ao esperado e, em seguida, selecione Concluído. Sua fonte conectada foi criada e está pronta para uso em extensões de segmento CDI.
Você pode configurar várias fontes conectadas com a Braze, mas cada fonte deve estar configurada para se conectar a um esquema diferente. Ao criar fontes adicionais, você pode reutilizar credenciais existentes se estiver se conectando à mesma conta do Azure.
Formatar uma carga útil a partir de colunas existentes
Se você prefere armazenar cada atributo em sua própria coluna internamente, é necessário converter essas colunas em uma string JSON para preencher a sincronização com a Braze. Use esta consulta no Microsoft Fabric para formatar as colunas de origem em campos do CDI.
CREATE TABLE [braze].[users] (
attribute_1 VARCHAR,
attribute_2 VARCHAR,
attribute_3 VARCHAR,
attribute_4 VARCHAR,
user_id VARCHAR
)
GO
CREATE VIEW [braze].[user_update_example]
AS SELECT
user_id as EXTERNAL_ID,
CURRENT_TIMESTAMP as UPDATED_AT,
JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD
FROM [braze].[users] ;
Para mais orientações de otimização, consulte as práticas recomendadas de ingestão de dados na nuvem.
Solução de problemas
O teste de conexão está lento
O teste de conexão é executado no seu data warehouse, então aumentar a capacidade pode melhorar a velocidade dele.
O segredo da entidade de serviço venceu
O Azure não permite vencimento ilimitado para segredos de entidades de serviço. Se as sincronizações começarem a falhar com erros de autenticação, atualize o segredo do cliente no Microsoft Entra ID e atualize as credenciais na Braze.
Onde executar verificações SQL
Execute as verificações de validação diretamente no editor de consultas SQL do Fabric, na mesma tabela ou visualização usada pela sua integração de CDI. O Fabric não oferece suporte a LIMIT, então use uma sintaxe equivalente, como TOP.
Páginas relacionadas
- Configuração da tabela para colunas obrigatórias e formatação da carga útil
- Melhores práticas para agendamento de sincronizações e eficiência no uso de pontos de dados
- Logs de sincronização e observabilidade para monitorar as execuções de sincronização
- Perguntas frequentes para dúvidas comuns sobre todas as fontes