Transmita dados do seu Snowflake banco de dados para Experience Platform usando o interface
Aprenda a usar a interface do usuário para transmitir dados do seu Snowflake banco de dados para Adobe Experience Platform seguindo este guia.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual Experience Platform organiza experiência do cliente dados.
- Noções básicas de schema composição: conheça os elementos básicos dos esquemas XDM, incluindo princípios fundamentais e práticas recomendadas em schema composição.
- Tutorial de editor de esquema: saiba como criar esquemas personalizados usando o interface de editor de esquema.
-
Real-Time Customer Profile: fornece um perfil unificado do consumidor em tempo real com base em dados agregados de várias fontes.
Autenticação
Leia o guia sobre a configuração de pré-requisito para Snowflake transmitir dados para informações sobre as etapas que você precisa concluir antes de poder assimilar dados de streaming de Snowflake até Experience Platform.
Use a Snowflake Streaming fonte para transmitir Snowflake dados para Experience Platform
Na interface do Experience Platform, selecione Fontes na navegação esquerda para acessar o espaço de trabalho das Fontes . Você pode selecionar as categoria apropriadas 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 pesquisa.
Em Bancos de dados categoria, selecione Snowflake Streaming e selecione Adicionar dados.
A página de conta de transmissão do Connect Snowflake é exibida. Nesse 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 a 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 do usuário do seu Snowflake conta. |
| Senha | O senha ao seu Snowflake conta. |
| 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 comprovado, esse valor assumirá public. |
Para obter mais informações sobre conta criação, leia a seção sobre como configurar função configurações na Snowflake Streaming visão geral.
Para usar um conta existente, selecione Conta existente e selecione os conta desejados no catálogo de conta existente.
Selecione Próximo 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 de banco de dados à esquerda da tela e selecione a tabela que deseja importar para Experience Platform.
Próximo, selecione o tipo de coluna do carimbo de data e hora da tabela. Você pode selecionar entre dois tipos de colunas de carimbo de data e hora: TIMESTAMP_NTZ ou TIMESTAMP_LTZ. Se você selecionar um tipo de TIMESTAMP_NTZcoluna, você também deve 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 preenchimento retroativo configurações durante essa etapa. O preenchimento retroativo determina quais dados são inicialmente assimilados. Se preenchimento retroativo estiver habilitada, todos os arquivos atuais no caminho especificado serão assimilados durante a primeira ingestão programada. Caso contrário, apenas os arquivos carregados entre a primeira execução de ingestão e o start tempo serão assimilados. arquivos carregadas antes do horário start não serão ingeridas.
Selecione a opção Preenchimento retroativo para ativar o preenchimento retroativo.
Por fim, selecione Escolher arquivo para upload um dado de origem de amostra 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 conjunto de dados e detalhes do fluxo de dados provide-dataset-and-dataflow-details
Próximo, você deve fornecer informações sobre sua 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 ingeridos com êxito na Experience Platform são mantidos dentro do lago de dados como conjuntos de dados. Durante essa etapa, você pode criar uma nova conjunto de dados ou usar uma conjunto de dados existente.
Para usar uma nova 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 schema do Experience Data Model (XDM) ao qual seus conjunto de dados aderem.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| detalhes do conjunto de dados de Novo | Descrição |
| Nome do conjunto de dados de saída | O nome do seu 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 sua própria schema antes do processo de configuração de origem. Para obter mais informações, leia o guia sobre como criar um schema XDM no interface. |
Se você já tiver um conjunto de dados existente, selecione Conjunto de dados Existente e use a opção Avançado pesquisa para visualização uma janela de todos os conjuntos de dados em sua organização, incluindo seus respectivos detalhes, como se 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 na 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.
Experience Platform podem produzir alertas baseados em evento que os usuários podem subscrever. 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 na 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 de dataflow é revisar seu fluxo de dados antes de executá-lo. Use a etapa de revisão para analisar os detalhes do novo fluxo de dados antes de 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 > Mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo as schema às quais o conjunto de dados adere.
Depois de revisar seu fluxo de dados, selecione Concluir e permita que algum tempo do fluxo de dados seja criado.
Próximas etapas
Ao seguir esse tutorial, você criou com sucesso um fluxo de dados de transmissão para Snowflake dados. Para obter mais recursos, leia a documentação abaixo.
Monitore seu fluxo de dados
Após criar seu dataflow, você pode monitor os dados que estão sendo assimilados por ele para visualização informações sobre taxas de ingestão, sucesso e erros. Para obter mais informações sobre como monitor fluxos de dados de streaming, visita o tutorial sobre o monitoramento de dataflows de streaming no 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 nos Dataflows espaço de trabalho. Para obter mais informações sobre como excluir fluxos de dados, visita o tutorial sobre a exclusão de dataflows no interface.