1. O Problema Raiz
Por padrão, quando o Power BI / Excel altera o tipo de uma coluna pela interface gráfica, ele gera a função Table.TransformColumnTypes.
Essa função é rígida: se uma planilha de origem (Excel, CSV, SharePoint) tiver qualquer célula com dado sujo — como um texto "N/A" ou "-" em uma coluna numérica, ou uma data digitada incorretamente —, toda a atualização da consulta é interrompida com erro (DataFormat.Error).
2. A Solução Universal (Padrão try ... otherwise null)
Para tornar qualquer consulta tolerante a falhas, substituímos a tipagem rígida pela função Table.TransformColumns combinada com blocos de tratamento de exceção (try ... otherwise null).
3. Código Dinâmico Reutilizável (Plug & Play)
Se você não quiser reescrever coluna por coluna nas suas dezenas de bases, cole a função abaixo no final de qualquer consulta (substituindo a etapa #"Tipo Alterado" gerada automaticamente pelo Power BI).
Este bloco lê automaticamente o esquema de tipos que o Power Query tentou aplicar e o converte em uma versão 100% blindada contra erros:
let
// =========================================================================
// 1. SUAS ETAPAS DE ORIGEM E LIMPEZA INICIAL AQUI
// =========================================================================
Fonte = Excel.Workbook(Web.Contents("URL_DO_SEU_ARQUIVO"), null, true),
Planilha = Fonte{[Item="Nome_da_Aba", Kind="Sheet"]}[Data],
#"Cabeçalhos Promovidos" = Table.PromoteHeaders(Planilha, [PromoteAllScalars=true]),
// =========================================================================
// 2. DEFINIÇÃO PADRÃO DE TIPOS (Pode manter a gerada pelo Power Query)
// =========================================================================
EsquemaDeTipos = {
{"Coluna_Texto", type text},
{"Coluna_Inteiro", Int64.Type},
{"Coluna_Decimal", type number},
{"Coluna_Moeda", Currency.Type},
{"Coluna_Data", type date}
},
// =========================================================================
// 3. MOTOR DE BLINDAGEM AUTOMÁTICA (NÃO PRECISA ALTERAR)
// =========================================================================
#"Tabela Blindada" = Table.TransformColumns(
#"Cabeçalhos Promovidos",
List.Transform(EsquemaDeTipos, (item) =>
let
nomeColuna = item{0},
tipoAlvo = item{1},
funcaoConversao =
if tipoAlvo = type text then (v) => try Text.From(v) otherwise null
else if tipoAlvo = Int64.Type then (v) => try Int64.From(v) otherwise null
else if tipoAlvo = type number then (v) => try Number.From(v) otherwise null
else if tipoAlvo = Currency.Type then (v) => try Currency.From(v) otherwise null
else if tipoAlvo = Percentage.Type then (v) => try Percentage.From(v) otherwise null
else if tipoAlvo = type date then (v) => try Date.From(v) otherwise null
else if tipoAlvo = type datetime then (v) => try DateTime.From(v) otherwise null
else (v) => v
in
{nomeColuna, funcaoConversao}
)
)
in
#"Tabela Blindada"
4. Boas Práticas Adicionais para Evitar Quebras
Evite remover linhas em branco antes de promover cabeçalhos:
Ordem correta:
Fonte➔Navegação (Aba)➔Cabeçalhos Promovidos➔Blindagem de Tipos.Remover linhas vazias antes de definir o cabeçalho costuma desalinhar o índice interno das colunas quando o arquivo de origem sofre edições.
Ignorar colunas ausentes (
MissingField.Ignore):Se alguma planilha externa costuma ter colunas renomeadas ou excluídas eventualmente, adicione o parâmetro
MissingField.Ignorecomo terceiro argumento na funçãoTable.TransformColumns:
Table.TransformColumns(#"Cabeçalhos Promovidos", ListaDeConversoes, null, MissingField.Ignore)Entendendo o ícone de relógio na etapa (Query Folding):
Ao utilizar funções personalizadas (
try ... otherwise), o Power Query exibe um pequeno ícone de relógio/aviso na lateral da etapa ("Essa etapa será avaliada fora da fonte de dados"). Isso não é um erro, apenas indica que o processamento ocorre na memória do Power BI e não no servidor de origem (o que já é o comportamento padrão para arquivos Excel e SharePoint).
Criei um arquivo guia_blindagem_power_query.md com a tabela de referência rápida e um Motor de Blindagem Automática em Linguagem M.
Nas suas próximas bases, basta pegar a lista de colunas que o próprio Power BI gera na etapa Tipo Alterado, colar dentro da variável EsquemaDeTipos desse modelo e o script blindará todas as colunas automaticamente (incluindo proteção extra caso alguma coluna suma no futuro usando o MissingField.Ignore).
👉 Siga André Bernardes no Linkedin. Clique aqui e contate-me via What's App.
















