Partilhar via


Comparar conteúdo em diferentes estágios de implantação

Antes de implantar o conteúdo em um estágio diferente, pode ser útil ver as diferenças entre os dois estágios. A home page do pipeline de implantação compara estágios de implantação consecutivos e indica se há diferenças entre eles. Use os botões de revisão Comparar e Alterar para exibir o conteúdo de cada pipeline e ver exatamente quais itens são diferentes e onde estão essas diferenças.

Os pipelines de implantação emparelham itens de dois estágios vizinhos combinando tipo de item e nome de item, para saber quais itens comparar e substituir. Itens do mesmo nome e tipo são emparelhados. Se houver mais de um item com o mesmo nome e tipo em um espaço de trabalho, os itens serão emparelhados se seus caminhos forem os mesmos. Se o caminho não for o mesmo, os itens não serão emparelhados. O emparelhamento é criado apenas uma vez, durante a primeira implantação de um estágio para outro ou durante a atribuição de um espaço de trabalho. Em implantações subsequentes, cada item implantado substitui seus metadados de item emparelhados, incluindo seu nome, se tiver sido alterado.

Comparar estágios

Captura de tela mostrando três estágios de implantação. Há uma verificação verde entre os estágios de teste e produção e um X laranja entre os estágios de desenvolvimento e teste.

Um indicador de ícone de comparação aparece entre dois estágios sequenciais para fornecer uma visão rápida das diferenças entre eles. O indicador de comparação tem dois estados:

  • Indicador verde – Os metadados para cada item de conteúdo em ambos os estágios, são os mesmos.

  • Indicador laranja - Aparece se uma destas condições for verdadeira:

    • Alguns dos itens de conteúdo em cada etapa foram alterados ou atualizados (têm metadados diferentes).
    • Há uma diferença no número de itens em cada etapa.

Quando dois estágios sequenciais são diferentes, um link Comparar aparece abaixo do ícone de comparação laranja. Selecione Comparar para abrir a lista de itens de conteúdo em ambos os estágios. Esta vista Comparar ajuda-o a controlar alterações ou diferenças entre itens em cada fase de pipeline.

Uma captura de tela mostrando a opção de comparação, que expande a exibição de comparação e permite comparar itens entre os estágios do pipeline de implantação.

Na exibição de comparação, os itens emparelhados estão próximos uns dos outros, mesmo que tenham nomes diferentes. Todos os itens no espaço de trabalho são listados em uma lista simples, independentemente de sua estrutura de pastas. Passe o cursor sobre um item para ver seu caminho e nome.

Os itens que não estão emparelhados ou que foram alterados recebem um dos seguintes rótulos:

  • Novo – Um novo item no estágio de origem. Este item não existe no estágio de destino. Após a implantação, esse item será clonado para o estágio de destino.

  • Diferente – Um item que existe tanto no estágio de origem quanto no de destino, onde uma das versões foi alterada após a última implantação. Após a implantação, o item no estágio de origem substituirá o item no estágio de destino, independentemente de onde a alteração foi feita.

    Os modelos semânticos com regras de implantação configuradas que não foram implantadas também são marcados como diferentes, uma vez que as regras de implantação não são aplicadas até que os modelos semânticos sejam implantados do estágio de origem ao estágio de destino.

  • Ausente de – Este item aparece no estágio de destino, mas não no estágio de origem. A implantação não afeta esses itens.

Nota

Se você fizer alterações em uma pasta, como mover seu local ou renomeá-la, mesmo que não tenha alterado os itens nela, os itens ainda serão tratados como se você os renomeasse. Portanto, ao comparar pipelines, os itens são rotulados como Diferentes.

Rever as alterações aos itens emparelhados

Se um item de texto, como um modelo semântico, for diferente, passe o mouse sobre ele para ver o botão Alterar revisão .

Captura de tela mostrando o botão de revisão de alterações ao lado de um item.

Se não houver nada para comparar, o botão está desativado. Se houver alterações no esquema, você poderá selecionar o botão para ver uma comparação detalhada, linha por linha, dos dois itens.

Quando você seleciona o botão Alterar revisão , uma janela pop-up é aberta com uma comparação linha a linha do conteúdo do item como ele aparece atualmente nos dois estágios que estão sendo comparados.

A parte superior do ecrã tem as seguintes informações:

  1. O nome do espaço de trabalho seguido pelo nome do item conforme ele aparece no estágio de origem (a ser implantado).
  2. O número total de alterações feitas no arquivo no estágio a ser modificado (verde) e no estágio a ser implantado (vermelho).
  3. Setas para cima e para baixo que levam você à diferença anterior ou seguinte no arquivo.
  4. Uma barra de navegação no lado direito com barras vermelhas ou verdes destacando onde as alterações estão no arquivo.
  5. Botões que alternam entre uma vista lado a lado e uma vista em linha das alterações.
  6. A janela de revisão de alterações com uma comparação linha a linha dos itens.

Comparar alterações

Na visualização de comparação lado a lado dos itens, a área de código é dividida em duas:

  • À esquerda está o conteúdo do item no estágio de destino da implantação. Esta etapa será modificada na próxima implantação. O seu conteúdo será anulado.
  • À direita está o conteúdo do item no estágio de origem da implantação. Esta etapa será implantada. O seu conteúdo será aplicado.
  • As linhas de cada lado aparecem na mesma ordem, de modo que cada linha está ao lado de seu equivalente no estágio comparado.

A visualização de comparação embutida , em oposição à exibição lado a lado, mostra cada linha no estágio de destino (a ser modificado) abaixo de seu equivalente no estágio de origem (a ser implantado).

Em ambos os monitores de comparação, seja em linha ou lado a lado, as diferenças são destacadas da seguinte forma:

  • As linhas de conteúdo do arquivo são numeradas e as linhas que foram alteradas são marcadas da seguinte maneira:

    • As alterações mostradas no estágio A ser modificado serão removidas ou substituídas durante a próxima implantação. Eles são destacados em vermelho com um sinal '-' ao lado do número.
    • As alterações mostradas no estágio A ser implantado são os novos valores que serão aplicados durante a próxima implantação. Eles são destacados em verde com um sinal de '+' ao lado do número.
  • Nas linhas modificadas, os caracteres específicos que foram adicionados ou excluídos são realçados em um tom mais escuro.

Modificações de arquivo antes da comparação

As duas versões do conteúdo mostradas na janela de revisão de alterações são modificadas das seguintes maneiras para facilitar a comparação:

  • As regras de fonte de dados e parâmetro são aplicadas ao item de origem para que a fonte de dados que você vê seja a que está implantada.
  • Alguns campos que não indicam diferenças (por exemplo, carimbos de data/hora e associação de função) são removidos de ambos os itens.
  • As tabelas gerenciadas pelo sistema, como a agregação automática, são removidas.
  • Os itens são classificados para que os campos e as tabelas apareçam na mesma ordem.

Feche a janela quando terminar de examinar as diferenças e implante para a próxima etapa quando estiver pronto.

Considerações e limitações

  • O recurso de revisão de alterações oferece suporte apenas a alterações de esquema para tipos de itens textuais. Atualmente, ele suporta modelos semânticos, excluindo o formato de modelagem de dados v1 e fluxos de dados.

  • Um item pode ser marcado como Diferente, mas ainda não se qualifica para revisão de alterações. Nesses casos, o botão Alterar revisão está desativado. Por exemplo:

    • Alterações de configurações, como alteração de nome.
    • O tipo de item ainda não é suportado.
    • O item tem um status desconhecido porque o processo de comparação não foi concluído.
  • O conteúdo na janela de revisão de alterações pode parecer um pouco diferente da versão original, uma vez que foi modificado antes de executar a comparação.

Implantar conteúdo para o próximo estágio