Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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 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
No editor Power Query, adicione um destino de dados a uma consulta.
Coloque o cursor num campo de destino que suporte expressões dinâmicas, como nome da tabela ou nome do ficheiro.
Insira qualquer texto que deva permanecer igual cada vez que o fluxo de dados é 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. Também podes começar a escrever depois de
/para filtrar o menu.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.
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:
- No editor Power Query, selecione Opções no separador Inicial.
- No diálogo de Opções , selecione Global>General.
- Desloce-se até à secção de destinos de dados .
- 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.
- 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 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.