Uma Connection separa endpoint, conector, método de autenticação e custódia protegida de credenciais da lógica de um Mapping. Os campos e métodos disponíveis dependem do conector escolhido. A presença de uma tecnologia no catálogo não comprova que um worker possua o driver, a conectividade ou as permissões necessárias.
Antes de começar
Prepare um recurso de laboratório autorizado, preferencialmente somente de leitura. Identifique o worker que realizará o teste e sua identidade de execução. Não inclua senhas, chaves nem referências sensíveis do Vault em descrições ou capturas.
Procedimento
- Abra Connections e crie um registro com nome que indique sua finalidade. Selecione o conector e examine os campos obrigatórios.
- Informe os metadados autorizados: host ou endpoint, porta, banco de dados, esquema ou recurso conforme o caso. Confirme os valores com o responsável pelo ambiente.
- Escolha um método de autenticação e um modo de custódia disponíveis. Passwordless usa uma identidade de execução; custódia externa exige uma referência protegida que possa ser resolvida. Não force métodos ocultos no formulário.
- Conclua o fluxo protegido, confira o tenant e salve. Verifique os metadados persistidos antes de testar.
- Use Test para a Connection salva e leia o resultado seguro. Depois execute uma extração pequena por um Mapping/Session em um worker compatível.
- Examine os consumidores antes de rotacionar, revogar ou excluir a Connection. Diferencie editar metadados de substituir credenciais.
Verificar o resultado
A Connection mostra apenas os metadados permitidos; o teste informa o estado esperado e uma leitura pequena produz o resultado conhecido. Compare os identificadores com o editor. Um teste bem-sucedido não certifica todos os modos de escrita, repetição ou recuperação.
Erros e recuperação
Em erros de autenticação, confira método, custódia, permissões e expiração. Para erros de rede, verifique DNS, TLS e saída de rede do worker. A ausência de driver exige revisar as capacidades instaladas. Mantenha mensagens seguras e nunca copie segredos para a descrição durante o diagnóstico.
Exemplo sintético
CustomerLabReadOnly acessa o banco sintético training e a tabela customers por uma identidade de leitura. Selecione-a no componente de origem adequado e confira dez registros conhecidos.
Contexto de ambiente
Antes de usar este módulo, confirme Tenant, Domain e Environment no menu do usuário. O ambiente inicial é Development. As capacidades do módulo, Domain e ambiente se aplicam juntas; Production fica somente leitura sem autorização explícita. Mudar o seletor não transfere artefatos nem publica ou executa seus dados. Consulte ambientes e recuperação e promoção entre ambientes.
Preparar Connections do destino
Antes de promover para Production, prepare Connections próprias do destino com custódia e permissões válidas. Um administrador autorizado pode registrá-las ou alterar metadados com etl.connections.manage e etl.environments.production.edit. Essa autorização específica não libera editores de Mapping, Session ou Workflow de Production. Connections legacy compartilhadas ou ambíguas continuam somente leitura.
Previews de promoção e Fork to Development oferecem somente Connections compatíveis já existentes no destino. Selecione cada substituição explicitamente; senhas não são copiadas e referências de segredos não são inventadas. Domain e Environment da Connection permanecem associados ao contexto proprietário.
Disponibilidade dos workers e carregamento da tela
Uma referência a um worker removido ou com identidade inválida não impede o acesso a Overview, Monitor ou Connections. Essa referência não fica disponível para execução; os workers válidos continuam visíveis conforme suas permissões. Uma falha real de armazenamento ou de política é informada como erro e não é convertida em um contador zero.