Ir para o conteúdo

Ingestão de dados na nuvem para Snowflake

Esta página reúne tudo o que você precisa para sincronizar dados do Snowflake com a Braze usando a Ingestão de Dados na Nuvem (CDI). Você vai ver quais recursos criar no Snowflake, como conectar a fonte e criar uma sincronização na Braze, qual é a tabela de origem para cada tipo de dado e como resolver problemas específicos do Snowflake.

Visão geral da configuração

  1. Na sua instância do Snowflake, configure as tabelas ou visualizações que você deseja sincronizar com a Braze.
  2. Configure uma função e um warehouse para a Braze.
  3. Configure um usuário do Snowflake para a Braze com um dos métodos de autenticação compatíveis.
  4. Crie uma nova fonte do Snowflake no dashboard da Braze e conclua a autenticação no Snowflake.
  5. Crie uma sincronização no dashboard da Braze, valide a integração e inicie a sincronização.

Etapa 1: Configure sua tabela de origem

As etapas desta seção criam uma tabela com uma coluna PAYLOAD. Se você pretende estruturar seus dados na etapa Definição de dados, pode usar uma tabela ou view existente. Nesse caso, pule a etapa de criação da tabela e conceda à Braze acesso de leitura às tabelas ou views que deseja sincronizar. Para comparar as opções, consulte Escolha uma opção de definição de dados.

Você pode dar o nome que quiser ao banco de dados, ao esquema e à tabela. No entanto, os nomes das colunas devem corresponder às definições das guias a seguir. Também é possível usar uma view ou uma view materializada no lugar de uma tabela.

Selecione a guia do tipo de dados que você deseja sincronizar.

Atributos do usuário, eventos personalizados e eventos de compra usam a mesma estrutura de tabela de origem. Apenas o conteúdo de PAYLOAD muda.

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216),
     --If you include both email and phone, email is used as the primary identifier
     EMAIL VARCHAR(16777216),
     PHONE VARCHAR(16777216),
     PAYLOAD VARCHAR(16777216) NOT NULL
);
  • UPDATED_AT - O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 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 identificador.
    • EXTERNAL_ID - Identifica o usuário que você deseja atualizar. Deve corresponder ao valor de 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. 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 dos atributos do usuário. Crie a tabela mostrada na guia Atributos do usuário e, em seguida, 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 dos atributos do usuário. Crie a tabela mostrada na guia Atributos do usuário e, em seguida, 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álogos.

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --ID of the catalog item to be created or updated
     ID VARCHAR(16777216) NOT NULL,
     --Catalog fields and values that should be added or updated
     PAYLOAD VARCHAR(16777216) NOT NULL,
     --The catalog item associated with this ID should be deleted
     DELETED BOOLEAN
);

Conceda à função da Braze acesso a esta tabela, junto com suas outras tabelas de origem:

GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

O nome da integração deve corresponder exatamente ao nome do catálogo que você criou na Braze.

A Braze recomenda criar uma view a partir dos dados do seu catálogo para que a tabela de origem seja totalmente atualizada a cada execução da sincronização. Por exemplo, se você tiver uma tabela de dados de produtos (product_catalog_1) com product_id e três atributos adicionais, poderá sincronizar a seguinte view:

CREATE VIEW BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC AS
SELECT
    CURRENT_TIMESTAMP as UPDATED_AT,
    product_id as id,
    TO_JSON(
        OBJECT_CONSTRUCT (
            'attribute_1',
            attribute_1,
            'attribute_2',
            attribute_2,
            'attribute_3',
            attribute_3)
    )as PAYLOAD FROM "product_catalog_1";

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 REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC (
    UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
    OBJECT_ID VARCHAR(16777216) NOT NULL,
    PAYLOAD VARCHAR(16777216) NOT NULL,
    --the data object record associated with this OBJECT_ID should be deleted
    DELETED BOOLEAN
);
Nome do campo Tipo Modo
UPDATED_AT TIMESTAMP_NTZ REQUIRED
OBJECT_ID VARCHAR REQUIRED
PAYLOAD VARCHAR REQUIRED
DELETED BOOLEAN NULLABLE
  • UPDATED_AT - O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de object_id usado 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 for true, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou como false nas 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}

Conceda à função da Braze acesso a esta tabela:

GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Na etapa Definição de dados, selecione o tipo de dados Objetos de dados e, em seguida, escolha o Tipo de objeto de dados. As sincronizações de objetos de dados são compatíveis com Tabela e SQL.

Use esta sincronização para conectar usuários a registros de objetos de dados, como vincular usuários às contas a que pertencem. Crie o relacionamento na Braze antes de sincronizá-lo.

CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_USERS_SYNC (
    UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
    OBJECT_ID VARCHAR(16777216) NOT NULL,
    --at least one of external_id, alias_name and alias_label, email, or phone is required
    EXTERNAL_ID VARCHAR(16777216),
    --if using user alias, both alias_name and alias_label are required
    ALIAS_NAME VARCHAR(16777216),
    ALIAS_LABEL VARCHAR(16777216),
    EMAIL VARCHAR(16777216),
    PHONE VARCHAR(16777216),
    PAYLOAD VARCHAR(16777216),
    DELETED BOOLEAN
);
Nome do campo Tipo Modo
UPDATED_AT TIMESTAMP_NTZ 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 BOOLEAN 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.

  • UPDATED_AT - O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de object_id usado 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 for true, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou como false nas 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 de usuário com objetos de dados e, em seguida, escolha um Nome do relacionamento, como Usuário (Conta-Usuário).

Use esta sincronização para conectar registros de objetos de dados entre si, como vincular contas às respectivas contas principais. Crie o relacionamento na Braze antes de sincronizá-lo.

CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_SUBACCOUNTS_SYNC (
    UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
    OBJECT_ID VARCHAR(16777216) NOT NULL,
    RELATED_OBJECT_ID VARCHAR(16777216) NOT NULL,
    PAYLOAD VARCHAR(16777216),
    DELETED BOOLEAN
);
Nome do campo Tipo Modo
UPDATED_AT TIMESTAMP_NTZ REQUIRED
OBJECT_ID VARCHAR REQUIRED
RELATED_OBJECT_ID VARCHAR REQUIRED
PAYLOAD VARCHAR NULLABLE
DELETED BOOLEAN NULLABLE

OBJECT_ID é o registro de onde o relacionamento parte, e RELATED_OBJECT_ID é o registro para o qual ele aponta. Ambos 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 que UPDATED_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 de object_id usado 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 for true, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou como false nas 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, em seguida, escolha um Nome do relacionamento, como Subconta (Conta-Conta).

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 DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id or alias_name and alias_label is required
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     PROPERTIES VARCHAR(16777216)
);

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.
  • PROPERTIES substitui a coluna PAYLOAD. 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 que UPDATED_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_ID ou ALIAS_NAME e ALIAS_LABEL como 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 de external_id usado na Braze.
    • ALIAS_NAME e ALIAS_LABEL - Essas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador único, 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.
  • 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.

Conceda à função da Braze acesso a esta tabela:

GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

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 que UPDATED_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 de alias_name e alias_label, ou braze_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 de 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 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.
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, or braze_id is required
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216)
);

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 execução da integração. Para saber mais, consulte Excluir usuários com a ingestão de dados na nuvem.

Etapa 2: Configure a função e o warehouse

Etapa 2.1: Configure a função e as permissões do banco de dados

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Atualize os nomes conforme necessário, mas as permissões devem corresponder ao exemplo anterior.

Etapa 2.2: Configure o warehouse e dê acesso à função da Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Etapa 2.3: Permita os IPs da Braze na política de rede do Snowflake (opcional)

Dependendo da configuração da sua conta do Snowflake, talvez seja necessário permitir os seguintes endereços IP na sua política de rede do Snowflake. Para saber mais sobre como fazer isso, consulte a documentação relevante do Snowflake sobre como modificar uma política de rede.

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.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

Para a instância US-08, estes são os endereços IP relevantes:

  • 52.151.246.51
  • 52.170.163.182
  • 40.76.166.157
  • 40.76.166.170
  • 40.76.166.167
  • 40.76.166.161
  • 40.76.166.156
  • 40.76.166.166
  • 40.76.166.160
  • 40.88.51.74
  • 52.154.67.17
  • 40.76.166.80
  • 40.76.166.84
  • 40.76.166.85
  • 40.76.166.81
  • 40.76.166.71
  • 40.76.166.144
  • 40.76.166.145

Para a instância US-10, estes são os endereços IP relevantes:

  • 100.25.232.164
  • 35.168.86.179
  • 52.7.44.117
  • 3.92.153.18
  • 35.172.3.129
  • 50.19.162.19

Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

Para a instância AU-01, estes são os endereços IP relevantes:

  • 13.210.1.145
  • 13.211.70.159
  • 13.238.45.54
  • 52.65.73.167
  • 54.153.242.239
  • 54.206.45.213

Para a instância ID-01, estes são os endereços IP relevantes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para a instância JP-01, estes são os endereços IP relevantes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para a instância KR-01, estes são os endereços IP relevantes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60
  • 3.34.212.92
  • 54.116.134.231
  • 3.37.197.225

Etapa 3: Configure a autenticação

A Braze se conecta ao Snowflake como um usuário do Snowflake que tem a função da Etapa 2. Configure o usuário com um dos seguintes métodos de autenticação:

Método Como a Braze faz a autenticação O que você insere na Braze
Key pair authentication Braze generates an RSA key pair and connects as a Snowflake user that has the public key assigned. Username and Role

Key pair authentication

Com a autenticação por par de chaves, a Braze gera um par de chaves RSA quando você salva suas credenciais no dashboard da Braze. Você atribui a chave pública a um usuário do Snowflake que a Braze usa para se conectar.

Configure o usuário

Crie um usuário para a Braze e conceda a ele a função que você criou:

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Adicione a chave pública ao usuário

Conclua esta etapa depois de inserir suas credenciais no dashboard da Braze e selecionar Salvar credenciais. A Braze gera o par de chaves e exibe a chave pública. Adicione a chave pública ao usuário que você criou para a Braze:

ALTER USER BRAZE_INGESTION_USER SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BA...';

Para atribuir a chave, é necessário ter acesso SECURITYADMIN ou superior no Snowflake. Para saber mais, consulte a documentação do Snowflake.

Para fazer a rotação das chaves, acesse Gerenciamento de acesso a dados em Ingestão de dados na nuvem e selecione Gerar nova chave para a conta. Depois, atribua a nova chave pública ao usuário. Se você reutilizar o mesmo usuário e a mesma função em várias integrações, não será necessário adicionar a chave pública novamente.

Etapa 4: 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, em seguida, selecione Snowflake.

Etapa 4.1: Adicionar as informações de conexão do Snowflake

Escolha um nome para sua fonte e insira suas credenciais e configurações do Snowflake. Depois, avance para a próxima etapa. Selecione o método de autenticação que você configurou na Etapa 3 e insira as credenciais correspondentes:

Antes de continuar, confirme o valor que você inseriu em Snowflake Account Locator.

No campo Snowflake Account Locator, insira o identificador da conta do Snowflake. Insira apenas o valor do identificador da conta, como myorganization-myaccount. Não inclua https://, .snowflakecomputing.com nem nenhum caminho.

Para encontrar o identificador da sua conta do Snowflake:

  1. No Snowsight, selecione o menu da sua conta.
  2. Selecione View account details.
  3. Copie o valor de Account identifier.
  4. Se você copiar de um URL do Snowflake, use apenas o valor antes de .snowflakecomputing.com.

Etapa 4.2: Concluir a autenticação no Snowflake

Depois de inserir suas credenciais e configurações, selecione Salvar credenciais. Para a autenticação por par de chaves, a Braze gera um par de chaves RSA e exibe a chave pública. Volte ao Snowflake e adicione a chave pública ao usuário que você criou para a Braze.

Etapa 5: Crie 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.

Configure os detalhes da sincronização e defina 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. Por fim, selecione Prévia e validação.

Depois que a validação for concluída, aparecerá uma prévia dos dados. Selecione Próximo: Notificações para continuar. Se a validação falhar, aparecerá uma mensagem de erro para ajudar a solucionar o problema.

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.

Executar a sincronização

Depois de ativada, sua 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 sempre que 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 conta do Snowflake.

Se você reutilizar o mesmo usuário e a mesma função em várias integrações, não precisará adicionar a chave pública novamente.

Usar o Snowflake como fonte conectada

Uma fonte conectada é uma alternativa de cópia zero à sincronização de dados com a Braze. A Braze consulta sua instância do Snowflake diretamente 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: Criar uma função e conceder permissões

Crie uma função para a sua fonte conectada usar. Essa função é usada para gerar a lista de tabelas disponíveis nas suas extensões de segmento CDI e para consultar as tabelas de origem ao criar novos segmentos. Depois que a fonte conectada é criada, a Braze descobre os nomes e as descrições de todas as tabelas disponíveis para o usuário no esquema de origem.

Você pode conceder acesso a todas as tabelas de um esquema ou conceder privilégios apenas a tabelas específicas. Todas as tabelas às quais a função da Braze tem acesso ficam disponíveis para consulta na extensão de segmento CDI.

É necessário conceder a permissão create table para que a Braze possa criar uma tabela com os resultados da consulta da sua extensão de segmento CDI antes de atualizar o segmento na Braze. A Braze cria uma tabela temporária por segmento, e a tabela só existe enquanto a Braze atualiza o segmento.

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

A configuração do warehouse é igual à da Etapa 2.2, e a configuração da política de rede é igual à da Etapa 2.3. Configure o usuário com o qual a Braze se conecta usando um dos métodos da Etapa 3: Configurar a autenticação.

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 Snowflake.

Em Configurar fonte, informe o seguinte:

  • Credenciais: Localizador de conta e os campos do seu método de autenticação. Insira Username and Role.
  • Configuração: Warehouse, Banco de dados e Esquema

Para autenticação por par de chaves, se você estiver criando novas credenciais do Snowflake, selecione Salvar credenciais e gerar chave RSA antes de testar a conexão.

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 qualquer consulta que ultrapasse o tempo máximo de execução. O tempo máximo permitido é de 60 minutos. Um tempo menor reduz os custos gerados na sua conta do Snowflake. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Para autenticação por par de chaves, anote a chave pública RSA na etapa Testar conexão. Você vai precisar dela para concluir a integração no Snowflake.

Etapa 3: Finalizar a configuração do Snowflake

Para autenticação por par de chaves, adicione a chave pública que você anotou na etapa anterior ao seu usuário no Snowflake, conforme descrito em Adicionar a chave pública ao usuário. Isso permite que a Braze se conecte ao Snowflake.

Depois de concluir a autenticação no Snowflake, selecione Testar conexão na Braze 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 ser configurada para se conectar a um esquema diferente. Ao criar conexões adicionais, você pode reutilizar credenciais existentes se estiver se conectando à mesma conta do Snowflake. Se você reutilizar o mesmo usuário e a mesma função em várias integrações, não precisará adicionar a chave pública novamente.

Formatar uma carga útil a partir de colunas existentes

Se você preferir armazenar cada atributo em sua própria coluna internamente, será necessário converter essas colunas em uma string JSON para preencher a sincronização com a Braze. Use esta consulta no Snowflake para formatar as colunas de origem em campos do CDI.

CREATE TABLE "EXAMPLE_USER_DATA"
    (attribute_1 string,
     attribute_2 string,
     attribute_3 number,
     my_user_id string);

SELECT
    CURRENT_TIMESTAMP as UPDATED_AT,
    my_user_id as EXTERNAL_ID,
    TO_JSON(
        OBJECT_CONSTRUCT (
            'attribute_1',
            attribute_1,
            'attribute_2',
            attribute_2,
            'yet_another_attribute',
            attribute_3)
    )as PAYLOAD FROM "EXAMPLE_USER_DATA";

Para remover completamente um atributo em vez de defini-lo como null, use TO_JSON(OBJECT_CONSTRUCT_KEEP_NULL(...)).

Para saber mais sobre otimização, consulte 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 do warehouse pode deixá-lo mais rápido. Usar uma instância SQL serverless reduz o tempo de aquecimento e melhora o throughput das consultas. Porém, os custos de integração podem ficar um pouco mais altos.

Erro ao conectar à instância do Snowflake: Incoming request with IP is not allowed to access Snowflake

Tente adicionar os IPs oficiais da Braze à sua lista de permissões de IP. Para saber mais, consulte Permitir IPs da Braze na política de rede do Snowflake.

Erro ao executar SQL devido à configuração do cliente: 002003 (42S02): SQL compilation error: does not exist or not authorized

Se a tabela não existir, crie a tabela. Se a tabela existir, verifique se o usuário e a função têm permissões de leitura na tabela.

Could not use schema

Se você receber esse erro, conceda acesso a esse esquema para o usuário ou a função especificada.

Could not use role

Se você receber esse erro, permita que esse usuário use a função especificada.

User access disabled

Se você receber esse erro, conceda a esse usuário acesso à sua conta do Snowflake.

Erro ao conectar à instância do Snowflake com a chave atual e a antiga

Se você receber esse erro, confira se o usuário está usando a chave pública atual, conforme exibida no seu dashboard da Braze. Para fazer a rotação das chaves, consulte Adicionar a chave pública ao usuário.

Onde executar verificações de SQL

Execute as verificações de validação diretamente no editor SQL do Snowflake, na mesma tabela ou visualização usada pela sua integração de CDI. Acesse Projects > Worksheets. Para saber mais, consulte Snowflake Worksheets.

New Stuff!