Perguntas frequentes

Esta página contém respostas para algumas perguntas frequentes sobre a ingestão de dados na nuvem.

Por que me enviaram um e-mail: “Erro na sincronização do CDI”?

Esse tipo de e-mail geralmente significa que há um problema com sua configuração de CDI. Aqui estão alguns problemas comuns e como corrigi-los:

O CDI não pode acessar o data warehouse ou a tabela usando suas credenciais

Isso pode significar que as credenciais no CDI estão incorretas ou mal configuradas no data warehouse. Para obter mais informações, consulte Integrações de Data Warehouse.

A tabela não pode ser encontrada

Tente atualizar sua integração com a configuração correta do banco de dados ou criar recursos correspondentes no data warehouse, como database/table.

O catálogo não pode ser encontrado

O catálogo configurado na integração não existe no catálogo do Braze. Um catálogo pode ser removido depois que a integração foi configurada. Para resolver o problema, atualize a integração para usar um catálogo diferente ou crie um novo catálogo que corresponda ao nome do catálogo na integração.

Por que me enviaram um e-mail: “Erros de linha em sua sincronização de CDI”?

Esse tipo de e-mail significa que alguns de seus dados não puderam ser processados durante a sincronização. Para descobrir o erro específico, você pode revisar os registros no Braze acessando CDI > Sync Log.

Como faço para corrigir erros na conexão de teste e nos e-mails de suporte?

A conexão de teste é lenta

O Test Connection está sendo executado em seu data warehouse, portanto, aumentar a capacidade do warehouse pode melhorar sua velocidade. O uso de uma instância de SQL sem servidor minimizará o tempo de aquecimento e melhorará o rendimento da consulta, mas poderá resultar em custos de integração um pouco mais altos.

Erro ao conectar-se à instância do Snowflake: A solicitação de entrada com IP não tem permissão para acessar o Snowflake

Tente adicionar os IPs oficiais do Braze à sua lista de permissões de IP. Para obter mais informações, consulte Integrações do Data Warehouse ou permita os IPs relevantes:

Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, esses 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

Por exemplo 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

Por exemplo 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, esses 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

Por exemplo 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

Por exemplo 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

Erro ao executar o SQL devido à configuração do cliente: 002003 (42S02): Erro de compilação SQL: não existe ou não está autorizado

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ão para ler a tabela.

Não foi possível usar o esquema

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

Não foi possível usar a função

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

Acesso do usuário desativado

Se receber esse erro, permita que o usuário tenha acesso à sua conta do Snowflake.

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

Se você receber esse erro, verifique se o usuário está usando a chave pública atual, conforme exibido no painel do Braze.

A conexão de teste é lenta

Permissão negada para a relação {table_name}

Se você receber esse erro:

Conceda a permissão usage no esquema para esse usuário.
Conceda a permissão select na tabela para esse usuário.

Erro ao criar conexão

Se você receber esse erro, verifique se o ponto de extremidade e a porta do Redshift estão corretos.

Erro ao criar túnel SSH

Se você receber esse erro:

Verifique se a chave pública em seu painel do braze está no host ec2 usado para o tunelamento SSH.
Verifique se o seu nome de usuário está correto.
Verifique se o túnel SSH está correto.

A conexão de teste é lenta

O usuário não tem permissão para consultar a tabela

Se receber esse erro, adicione permissões de usuário para consultar a tabela.

Seu uso excedeu a cota personalizada

Se você receber esse erro, sua cota precisará ser atualizada para que você possa continuar a sincronização na taxa atual.

A tabela não foi encontrada no local {region} Local

Se você receber esse erro, verifique se a tabela está no projeto e no conjunto de dados corretos.

Assinatura JWT inválida

Se você receber esse erro, verifique se o serviço da API do BigQuery está ativado para sua conta.

A conexão de teste é lenta

O Test Connection está sendo executado em seu data warehouse, portanto, aumentar a capacidade do warehouse pode melhorar sua velocidade. Para o Databricks, pode haver de dois a cinco minutos de tempo de aquecimento quando o Braze se conectar às instâncias Classic e Pro SQL, o que causará atrasos durante a configuração e o teste da conexão, bem como no início das sincronizações programadas. O uso de uma instância de SQL sem servidor minimizará o tempo de aquecimento e melhorará o rendimento da consulta, mas poderá resultar em custos de integração um pouco mais altos.

O comando falhou porque o depósito foi interrompido

Se você receber esse erro, verifique se o Databricks warehouse está em execução.

Serviço: Amazon S3; Código de status: 403; Código de erro: 403 Proibido

Se você receber esse erro, consulte Databricks: Erro proibido ao acessar dados do S3.

Como faço para atualizar minhas preferências de alerta por e-mail para integrações CDI?

Cada integração tem sua própria preferência de notificação. Vá para a página CDI e selecione o nome da integração que deseja atualizar. Na seção Notification preferences (Preferências de notificação ), é possível atualizar a forma como você recebe alertas referentes à integração selecionada.

O que acontecerá se um futuro UPDATED_AT for sincronizado com uma integração?

O CDI usa o site UPDATED_AT para decidir quais dados são novos. Depois que um UPDATED_AT futuro for sincronizado, todos os dados anteriores a essa data e hora futuras não serão processados. Para corrigir isso:

Correto UPDATED_AT.
Remover todos os dados antigos que já foram sincronizados com o Braze
Crie uma nova integração para processar essa tabela novamente.

Por que “Rows Synced” (Linhas sincronizadas) não corresponde ao número em meu depósito?

O CDI usa o site UPDATED_AT para decidir quais registros devem ser coletados durante uma sincronização. Dê uma olhada nesta ilustração para ver como funciona. No início de uma execução de sincronização, o CDI consulta o seu depósito para obter todos os registros com UPDATED_AT igual ou posterior ao carimbo de data/hora UPDATED_AT processado anteriormente. Qualquer registro coletado no momento em que a consulta for executada será sincronizado com o Braze. Aqui estão os casos comuns em que um registro pode não ser sincronizado:

Você está adicionando registros à tabela com um valor UPDATED_AT que já foi processado.
Você está atualizando os valores de registro depois que eles foram processados por uma sincronização, mas deixando o site UPDATED_AT inalterado.
Você está adicionando ou atualizando registros enquanto uma sincronização está em andamento. Dependendo de quando a consulta CDI é executada, pode haver condições de corrida que fazem com que os registros não sejam coletados.

tip:

Para evitar esses comportamentos no futuro, recomendamos usar valores UPDATED_AT que aumentem monotonicamente e não atualizar a tabela durante a execução da sincronização agendada.

Durante uma sincronização, a ordem é preservada se vários registros tiverem o mesmo ID?

A ordem de processamento não é 100% previsível. Por exemplo, se houver várias linhas com o mesmo EXTERNAL_ID na tabela durante uma sincronização, não poderemos garantir qual valor será incluído no perfil final. Se você estiver atualizando o mesmo EXTERNAL_ID com atributos diferentes na coluna de carga útil, todas as alterações serão refletidas quando a sincronização for concluída.

Quais são as medidas de segurança do CDI?

Nossas medidas

A Braze tem as seguintes medidas em vigor para CDI:

Todas as credenciais são criptografadas em nosso banco de dados, e somente determinados funcionários têm acesso autenticado a elas.
Usamos conexões criptografadas para levar os dados aos armazéns dos clientes.
Fazemos solicitações aos endpoints da API do Braze usando as mesmas chaves de API e conexões TLS que recomendamos que nossos clientes usem.
Atualizamos regularmente nossas bibliotecas e recebemos todos os patches de segurança.

Suas medidas

Recomendamos que você e sua equipe configurem as seguintes medidas de segurança:

Restringir o acesso às credenciais ao mínimo necessário para o funcionamento da CDI. Isso se deve ao fato de que precisamos ser capazes de executar a seleção (e a contagem) nas tabelas e exibições específicas.
Restringir os IPs que podem acessar as tabelas aos IPs do Braze publicados oficialmente.

Editar esta página no GitHub

New Stuff!