Compartilhar via

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

Este tutorial mostra como usar conteúdo dinâmico em pipelines do Microsoft Fabric. Ao criar um item de biblioteca variável e adicionar variáveis a ele, você pode automatizar valores para vários estágios do pipeline de implantação. Neste tutorial, você copia dados de um lakehouse para outro. Em seguida, use a biblioteca de variáveis para definir os valores de origem e de 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 workspace (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 no estágio de destino do pipeline de implantação.
  • Mostre que o valor da variável está em conformidade com o conjunto de valores ativos em cada estágio.

O diagrama a seguir mostra o layout do workspace para este tutorial.

Diagrama de um layout de workspace.

Pré-requisitos

Criar o workspace do Stage LHs, SourceLH_Stage lakehouse com dados de exemplo e Pipeline_Stage pipeline

Primeiro, crie um workspace e um lakehouse para usar como seus dados iniciais de preparo:

  1. Vá para o Power BI.

  2. Na barra lateral, selecione Workspace.

  3. Criar um espaço de trabalho. Chame-o de LHs de estágio.

    Captura de tela do botão para criar um novo workspace.

  4. Crie uma lakehouse:

    1. Na parte superior do workspace, selecione Novo item.

    2. Em Dados do Repositório, selecione Lakehouse.

      Captura de tela do bloco para selecionar um lakehouse como um novo item.

    3. Insira o nome SourceLH_Stage e selecione Criar.

  5. Crie um pipeline:

    1. Na lakehouse, selecione Novo pipeline.

      Captura de tela do bloco para criar um novo pipeline.

    2. Insira o nome Pipeline_Stage e 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 um lakehouse.

    4. Selecione Feriados Públicos.

      Captura de tela da seleção de dados de exemplo de Feriados Públicos.

    5. Depois que os dados de exemplo terminarem de carregar, selecione Avançar.

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

      Captura de tela dos detalhes de um destino de pipeline.

    7. Na página Revisar + Salvar , selecione Salvar + Executar.

      Captura de tela da página para salvar e executar um pipeline.

Criar os LHs de origem com o workspace Variáveis

Agora, crie o workspace do qual você trabalhará e usará com sua biblioteca de variáveis:

  1. Vá para o Power BI.

  2. Na barra lateral, selecione Workspace.

  3. Criar um espaço de trabalho. Chame-o de LHs de origem com variáveis.

Criar as SourceLH_Dev, SourceLH_Test e SourceLH_Prod lakehouses

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

  1. Crie a primeira lakehouse:

    1. Na barra lateral, selecione os LHs de origem com o workspace Variáveis.

    2. Selecione Novo item.

    3. Em Dados do Repositório, selecione Lakehouse.

    4. Insira o nome SourceLH_Dev e selecione Criar.

  2. Crie o segundo lakehouse seguindo as etapas anteriores. Nomeie-o SourceLH_Test.

  3. Crie o terceiro lakehouse seguindo as etapas anteriores. Nomeie-o SourceLH_Prod.

  4. Na barra lateral, selecione os LHs de origem com o workspace Variáveis e verifique se ele contém todas as casas de lago recém-criadas.

Obter as IDs do workspace e as IDs de objeto para lakehouses

Nestas etapas, você obtém os identificadores exclusivos a serem usados em sua biblioteca de variáveis:

  1. No Power BI, na barra lateral, selecione o workspace LHs de estágio .

  2. No workspace, selecione o SourceLH_Stage lakehouse.

  3. Copie a ID do workspace e a ID do objeto lakehouse na URL.

    Captura de tela que mostra como obter o identificador do workspace e o identificador de objeto lakehouse.

  4. Repita as etapas anteriores para o SourceLH_Dev e SourceLH_Test lakehouses nos LHs de origem com o workspace Variáveis.

Criar uma biblioteca de variáveis com variáveis

Agora, crie a biblioteca de variáveis:

  1. Nos LHs de origem com o workspace 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 String <GUID de SourceLH_Stage lakehouse>
    Source_WSID String <GUID do workspace SourceLH_Stage>
    Destination_LH String <GUID de SourceLH_Dev lakehouse>
    Destination_WSID String <GUID do workspace SourceLH_Dev>
    SourceTable_Name String Processed
    DestinationTable_Name String DevCopiedData

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

  6. Clique em Salvar.

Criar conjuntos de valores alternativos

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

  1. Crie o primeiro conjunto de valores:

    1. Na biblioteca de variáveis WS Variables , selecione Adicionar conjunto de valores.

    2. Insira o VS de Teste para o nome e, em seguida, selecione Criar.

    3. Crie as seguintes variáveis:

      Nome Tipo Conjunto de valores padrão
      Source_LH String <GUID de SourceLH_Dev lakehouse>
      Source_WSID String <GUID do workspace SourceLH_Dev>
      Destination_LH String <GUID de SourceLH_Test lakehouse>
      Destination_WSID String <GUID do workspace SourceLH_Test>
      SourceTable_Name String DevCopiedData
      DestinationTable_Name String TestCopiedData

    4. Selecione Salvar>Concordar.

  2. Crie o segundo conjunto de valores:

    1. Selecione Adicionar conjunto de valores.

    2. Insira o VS do Prod para o nome e, em seguida, selecione Criar.

    3. Crie as seguintes variáveis:

      Nome Tipo Conjunto de valores padrão
      Source_LH String <GUID de SourceLH_Test lakehouse>
      Source_WSID String <GUID do workspace SourceLH_Test>
      Destination_LH String <GUID de SourceLH_Prod lakehouse>
      Destination_WSID String <GUID do workspace SourceLH_Prod>
      SourceTable_Name String TestCopiedData
      DestinationTable_Name String ProdCopiedData

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

    4. Selecione Salvar>Concordar.

Criar o pipeline Pipeline_Deploy e declarar variáveis

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

  1. Nos LHs de origem com o workspace Variáveis, selecione Novo item.

  2. Em Obter dados, selecione Pipeline.

    Captura de tela do bloco de um pipeline.

  3. Insira o nome Pipeline_Deploy e selecione Criar.

  4. Selecione Copiar dados>Adicionar à tela.

    Captura de tela das seleções de menu para adicionar dados de cópia a uma tela.

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

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

    Captura de tela da guia para variáveis de biblioteca.

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

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

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

  8. Clique em Salvar.

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

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

  1. Nos LHs de origem com workspace variáveis , vá para Pipeline_Deploy.

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

  3. Selecione Origem.

  4. Configurar o SourceLH:

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

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis de 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 a uma fonte de conexão.

  5. Configurar SourceWSID:

    1. NaID do Workspace de >, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis de 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 a uma fonte de workspace.

  6. Configurar SourceTableName:

    1. EmTabela de>, selecione Enter 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 de biblioteca**.

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

      Captura de tela 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 selecione OK no submenu. Depois que os dados forem preenchidos, você poderá fechar a visualização de dados.

    Captura de tela da visualização de dados para uma conexã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 o pipeline:

  1. Nos LHs de origem com workspace 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 o SourceLH:

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

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

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

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

  5. Configurar DestinationWSID:

    1. EmID do Workspace de >, selecione Adicionar conteúdo dinâmico.

    2. Selecione as reticências (...) e, em seguida, selecione **Variáveis de 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 workspace.

  6. Configurar DestinationTableName:

    1. EmTabela de>, 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 de biblioteca**.

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

      Captura de tela 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 se ele é executado com êxito.

    Captura de tela de uma execução de pipeline.

Criar o pipeline de implantação

Agora, crie seu pipeline de implantação:

  1. Nos LHs de origem com o workspace 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 o estágio desenvolvimento :

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

      Captura de tela da seleção do workspace para um novo pipeline de implantação.

    2. Selecione Continuar. O estágio agora deve ser preenchido com os itens do workspace.

      Captura de tela da parte de desenvolvimento de um pipeline de implantação.

  5. Para o estágio de teste :

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

    2. Selecione o botão Implantar . Selecione Implantar novamente. O estágio de teste agora deve ser preenchido.

      Captura de tela da parte de teste de um novo pipeline de implantação.

  6. Para o estágio de produção :

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

    2. Selecione o botão Implantar . Selecione Implantar novamente. O estágio de produção agora deve ser preenchido.

      Captura de tela da parte de produção de um novo pipeline de implantação.

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

Nestas etapas, você configura o conjunto ativo para cada estágio no pipeline de implantação:

  1. Configure o conjunto ativo para o estágio de teste :

    1. Na barra lateral, selecione o pipeline Deployment_Pipeline_Var .

    2. Selecione o estágio de teste .

      Captura de tela do estágio de teste.

    3. Selecione variáveis do 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 de variáveis, 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>Concordar.

  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 do WS.

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

    5. Selecione Salvar>Concordar.

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. Verifique o SourceLHs_Dev lakehouse:

    1. Nos LHs de origem com o workspace Variáveis, selecione o SourceLHs_Dev lakehouse.

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

    3. No explorer, expanda tabelasde dbo>schemas>.

    4. Confirme se a tabela DevCopiedData é exibida.

      Captura de tela da área para tabelas no explorer.

  2. Alterne para o SourceLHs_Test lakehouse e repita as etapas anteriores.

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

  3. Alterne para o SourceLHs_Prod lakehouse e repita as etapas anteriores.

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

  4. Verifique o estágio de teste do pipeline de Deployment_Pipeline_Var :

    1. Alterne para o pipeline Deployment_Pipeline_Var e selecione o estágio de teste .

    2. Selecione o pipeline Pipeline_Deploy .

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

  5. Verifique o SourceLHs_Test lakehouse novamente:

    1. Mude para o SourceLHs_Test lakehouse.

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

    3. No explorer, expanda tabelasde dbo>schemas>.

    4. Confirme se a tabela TestCopiedData é exibida.

      Captura de tela da área para tabelas e uma visualização de dados no explorer.

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

    1. Alterne para o pipeline Deployment_Pipeline_Var e selecione o estágio produção .

    2. Selecione o pipeline Pipeline_Deploy .

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

  7. Verifique o SourceLHs_Prod lakehouse novamente:

    1. Mude para o SourceLHs_Prod lakehouse.

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

    3. No explorer, expanda tabelasde dbo>schemas>.

    4. Confirme se a tabela ProdCopiedData é exibida.

Personalizar os valores de variável 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 workspace, selecione Controle do código-fonte e conecte o workspace a um repositório Git.

  2. No painel Controle do Código-fonte , selecione Confirmar para enviar o conteúdo do workspace por push para o repositório Git.

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

  3. Compare os arquivos ProdVS.json e TestVS.json na pasta valueSets . Confirme se a overrides variável está definida como 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 workspace.

    {
 "$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