Você está aqui:
Entender credenciais nomeadas, conexões e pipelines
Quando você cria um pipeline de dados no Marketing Intelligence, três componentes trabalham juntos para ingerir dados: Credencial nomeada, conexão e pipeline. Essa arquitetura separa autenticação, conectividade e processamento de dados para que você possa reutilizar credenciais e configurar pipelines de modo eficiente.
Credenciais nomeadas
Uma Credencial nomeada especifica os detalhes da autenticação e o ponto de extremidade para um sistema externo. Ele atua como uma configuração centralizada que os serviços fazem referência para que você não precise definir detalhes de autenticação sempre que criar uma conexão.
Uma Credencial nomeada geralmente inclui:
- O URL do ponto de extremidade do sistema externo
- O método de autenticação, como OAuth ou autenticação básica
- Credenciais necessárias, como tokens, nomes de usuário ou senhas
Conexões
Uma conexão vincula o Data Cloud a uma origem de dados externa. Ele define como o Data Cloud interage com o sistema de origem e prepara os dados para ingestão.
Uma conexão geralmente inclui:
- Configuração do conector para o sistema de origem
- Autenticação usando uma credencial nomeada
Pipelines
Um pipeline gerencia o fluxo de trabalho de ingestão e processamento de dados de ponta a ponta. Ele recupera dados da Conexão e os prepara para uso no Data Cloud.
Um pipeline lida com:
- Ingestão de dados do sistema de origem
- Transformação de dados
- Harmonização dos dados
- Carregando dados processados em objetos do Data Cloud
Relacionamentos de componente
| Relacionamento | Descrição |
|---|---|
| Credencial nomeada → Conexão | Uma Credencial nomeada pode ser usada por várias Conexões. |
| Credencial nomeada → Pipeline | Uma credencial nomeada pode dar suporte a vários pipelines. |
| Conexão → Pipeline | Cada conexão é associada a um pipeline. |
Como os componentes funcionam juntos
Quando um pipeline é executado:
- A Credencial nomeada fornece a autenticação e o ponto de extremidade para acessar o sistema externo.
- A Conexão usa essa credencial para estabelecer o vínculo entre o Data Cloud e a origem de dados externa.
- O Pipeline recupera dados por meio da conexão e realiza a ingestão, a transformação e o carregamento no Data Cloud.
Exemplo: Conectar várias contas do Google Ads
Suponha que você queira ingerir dados de três contas diferentes do Google Ads para sua organização. Em vez de configurar a autenticação três vezes, você pode:
- Crie uma Credencial nomeada chamada "Auth do Google Ads" que contenha seu token OAuth e o ponto de extremidade da API do Google Ads.
- Crie três conexões separadas, uma para cada conta, que fazem referência a "Autenticação do Google Ads" para autenticação.
- Crie três Pipelines, um por conexão, para ingerir, transformar e carregar dados da conta no Data Cloud.
Se o token de autenticação do Google Ads expirar, você precisará apenas atualizá-lo em um só lugar: a Credencial nomeada. Todas as três conexões e pipelines usam automaticamente a credencial atualizada sem exigir reconfiguração individual.
