Partilhar 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 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, você copia dados de uma casa de lago para outra. 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 valor ativo definido no estágio de destino do pipeline de implantaçã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, SourceLH_Stage lakehouse com dados de exemplo e 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 tela do bloco para selecionar uma casa do lago como um novo item.

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

  5. Crie um pipeline:

    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ã a mostrar a seleção de dados de exemplo de Feriados.

    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 tela dos detalhes de um destino de pipeline.

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

      Captura de tela da página para salvar 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. Chame-lhe LHs de origem com variáveis.

Crie as SourceLH_Dev, SourceLH_Test e SourceLH_Prod lakehouses

Em seguida, crie as três lakehouses para usar com a biblioteca variável:

  1. Crie a primeira casa do lago:

    1. Na barra lateral, selecione o espaço de trabalho LHs de origem com variáveis .

    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. Nomeie-o SourceLH_Prod.

  4. Na barra lateral, selecione o espaço de trabalho LHs de origem com variáveis e certifique-se de que ele contém todas as casas de lago recém-criadas.

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 LHs do Palco .

  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 tela de seleções de menu para adicionar dados de cópia a uma tela.

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

  6. Selecione **Variáveis da 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 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. No espaço 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. EmID do Espaço de Trabalho de Origem>, 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. Configure 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 submenu. 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. No espaço 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. EmID do Espaço de Trabalho de Destino>, 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 se ele foi 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. No espaço 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 suspensa, 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 tela da parte de desenvolvimento de um pipeline de implantaçã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 seleção da casa do lago SourceLH_Dev .

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

      Captura de tela da parte de teste de um novo pipeline de implantaçã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 seleção da casa do lago SourceLH_Test .

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

      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 a etapa Teste .

      Captura de tela da etapa 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 SourceLHs_Dev lakehouse.

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

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

    4. Confirme se a tabela DevCopiedData é exibida.

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

  2. Mude para a casa do lago SourceLHs_Test 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 a casa do lago SourceLHs_Prod 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. Alterne para o pipeline de Deployment_Pipeline_Var e selecione o estágio de teste .

    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 casa do lago SourceLHs_Test.

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

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

    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. Alterne para o pipeline de Deployment_Pipeline_Var e selecione o estágio de produção .

    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 a casa do lago SourceLHs_Prod.

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

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

    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