Use o editor de expressões dinâmicas para destinos de dados Dataflow Gen2 (prévia)

Note

O editor de expressões dinâmicas para destinos de dados está atualmente em pré-visualização.

O editor de expressões dinâmicas ajuda você a criar valores em campos compatíveis de destino de dados, combinando texto com valores que são resolvidos quando o fluxo de dados é executado. Por exemplo, você pode incluir a data de atualização UTC em um nome de arquivo, usar um parâmetro para o nome de uma tabela ou incluir um valor específico do workspace.

O editor está ativado por padrão. Ao usar isso pela primeira vez, uma dica explicativa mostra como abrir o menu de valores dinâmicos.

Valores disponíveis

Os valores disponíveis no editor dependem do fluxo de dados e da configuração do espaço de trabalho.

Category Description
Valores dinâmicos Valores de data e hora UTC para a execução do fluxo de dados. Data usa yyyyMMdd, Hora usa HHmmss, e Data/Hora usa yyyyMMddHHmmss. Por exemplo, um valor Data/Hora pode ser resolvido para 20201230232459 30 de dezembro de 2020 às 23:24:59 UTC.
Parâmetros Parâmetros que você define no fluxo de dados. Selecione Gerenciar parâmetros no menu para criar ou editar parâmetros.
Variáveis do espaço de trabalho Valores de espaço de trabalho embutidos, como currentWorkspaceId, e valores de itens da Biblioteca de Variáveis Fabric disponíveis para o fluxo de dados.

Crie uma tabela dinâmica ou nome de arquivo

  1. No editor Power Query, adicione um destino de dados a uma consulta.

  2. Coloque o cursor em um campo de destino que suporte expressões dinâmicas, como nome da tabela ou nome do arquivo.

  3. Insira qualquer texto que deva permanecer igual sempre que o fluxo de dados for executado.

  4. Pressione / para abrir o menu de valores dinâmicos.

    Captura de tela do menu de valores dinâmicos aberto no campo Nome do Arquivo. O menu contém Data, Hora, Data/Hora, parâmetros e variáveis do espaço de trabalho.

  5. Selecione um valor dinâmico, parâmetro ou variável de espaço de trabalho. Você também pode começar a digitar depois de / para filtrar o menu.

  6. Continue inserindo texto e valores até que a expressão esteja completa. Para o destino do arquivo, inclua a extensão do arquivo como texto.

    Captura de tela de um nome de arquivo dinâmico que combina texto com tokens Data, Hora e Data/Hora.

  7. Termine de configurar o destino dos dados e então publique o fluxo de dados.

Em tempo de execução, o Dataflow Gen2 resolve cada token e combina os valores com o texto na expressão. O comportamento normal de destino ainda se aplica ao nome resultante. Por exemplo, um destino de arquivo pode sobrescrever um arquivo quando o nome do arquivo resolvido corresponde a um arquivo existente.

Editar uma expressão

Você pode editar texto e inserir mais valores em qualquer lugar da expressão.

  • Para abrir o menu sem usar o mouse, pressione /. Use as setas para navegar pelo menu e depois pressione Enter para inserir o valor selecionado.
  • Para fechar o menu sem selecionar um valor, pressione Esc. O / e qualquer texto que você tenha inserido depois permanecem no campo como texto.
  • Para remover um valor inserido, coloque o cursor ao lado do token e pressione Backspace ou Delete.

Expressões de exemplo

Scenario Expressão
Adicione a data e hora de execução a um nome de arquivo Orders-<Date>-<Time>.csv
Use um parâmetro de dataflow como prefixo do nome da tabela <Environment>_Sales
Inclua o espaço de trabalho atual em um nome Sales_<currentWorkspaceId>

No editor, os valores mostrados entre colchetes angulares nesses exemplos aparecem como tokens. Você não digita os suportes angulares.

Importante

A tabela resolvida ou nome de arquivo deve seguir as regras de nomenclatura do destino selecionado. Se um valor dinâmico introduzir caracteres não suportados ou criar um nome inválido, a validação de destino ou a execução do fluxo de dados pode falhar.

Desligue ou ligue o editor de expressões dinâmicas

O editor de expressões dinâmicas está ativado por padrão. Sua preferência é armazenada em um cookie do navegador e não é salva no serviço Fabric. Como resultado, a configuração não é mantida em navegadores ou dispositivos e pode voltar ao padrão se você limpar os cookies do navegador. Para alterar:

  1. No editor Power Query, selecione Opções na aba Home.
  2. No diálogo de Opções, selecione Geral Global>.
  3. Role até a seção de Destinos de Dados .
  4. Em Editor, desligue Habilitar o editor de expressões dinâmicas para desligar o editor. Selecione a caixa de seleção para reativá-la.
  5. Selecione OK.

Captura de tela do diálogo Opções com a configuração Ativar editor de expressões dinâmicas selecionada em Destinos de dados.

Desligar o editor não remove expressões dinâmicas que já estão configuradas.

Considerações e limitações

  • A disponibilidade depende do destino e campo dos dados selecionados.
  • O editor combina texto e valores disponíveis. Não é um editor de expressões Power Query M de uso geral.
  • Um parâmetro referenciado ou variável de espaço de trabalho deve estar disponível quando o fluxo de dados é executado.
  • Alterar um parâmetro, variável de workspace, valor de data ou hora pode fazer com que o nome do destino resolvido mude entre as execuções.
  • Para parametrizar configurações de destino que não são suportadas por este editor, veja Edição avançada para consultas de destino de dados.