Parâmetros no Power Query: controle a origem da carga

Os parâmetros no Power Query permitem guardar valores reutilizáveis nas etapas de uma consulta. Para trocar a origem de uma carga, isso ajuda a localizar a configuração responsável pelo caminho do arquivo. A mudança ainda precisa de conferência: um endereço válido pode apontar para um arquivo diferente daquele esperado pelo relatório.

Este roteiro usa um arquivo hipotético de vendas para organizar configuração, teste e liberação. O exemplo considera um caminho local no Windows e uma estrutura de colunas conhecida. Adapte a origem ao ambiente real e confirme o resultado completo da atualização antes de disponibilizar os dados à equipe.

1. Escolha a finalidade dos parâmetros no Power Query

A documentação de parâmetros do Power Query descreve valores reutilizáveis em argumentos de etapas e funções. Neste exemplo, o parâmetro controla o arquivo lido na preparação dos dados. Ele deve ter nome, descrição e tipo coerentes com essa finalidade, para reduzir ambiguidades na manutenção.

Separe essa configuração das escolhas feitas pelo leitor no relatório. Alterar um caminho de carga é uma decisão sobre a origem dos dados, enquanto escolher uma medida em uma página responde a outra necessidade. O artigo sobre parâmetros de campo trata da alternância de indicadores no contexto dos visuais.

2. Defina um contrato para os arquivos aceitos

Antes de criar o parâmetro, descreva nome do arquivo, colunas, delimitador, codificação e período representado. No cenário hipotético, movimentos.csv contém PedidoID e Valor, utiliza ponto e vírgula e guarda valores monetários como texto no padrão brasileiro. Arquivos com outro contrato precisam de uma preparação própria antes de substituir essa origem.

Defina também o que identifica uma versão válida da exportação. Apenas manter o mesmo nome não garante que o arquivo foi renovado. Inclua na conferência data da extração, período coberto e quantidade de registros esperada, usando evidências da fonte para impedir que uma cópia antiga seja interpretada como atualização bem-sucedida.

3. Crie um parâmetro de texto com descrição clara

No editor, use Gerenciar Parâmetros e crie pArquivoVendas com tipo Texto. Informe como valor atual um caminho completo de teste, como C:\Dados\Vendas\movimentos.csv, e descreva o contrato esperado. O valor atual é o utilizado nas transformações; a documentação distingue esse valor das sugestões e do valor padrão apresentado na configuração.

Evite nomes genéricos como Parametro1 quando várias consultas dependem da configuração. Documente quais tabelas usam pArquivoVendas e quem pode alterar seu conteúdo no processo de publicação. Essa relação ajuda a antecipar o impacto de uma troca de origem e a localizar outros resultados que precisam ser conferidos depois da mudança.

4. Referencie o parâmetro na leitura do arquivo

A função File.Contents recebe o caminho do arquivo e retorna seu conteúdo binário. Csv.Document interpreta esse conteúdo como uma tabela, com opções de leitura. CSV é um formato textual de dados tabulares; no nosso exemplo, os campos são separados por ponto e vírgula.

let
    Fonte = Csv.Document(
        File.Contents(pArquivoVendas),
        [
            Delimiter = ";",
            Encoding = 65001,
            QuoteStyle = QuoteStyle.Csv
        ]
    ),
    Cabecalhos = Table.PromoteHeaders(
        Fonte, [PromoteAllScalars = true]
    )
in
    Cabecalhos

O exemplo assume que pArquivoVendas já foi criado no editor. O valor 65001 identifica a codificação UTF-8, conforme a referência de Csv.Document. A função Table.PromoteHeaders transforma a primeira linha em cabeçalhos; por isso, confira se a exportação realmente contém os nomes das colunas nessa posição.

5. Confira o conteúdo depois de trocar o caminho

Prepare dois arquivos de teste com o mesmo contrato e valores conhecidos. Em um exemplo hipotético, o primeiro contém duas vendas de oitenta e cento e vinte reais; o segundo contém uma venda de cinquenta reais. Depois da troca e da conversão de tipos, espere duzentos reais no primeiro e cinquenta reais no segundo.

Confira também identificadores e quantidade de linhas, pois um total isolado pode coincidir por acaso. Mantenha a conversão de Valor em uma etapa explícita, de acordo com a localidade da fonte. O parâmetro seleciona a origem, mas não corrige automaticamente uma mudança no padrão numérico do arquivo recebido.

6. Trate sugestões como ajuda, sem presumir validação

A lista de valores sugeridos facilita a escolha, porém a documentação informa que ela não impede digitação manual de outros valores. Portanto, registre uma conferência adicional para a origem utilizada. Um caminho fora da lista pode existir e carregar uma base com aparência semelhante, produzindo resultados tecnicamente válidos para o arquivo errado.

Teste arquivo inexistente, arquivo vazio e arquivo com cabeçalho alterado. Defina quais situações devem bloquear a liberação. A decisão precisa considerar o contrato do relatório: uma base vazia pode ser legítima em um período sem movimentos ou indicar falha na exportação, e o tratamento depende dessa distinção registrada no processo.

7. Revise a configuração depois da publicação

A Microsoft documenta a edição de parâmetros no serviço do Power BI nas configurações do modelo semântico. Modelo semântico é o conjunto de dados e definições usado pelos relatórios. Após alterar um parâmetro, execute uma atualização e confira se a consulta utilizou o novo valor na carga.

Inclua essa conferência na liberação: caminho esperado, origem efetivamente acessada, resultado da atualização e período carregado. Não considere a visualização antiga como prova de que a nova origem já funcionou. Registre a execução que utilizou o valor novo e compare os dados obtidos com o arquivo aprovado para esse ambiente.

8. Confira o acesso à origem no ambiente de atualização

Um caminho que existe no computador do analista não garante acesso pelo serviço. A documentação de gateways de dados locais explica a conexão entre o serviço e fontes da rede local. Gateway é o componente que viabiliza esse acesso quando a origem não está disponível diretamente pela internet.

Valide a conexão e as permissões com o responsável pelo ambiente de atualização. No nosso exemplo, o arquivo precisa estar acessível a esse ambiente, com o contrato esperado. Teste a carga fora da sessão pessoal do analista para identificar diferenças de caminho, disponibilidade ou acesso antes de anunciar que o relatório está pronto para uso recorrente.

9. Registre alterações e mantenha um caminho de retorno

Guarde valor anterior, valor novo, motivo, responsável e resultado do teste. Quando a mudança atender outro ambiente, preserve a identificação dessa finalidade no registro. Isso permite explicar por que dois relatórios com a mesma estrutura apresentaram bases diferentes, sem depender da lembrança de quem alterou a configuração.

Se a origem selecionar vários arquivos de uma pasta, confira também a regra de inclusão e a transformação aplicada a cada um. O roteiro de combinação de arquivos aprofunda essa preparação. Parametrizar o endereço da pasta não resolve diferenças de esquema nem evita incluir exportações duplicadas por si só.

10. Entregue a configuração junto do teste de carga

Antes de distribuir um modelo, confira o valor atual de cada parâmetro, as dependências e os casos de teste. Para começar com um arquivo editável, consulte o guia de importação de template Power BI. A configuração deve ser compreensível para quem receberá a responsabilidade de manter a atualização.

Uma entrega completa informa qual origem foi aprovada, quando ela foi carregada e quais resultados passaram na conferência. Se o acesso no serviço ainda não foi validado, mantenha essa etapa como pendência concreta. O parâmetro ajuda a centralizar a mudança, enquanto os testes demonstram se a carga continua atendendo ao contrato de dados do relatório.

Documentação técnica da Microsoft consultada em 18/10/2026.