Federated Data Access (FDA)

Use o Conector FDA (Federated Data Access) para conectar o Campaign a um ou mais bancos de dados externos e processe as informações armazenadas nelas sem afetar os dados do banco de dados da Campaign Cloud. Em seguida, você pode acessar dados externos sem alterar a estrutura dos dados do Adobe Campaign.

OBSERVAÇÃO
  • Bancos de dados compatíveis com o FDA estão listados no Matriz de compatibilidade.

  • No contexto de um Implantação empresarial (FDA), uma conta externa específica está disponível para gerenciar a comunicação entre o banco de dados local do Campaign e o banco de dados da nuvem do Snowflake. Essa conta externa é configurada para você pelo Adobe e não deve ser modificada.

A opção FDA do Campaign permite estender o modelo de dados em um banco de dados de terceiros. Ele detectará automaticamente a estrutura das tabelas direcionadas e usará os dados das fontes SQL.

Específico permissões são necessárias em Adobe Campaign e no banco de dados externo para interagir. Saiba mais nesta seção.

Práticas recomendadas e limitações

  • Otimizar a personalização de email com dados externos

    Você pode pré-processar a personalização de mensagens em um workflow dedicado. Para fazer isso, use o Prepare the personalization data with a workflow , disponível na Analysis das propriedades de delivery.

    Durante a análise de delivery, essa opção cria e executa automaticamente um workflow que armazena todos os dados vinculados ao target em uma tabela temporária, incluindo dados de tabelas vinculadas em um banco de dados externo.

    Essa opção melhora significativamente o desempenho ao executar a etapa de personalização.

  • Limitações do FDA

    A opção FDA é feita para manipular os dados em bancos de dados externos em modo de lote em workflows. Para evitar problemas de desempenho, não é recomendável usar o módulo FDA no contexto de operações unitárias, como: personalização, interação, mensagens em tempo real etc.

    Evite o máximo possível as operações que precisam usar o banco de dados tanto do Adobe Campaign quanto externo. Para fazer isso, é possível:

    • Exportar o banco de dados do Adobe Campaign para o banco de dados externo e executar as operações somente do banco de dados externo antes de importar novamente os resultados para o Adobe Campaign.

    • Coletar os dados do banco de dados externo do Adobe Campaign e executar as operações no local.

    Se você quiser realizar a personalização de deliveries usando dados do banco de dados externo, colete os dados para usar em um workflow para torná-lo disponível em uma tabela temporária. Em seguida, use os dados da tabela temporária para personalizar seu delivery.

    A opção FDA está sujeita às limitações do sistema de banco de dados externo que você usa.

Etapas de configuração

Para configurar o acesso a um banco de dados externo com o FDA, as etapas de configuração são:

  1. Como usuário do Adobe Managed Services, entre em contato com o Adobe para instalar os drivers na instância do Campaign.
  2. Depois que os drivers forem instalados, configure a conta externa que corresponde ao banco de dados no servidor do Adobe Campaign e teste a conta externa. Saiba mais
  3. Criar o schema do banco de dados externo no Adobe Campaign. Isso permite identificar a estrutura de dados do banco de dados externo. Saiba mais

Observe que com o Campaign Implantação empresarial (FDA), não é possível criar um target mapping de um schema armazenado em um banco de dados externo acessado pelo FDA. Como consequência, os recipients dos seus deliveries não podem vir do banco de dados externo.

Conta externa do banco de dados externo

Você precisa criar uma conta externa específica para conectar a instância do Campaign ao banco de dados externo.

Para fazer isso, siga as etapas abaixo:

  1. Da campanha Explorer, navegue até Administration > Platform > External accounts.

  2. Clique em New.

    OBSERVAÇÃO

    Para estar ativo, a variável Enabled deve estar marcada. Se necessário, desmarque essa opção para desabilitar o acesso a esse banco de dados sem excluir sua configuração.

  3. Selecione External database como sua conta externa Type.

  4. Escolha o banco de dados externo na lista suspensa e configure a conta externa . Você deve especificar:

    • Server: URL do servidor

    • Account: Nome do usuário

    • Password: Senha da conta do usuário

    • Database: Nome do banco de dados

  5. Clique na guia Parameters e depois no botão Deploy functions para criar as funções.

  6. Quando os parâmetros forem inseridos, clique no botão Test the connection para aprová-los.

  7. Para permitir que o Adobe Campaign acesse esse banco de dados, você deve implantar as funções SQL. Clique na guia Parameters e depois no botão Deploy functions.

Você pode definir espaços de tabela de trabalho específicos para as tabelas e para o índice na guia Parameters.

Para Snowflake, o conector é compatível com as seguintes opções:

Opção Descrição
schema de trabalho schema de banco de dados que deve ser usado para tabelas de trabalho
depósito Nome do depósito padrão que deve ser usado. Ele substituirá o padrão do usuário.
TimeZoneName É vazio por padrão, o que significa que o fuso horário do sistema do servidor de aplicativos Campaign Classic é usado. A opção pode ser usada para forçar o parâmetro da sessão TIMEZONE.
Para obter mais informações, consulte esta página.
WeekStart Parâmetro de sessão WEEK_START. Por padrão, defina como 0.
Para obter mais informações, consulte esta página.
UseCachedResult Parâmetro de sessão USE_CACHED_RESULTS. Por padrão, defina como TRUE. Esta opção pode ser usada para desativar os resultados em cache do Snowflake.
Para obter mais informações, consulte esta página.

Criar o esquema de dados

Para criar o schema do banco de dados externo no Adobe Campaign, siga as etapas abaixo:

  1. Clique no botão New acima da lista dos schemas de dados e escolha Access external data.

  2. Insira um nome e uma descrição para o schema e selecione a conta externa que habilitará a conexão com o banco de dados. Isso permite o acesso à lista de tabelas disponíveis na base externa. Escolha a tabela que contém os dados a serem coletados.

  3. Clique em OK para confirmar. O Adobe Campaign detecta automaticamente a estrutura da tabela selecionada e gera o schema lógico. Observe que o Adobe Campaign não gera links.

  4. Clique em Save para confirmar a criação.

Permissões

Específico permissões são necessárias em Adobe Campaign e no banco de dados externo para interagir.

Primeiro, para que o usuário possa realizar operações em um banco de dados externo por meio do FDA, o operador deve ter um direito nomeado específico em Adobe Campaign.

  1. Selecione o nó Administration > Access Management > Named Rights no Adobe Campaign Explorer.

  2. Crie um novo direito especificando o rótulo escolhido.

  3. Insira o nome do direito Nomeado no seguinte formato usuário:base@server, onde :

    • usuário é o nome do usuário no banco de dados externo
    • base é o nome do banco de dados externo
    • server é o nome do servidor de banco de dados externo
  4. Salve o direito Nomeado e o vincule ao operador escolhido a partir do Administration > Access Management > Operators nó do explorador do Adobe Campaign.

Em seguida, para processar os dados contidos em um banco de dados externo, o operador do Adobe Campaign deve ter pelo menos permissões "Write" no banco de dados para poder criar worktables. Essas tabelas são excluídas automaticamente pelo Adobe Campaign.

As seguintes permissões são necessárias:

  • CONNECT: conexão ao banco de dados remoto
  • READ Data: acesso somente leitura a tabelas com dados do cliente
  • READ 'MetaData': acesso aos catálogos de dados do servidor para obter a estrutura da tabela
  • LOAD: carregamento em massa em tabelas de trabalho (necessário ao trabalhar em coleções e associações)
  • CREATE/DROP para TABLE/INDEX/PROCEDURE/FUNCTION (apenas para tabelas de trabalho geradas pelo Adobe Campaign)
  • EXPLICAR (recomendado): para monitorar desempenhos em caso de problema
  • WRITE Data (dependendo do cenário de integração)

O administrador do banco de dados precisa combinar esses direitos com os direitos específicos de cada mecanismo de banco de dados, conforme detalhado abaixo.

Snowflake Amazon Redshift
Conexão com o banco de dados remoto Privilégios de USAGE ON WAREHOUSE, USAGE ON DATABASE e USAGE ON SCHEMA Criar um usuário vinculado à conta AWS
Criar tabelas Privilégio CRIAR TABELA NO SCHEMA Privilégio CRIAR
Criar índices N/D Privilégio CRIAR
Criar funções Privilégio CRIAR FUNÇÃO NO SCHEMA Privilégio plpythonu USO EM IDIOMA para poder chamar scripts python externos
Criar procedimentos N/D Privilégio python USO EM IDIOMA para poder chamar scripts python externos
Remover objetos (tabelas, índices, funções, procedimentos) Propriedade do objeto Ter o objeto ou ser um superusuário
Monitoramento de execuções Privilégio MONITORAR no objeto necessário Não é necessário nenhum privilégio para usar o comando EXPLICAR
Gravação de dados Privilégios INSERIR e/ou ATUALIZAR (que depende da operação de gravação) Privilégios INSERIR e ATUALIZAR
Carregamento de dados em tabelas Privilégios CRIAR ETAPA NO SCHEMA, SELECIONAR e INSERIR na tabela do direcionamento Privilégios SELECIONAR e INSERIR
Acesso aos dados do cliente Privilégio(s) SELECIONAR em (FUTURO) TABELA(S) ou VISUALIZAÇÃO(es) Privilégio SELECIONAR
Acesso aos metadados Privilégio SELECIONAR no ESQUEMA de INFORMATION_SCHEMA Privilégio SELECIONAR

Usar dados externos em um workflow

Após a criação do schema de dados, é possível processar os dados nos workflows do Adobe Campaign.

Várias atividades permitem interagir com dados de um banco de dados externo:

  • Filtrar dados externos - O Query permite adicionar dados externos e usá-los nas configurações de filtro definidas.

  • Criar subconjuntos - O Split permite criar subconjuntos. Você pode usar dados externos para definir os critérios de filtragem a serem usados.

  • Carregar banco de dados externo - Você pode usar os dados externos no Data loading (RDBMS) atividade .

  • Adição de informações e links - O Enrichment permite adicionar dados adicionais à tabela de trabalho do workflow e criar links para uma tabela externa. Nesse contexto, é possível usar dados de um banco de dados externo.

Você também pode definir diretamente uma conexão com um banco de dados externo a partir dessas atividades de workflow, para um uso temporário. Nesse caso, ele estará em um banco de dados externo local, reservado para ser usado em um workflow atual, ou seja, não será salvo nas contas externas.

ATENÇÃO

Esse tipo de configuração deve ser usado apenas temporariamente para coletar dados. A configuração da conta externa deve ser preferida para qualquer outro uso.

Por exemplo, no Query , é possível definir uma conexão temporária com um banco de dados externo da seguinte maneira:

  1. Abra a atividade e clique no botão Add data…
  2. Selecione o External data opções
  3. Selecione o Locally defining the data source opção
  4. Selecione o mecanismo de banco de dados do Target na lista suspensa. Digite o nome do servidor e forneça os parâmetros de autenticação. Especifique também o nome do banco de dados externo.
  5. Selecione a tabela onde os dados estão armazenados. Você pode inserir o nome da tabela diretamente no campo correspondente ou clicar no ícone edição para acessar a lista das tabelas do banco de dados.
  6. Clique no botão Add para definir um ou vários campos de reconciliação entre os dados do banco de dados externo e os do banco de dados do Adobe Campaign. Os ícones Edit expression do Remote field e Local field fornecem acesso à lista de campos de cada uma das tabelas.
  7. Se necessário, especifique uma condição de filtragem e o modo de classificação de dados.
  8. Selecione os dados adicionais a serem coletados no banco de dados externo. Para fazer isso, clique duas vezes nos campos que deseja adicionar para exibi-los nas Output columns.
  9. Clique em Finish para confirmar essa configuração.

Nesta página