TMDL no Power BI: revise metadados do modelo com segurança

TMDL no Power BI descreve metadados de modelos tabulares em forma textual. A visão TMDL do Desktop ajuda a gerar scripts para objetos como tabelas, medidas e colunas, revisar suas definições e aplicar mudanças. Isso pode ajudar equipes que precisam inspecionar propriedades ou repetir um ajuste. A linguagem não substitui entendimento do modelo: nomes, relações, expressões e dependências precisam continuar coerentes com as regras da empresa. Trate cada script como mudança que merece revisão, teste e forma de retorno.

Separe TMDL de PBIP e da experiência de edição

O formato de projeto PBIP organiza partes do relatório e do modelo em arquivos, o que pode ajudar controle de versão e trabalho em equipe quando a empresa adota esse fluxo. TMDL é a linguagem usada para representar metadados; a visão TMDL é a experiência de edição dentro da ferramenta. São conceitos ligados, mas não iguais. Verifique quais formatos e recursos estão habilitados na instalação. A documentação explica onde scripts da visão podem ser salvos e como isso se relaciona ao projeto.

Não transforme uma explicação de formato em regra de publicação. A empresa pode ter requisitos próprios de licença, preview ou repositório. Registre a versão do Desktop, do projeto e do modo usado no teste.

Comece por cópia e objetivo

Antes de editar, registre o problema e o objeto que será alterado. Salve uma cópia ou use uma branch controlada pelo processo. Escolha uma mudança pequena, como ajustar descrição ou propriedade, e compare com a versão inicial. Para tarefa de risco, peça revisão. Um script curto não é automaticamente seguro: pode modificar mais objetos do que o autor pretendia, sobretudo quando inclui dependências.

Defina resultado esperado antes de abrir o editor. Se o alvo é corrigir nome, não aprove alterações de expressão que surgiram junto sem explicação. Mantenha referência ao pedido e à pessoa que validou.

Gere o script do objeto certo

No Desktop, a visão pode gerar TMDL quando objetos do painel de dados são levados ao editor. Confirme que selecionou tabela, medida ou conjunto de propriedades correto. Leia o script inteiro antes de aplicar. Verifique nomes, caracteres, relações e expressões mantidas. Se houver operação de criação ou substituição, entenda seu escopo e teste no modelo de desenvolvimento. Não copie exemplo de outro arquivo sem conferir diferença de versão e dependências.

Faça inventário de objetos no script e compare com a tarefa. Uma alteração em coluna pode afetar medida, hierarquia, visual e consumidor externo. Nome semelhante não garante que se trata do objeto certo.

Faça mudanças pequenas e reversíveis

Agrupe alterações com uma finalidade comum. Um ajuste de descrição é fácil de comparar; uma reescrita de medidas, relações e hierarquias exige mais testes. Salve o script com nome que explique a tarefa. Mantenha versão anterior e registre autor, data e motivo. Quando possível, revise diferença linha a linha. A revisão textual encontra propriedades que uma inspeção visual do relatório pode não mostrar.

Se a aplicação falhar, não prossiga com mudanças adicionais até entender a causa. Volte à cópia conhecida e separe a tarefa em partes menores. Mudança reversível diminui o custo de investigar um efeito imprevisto.

Valide sintaxe e comportamento

Aplicar sem erro de sintaxe não prova que os números estão corretos. Depois, atualize ou consulte o modelo, valide medidas afetadas e compare visuais de referência. Teste sem filtro, com filtro restrito e no total geral. Confira campos escondidos, formatos e nomes usados por relatórios. Se um campo foi renomeado, procure referências em medidas, visuais, consultas e integrações. Anote resultado esperado antes de olhar o número.

Inclua um caso com valor vazio e outro com categoria rara. Confirme relações e direção de filtro quando elas forem afetadas. Uma conta de controle independente ajuda a detectar mudança que passa na sintaxe, mas altera o significado.

Use controle de versão e revisão

Quando o projeto está em controle de versão, inclua TMDL numa revisão que mostre arquivos modificados. A pessoa revisora deve checar escopo, nomes e dependências. Não aceite arquivo inteiro só porque foi gerado automaticamente. Combine convenções de nomes, pastas, autoria e mensagens. Uma lista curta de verificações reduz conflitos quando duas pessoas alteram o mesmo modelo em paralelo.

Escreva uma descrição de mudança que diga o que mudou e como testar. Não deixe que o diff substitua a validação do processo. O revisor pode não conhecer a regra de negócio; peça a aprovação de quem a domina.

Considere diferença entre serviço e Desktop

A visão no serviço pode ter modos e regras diferentes da experiência Desktop. A documentação atual descreve diferenças de edição, persistência, permissão e histórico. Se a mudança será aplicada ao modelo publicado, revise o modo ativo e os direitos exigidos. Em uma prévia, comportamento e limites podem mudar. Não use procedimento de captura antiga como prova de que os menus continuam iguais. Consulte a documentação da sua versão antes de orientar a equipe.

Confirme onde a alteração será executada e quem pode aplicar. Separe inspeção de gravação no serviço se a tela oferecer esses modos. Essa separação cria oportunidade de revisar antes do compromisso com o modelo compartilhado.

Crie uma rotina de entrega

Use fluxo claro: abrir cópia, gerar script, revisar, aplicar, testar, comparar e promover conforme o processo da empresa. Se o teste falhar, reverta ou restaure a cópia conhecida. Separe alterações do modelo e ajustes de visual quando facilitar a análise. Registre versão aprovada, aprovação do dono dos dados e lista de objetos afetados. Um roteiro curto evita que a equipe dependa da memória de quem fez a primeira mudança.

Depois da publicação, revise visuais com filtros representativos e peça que um usuário conclua uma tarefa real. Monitore falhas e dê um caminho para reportar diferença. O trabalho termina quando o modelo continua útil para quem consome seus resultados.

Faça a mudança valer a pena

Para decidir esforço e escopo, veja critérios de avaliação de modelos, o exemplo de métricas operacionais e a checagem de dados de estoque. Consulte a documentação oficial da visão TMDL para detalhes atuais. Gere um script pequeno, teste em cópia, compare o resultado e peça revisão antes de mexer no modelo usado pelo negócio.