Troubleshooting en Power BI
Resolução de conflitos de permissões globais e corrupção de roteamento ('A chave não coincidiu') em Power Query.
Enquanto a limpeza do "cache de esquema" (documentada na seção 02) resolve problemas com colunas modificadas, às vezes enfrentamos quedas completas de conectividade que impedem até mesmo a visualização dos ambientes do Business Central.
Este documento detalha como diagnosticar e resolver a corrupção de credenciais globais no Power BI Desktop.
Incidente: "A chave não correspondeu a nenhuma linha da tabela"
Sección titulada «Incidente: “La clave no coincidió con ninguna fila de la tabla”»Sintoma
Sección titulada «Síntoma»Al intentar conectar por primera vez el conector visual nativo de Business Central en Power BI, o al intentar cambiar de entorno (ej. mover un reporte de Sandbox a Production), aparece el siguiente error crítico antes de poder desplegar las carpetas de las APIs:
Error: La clave no coincidió con ninguna fila de la tabla.(En inglés: The key didn't match any rows in the table)Diagnóstico Raiz (Global Permissions Mismatch)
Sección titulada «Diagnóstico Raíz (Global Permissions Mismatch)»Este erro não é um problema de código AL nem uma queda da API. É uma corrupção interna do motor de roteamento do Power Query (Navigation Path).
O Power BI guarda no nosso sistema operacional um cache de navegação fortemente vinculado ao nosso token OAuth do Azure AD. Se o nosso token expirar, se mudarmos de usuário no Windows, ou se tentarmos forçar uma atualização em um ambiente onde a nossa assinatura de segurança local já não concorda com a rota do Business Central guardada em cache, o Power BI não sabe como construir a árvore de pastas e lança a exceção "A chave não correspondeu".
Solução DevSecOps: Reset de Permissões de Fonte de Dados
Sección titulada «Solución DevSecOps: Reset de Permisos de Origen de Datos»Não basta reiniciar o Power BI; devemos destruir manualmente os direitos de acesso armazenados a nível global na nossa máquina local.
- En Power BI Desktop, vamos a la pestaña Archivo.
- Seleccionamos Opciones y configuración -> Configuración de origen de datos (Data source settings).
- En la ventana emergente, es vital asegurarnos de estar en la pestaña Permisos globales (Global permissions) y NO en “Orígenes de datos en el archivo actual”.
- Buscamos na lista qualquer entrada que contenha:
- Dynamics 365 Business Central
- Rutas que empiecen por https://api.businesscentral.dynamics.com...
- Referencias a OData relacionadas con nuestro tenant
- Seleccionamos cada una de estas entradas y pulsamos el botón Borrar permisos (Clear permissions) en la parte inferior.
- Confirmamos a exclusão na caixa de diálogo.
- Fechamos a janela de configurações.
Reconexão a Frio
Sección titulada «Reconexión en Frío»Una vez purgada la seguridad global, volvemos a pulsar en Obtener Datos y seleccionamos nuestra conexión a Business Central.
O sistema reconhecerá que não tem permissões guardadas e abrirá a janela pop-up de autenticação da Microsoft (OAuth2). Ao iniciar sessão novamente, será gerado um token limpo e a navegação através das pastas das APIs voltará a funcionar perfeitamente.
Checklist de Resolução de Problemas no Power BI
Sección titulada «Checklist de Resolución de Problemas en Power BI»- ✓ Depuración de Credenciales: Purga de la configuración de “Permisos Globales” para descartar tokens OAuth corruptos o expirados.
- ✓ Autenticación Limpia: Cierre forzado y reinicio de sesión de Microsoft Entra ID para regenerar tokens de lectura.
- ✓ Validación: Comprobación del correcto despliegue visual de carpetas analíticas en Power BI Desktop tras la reconexión.

