[Ultimate]{class="badge positive"}

Conectar o Snowflake ao Experience Platform usando a interface

IMPORTANT
A origem Snowflake está disponível no catálogo de origens para usuários que compraram o Real-Time Customer Data Platform Ultimate.

Leia este guia para saber como conectar sua conta do Snowflake à Adobe Experience Platform usando a interface do usuário.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Experience Platform:

  • Fontes: o Experience Platform permite a assimilação de dados de várias fontes, ao mesmo tempo em que fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Platform.
  • Sandboxes: a Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
NOTE
Você deve definir o sinalizador PREVENT_UNLOAD_TO_INLINE_URL como FALSE para permitir o descarregamento de dados do banco de dados Snowflake para o 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.

Selecione Snowflake na categoria Bancos de dados e selecione Configurar.

TIP
As origens no catálogo de origens exibem a opção Configurar quando uma determinada origem ainda não tem uma conta autenticada. Quando uma conta autenticada existir, esta opção será alterada para Adicionar dados.

O catálogo de origens com o cartão Snowflake selecionado..

Usar uma conta existente existing

Em seguida, você é levado à etapa de autenticação do workflow de origens. Aqui, você pode usar uma conta existente ou criar uma nova conta.

Para usar uma conta existente, selecione a conta Snowflake à qual deseja se conectar e clique em Avançar para continuar.

A interface de conta existente no fluxo de trabalho de origens.

Criar uma nova conta create

Se você não tiver uma conta existente, deverá criar uma nova conta fornecendo as credenciais de autenticação necessárias que correspondam à sua origem.

Para criar uma nova conta, selecione Nova conta e forneça um nome e, opcionalmente, adicione uma descrição para sua conta.

Conectar-se ao Experience Platform no Azure azure

Você pode conectar sua conta do Snowflake ao Experience Platform no Azure usando a autenticação de chave de conta ou a autenticação de par de chaves.

Autenticação da chave da conta

Para usar a autenticação de chave de conta, selecione Autenticação de chave de conta, forneça sua cadeia de conexão no formulário de entrada e selecione Conectar à origem.

A interface de autenticação da chave da conta.

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 Um nome de conta identifica exclusivamente uma conta na organização. Nesse caso, você deve identificar exclusivamente uma conta em diferentes organizações do Snowflake. Para fazer isso, você deve anexar o nome da organização ao nome da conta. Por exemplo: orgname-account_name. Leia o guia em recuperando seu Snowflake identificador de conta para obter orientação adicional. Para obter mais informações, consulte a Snowflake documentação.
Warehouse O warehouse Snowflake gerencia o processo de execução da consulta para o aplicativo. Cada warehouse Snowflake é independente um do outro e deve ser acessado individualmente ao trazer dados para a plataforma.
Banco de dados O banco de dados Snowflake contém os dados que você deseja trazer para a Plataforma.
Nome de usuário O nome de usuário da conta Snowflake.
Senha A senha da conta de usuário Snowflake.
Função A função de controle de acesso padrão a ser usada na sessão Snowflake. A função deve ser uma função existente que já foi atribuída ao usuário especificado. A função padrão é PUBLIC.
String de conexão A cadeia de conexão usada para se conectar à sua instância do Snowflake. O padrão da cadeia de conexão para Snowflake é jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}
Autenticação de par de chaves

Para usar a autenticação de par de chaves, selecione Autenticação de par de chaves, forneça valores para sua conta, nome de usuário, chave privada, senha de chave privada, banco de dados e warehouse e selecione Conectar à origem.

A interface de autenticação de par de chaves da conta.

Com a autenticação de par de chaves, você deve gerar um par de chaves RSA de 2048 bits e fornecer os seguintes valores ao criar uma conta para sua origem Snowflake.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Credencial Descrição
Conta Um nome de conta identifica exclusivamente uma conta na organização. Nesse caso, você deve identificar exclusivamente uma conta em diferentes organizações do Snowflake. Para fazer isso, você deve anexar o nome da organização ao nome da conta. Por exemplo: orgname-account_name. Leia o guia em recuperando seu Snowflake identificador de conta para obter orientação adicional. Para obter mais informações, consulte a Snowflake documentação.
Nome de usuário O nome de usuário da sua conta Snowflake.
Chave privada A chave privada Base64-codificada da sua conta Snowflake. Você pode gerar chaves privadas criptografadas ou não. Se você estiver usando uma chave privada criptografada, também deverá fornecer uma senha de chave privada ao autenticar no Experience Platform. Leia o guia em recuperando sua Snowflake chave privada para obter mais informações.
Senha da chave privada A senha da chave privada é uma camada adicional de segurança que deve ser usada ao autenticar com uma chave privada criptografada. Não é necessário fornecer a senha se você estiver usando uma chave privada não criptografada.
Banco de dados O banco de dados Snowflake que contém os dados que você deseja assimilar na Experience Platform.
Warehouse O warehouse Snowflake gerencia o processo de execução da consulta para o aplicativo. Cada warehouse Snowflake é independente um do outro e deve ser acessado individualmente ao trazer dados para a plataforma.

Para obter mais informações sobre esses valores, consulte este documento do Snowflake.

Conectar-se ao Experience Platform no AWS aws

AVAILABILITY
Esta seção se aplica às implementações do Experience Platform em execução no Amazon Web Services (AWS). O Experience Platform em execução no AWS está disponível atualmente para um número limitado de clientes. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.

Para criar uma nova conta do Snowflake e conectar-se ao Experience Platform no AWS, verifique se você está em uma sandbox VA6 e forneça as credenciais necessárias para autenticação.

A nova etapa da conta no fluxo de trabalho de origens, na qual você pode conectar o Snowflake ao Experience Platform no AWS.

Credencial
Descrição
Host
A URL de host à qual sua conta do Snowflake se conecta.
Porta
O número da porta usada por Snowflake ao se conectar a um servidor pela Internet.
Nome de usuário
O nome de usuário associado à sua conta Snowflake.
Senha
A senha associada à sua conta Snowflake.
Banco de dados
O banco de dados Snowflake de onde os dados serão extraídos.
Esquema
O nome do esquema associado ao banco de dados Snowflake. Você deve garantir que o usuário ao qual deseja conceder acesso ao banco de dados também tenha acesso a esse esquema.
Warehouse
O warehouse Snowflake que você está usando.

Ignorar pré-visualização de dados de amostra skip-preview-of-sample-data

Durante a etapa de seleção de dados, você pode encontrar um tempo limite ao assimilar tabelas ou arquivos de dados grandes. Você pode ignorar a visualização de dados para contornar o tempo limite e ainda visualizar o esquema, embora sem dados de amostra. Para ignorar a visualização de dados, habilite a opção Ignorar visualização de dados de amostra.

O restante do workflow permanecerá o mesmo. O único problema é que ignorar a pré-visualização de dados pode impedir que campos calculados e obrigatórios sejam validados automaticamente durante a etapa de mapeamento e, em seguida, será necessário validar manualmente esses campos durante o mapeamento.

Próximas etapas

Ao seguir este tutorial, você estabeleceu uma conexão com sua conta da Snowflake. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados para o Platform.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089