Usar bibliotecas de variáveis do Fabric no Dataflow Gen2 (versão prévia)

Bibliotecas de variáveis do Fabric oferecem uma maneira centralizada de gerenciar valores de configuração em todas as cargas de trabalho do Microsoft Fabric. Com a nova integração no Dataflow Gen2 (versão prévia), você pode referenciar essas variáveis diretamente em seu fluxo de dados, habilitando o comportamento dinâmico entre ambientes e simplificando fluxos de trabalho de CI/CD.

Pré-requisitos

Para usar bibliotecas de variáveis do Fabric no Dataflow Gen2, verifique o seguinte:

• Você tem permissão para criar e gerenciar bibliotecas de variáveis do Fabric.

• Você está trabalhando com Dataflow Gen2 com CI/CD.

Como usar bibliotecas de variáveis do Fabric no Dataflow Gen2

Dentro do Seu Fluxo de Dados Gen2, você pode referenciar uma variável usando uma das seguintes funções:

• Variable.ValueOrDefault

• Variable.Value

O identificador esperado que deve ser passado para qualquer uma dessas duas funções deve seguir o formato de:

$(/**/LibraryName/VariableName)

Os exemplos a seguir para ambas as funções no cenário em que você tem uma biblioteca de variáveis chamada Minha Biblioteca e uma variável da cadeia de caracteres de tipo chamada Minha Variável:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Aplicando essa função a um script de consulta, vamos usar a consulta de exemplo a seguir que se conecta a uma tabela chamada Table1 de um LakehouseId e WorkspaceId específicos usando o conector Fabric Lakehouse.

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = "cfafbeb1-8037-4d0c-896e-a46fb27ff229"]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId = "5b218778-e7a5-4d73-8187-f10824047715"]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Você planeja substituir os valores passados para o workspaceId e lakehouseId para que, em cenários de CI/CD, eles apontem dinamicamente para o item certo no estágio certo.

Para esse fim, no mesmo workspace em que o fluxo de dados está localizado, você também tem uma biblioteca de variáveis chamada Minha Biblioteca que contém as seguintes variáveis que você planeja referenciar no fluxo de dados:

Com essas informações, você pode modificar o script de consulta para substituir os valores que resultam no próximo script:

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = Variable.ValueOrDefault("$(/**/My Library/Workspace ID)",  "cfafbeb1-8037-4d0c-896e-a46fb27ff229")]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId =  Variable.ValueOrDefault("$(/**/My Library/Lakehouse ID)","5b218778-e7a5-4d73-8187-f10824047715")]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Quando você executa o fluxo de dados com o script modificado, ele é resolvido para o valor da variável e o tipo de dados correto definido pela variável. Isso aponta para um workspace diferente e Lakehouse, dependendo dos valores disponíveis no momento da execução do fluxo de dados.

Considerações e limitações

A lista a seguir descreve restrições e comportamentos importantes para ter em mente ao usar bibliotecas de variáveis do Fabric com o Dataflow Gen2. Essas limitações afetam a forma como as variáveis são referenciadas, avaliadas e aplicadas durante o design e o runtime.

• Escopo do Workspace: as bibliotecas de variáveis devem residir no mesmo workspace que o Dataflow Gen2 com CI/CD.

• Local de referência: as variáveis só podem ser usadas dentro do arquivo mashup.pq de um Dataflow Gen2 com CI/CD.

• Comportamento de runtime: os valores de variáveis são recuperados no início de uma operação de execução e persistidos durante toda a operação. As alterações que ocorrem em uma biblioteca durante uma execução de fluxo de dados não interrompem ou afetam sua execução.

• Suporte ao editor do Power Query: não há suporte atual para resolver ou avaliar variáveis no editor do Power Query.

• Usando um valor padrão: ao usar um valor padrão por meio da função Variable.ValueOrDefault, verifique se o tipo de dados do valor padrão corresponde ao tipo de dados da variável referenciada.

• Tipos com suporte: há suporte apenas para variáveis de tipos básicos (boolean, , datetime, guid, integer, numbere string).

• Conexões fixas: as variáveis não podem alterar as informações de conexão. As conexões permanecem fixas para as configurações de caminho de recurso criadas.

• Sobrescrever risco: os usuários com acesso para modificar bibliotecas de variáveis podem sobrescrever valores de variáveis, afetando potencialmente a saída do fluxo de dados.

• Mapeamento de esquema: as variáveis não podem modificar mapeamentos de esquema de destino; os mapeamentos seguem a configuração criada.

• Visibilidade da linhagem: as exibições de linhagem não mostram links entre o Dataflow Gen2 e as bibliotecas variáveis que ele faz referência.

• Limite de variável: os fluxos de dados só podem recuperar um máximo de 50 variáveis.

• Suporte ao SPN: os fluxos de dados só poderão ser atualizados com êxito se a atualização não estiver usando um SPN para autenticação.