[Ultimate]{class="badge positive"}
Criar uma conexão de origem Snowflake na interface
Este tutorial fornece etapas para a criação de um conector de origem Snowflake usando a interface do usuário do Adobe Experience Platform.
Introdução
Este tutorial requer um entendimento prático dos seguintes componentes do Experience Platform:
- Fontes: Experience Platform permite que os dados sejam assimilados de várias fontes e fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Platform.
- Sandboxes: Experience Platform fornece sandboxes virtuais que particionam uma única instância do Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
Coletar credenciais necessárias
Você deve fornecer valores para as seguintes propriedades de credencial para autenticar 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 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} |
Para usar 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 no 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 Snowflake.
PREVENT_UNLOAD_TO_INLINE_URL como FALSE para permitir o descarregamento de dados do banco de dados Snowflake para o Experience Platform.Conectar sua conta Snowflake
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 barra de pesquisa.
Na categoria Bancos de dados, selecione Snowflake e Adicionar dados.
A página Conectar-se ao Snowflake é exibida. Nesta página, você pode usar credenciais novas ou existentes.
Conta existente
Para usar uma conta existente, selecione a conta Snowflake à qual deseja se conectar e clique em Avançar para continuar.
Nova conta
Para criar uma nova conta, selecione Nova conta e forneça um nome e uma descrição opcional para sua nova conta Snowflake.
Para usar a autenticação de chave de conta, forneça sua cadeia de conexão no formulário de entrada e selecione Conectar à origem.
Para usar a 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.
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 Snowflake. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados para o Platform.