Tutorial: Usar bibliotecas de variáveis para personalizar e compartilhar configurações de itens

Este tutorial mostra-te como usar conteúdo dinâmico em pipelines Fabric. Ao criar um item de biblioteca de variáveis e adicionar variáveis a ele, você pode automatizar valores para vários estágios do pipeline de implantação. Neste tutorial, vai copiar dados de um lakehouse para outro. Em seguida, use a biblioteca de variáveis para definir os valores de origem e destino para a atividade de cópia.

Neste tutorial, você:

  • Crie uma biblioteca de variáveis.
  • Adicione variáveis à biblioteca.
  • Defina conjuntos de valores adicionais para as variáveis.
  • Consuma as variáveis em outro item no espaço de trabalho (um pipeline).
  • Edite as variáveis em um repositório Git.
  • Crie um pipeline de implantação e implante a biblioteca de variáveis.
  • Altere o conjunto de valores ativos definido na fase de destino do pipeline de implementação.
  • Mostrar que o valor da variável está em conformidade com o valor ativo definido em cada estágio.

O diagrama a seguir mostra o layout do espaço de trabalho para este tutorial.

Diagrama de um layout de espaço de trabalho.

Pré-requisitos

Crie o espaço de trabalho Stage LHs, o lakehouse SourceLH_Stage com dados de exemplo e o pipeline Pipeline_Stage

Primeiro, crie um espaço de trabalho e uma casa de lago para usar como seus dados iniciais de preparação:

  1. Vá para Power BI.

  2. Na barra lateral, selecione Espaço de trabalho.

  3. Crie um espaço de trabalho. Chame-lhe Stage LHs.

    Captura de ecrã do botão para criar uma nova área de trabalho.

  4. Crie uma casa no lago:

    1. Na parte superior do espaço de trabalho, selecione Novo item.

    2. Em Armazenar dados, selecione Lakehouse.

      Captura de ecrã do mosaico para selecionar um lakehouse como novo item.

    3. Introduza o nome SourceLH_Stage e, em seguida, selecione Criar.

  5. Crie um fluxo:

    1. Na casa do lago, selecione Novo pipeline.

      Captura de ecrã do bloco para criar um novo pipeline.

    2. Introduza o nome Pipeline_Stage e, em seguida, selecione Criar.

    3. No assistente Copiar dados para o Lakehouse , na página Escolher fonte de dados , selecione Dados de exemplo.

      Captura de tela da página para escolher uma fonte de dados para copiar dados em uma casa de lago.

    4. Selecione Feriados.

      Captura de ecrã da seleção de dados de exemplo de Feriados públicos.

    5. Depois que o carregamento dos dados de exemplo terminar, selecione Avançar.

    6. Na página Conectar ao destino dos dados , selecione Avançar.

      Captura de ecrã dos detalhes de um destino de pipeline.

    7. Na página Rever + guardar, selecione Guardar + Executar.

      Captura de ecrã da página para guardar e executar um pipeline.

Criar o espaço de trabalho LHs de origem com variáveis

Agora, crie o espaço de trabalho que você trabalhará e usará com sua biblioteca de variáveis:

  1. Vá para Power BI.

  2. Na barra lateral, selecione Espaço de trabalho.

  3. Crie um espaço de trabalho. Dê-lhe o nome de LHs de origem com variáveis.

Crie os lakehouses SourceLH_Dev, SourceLH_Test e SourceLH_Prod

Em seguida, crie as três lakehouses para utilizar com a biblioteca de variáveis:

  1. Crie a primeira casa do lago:

    1. Na barra lateral, selecione o espaço de trabalho Source LHs with Variables.

    2. Selecione Novo item.

    3. Em Armazenar dados, selecione Lakehouse.

    4. Introduza o nome SourceLH_Dev e, em seguida, selecione Criar.

  2. Crie a segunda casa do lago seguindo as etapas anteriores. Nomeie-o SourceLH_Test.

  3. Crie a terceira casa do lago seguindo as etapas anteriores. Dê-lhe o nome de SourceLH_Prod.

  4. Na barra lateral, selecione o espaço de trabalho Source LHs with Variables e certifique-se de que contém todos os lakehouses recém-criados.

Obter os IDs do espaço de trabalho e os IDs do objeto para lakehouses

Nestas etapas, você obtém os identificadores exclusivos para usar em sua biblioteca de variáveis:

  1. No Power BI, na barra lateral, selecione o espaço de trabalho Stage LHs.

  2. No espaço de trabalho, selecione a SourceLH_Stage lakehouse.

  3. Copie o ID do espaço de trabalho e o ID do objeto lakehouse no URL.

    Captura de tela que mostra como obter o identificador de espaço de trabalho e o identificador de objeto lakehouse.

  4. Repita as etapas anteriores para o SourceLH_Dev e SourceLH_Test lakehouses no espaço de trabalho Source LHs with Variables .

Criar uma biblioteca de variáveis com variáveis

Agora, crie a biblioteca de variáveis:

  1. No espaço de trabalho LHs de origem com variáveis , selecione Novo item.

  2. Em Desenvolver dados, selecione **Biblioteca de variáveis **.

    Captura de tela que mostra o bloco para criar uma biblioteca de variáveis.

  3. Nomeie as variáveis WS da biblioteca e selecione Criar.

  4. Selecione Nova variável.

    Captura de tela que mostra o botão para selecionar uma nova variável.

  5. Crie as seguintes variáveis:

    Nome Tipo Conjunto de valores padrão
    Source_LH Cordão <GUID de SourceLH_Stage lakehouse>
    Source_WSID Cordão <GUID do espaço de trabalho SourceLH_Stage>
    Destination_LH Cordão <GUID de SourceLH_Dev lakehouse>
    Destination_WSID Cordão <GUID do espaço de trabalho SourceLH_Dev>
    SourceTable_Name Cordão Processed
    DestinationTable_Name Cordão DevCopiedData

    Captura de tela do conjunto padrão concluído para a biblioteca de variáveis.

  6. Selecione Guardar.

Criar conjuntos de valores alternativos

Nestas etapas, você adiciona os conjuntos de valores alternativos à sua biblioteca de variáveis:

  1. Crie o primeiro conjunto de valores:

    1. Na biblioteca de variáveis WS Variables , selecione Add value set.

    2. Insira Test VS para o nome e selecione Criar.

    3. Crie as seguintes variáveis:

      Nome Tipo Conjunto de valores padrão
      Source_LH Cordão <GUID de SourceLH_Dev lakehouse>
      Source_WSID Cordão <GUID do espaço de trabalho SourceLH_Dev>
      Destination_LH Cordão <GUID de SourceLH_Test lakehouse>
      Destination_WSID Cordão <GUID do espaço de trabalho SourceLH_Test>
      SourceTable_Name Cordão DevCopiedData
      DestinationTable_Name Cordão TestCopiedData

    4. Selecione Salvar>Concordo.

  2. Crie o segundo conjunto de valores:

    1. Selecione Adicionar conjunto de valores.

    2. Digite Prod VS para o nome e selecione Criar.

    3. Crie as seguintes variáveis:

      Nome Tipo Conjunto de valores padrão
      Source_LH Cordão <GUID de SourceLH_Test lakehouse>
      Source_WSID Cordão <GUID do espaço de trabalho SourceLH_Test>
      Destination_LH Cordão <GUID de SourceLH_Prod lakehouse>
      Destination_WSID Cordão <GUID do espaço de trabalho SourceLH_Prod>
      SourceTable_Name Cordão TestCopiedData
      DestinationTable_Name Cordão ProdCopiedData

      Captura de tela dos valores alternativos concluídos em uma biblioteca de variáveis.

    4. Selecione Salvar>Concordo.

Criar o pipeline de Pipeline_Deploy e declarar variáveis

Nestas etapas, você cria seu pipeline e declara suas variáveis:

  1. No espaço de trabalho LHs de origem com variáveis , selecione Novo item.

  2. Em Obter dados, selecione Pipeline.

    Captura de ecrã do módulo de um pipeline.

  3. Introduza o nome Pipeline_Deploy e, em seguida, selecione Criar.

  4. Selecione Copiar dados>Adicionar à tela.

    Captura de ecrã das opções de menu para adicionar dados copiados a um ecrã.

  5. Selecione a tela para que o foco esteja desativado Copiar dados.

  6. Selecione **Variáveis da biblioteca **.

    Captura de ecrã do separador das variáveis da biblioteca.

  7. Selecione Novo e adicione as seguintes variáveis:

    Nome Biblioteca Nome da variável Tipo
    SourceLH Variáveis WS Source_LH Cordão
    SourceWSID Variáveis WS Source_WSID Cordão
    DestinationLH Variáveis WS Destination_LH Cordão
    DestinationWSID Variáveis WS Destination_WSID Cordão
    SourceTableName Variáveis WS SourceTable_Name Cordão
    DestinationTableName Variáveis WS DestinationTable_Name Cordão

    Captura de tela da adição de variáveis a um pipeline.

  8. Selecione Guardar.

Configurar a conexão de origem para o pipeline de Pipeline_Deploy

Nestas etapas, você configura a conexão de origem para seu pipeline:

  1. Na área de trabalho LHs de Origem com Variáveis, vá para Pipeline_Deploy.

  2. Na tela, selecione Copiar dados para que o foco esteja em Copiar dados.

  3. Selecione Fonte.

  4. Configurar SourceLH:

    1. EmConexão de origem>, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis da biblioteca **.

    3. Selecione SourceLH. Ele preenche a caixa com @pipeline().libraryVariables.SourceLH. Selecione OK.

      Captura de tela do painel para adicionar conteúdo dinâmico para uma fonte de conexão.

  5. Configurar SourceWSID:

    1. Em Origem>ID do espaço de trabalho, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis da biblioteca **.

    3. Selecione SourceWSID. Ele preenche a caixa com @pipeline().libraryVariables.SourceWSID. Selecione OK.

      Captura de tela do painel para adicionar conteúdo dinâmico para uma fonte de espaço de trabalho.

  6. Configurar SourceTableName:

    1. > EmTabela de origem, selecione Inserir manualmente, selecione Nome da tabela e, em seguida, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis da biblioteca **.

    3. Selecione SourceTableName. Ele preenche a caixa com @pipeline().libraryVariables.SourceTableName. Selecione OK.

      Captura de ecrã do painel para adicionar conteúdo dinâmico a um nome de tabela.

  7. Agora que a conexão de origem está configurada, você pode testá-la. Selecione Visualizar dados e, em seguida, selecione OK no painel. Depois que os dados forem preenchidos, você poderá fechar a visualização de dados.

    Captura de ecrã da pré-visualização de dados para uma ligação de origem.

Configurar a conexão de destino para o pipeline de Pipeline_Deploy

Nestas etapas, você configura a conexão de destino para seu pipeline:

  1. Na área de trabalho LHs de Origem com Variáveis, vá para Pipeline_Deploy.

  2. Na tela, selecione Copiar dados para que o foco esteja em Copiar dados.

  3. Selecione Destino.

  4. Configurar SourceLH:

    1. Em Conexão>de destino, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis da biblioteca **.

    3. Selecione SourceLH. Ele preenche a caixa com @pipeline().libraryVariables.DestinationLH. Selecione OK.

      Captura de ecrã do painel para adicionar conteúdo dinâmico a um destino de ligação.

  5. Configurar DestinationWSID:

    1. Em Destino>ID do espaço de trabalho, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis da biblioteca **.

    3. Selecione DestinationWSID. Ele preenche a caixa com @pipeline().libraryVariables.DestinationWSID. Selecione OK.

      Captura de tela do painel para adicionar conteúdo dinâmico para um destino de espaço de trabalho.

  6. Configurar DestinationTableName:

    1. EmTabela de Destino>, selecione Inserir manualmente, selecione Nome da tabela e, em seguida, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis da biblioteca **.

    3. Selecione DestinationTableName. Ele preenche a caixa com @pipeline().libraryVariables.DestinationTableName. Selecione OK.

      Captura de ecrã do painel para adicionar conteúdo dinâmico a um nome de tabela de destino.

  7. Agora que a conexão de destino está configurada, salve o pipeline e selecione Executar. Confirme que é executado com êxito.

    Captura de ecrã da execução de um pipeline.

Criar o pipeline de implementação

Agora, crie seu pipeline de implantação:

  1. Na área de trabalho LHs de origem com variáveis, selecione Criar pipeline de implantação.

  2. Nomeie o pipeline Deployment_Pipeline_Var e selecione Avançar.

    Captura de tela do painel para nomear um novo pipeline de implantação.

  3. No pipeline de implantação, selecione Criar e continuar.

    Captura de tela que mostra o botão para criar um pipeline de implantação.

  4. Para a fase de desenvolvimento :

    1. Na lista pendente, selecione LHs de origem com variáveis para o espaço de trabalho. Em seguida, selecione a marca de seleção Atribuir .

      Captura de tela mostrando a seleção do espaço de trabalho para um novo pipeline de implantação.

    2. Selecione Continuar. O palco agora deve ser preenchido com os itens do espaço de trabalho.

      Captura de ecrã da parte de desenvolvimento de um pipeline de implementação.

  5. Para a etapa de teste :

    1. Marque a caixa de seleção na parte superior para selecionar todos os itens. Em seguida, desmarque a caixa de verificação para o SourceLH_Dev lakehouse.

    2. Selecione o botão Implantar . Selecione Implantar novamente. A fase de teste deve agora ser preenchida.

      Captura de ecrã da parte de teste de um novo pipeline de implementação.

  6. Para a fase de produção :

    1. Marque a caixa de seleção na parte superior para selecionar todos os itens. Em seguida, desmarque a caixa de verificação do lakehouse SourceLH_Test.

    2. Selecione o botão Implantar . Selecione Implantar novamente. A fase de produção deve agora ser preenchida.

      Captura de ecrã da parte de produção de um novo pipeline de implementação.

Definir o conjunto ativo da biblioteca de variáveis para cada estágio

Nestas etapas, configura o conjunto ativo para cada fase no pipeline de implementação:

  1. Configure o conjunto ativo para a fase Teste:

    1. Na barra lateral, selecione o pipeline Deployment_Pipeline_Var.

    2. Selecione a etapa Teste .

      Captura de ecrã da fase de teste.

    3. Selecione Variáveis WS.

    4. Selecione as reticências (...) e, em seguida, selecione Definir como ativo. Selecione o botão Definir como ativo .

      Captura de tela de uma biblioteca variável, com seleções para definir o estágio de teste como ativo.

      O conjunto ativo agora está configurado.

      Captura de tela de um conjunto ativo configurado em um pipeline de implantação.

    5. Selecione Salvar>Concordo.

  2. Configure o conjunto ativo para o estágio Prod :

    1. Na barra lateral, selecione o pipeline Deployment_Pipeline_Var.

    2. Selecione o estágio Prod .

    3. Selecione Variáveis WS.

    4. Selecione as reticências (...) e, em seguida, selecione Definir como ativo. Selecione o botão Definir como ativo .

    5. Selecione Salvar>Concordo.

Verificar e testar a biblioteca de variáveis

Agora que você configurou a biblioteca de variáveis e configurou todos os conjuntos ativos para cada estágio do pipeline de implantação, você pode verificá-los:

  1. Confira a SourceLHs_Dev lakehouse:

    1. No espaço de trabalho LHs de Origem com Variáveis, selecione o lakehouse SourceLHs_Dev.

    2. Altere a conexão de Lakehouse para ponto final de análise SQL.

    3. No explorador, expanda Schemas>dbo>Tabelas.

    4. Confirme se a tabela DevCopiedData é exibida.

      Captura de ecrã da área das tabelas no explorador.

  2. Mude para o SourceLHs_Test lakehouse e repita os passos anteriores.

    A tabela TestCopiedData não deve aparecer porque você ainda não executou o pipeline com o conjunto Test VS ativo.

  3. Mude para o SourceLHs_Prod lakehouse e repita os passos anteriores.

    A tabela ProdCopiedData não deve aparecer porque você ainda não executou o pipeline com o conjunto Prod VS ativo.

  4. Verifique a etapa de teste do pipeline de Deployment_Pipeline_Var :

    1. Mude para o pipeline Deployment_Pipeline_Var e selecione a fase Test.

    2. Selecione o pipeline Pipeline_Deploy.

    3. Selecione Executar. Este processo deve ser concluído com êxito.

  5. Confira o SourceLHs_Test lakehouse novamente:

    1. Mude para a SourceLHs_Test lakehouse.

    2. Altere a conexão de Lakehouse para ponto final de análise SQL.

    3. No explorador, expanda Schemas>dbo>Tabelas.

    4. Confirme se a tabela TestCopiedData é exibida.

      Captura de ecrã da área para tabelas e uma pré-visualização de dados no explorador.

  6. Confira o estágio de produção do pipeline de Deployment_Pipeline_Var :

    1. Mude para o pipeline Deployment_Pipeline_Var e selecione a fase Production.

    2. Selecione o pipeline Pipeline_Deploy.

    3. Selecione Executar. Este processo deve ser concluído com êxito.

  7. Confira o SourceLHs_Prod lakehouse novamente:

    1. Mude para o lakehouse SourceLHs_Prod.

    2. Altere a conexão de Lakehouse para ponto final de análise SQL.

    3. No explorador, expanda Schemas>dbo>Tabelas.

    4. Confirme se a tabela ProdCopiedData é exibida.

Personalizar os valores das variáveis no Git (opcional)

Para ver como a biblioteca de variáveis é representada no Git ou para editar as variáveis de um repositório Git:

  1. No espaço de trabalho, selecione Controle do código-fonte e conecte o espaço de trabalho a um repositório Git.

  2. No painel Controle do código-fonte , selecione Confirmar para enviar o conteúdo do espaço de trabalho para o repositório Git.

    O repositório Git tem uma pasta para cada item no espaço de trabalho. Uma pasta chamada variáveis WS. VariableLibrary representa o item de biblioteca variável. Para obter mais informações sobre o conteúdo dessa pasta, consulte Biblioteca variável CI/CD.

  3. Compare os arquivos ProdVS.json e TestVS.json na pasta valueSets . Confirme se a overrides variável está definida para os valores diferentes. Você pode editar esses valores diretamente na interface do usuário ou editando esse arquivo no Git e atualizando-o para o espaço de trabalho.

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

Conteúdo relacionado

  • Last updated on