Ir al contenido

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.

0lecturas

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”»

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.

  1. En Power BI Desktop, vamos a la pestaña Archivo.
  2. Seleccionamos Opciones y configuración -> Configuración de origen de datos (Data source settings).
  3. 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”.
  4. 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
  5. Seleccionamos cada una de estas entradas y pulsamos el botón Borrar permisos (Clear permissions) en la parte inferior.
  6. Confirmamos a exclusão na caixa de diálogo.
  7. Fechamos a janela de configurações.

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.