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 habilitando diferentes entradas e cenários sem modificar o próprio fluxo de dados. 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 fluxo de dados seja executado passando valores de parâmetro fora do editor do Power Query por meio da API REST do Fabric ou por meio de experiências nativas do Fabric. Ele permite que você tenha uma experiência mais dinâmica com o fluxo de dados em que cada execução pode ser invocada com parâmetros diferentes que afetam a execução do fluxo de dados.

Pré-requisitos

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

Habilitar o modo de parâmetro público

Como proprietário do fluxo de dados, abra o fluxo de dados. Na guia Página Inicial da faixa de opções, 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 seção Parâmetros, você pode habilitar a opção que diz "Habilitar parâmetros a serem descobertos e substituir para execução" para habilitar o modo de parâmetros públicos.

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

Quando esse modo estiver habilitado, você receberá 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 tiver sido habilitado, você poderá salvar seu fluxo de dados.

Passar valores de parâmetro 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 em que há uma distinção entre parâmetros obrigatórios e não requisitos.

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

Usar a atividade de Fluxo de Dados nos 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úblico 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 têm. 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 atualizar para solicitar as informações de parâmetro mais recentes do fluxo de dados.

Tipos de parâmetros compatíveis

A tabela a seguir mostra os tipos de parâmetro com suporte no momento e o link para a definição da API REST para que ele entenda quais são os valores esperados pela API REST.

Considerações e limitações

Veja a seguir 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 & gatilho manual: fluxos de dados com parâmetros públicos não podem ser agendados ou disparados manualmente por meio do Fabric, a menos que nenhum parâmetro necessário seja definido.
• Parametrização sem suporte: não há suporte para parâmetros que alteram caminhos de recursos para fontes ou destinos. As conexões são fixadas no caminho definido.
• 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âmetro usados durante a execução.
• Comportamento de preparação: somente a execução mais recente é 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é que seja 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.