Criar uma consulta de parâmetro (Consulta do Power)

Você pode estar familiarizado com as consultas de parâmetros com o uso deles no SQL ou no Microsoft Query. No entanto, os parâmetros de Consulta do Power têm diferenças importantes:    

  • Os parâmetros podem ser usados em qualquer etapa de consulta. Além de funcionar como um filtro de dados, os parâmetros podem ser usados para especificar coisas como um caminho de arquivo ou um nome de servidor.

  • Os parâmetros não solicitam entrada. Em vez disso, você pode alterar rapidamente o valor usando o Power Query. Você pode até armazenar e recuperar os valores de células no Excel.

  • Os parâmetros são salvos em uma consulta de parâmetro simples, mas são separados das consultas de dados em que são usados.  Depois de criado, você pode adicionar um parâmetro às consultas conforme necessário.

Observação    Se você quiser que a outra maneira de criar consultas de parâmetros, consulte Create a parameter query in Microsoft Query.

Você pode usar um parâmetro para alterar automaticamente um valor em uma consulta e evitar editar a consulta sempre para alterar o valor. Basta alterar o valor do parâmetro. Depois de criar um parâmetro, ele é salvo em uma consulta de parâmetro especial que você pode alterar convenientemente diretamente do Excel.

  1. Selecione Dados >Obter Dados >Outras Fontes > Iniciar o Editor de Consulta do Power.

  2. No Editor de Consulta do Power, selecione Home > Gerenciar Parâmetros > Novos Parâmetros.

  3. Na caixa de diálogo Gerenciar Parâmetro, selecione Novo.

  4. De definir o seguinte conforme necessário:

    Nome    

    Isso deve refletir a função do parâmetro, mas mantê-lo o mais curto possível.

    Descrição    

    Isso pode conter todos os detalhes que ajudarão as pessoas a usarem corretamente o parâmetro.

    Obrigatório    

    Faça um dos seguintes: Qualquer Valor Você pode inserir qualquer valor de qualquer tipo de

    dados na consulta de parâmetros.

    Lista de valores    Você pode limitar os valores a uma lista específica inserindo-os na grade pequena. Você também deve selecionar um Valor Padrão e um Valor Atual abaixo.

    Consulta Selecione uma consulta de lista, que se parece com uma coluna estruturada lista separada por vírgulas e entre chaves.

    Por exemplo, um campo de status Issues pode ter três valores: {"New", "Ongoing", "Closed"}. Você deve criar aconsulta de lista antecipadamente abrindo o Editor Avançado (selecione Editor Avançado do Home> ), removendo o modelo de código, inserindo a lista de valores no formato de lista de consulta e selecionando Feito.

    Depois de concluir a criação do parâmetro, a consulta de lista será exibida em seus valores de parâmetro.

    Tipo    

    Isso especifica o tipo de dados do parâmetro.

    Valores sugeridos    

    Se desejado, adicione uma lista de valores ou especifique uma consulta para fornecer sugestões de entrada.

    Valor Padrão

    Isso só será exibido se Valores Sugeridos for definido como Lista devalores e especificar qual item de lista é o padrão. Nesse caso, você deve escolher um padrão.

    Valor Atual    

    Dependendo de onde você usa o parâmetro, se isso estiver em branco, a consulta poderá retornar nenhum resultado. Se Obrigatório estiver selecionado, Valor Atual não poderá estar vazio.

  5. Para criar o parâmetro, selecione OK.

Aqui está uma maneira de gerenciar alterações em locais de fonte de dados e ajudar a evitar erros de atualização. Por exemplo, supondo um esquema e uma fonte de dados semelhantes, crie um parâmetro para alterar facilmente uma fonte de dados e ajudar a evitar erros de atualização de dados. Às vezes, o servidor, o banco de dados, a pasta, o nome do arquivo ou o local mudam. Talvez um gerente de banco de dados ocasionalmente troque um servidor, uma entrega mensal de arquivos CSV vá para uma pasta diferente ou você precisa alternar facilmente entre um ambiente de desenvolvimento/teste/produção.

Etapa 1: Criar uma consulta de parâmetro

No exemplo a seguir, você tem vários arquivos CSV que você importa usando a operação de pasta de importação (Selecione Dados> Obter dados> de arquivos > dapasta ) da pasta C:\DataFilesCSV1. Mas, às vezes, uma pasta diferente é ocasionalmente usada como um local para soltar os arquivos, C:\DataFilesCSV2. Você pode usar um parâmetro em uma consulta como um valor substituto para a pasta diferente.

  1. Selecione Home > Gerenciar Parâmetros > Novo Parâmetro.

  2. Insira as seguintes informações na caixa de diálogo Gerenciar Parâmetro:

    Nome

    CSVFileDrop

    Descrição

    Local de entrega de arquivo alternativo

    Obrigatório

    Sim

    Tipo

    SMS

    Valores sugeridos

    Qualquer valor

    Valor Atual

    C:\DataFilesCSV1

  3. Clique em OK.

Etapa 2: Adicionar o parâmetro à consulta de dados

  1. Para definir o nome da pasta como um parâmetro, em Configuraçõesde Consulta , em Etapas de Consulta,selecione Fontee selecione Editar Configurações.

  2. Certifique-se de que a opção Caminho do arquivo está definida como Parâmetroe selecione o parâmetro que você acabou de criar na lista lista listada.

  3. Clique em OK.

Etapa 3: Atualizar o valor do parâmetro

O local da pasta acabou de ser alterado, portanto, agora você pode simplesmente atualizar a consulta de parâmetro.

  1. Selecione Conexões > De & consultas > consultas, clique com o botão direito do mouse na consulta de parâmetro e selecione Editar.

  2. Insira o novo local na caixa Valor Atual, como C:\DataFilesCSV2.

  3. Selecione Home > Fechar & Carregar.

  4. Para confirmar seus resultados, adicione novos dados à fonte de dados e atualize a consulta de dados com o parâmetro atualizado (Selecione Dados > Atualizar Tudo).

Às vezes, você deseja uma maneira fácil de alterar o filtro de uma consulta para obter resultados diferentes sem editar a consulta ou fazer cópias ligeiramente diferentes da mesma consulta. Neste exemplo, alteramos uma data para alterar convenientemente um filtro de dados.

  1. Para abrir uma consulta, localize uma carregada anteriormente no Editor de Consulta do Power, selecione uma célula nos dados e selecione Consulta > Editar. Para obter mais informações, consulte Criar, carregar ou editar uma consulta no Excel.

  2. Selecione a seta de filtro em qualquer header de coluna para filtrar seus dados e selecione um comando de filtro, como Filtros de Data/Hora > Depois. A caixa de diálogo Linhas de Filtro é exibida.

    Inserindo um parâmetro na caixa de diálogo Filtro

  3. Selecione o botão à esquerda da caixa Valor e faça um dos seguintes:

    • Para usar um parâmetro existente, selecione Parâmetroe selecione o parâmetro que você deseja na lista que aparece à direita.

    • Para usar um novo parâmetro, selecione Novo Parâmetroe crie um parâmetro.

  4. Insira a nova data na caixa Valor Atual e selecione Home > Fechar & Carregar.

  5. Para confirmar seus resultados, adicione novos dados à fonte de dados e atualize a consulta de dados com o parâmetro atualizado (Selecione Dados > Atualizar Tudo). Por exemplo, altere o valor do filtro para uma data diferente para ver novos resultados.

  6. Insira a nova data na caixa Valor Atual.

  7. Selecione Home > Fechar & Carregar.

  8. Para confirmar seus resultados, adicione novos dados à fonte de dados e atualize a consulta de dados com o parâmetro atualizado (Selecione Dados > Atualizar Tudo).

Neste exemplo, o valor no parâmetro de consulta é lido de uma célula em sua workbook. Você não precisa alterar a consulta de parâmetro, basta atualizar o valor da célula. Por exemplo, você deseja filtrar uma coluna pela primeira letra, mas alterar facilmente o valor para qualquer letra de A a Z.

  1. Na planilha em uma pasta de trabalho onde a consulta que você deseja filtrar é carregada, crie uma tabela do Excel com duas células: um header e um valor.
     

    MyFilter

    G

  2. Selecione uma célula na tabela Excel e selecione Dados > Obter dados > de tabela/intervalo. O Editor de Consulta do Power é exibido.

  3. Na caixa Nome do painel Configurações de Consulta à direita, altere o nome da consulta para ser mais significativo, como FilterCellValue. 

  4. Para passar o valor na tabela, e não a tabela em si, clique com o botão direito do mouse no valor em Visualização de Dados e selecione Drill Down.

    Observe que a fórmula foi alterada para = #"Changed Type"{0}[MyFilter]

    Quando você usa a Tabela do Excel como um filtro na etapa 10, a Consulta do Power faz referência ao valor Table como a condição de filtro. Uma referência direta à Tabela do Excel causaria um erro.

  5. Selecione Home > Fechar & Carregar > Fechar & Carregar para. Agora você tem um parâmetro de consulta chamado "FilterCellValue" que você usa na etapa 12.

  6. Na caixa de diálogo Importar Dados, selecione Somente Criar Conexãoe selecione OK.

  7. Abra a consulta que você deseja filtrar com o valor na tabela FilterCellValue, uma carregada anteriormente do Editor de Consulta do Power, selecionando uma célula nos dados e selecionando Query > Editar. Para obter mais informações, consulte Criar, carregar ou editar uma consulta no Excel.

  8. Selecione a seta de filtro em qualquer header de coluna para filtrar seus dados e selecione um comando de filtro, como Filtrosde Texto> Começa com . A caixa de diálogo Linhas de Filtro é exibida. 

  9. Insira qualquer valor na caixa Valor, como "G" e selecione OK. Nesse caso, o valor é um espaço reservado temporário para o valor na tabela FilterCellValue que você inserir na próxima etapa.

  10. Selecione a seta no lado direito da barra de fórmulas para exibir toda a fórmula. Veja um exemplo de uma condição de filtro em uma fórmula:

    = Table.SelectRows(#"Changed Type", each Text.StartsWith([Name], "G"))

  11. Selecione o valor do filtro. Na fórmula, selecione "G".

  12. Usando o M Intellisense, insira a primeira letra da tabela FilterCellValue que você criou e selecione-a na lista exibida.

  13. Selecione Home > Fechar > Fechar & Carregar.

Resultado

Sua consulta agora usa o valor na Tabela do Excel que você criou para filtrar os resultados da consulta. Para usar um novo valor, edite o conteúdo da célula na tabela original do Excel na etapa 1, altere "G" para "V" e atualize a consulta.

Você pode controlar se as consultas de parâmetros são permitidas ou não.

  1. No Editor de Consulta do Power, selecione Opções> de arquivo e configurações > Opções de Consulta > Editor de Consulta do Power.

  2. No painel à esquerda, em GLOBAL, selecione Power Query Editor.

  3. No painel à direita, em Parâmetros,selecione ou desimpleia Sempre permitir parametrizaçãoem caixas de diálogo de fonte de dados e transformação.

Veja também

Consulta do Power para Ajuda do Excel

Usar parâmetros de consulta (docs.com)https://docs.microsoft.com/en-us/power-query/power-query-query-parameters

Precisa de mais ajuda?

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×