Usar parâmetros públicos no Dataflow Gen2

Os parâmetros no Dataflow Gen2 permitem controlar e personalizar dinamicamente os fluxos de dados, tornando-os mais flexíveis e reutilizáveis, permitindo diferentes entradas e cenários sem modificar o fluxo de dados em si. Ele ajuda a manter as coisas organizadas, reduzindo a necessidade de vários fluxos de dados e centralizando o controle em um único fluxo de dados parametrizado.

Os parâmetros públicos no Dataflow Gen2 são um novo modo em que você pode permitir que seu Dataflow seja executado passando valores de parâmetros fora do editor do Power Query por meio da API REST de malha ou por meio de experiências nativas do Fabric. Ele permite que você tenha uma experiência mais dinâmica com seu Dataflow, onde cada execução pode ser invocada com diferentes parâmetros que afetam como seu Dataflow é executado.

Pré-requisitos

• Um Dataflow Gen2 com suporte a CI/CD
• Os parâmetros devem ser definidos dentro do seu fluxo de dados.Saiba mais sobre como definir parâmetros de consulta no Dataflow.

Ativar o modo de parâmetro público

Como proprietário do fluxo de dados, abra o fluxo de dados. Na faixa Base do separador, selecione o botão Opções.

Selecionar o botão abre uma nova caixa de diálogo Opções . No menu vertical, selecione a opção com o rótulo Parâmetros dentro do grupo de fluxo de dados . Na secção Parâmetros, pode ativar a opção "Ativar a descoberta de parâmetros e permitir substituição durante a execução" para ativar o modo de parâmetros públicos.

Selecione o botão OK para confirmar essas alterações.

Quando esse modo está ativado, você recebe uma notificação na caixa de diálogo Gerenciar parâmetros que diz "O modo de parâmetro público está habilitado" na parte superior da caixa de diálogo.

Depois que o modo de parâmetro público estiver habilitado, você poderá salvar seu fluxo de dados.

Passar valores de parâmetros personalizados para execuções do Dataflow

O modo de parâmetro público segue a definição dos parâmetros dentro do fluxo de dados, onde há uma distinção entre parâmetros necessários e não necessários.

• Parâmetros necessários: se um parâmetro for definido conforme necessário, para executar o fluxo de dados um valor precisa ser passado para o trabalho de execução. A execução falhará se nenhum valor for passado para um parâmetro definido como obrigatório.
• Parâmetros não necessários: também são chamados de parâmetros opcionais e nenhum valor é necessário para ser passado para que uma execução seja acionada. Se nenhum valor for passado, o valor Current definido em seu parâmetro será usado para execução.

Usar a atividade de fluxo de dados em Pipelines

Ao criar um pipeline no Fabric, você pode usar a atividade de fluxo de dados para disparar a execução de um Dataflow Gen2 com suporte a CI/CD que tenha o modo de parâmetros públicos habilitado.

Você pode selecionar o fluxo de dados que deseja usar e definir os parâmetros que deseja usar na seção Parâmetros de fluxo de dados .

Na seção Parâmetros de fluxo de dados , você pode ver todos os parâmetros disponíveis em seu fluxo de dados e o valor padrão de cada um dentro da seção de valor.

Os parâmetros necessários têm um asterisco ao lado do nome, enquanto os parâmetros opcionais não. Ao mesmo tempo, os parâmetros opcionais podem ser removidos da grade, enquanto os parâmetros necessários não podem ser excluídos e um valor deve ser passado para que o fluxo de dados seja executado.

Você pode selecionar o botão de atualização para solicitar as informações de parâmetros mais recentes do seu fluxo de dados.

Tipos de parâmetros suportados

A tabela a seguir mostra os tipos de parâmetros atualmente suportados e o link para a definição da API REST para que ela entenda quais são os valores esperados pela API REST.

Considerações e limitações

A seguir está uma lista de todas as considerações e limitações ao usar o modo de parâmetros públicos no Dataflow Gen2 com CI/CD:

• Agendamento e acionamento manual: os fluxos de dados com parâmetros públicos não podem ser agendados ou acionados manualmente via malha, a menos que nenhum parâmetro necessário seja definido.
• Parametrização sem suporte: parâmetros que alteram caminhos de recursos para origens ou destinos não são suportados. As conexões são fixas na trajetória definida.
• Atualização incremental: Não compatível com o modo de parâmetros públicos.
• Modificação lógica: Os parâmetros públicos permitem que os usuários com acesso substituam valores, potencialmente alterando a saída do fluxo de dados.
• Hub de Monitoramento: o Hub de Monitoramento não mostra valores de parâmetros usados durante a execução.
• Comportamento de preparo: somente a última execução é armazenada no Staging Lakehouse. Use destinos definidos para reter dados.
• Solicitações duplicadas: Se os mesmos valores de parâmetro forem enviados várias vezes, somente a primeira solicitação será aceita até ser concluída.
• Mapeamento de esquema: os parâmetros não podem modificar mapeamentos de esquema de destino. Todos os mapeamentos seguem a configuração criada. Confira o artigo para obter mais informações sobre destinos de dados e configurações gerenciadas no Dataflow Gen2.