[Ultimate]{class="badge positive"}
Snowflake origem
- A origem Snowflake está disponível no catálogo de origens para usuários que compraram o Real-Time Customer Data Platform Ultimate.
- Por padrão, a origem Snowflake interpreta
nullcomo uma cadeia de caracteres vazia. Entre em contato com o representante da Adobe para garantir que os valores denullsejam gravados corretamente comonullno Adobe Experience Platform. - Para que o Experience Platform assimile dados, os fusos horários de todas as fontes de lote baseadas em tabela devem ser configurados como UTC. O único carimbo de data/hora com suporte para a origem Snowflake é TIMESTAMP_NTZ com a hora UTC.
Snowflake é uma plataforma de data warehouse baseada em nuvem projetada para permitir que as organizações armazenem, processem e analisem grandes volumes de dados com eficiência. Criado para aproveitar a escalabilidade e a flexibilidade da nuvem, o Snowflake oferece suporte à integração de dados, à análise avançada e ao compartilhamento contínuo entre equipes. Como um serviço totalmente gerenciado, o Snowflake elimina as complexidades de manutenção comuns aos bancos de dados tradicionais, permitindo que você se concentre em obter insights e valor de seus dados.
Você pode usar a origem Snowflake para se conectar e trazer seus dados do Snowflake para a Adobe Experience Platform. Leia a documentação abaixo para saber como configurar sua origem do Snowflake e se conectar ao Experience Platform.
Pré-requisitos prerequisites
Esta seção descreve as tarefas de instalação que devem ser concluídas para que você possa conectar sua origem do Snowflake à Experience Platform.
INCLUO NA LISTA DE PERMISSÕES de endereços IP
Você deve adicionar endereços IP específicos da região ao incluo na lista de permissões antes de conectar suas fontes à Experience Platform. Para obter mais informações, leia o guia sobre como ler os endereços IP de incluir na lista de permissões para se conectar ao Experience Platform para obter mais informações.
Coletar credenciais necessárias
Você deve fornecer valores para as seguintes propriedades de credencial para autenticar sua origem Snowflake.
Forneça valores para as credenciais a seguir para conectar Snowflake ao Experience Platform no Azure usando a autenticação de chave de 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 |
account |
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: myorg-myaccount.snowflakecomputing.com. Leia a seção sobre recuperação do Snowflake identificador de conta para obter orientações adicionais. 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 Experience Platform. |
database |
O banco de dados Snowflake contém os dados que você deseja trazer para a Experience Platform. |
username |
O nome de usuário da conta Snowflake. |
password |
A senha da conta de usuário Snowflake. |
role |
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. |
connectionString |
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, gere primeiro um par de chaves RSA de 2048 bits. Em seguida, forneça valores para as credenciais a seguir para se conectar ao Experience Platform no Azure usando a autenticação de par de chaves.
| 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 |
account |
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: myorg-myaccount.snowflakecomputing.com. Leia a seção sobre recuperação do Snowflake identificador de conta para obter orientações adicionais. Para obter mais informações, consulte a Snowflake documentação. |
username |
O nome de usuário da sua conta Snowflake. |
privateKey |
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 a seção sobre recuperando sua chave privada para obter mais informações. |
privateKeyPassphrase |
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. |
port |
O número da porta usada por Snowflake ao se conectar a um servidor pela Internet. |
database |
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 Experience Platform. |
Para obter mais informações sobre esses valores, consulte o Snowflake guia de autenticação de par de chaves.
Forneça valores para as credenciais a seguir para conectar Snowflake ao Experience Platform no AWS usando a autenticação básica.
| note warning |
|---|
| WARNING |
| A autenticação básica (ou autenticação de chave de conta) para a origem Snowflake será substituída em novembro de 2025. Você deve migrar para a autenticação baseada em par de chaves para continuar usando a origem e assimilando dados do banco de dados para o Experience Platform. Para obter mais informações sobre a descontinuação, leia o Snowflake manual de práticas recomendadas sobre como mitigar os riscos de comprometimento de credenciais. |
| 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 |
host |
A URL de host à qual sua conta do Snowflake se conecta. |
port |
O número da porta usada por Snowflake ao se conectar a um servidor pela Internet. |
username |
O nome de usuário associado à sua conta Snowflake. |
password |
A senha associada à sua conta Snowflake. |
database |
O banco de dados Snowflake de onde os dados serão extraídos. |
schema |
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. |
Para usar a autenticação de par de chaves, gere primeiro um par de chaves RSA de 2048 bits. Em seguida, forneça valores para as credenciais a seguir para se conectar ao Experience Platform no AWS usando a autenticação de par de chaves.
| 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 |
account |
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: http://myorg-myaccount.snowflakecomputing.com/. 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. |
username |
O nome de usuário da sua conta Snowflake. |
privateKey |
A chave privada do usuário Snowflake, codificada em base64 como uma linha única sem cabeçalhos ou quebras de linha. Para prepará-lo, copie o conteúdo do arquivo PEM, remova as linhas BEGIN/END e todas as quebras de linha e, em seguida, codifique o resultado em base64. Leia a seção sobre recuperando sua chave privada para obter mais informações. Observação: chaves privadas criptografadas não têm suporte no momento para uma conexão AWS. |
port |
O número da porta usada por Snowflake ao se conectar a um servidor pela Internet. |
database |
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 Experience Platform. |
Para obter mais informações sobre esses valores, consulte o Snowflake guia de autenticação de par de chaves.
Recupere o identificador da sua conta retrieve-your-account-identifier
Você deve recuperar o identificador da conta no painel da interface do usuário do Snowflake, pois você o usará para autenticar sua instância do Snowflake no Experience Platform.
Para recuperar o identificador da conta:
- Use o Snowflake painel da interface do usuário do aplicativo para acessar sua conta.
- Na navegação à esquerda, selecione Accounts e, em seguida, selecione Active Accounts no cabeçalho.
- Em seguida, selecione o ícone de informações e selecione e copie o nome de domínio do URL atual.
Gerar seu par de chaves RSA
Use o OpenSSL na interface de linha de comando para gerar um par de chaves RSA de 2048 bits no formato PKCS#8. É uma prática recomendada criar uma chave privada criptografada para segurança, o que exigirá uma senha.
Para gerar sua chave privada Snowflake criptografada, execute o seguinte comando no terminal:
| code language-bash |
|---|
|
Para gerar sua chave privada Snowflake não criptografada, execute o seguinte comando no terminal:
| code language-bash |
|---|
|
Gerar uma chave pública a partir de sua chave privada
Em seguida, execute o seguinte comando na interface da linha de comando para criar uma chave pública com base na sua chave privada.
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub# You will be prompted to enter the passphrase if the private key is encrypted.
Atribuir a chave pública ao usuário Snowflake
Você precisa usar uma função de administrador Snowflake (como SECURITYADMIN) para associar a chave pública gerada ao usuário de serviço Snowflake que a Experience Platform usará. Para recuperar o conteúdo da chave pública, abra o arquivo rsa_key.pub e copie o conteúdo inteiro, excluindo as linhas -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY-----. Em seguida, execute o seguinte SQL em Snowflake:
ALTER USER {YOUR_SNOWFLAKE_USERNAME}>SET RSA_PUBLIC_KEY='{PUBLIC_KEY_CONTENT}';
Codificar a chave privada em Base64
O Experience Platform exige que a chave privada seja codificada em Base64 e fornecida como uma cadeia de caracteres durante a configuração da conexão. Use uma ferramenta ou um script adequado para codificar o conteúdo do arquivo rsa_key.p8 em uma única cadeia de caracteres Base64.
(-----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----), antes ou depois do processo de codificação, pois isso pode causar erros de autenticação.Verificar configurações
Antes de criar a conexão de origem Snowflake no Experience Platform, verifique se o Default Role e o Default Warehouse do usuário correspondem aos valores fornecidos no Experience Platform. Você pode verificar essas configurações na interface do usuário Snowflake usando o comando SQL DESCRIBE USER {USERNAME}.
Como alternativa, siga as etapas abaixo para verificar suas configurações:
- Selecione Admin na navegação à esquerda e Users & Roles.
- Selecione o usuário apropriado e, em seguida, selecione as reticências (
...) no canto superior direito. - Na janela Edit user que aparece, navegue até Default Role para exibir a função associada ao usuário fornecido.
- Na mesma janela, navegue até Default Warehouse para exibir o depósito associado ao usuário especificado.
Próximas etapas
Com a configuração concluída, você pode prosseguir para conectar a conta do Snowflake à Experience Platform. Leia a documentação a seguir para obter mais informações: