Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
No editor Power Query, adicione um destino de dados a uma consulta.
Coloque o cursor em um campo de destino que suporte expressões dinâmicas, como nome da tabela ou nome do arquivo.
Insira qualquer texto que deva permanecer igual sempre que o fluxo de dados for executado.
Pressione
/para abrir o menu de valores dinâmicos.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.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.
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:
- No editor Power Query, selecione Opções na aba Home.
- No diálogo de Opções, selecione Geral Global>.
- Role até a seção de Destinos de Dados .
- Em Editor, desligue Habilitar o editor de expressões dinâmicas para desligar o editor. Selecione a caixa de seleção para reativá-la.
- Selecione OK.
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.