12. Erros e conexões de atalhos OneLake

Vários atalhos falham ao mesmo tempo depois de uma rotação de segredo. A causa pode estar na conexão compartilhada, e não em cada tabela. Diagnosticar atalhos exige distinguir referência, credencial, autorização e disponibilidade da origem.

Referência e caminho real

O atalho aponta para um local. Renomear ou mover a pasta ou tabela de origem pode tornar o endereço inválido. Autenticar com sucesso não demonstra que o caminho antigo ainda existe. Compare a referência com a localização atual antes de recriar o item inteiro.

Formato e contexto também importam. Uma pasta acessível não é necessariamente uma tabela reconhecida pelo consumidor. Verifique estrutura Delta quando aplicável, posição do atalho e suporte da experiência. Um erro de reconhecimento não deve ser tratado automaticamente como problema de senha.

Uma mudança de nome na origem pode manter a autenticação funcionando e quebrar apenas a resolução do caminho. Por isso, a mensagem de acesso deve ser interpretada com o contexto da alteração recente. Verifique o endereço real e se ele aponta para o mesmo conjunto esperado. Corrigir para qualquer pasta acessível pode eliminar o erro e entregar a versão errada. A validação precisa incluir conteúdo conhecido, não somente a abertura bem-sucedida do objeto.

Conexão e permissões

A conexão reúne informações de acesso usadas pelo atalho conforme sua modalidade. Criar ou vincular um novo atalho pode exigir permissão sobre essa conexão. Conseguir ler a origem por outra ferramenta ou identidade não prova autorização para usar o objeto de conexão do Fabric.

Na rotação de segredo, identifique todos os consumidores da conexão. Uma falha simultânea em vários atalhos com a mesma dependência é uma pista forte. Corrigir a conexão pode recuperar o conjunto sem alterar cada referência, preservando a organização e a rastreabilidade dos itens.