Criar conexões connections-fdb
AVAILABILITY
Para acessar conexões, você precisará de uma das seguintes permissões:
-Gerenciar Banco de Dados Federado
>-Exibir Banco de Dados Federado
>-Exibir Banco de Dados Federado
Para mais informações sobre as permissões exigidas, leia o guia de controle de acesso.
A Composição de público-alvo federado do Experience Platform permite criar e enriquecer públicos-alvo de data warehouses de terceiros e importar os públicos-alvo para o Adobe Experience Platform.
Bancos de dados compatíveis supported-databases
Para trabalhar com o banco de dados federado e o Adobe Experience Platform, primeiro é necessário estabelecer uma conexão entre as duas fontes. Com a Federated Audience Composition, você pode se conectar aos seguintes bancos de dados.
- Amazon Redshift
- Azure Synapse Analytics
- Databricks
- Google BigQuery
- Microsoft Fabric
- Oracle
- Snowflake
- Vertica Analytics
Criar conexão create
Para criar uma conexão, selecione Federated databases na seção Federated data.
A seção Federated databases é exibida. Selecione Adicionar banco de dados federado para criar uma conexão.
O popover de propriedades da conexão é exibido. Você pode nomear sua conexão e selecionar o tipo de banco de dados que deseja criar.
Após selecionar um tipo, a seção Detalhes é exibida. Esta seção difere com base no tipo de banco de dados escolhido anteriormente.
Amazon Redshift
| note availability |
|---|
| AVAILABILITY |
| Somente o Amazon Redshift AWS, o Amazon Redshift Spectrum e o Amazon Redshift Serverless são suportados. |
Depois de selecionar Amazon Redshift, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Campo | Descrição |
| Servidor | O nome da fonte de dados. |
| Conta | O nome de usuário da conta. |
| Senha | A senha da conta. |
| Banco de dados | O nome do banco de dados. Se isso for especificado no nome do servidor, esse campo poderá ser deixado em branco. |
| Esquema de trabalho | O nome do esquema do banco de dados a ser usado para tabelas de trabalho. Mais informações sobre este recurso podem ser encontradas na documentação sobre esquemas do Amazon. Observação: você pode usar qualquer esquema do banco de dados, incluindo esquemas usados para processamento temporário de dados, desde que tenha as permissões necessárias para se conectar a este esquema. No entanto, você deve usar esquemas de trabalho distintos ao conectar várias sandboxes com o mesmo banco de dados. |
Azure Synapse Analytics
| note note |
|---|
| NOTE |
| Se você quiser criar uma conexão segura usando o Azure Synapse Analytics, entre em contato com o representante do Atendimento ao cliente da Adobe. |
Depois de selecionar o Azure Synapse Analytics, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Campo | Descrição |
| Servidor | O URL do servidor Azure Synapse. |
| Conta | O nome de usuário da conta do Azure Synapse. |
| Senha | A senha da conta do Azure Synapse. |
| Banco de dados | O nome do banco de dados. Se isso for especificado no nome do servidor, esse campo poderá ser deixado em branco. |
| Opções | Opções adicionais para a conexão. Para o Azure Synapse Analytics, você pode especificar o tipo de autenticação compatível com o conector. Atualmente, a Composição de Público Federado dá suporte a ActiveDirectoryMSI. Para obter mais informações sobre cadeias de conexão, leia a seção de exemplos de cadeias de conexão da documentação da Microsoft. |
Databricks
| note note |
|---|
| NOTE |
| Há suporte para o acesso seguro ao data warehouse externo do Databricks por meio de link privado. Isso inclui conexões seguras com bancos de dados do Databricks hospedados no Amazon Web Services (AWS) por meio de link privado e bancos de dados do Databricks hospedados no Microsoft Azure via VPN. Entre em contato com o representante da Adobe para obter assistência na configuração do acesso seguro. |
Depois de selecionar Databricks, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Campo | Descrição |
| Servidor | O nome do servidor Databricks. |
| Caminho HTTP | O caminho para o Cluster ou Warehouse. Para obter mais informações sobre o caminho, leia a documentação do Databricks sobre detalhes de conexão. |
| Senha | O token de acesso para o servidor Databricks. Para obter mais informações sobre esse valor, leia a documentação de Databricks sobre tokens de acesso pessoal. |
| Catálogo | O nome do Catálogo de Databricks. Para obter mais informações sobre catálogos em Databricks, leia a documentação sobre Databricks em catálogos |
| Esquema de trabalho | O nome do esquema de banco de dados a ser usado para as tabelas de trabalho. Observação: você pode usar o esquema any do banco de dados, incluindo esquemas usados para processamento temporário de dados, desde que tenha as permissões necessárias para se conectar a este esquema. No entanto, você deve usar esquemas de trabalho distintos ao conectar várias sandboxes com o mesmo banco de dados. |
| Opções | Opções adicionais para a conexão. As opções disponíveis estão listadas na tabela a seguir. |
Para Databricks, você pode definir as seguintes opções adicionais:
| table 0-row-2 1-row-2 | |
|---|---|
| Opções | Descrição |
| TimeZoneName | O nome do fuso horário a ser usado. Este valor representa o parâmetro de sessão TIMEZONE. Para obter mais informações sobre fusos horários, leia a documentação de Databricks sobre fusos horários. |
Google BigQuery
Depois de selecionar o Google BigQuery, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Campo | Descrição |
| Conta de serviço | O endereço de email da sua conta de serviço. Para obter mais informações, leia a documentação da conta do Google Cloud Service. |
| Projeto | A ID do seu projeto. Para obter mais informações, leia a documentação do projeto do Google Cloud. |
| Conjunto de dados | O nome do conjunto de dados. Para obter mais informações, leia a documentação do conjunto de dados da Google Cloud. |
| Caminho do arquivo de chave | O arquivo de chave para o servidor. Somente json arquivos são suportados. |
| Opções | Opções adicionais para a conexão. As opções disponíveis estão listadas na tabela a seguir. |
Para o Google BigQuery, você pode definir as seguintes opções adicionais:
| 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 8-row-2 | |
|---|---|
| Opções | Descrição |
| ProxyType | O tipo de proxy usado para se conectar ao BigQuery. Os valores suportados incluem HTTP, http_no_tunnel, socks4 e socks5. |
| ProxyHost | O hostname ou endereço IP onde o proxy pode ser alcançado. |
| ProxyUid | O número da porta em que o proxy está sendo executado. |
| ProxyPwd | A senha do proxy. |
| bgpath | Observação: aplicável somente para a ferramenta de carregamento em massa (Cloud SDK). O caminho para o diretório bin do Cloud SDK no servidor. Você só precisa definir isso se tiver movido o diretório google-cloud-sdk para outro local ou se não quiser usar a variável PATH. |
| GCloudConfigName | Observação: isso só é aplicável para a ferramenta de carregamento em massa (Cloud SDK) acima da versão 7.3.4. O nome da configuração que armazena os parâmetros para carregar os dados. Por padrão, este valor é accfda. |
| GCloudDefaultConfigName | Observação: isso só é aplicável para a ferramenta de carregamento em massa (Cloud SDK) acima da versão 7.3.4. O nome da configuração temporária para recriar a configuração principal para carregar dados. Por padrão, este valor é default. |
| GCloudRecreateConfig | Observação: isso só é aplicável para a ferramenta de carregamento em massa (Cloud SDK) acima da versão 7.3.4. Um valor booliano que permite decidir se o mecanismo de carregamento em massa deve recriar, excluir ou modificar automaticamente as configurações do Google Cloud SDK. Se esse valor estiver definido como false, o mecanismo de carregamento em massa carregará dados usando uma configuração existente na máquina. Se esse valor estiver definido como true, verifique se a configuração está definida corretamente; caso contrário, o erro No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option será exibido e o mecanismo de carregamento será revertido para o mecanismo de carregamento padrão. |
Malha do Microsoft
Depois de selecionar o Microsoft Fabric, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| Campo | Descrição |
| Servidor | O URL do servidor do Microsoft Fabric. |
| ID do aplicativo | A ID do aplicativo do Microsoft Fabric. Para obter mais informações sobre a ID do aplicativo, leia a documentação do Microsoft Fabric sobre a configuração do aplicativo. |
| Segredo do cliente | O segredo do cliente para o aplicativo. Para obter mais informações sobre o segredo do cliente, leia a documentação do Microsoft Fabric sobre a configuração do aplicativo. |
| Opções | Opções adicionais para a conexão. As opções disponíveis estão listadas na tabela a seguir. |
Para o Microsoft Fabric, você pode definir as seguintes opções adicionais:
| table 0-row-2 1-row-2 | |
|---|---|
| Opção | Descrição |
| Autenticação | O tipo de autenticação usado pelo conector. Os valores suportados incluem: ActiveDirectoryMSI. Para obter mais informações, leia a documentação do Microsoft sobre conectividade de warehouse. |
Oracle
| note important |
|---|
| IMPORTANT |
| O Federated Audience Composition é compatível com a configuração de conexão federada com bancos de dados do Oracle na versão 11g ou superior e hospedado no AWS, Azure, Exadata ou em uma nuvem privada (desde que seja acessível por uma rede externa). Se você tiver mais dúvidas relacionadas à configuração do banco de dados do Oracle ou precisar criar uma conexão segura com o Oracle, entre em contato com o representante do Atendimento ao cliente da Adobe. |
Depois de selecionar Oracle, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Campo | Descrição |
| Servidor | O URL do servidor Oracle. |
| Conta | O nome de usuário da conta. |
| Senha | A senha da conta. |
Snowflake
| note note |
|---|
| NOTE |
| Há suporte para o acesso seguro ao data warehouse externo do Snowflake por meio de link privado. Observe que a conta do Snowflake deve estar hospedada no Amazon Web Services (AWS) ou Azure e localizada na mesma região do ambiente da Composição de público-alvo federado. Entre em contato com o representante da Adobe para obter assistência na configuração do acesso seguro à conta do Snowflake. |
Depois de selecionar Snowflake, você pode adicionar os seguintes detalhes:
| 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 | |
|---|---|
| Campo | Descrição |
| Servidor | O nome do servidor. |
| Usuário(a) | O nome de usuário da conta. |
| Senha | A senha da conta. |
| Banco de dados | O nome do banco de dados. Se isso for especificado no nome do servidor, esse campo poderá ser deixado em branco. |
| Esquema de trabalho | O nome do esquema de banco de dados a ser usado para as tabelas de trabalho. Observação: você pode usar o esquema any do banco de dados, incluindo esquemas usados para processamento temporário de dados, desde que tenha as permissões necessárias para se conectar a este esquema. No entanto, você deve usar esquemas de trabalho distintos ao conectar várias sandboxes com o mesmo banco de dados. |
| Chave privada | A chave privada da conexão de banco de dados. Você pode carregar um arquivo .pem do seu sistema local. |
| Opções | Opções adicionais para a conexão. As opções disponíveis estão listadas na tabela a seguir. |
Para o Snowflake, você pode definir as seguintes opções adicionais:
| 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 | |
|---|---|
| Opções | Descrição |
| esquema de trabalho | O nome do esquema de banco de dados a ser usado para tabelas de trabalho. |
| TimeZoneName | O nome do fuso horário a ser usado. Este valor representa o parâmetro de sessão TIMEZONE. Por padrão, o fuso horário do sistema será usado. Para obter mais informações sobre fusos horários, leia a documentação do Snowflake sobre fusos horários. |
| WeekStart | O dia em que você deseja que a semana comece. Este valor representa o parâmetro de sessão WEEK_START. Para obter mais informações sobre o início da semana, leia a documentação do Snowflake sobre o parâmetro de início da semana |
| UseCachedResult | Um booleano que determina se os resultados em cache do Snowflake serão usados. Este valor representa o parâmetro de sessão USE_CACHED_RESULTS. Por padrão, esse valor está definido como verdadeiro. Para obter mais informações sobre esse parâmetro, leia a documentação do Snowflake sobre resultados persistentes. |
| bulkThreads | O número de threads a serem usados para o carregador em massa do Snowflake. Quanto mais threads forem adicionados, melhor será o desempenho para cargas em massa maiores. Por padrão, esse valor é definido como 1. |
| chunkSize | O tamanho do arquivo de cada parte do carregador em massa. Quando usado simultaneamente com mais threads, você pode melhorar o desempenho de seus carregamentos em massa. Por padrão, esse valor é definido como 128 MB. Para obter mais informações sobre tamanhos de partes, leia a documentação do Snowflake sobre preparação de arquivos de dados. |
| StageName | O nome de um ambiente de preparo interno pré-provisionado. Isso pode ser usado em carregamentos em massa em vez de criar um novo estágio temporário. |
Vertica Analytics
Depois de selecionar Vertica Analytics, você pode adicionar os seguintes detalhes:
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Campo | Descrição |
| Servidor | O URL do servidor Vertica Analytics. |
| Conta | O nome de usuário da conta. |
| Senha | A senha da conta. |
| Banco de dados | O nome do banco de dados. Se isso for especificado no nome do servidor, esse campo poderá ser deixado em branco. |
| Esquema de trabalho | O nome do esquema de banco de dados a ser usado para as tabelas de trabalho. Observação: você pode usar o esquema any do banco de dados, incluindo esquemas usados para processamento temporário de dados, desde que tenha as permissões necessárias para se conectar a este esquema. No entanto, você deve usar esquemas de trabalho distintos ao conectar várias sandboxes com o mesmo banco de dados. |
| Opções | Opções adicionais para a conexão. As opções disponíveis estão listadas na tabela a seguir. |
Para o Vertica Analytics, você pode definir as seguintes opções adicionais:
| table 0-row-2 1-row-2 | |
|---|---|
| Opções | Descrição |
| TimeZoneName | O nome do fuso horário a ser usado. Este valor representa o parâmetro de sessão TIMEZONE. Para obter mais informações sobre fusos horários, leia a documentação do Vertica Analytics sobre fusos horários |
Depois de adicionar os detalhes da conexão, observe as seguintes configurações adicionais:
NOTE
Para usar a Federated Audience Composition para um determinado banco de dados, você deve lista de permissões todos os endereços IP associados a esse banco de dados.
Configurações
Detalhes
Habilitar conexão
Um botão booleano que determina se a conexão será ativada automaticamente.
IPs do servidor
Incluir na lista de permissões Um popover que exibe quais endereços IP precisam ser resolvidos para se conectar ao banco de dados.
Testar conexão
Permite verificar os detalhes da configuração.
Agora você pode selecionar Implantar funções, seguido de Adicionar para finalizar a conexão entre o banco de dados federado e o Experience Platform.
recommendation-more-help
fadff0d9-29d0-4d44-99a6-2499b0b7778b