Transmitir dados do banco de dados Snowflake para o Experience Platform usando a interface
Saiba como usar a interface de usuário para transmitir dados do banco de dados do Snowflake para o Adobe Experience Platform seguindo este guia.
Introdução
Este tutorial requer um entendimento prático dos seguintes componentes do Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
Autenticação
Leia o guia na configuração de pré-requisito para Snowflake dados de streaming para obter informações sobre as etapas que devem ser concluídas antes de assimilar dados de streaming de Snowflake para o Experience Platform.
Usar a origem Snowflake Streaming para transmitir dados Snowflake para Experience Platform
Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
Na categoria Bancos de dados, selecione Snowflake Streaming e Adicionar dados.
A página Connect Snowflake Streaming account é exibida. Nesta página, você pode usar credenciais novas ou existentes.
Para criar uma nova conta, selecione Nova conta e forneça um nome, uma descrição opcional e suas credenciais.
Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Credencial | Descrição |
| Conta | O nome da sua conta Snowflake. Para convenções sobre nomes de conta, leia o Snowflake Streaming guia de autenticação. |
| Warehouse | O nome do warehouse Snowflake. Os depósitos gerenciam a execução de consultas em Snowflake. Cada warehouse Snowflake é independente um do outro e deve ser acessado individualmente para trazer dados para o Experience Platform. |
| Banco de dados | O nome do banco de dados Snowflake. O banco de dados contém os dados que você deseja trazer para o Experience Platform. |
| Esquema | (Opcional) O esquema de banco de dados associado à sua conta do Snowflake. |
| Nome de usuário | O nome de usuário da sua conta Snowflake. |
| Senha | A senha da sua conta Snowflake. |
| Função | (Opcional) Uma função definida personalizada que pode ser fornecida a um usuário para uma determinada conexão. Se não for fornecido, o padrão será public. |
Para obter mais informações sobre a criação de contas, leia a seção sobre definição das configurações de função na visão geral de Snowflake Streaming.
Para usar uma conta existente, selecione Conta existente e a conta desejada no catálogo de contas existente.
Selecione Avançar para continuar.
Selecionar dados select-data
-
Uma coluna de carimbo de data e hora deve existir na tabela de origem para que um fluxo de dados de transmissão seja criado. O carimbo de data e hora é necessário para que o Experience Platform saiba quando os dados serão assimilados e quando os dados incrementais serão transmitidos. Você pode adicionar retroativamente uma coluna de carimbo de data e hora para uma conexão existente e criar um novo fluxo de dados.
-
Verifique se o uso de letras maiúsculas e minúsculas nos campos de dados do arquivo de dados de origem de amostra está de acordo com as orientações de Snowflake sobre resolução de casos para identificadores. Leia o Snowflake documento sobre a capitalização do identificador para obter mais informações.
A etapa Selecionar dados é exibida. Nesta etapa, você deve selecionar os dados que deseja importar para o Experience Platform, configurar carimbos de data e hora e fusos horários e fornecer um arquivo de dados de origem de amostra para a assimilação de dados brutos.
Use o diretório do banco de dados à esquerda da tela e selecione a tabela que deseja importar para o Experience Platform.
Em seguida, selecione o tipo de coluna de carimbo de data e hora da tabela. Você pode selecionar entre dois tipos de colunas de carimbo de data/hora: TIMESTAMP_NTZ ou TIMESTAMP_LTZ. Se você selecionar um tipo de coluna de TIMESTAMP_NTZ, também deverá fornecer um fuso horário. Suas colunas devem ter uma restrição não nula. Para obter mais informações, leia a seção sobre [limitações e perguntas frequentes]
Você também pode definir configurações de preenchimento retroativo durante essa etapa. O preenchimento retroativo determina quais dados são assimilados inicialmente. Se o preenchimento retroativo estiver ativado, todos os arquivos atuais no caminho especificado serão assimilados durante a primeira assimilação agendada. Caso contrário, então somente os arquivos carregados entre a primeira execução da assimilação e a hora de início serão assimilados. Os arquivos carregados antes da hora de início não serão assimilados.
Selecione o botão Preenchimento retroativo para habilitar o preenchimento retroativo.
Finalmente, selecione Escolher arquivo para carregar dados de origem de exemplo para ajudar a criar o conjunto de mapeamento, que será usado em uma etapa posterior para mapear seus dados originais para o Experience Data Model (XDM).
Quando terminar, selecione Avançar para continuar.
Fornecer detalhes do conjunto de dados e do fluxo de dados provide-dataset-and-dataflow-details
Em seguida, você deve fornecer informações sobre seu conjunto de dados e seu fluxo de dados.
Detalhes do conjunto de dados dataset-details
Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, normalmente uma tabela, que contém um esquema (colunas) e campos (linhas). Os dados assimilados com sucesso no Experience Platform são mantidos no data lake como conjuntos de dados. Durante essa etapa, você pode criar um novo conjunto de dados ou usar um conjunto de dados existente.
Para usar um novo conjunto de dados, selecione Novo conjunto de dados e forneça um nome e uma descrição opcional para seu conjunto de dados. Você também deve selecionar um esquema do Experience Data Model (XDM) ao qual seu conjunto de dados adere.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Detalhes do novo conjunto de dados | Descrição |
| Nome do conjunto de dados de saída | O nome do novo conjunto de dados. |
| Descrição | (Opcional) Uma breve visão geral do novo conjunto de dados. |
| Esquema | Uma lista suspensa de esquemas que existem em sua organização. Você também pode criar seu próprio esquema antes do processo de configuração de origem. Para obter mais informações, leia o manual sobre criação de um esquema XDM na interface. |
Se você já tiver um conjunto de dados existente, selecione Conjunto de dados existente e use a opção Pesquisa avançada para exibir uma janela de todos os conjuntos de dados na sua organização, incluindo seus respectivos detalhes, como se eles estão habilitados para assimilação no Perfil do cliente em tempo real.
Se o seu conjunto de dados estiver habilitado para o Perfil de cliente em tempo real, durante essa etapa você poderá alternar para o conjunto de dados do perfil para habilitar seus dados para assimilação de perfil. Você também pode usar esta etapa para habilitar o Diagnóstico de erro e a Assimilação parcial.
- Diagnóstico de erro: selecione Diagnóstico de erro para instruir a origem a produzir o diagnóstico de erro que você poderá consultar posteriormente ao monitorar a atividade do conjunto de dados e o status do fluxo de dados.
- Assimilação parcial: a assimilação parcial de lotes é a capacidade de assimilar dados que contêm erros, até um determinado limite configurável. Esse recurso permite assimilar com sucesso todos os seus dados precisos no Experience Platform, enquanto todos os seus dados incorretos são armazenados em lote separadamente com informações sobre por que são inválidos.
Detalhes do fluxo de dados dataflow-details
Depois que o conjunto de dados é configurado, você deve fornecer detalhes sobre o fluxo de dados, incluindo um nome, uma descrição opcional e configurações de alerta.
O Experience Platform pode produzir alertas baseados em eventos que os usuários podem assinar. Essas opções exigem um fluxo de dados em execução para serem acionadas. Para obter mais informações, leia a visão geral dos alertas
- Início da Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação quando a execução do fluxo de dados começar.
- Êxito na Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação se o fluxo de dados terminar sem erros.
- Falha na execução do fluxo de dados de fontes: selecione este alerta para receber uma notificação se a execução do fluxo de dados terminar com erros.
Quando terminar, selecione Avançar para continuar.
Mapear campos para um esquema XDM mapping
A etapa Mapping é exibida. Use a interface de mapeamento para mapear os dados de origem para os campos de esquema apropriados antes de assimilar esses dados no Experience Platform e selecione Avançar. Para obter um guia abrangente sobre como usar a interface de mapeamento, leia o guia da interface do usuário do Preparo de Dados para obter mais informações.
Revisar seu fluxo de dados review
A etapa final no processo de criação do fluxo de dados é revisar o fluxo de dados antes de executá-lo. Use a etapa Revisão para revisar os detalhes do novo fluxo de dados antes de ele ser executado. Os detalhes estão agrupados nas seguintes categorias:
- Conexão: mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e o número de colunas nesse arquivo de origem.
- Atribuir campos de conjunto de dados e mapa: mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados pertence.
Depois de revisar o fluxo de dados, selecione Concluir e aguarde algum tempo para que o fluxo de dados seja criado.
Próximas etapas
Ao seguir este tutorial, você criou com êxito um fluxo de dados de transmissão para Snowflake dados. Para obter recursos adicionais, leia a documentação abaixo.
Monitorar seu fluxo de dados
Depois que o fluxo de dados for criado, você poderá monitorar os dados que estão sendo assimilados por meio dele para exibir informações sobre taxas de assimilação, sucesso e erros. Para obter mais informações sobre como monitorar fluxos de dados de transmissão, visite o tutorial em monitoramento de fluxos de dados de transmissão na interface.
Atualizar seu fluxo de dados
Para atualizar as configurações do agendamento de fluxos de dados, mapeamento e informações gerais, visite o tutorial em atualizando fluxos de dados de fontes na interface.
Excluir seu fluxo de dados
Você pode excluir fluxos de dados que não são mais necessários ou que foram criados incorretamente usando a função Excluir disponível no espaço de trabalho Fluxos de Dados. Para obter mais informações sobre como excluir fluxos de dados, visite o tutorial em excluindo fluxos de dados na interface.