Connections: acesso reutilizável aos sistemas de dados

Objetivo e modelo

Connections centraliza definições reutilizáveis de conexão e seus estados. Uma definição reúne tipo de sistema, parâmetros e um método de autenticação compatível. Um item no catálogo não comprova conectividade, licenciamento nem dependências instaladas no worker de execução.

A definição e as credenciais armazenadas são conceitos relacionados, mas distintos. Um indicador de credencial configurada não revela o segredo nem comprova que ele continua válido no sistema externo.

Pré-requisitos

Você precisa de permissão para consultar Connections e da autorização correspondente para criar, editar, testar ou retirar credenciais. Prepare um sistema de laboratório autorizado, uma conta com privilégio mínimo e conectividade a partir do worker que executará o Mapping.

O catálogo de autenticação contempla métodos como usuário e senha, certificados, identidades gerenciadas, credenciais de cliente OAuth e chaves de API. As opções dependem do conector selecionado; não são alternativas equivalentes disponíveis para todas as famílias.

Autenticação e custódia seguem as opções oferecidas pelo conector. Passwordless utiliza uma identidade de execução; a custódia externa exige uma referência protegida resolvível no contexto autorizado. Revise consumidores antes de trocar, revogar ou excluir a conexão. Editar metadados difere de substituir credenciais.

Configurar e verificar uma conexão

1. Abra Connections. Pesquise e confira os filtros antes de criar uma conexão duplicada.
2. Inicie uma nova conexão e selecione o conector correspondente ao sistema real.
3. Informe nome e localização no repositório. Preencha host, banco de dados, endpoint ou outros campos exigidos pelo conector.
4. Escolha um método de autenticação compatível e informe segredos apenas nos campos específicos de credenciais.
5. Salve e corrija as validações de campo. Confira a confirmação; fechar o formulário não comprova que a operação foi concluída.
6. Execute o teste disponível e leia o resultado completo.
7. Se houver consulta de metadados, examine os objetos acessíveis à conta e confirme esquema e colunas.
8. Associe a conexão a um Mapping de laboratório e faça uma pequena leitura ou escrita autorizada em um destino exclusivo de teste.

Exemplo: extração limitada

Prepare uma tabela sintética com três registros e uma conta de origem somente para leitura. Configure a conexão de laboratório, teste-a e consulte os metadados. Crie um Mapping que leia apenas essa tabela e grave um arquivo de teste por meio de uma Session e de um worker compatível.

O resultado esperado contém três linhas com os mesmos valores sintéticos, exceto pelas transformações configuradas explicitamente. A escrita no banco de origem está fora deste exercício e não deve ser concedida para viabilizar o teste.

Para estudar uma falha, use uma definição temporária separada com um endpoint incorreto de laboratório. Registre a categoria do erro e restaure o endpoint. Não altere uma conexão compartilhada nem suas credenciais para provocar o problema.

Diagnóstico e recuperação

Separe falhas de rede, autenticação, autorização e esquema. Uma conta válida pode não ter acesso a uma tabela. Um host acessível pelo computador do navegador pode ser inacessível pelo worker. Verifique os drivers e as capacidades do conector nesse ambiente de execução.

Após trocar credenciais, repita o menor teste e a menor execução relevantes. Um resultado anterior não comprova acesso com o novo segredo. Para suporte, informe o identificador da conexão, a família do conector e uma mensagem sem dados sensíveis; não envie senhas, tokens, certificados privados ou referências internas de segredos.

Relações e limites

Consulte Mappings para formato e lógica, Sessions para contexto e Workers para conectividade. Os campos e limites específicos estão na referência de conectores; não suponha comportamento idêntico entre famílias.