Use o editor de expressões dinâmicas para os destinos de dados Dataflow Gen2 (pré-visualização)

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 permite-lhe criar valores em campos de destino de dados compatíveis, combinando texto com valores que são determinados quando o fluxo de dados é executado. Por exemplo, pode incluir a data de atualização UTC num nome de ficheiro, usar um parâmetro para o nome de uma tabela ou incluir um valor específico do espaço de trabalho.

O editor está ativado por defeito. Quando o utilizar pela primeira vez, um balão de ajuda explica 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.
Parameters Parâmetros que defines no fluxo de dados. Selecione Gerir parâmetros no menu para criar ou editar parâmetros.
Variáveis do espaço de trabalho Valores de espaço de trabalho incorporados, 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 ficheiro

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

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

  3. Insira qualquer texto que deva permanecer igual cada vez que o fluxo de dados é executado.

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

    Captura de ecrã do menu de valores dinâmicos aberta no campo Nome do Ficheiro. 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. Também podes começar a escrever depois de / para filtrar o menu.

  6. Continue a introduzir texto e valores até a expressão estar completa. Para um destino de ficheiro, inclua a extensão do ficheiro como texto.

    Captura de ecrã de um nome dinâmico de ficheiro que combina texto com tokens Data, Hora e Data/Hora.

  7. Termina de configurar o destino dos dados e depois publica 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 do destino ainda se aplica ao nome resultante. Por exemplo, um destino de ficheiro pode sobrescrever um ficheiro quando o nome do ficheiro resolvido corresponde a um ficheiro existente.

Editar uma expressão

Podes editar texto e inserir mais valores em qualquer lugar da expressão.

  • Para abrir o menu sem usar o rato, pressione /. Use as setas para avançar 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 tenha introduzido depois permanece no campo como texto.
  • Para remover um valor inserido, coloque o cursor ao lado do seu token e pressione Backspace ou Delete.

Expressões de exemplo

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

No editor, os valores mostrados entre colchetes angulares nestes exemplos aparecem como fichas. Não escreva os parênteses angulares.

Importante

O nome da tabela ou ficheiro resolvido 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 do 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 defeito. A sua preferência está guardada num cookie do navegador e não está guardada no serviço Fabric. Como resultado, a definição não se mantém entre navegadores ou dispositivos e pode regressar ao seu padrão se limpar os cookies do navegador. Para alterá-lo:

  1. No editor Power Query, selecione Opções no separador Inicial.
  2. No diálogo de Opções , selecione Global>General.
  3. Desloce-se até à secção de destinos de dados .
  4. Em Editor, desmarque Ativar o editor de expressões dinâmicas para desativar o editor. Selecione a caixa de verificação para o voltar a ativar.
  5. Selecione OK.

Captura de ecrã do diálogo Opções com a definiçã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 de 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 espaço de trabalho, data ou valor de hora pode fazer com que o nome do destino resolvido mude entre execuções.
  • Para parametrizar definições de destino que não são suportadas por este editor, veja Edição avançada para consultas de destino de dados.