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.
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 em um espaço de trabalho com o mesmo nome e tipo, 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. Para obter mais informações sobre emparelhamento, consulte Emparelhamento de itens.
Nota
A nova interface de utilizador do pipeline de implementação está atualmente em visão geral. Para ativar ou usar a nova interface do usuário, consulte Começar a usar a nova interface do usuário.
Comparar estágios
- Nova interface do usuário do pipeline de implantação
- Interface do usuário do pipeline de implantação original
Um indicador de ícone de comparação aparece em cada cartão de estágio, exceto no primeiro estágio do pipeline. Ele indica se este estágio é idêntico ao estágio de origem (estágio anterior) para dar 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 pelo menos um item em um dos estágios comparados foi alterado, adicionado ou removido.
Quando você seleciona um estágio de pipelines de implantação, os itens no estágio são listados e comparados ao item ao qual estão vinculados no estágio de origem.
O estágio de origem é mostrado no menu suspenso no painel inferior e o nome do nome do item de origem comparado aparece na última coluna
Na exibição do palco, os itens são organizados alfabeticamente por padrão. Pode ordenar ou filtrar os itens para encontrar os que lhe interessam ou pode procurar um item específico. Cada item tem um dos seguintes rótulos, dependendo do status de comparação:
Não na fonte – Este item aparece no estágio selecionado, mas não no estágio de origem. Este item não pode ser selecionado para implantação (pois não existe na origem) e não é afetado durante uma implantação.
Diferente da fonte – Foi identificada uma diferença entre este item e o seu item emparelhado na etapa de origem. A diferença pode ser qualquer uma das seguintes coisas:
- uma alteração de esquema para um dos itens
- alteração de propriedade, como uma alteração de nome (considerando o caminho completo das pastas, se houver)
- regras de implantação que foram definidas para este item, mas ainda não aplicadas (requer a implantação do item).
Após a implantação, o item no estágio de origem substitui o item no estágio de destino, independentemente de onde a alteração foi feita.
Somente na origem – Um novo item identificado no estágio de origem. Este item não existe no estágio selecionado e, portanto, é um espaço reservado sem nome de item na primeira coluna (em nome). Após a implantação, este item será clonado para este estágio.
Igual à fonte – Não foi identificada diferença entre este item e o seu par na fase de origem.
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.
- A implantação não afetará itens que não estejam no estágio de origem.
Rever as alterações aos itens emparelhados
Se houver uma alteração no esquema, você poderá ver as diferenças entre os dois itens selecionando o botão Comparar .
- Novo botão de revisão de alteração de implantação
- Botão de revisão de alteração de implantação original
Para comparar os itens nos dois estágios, selecione o ícone Comparar :
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:
- O nome do espaço de trabalho seguido pelo nome do item conforme ele aparece no estágio de origem (a ser implantado).
- 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).
- Setas para cima e para baixo que levam você à diferença anterior ou seguinte no arquivo.
- Uma barra de navegação no lado direito com barras vermelhas ou verdes destacando onde as alterações estão no arquivo.
- Botões que alternam entre uma vista lado a lado e uma vista em linha das alterações.
Uma comparação linha a linha dos itens. À esquerda está o esquema do item desta etapa. À direita está o esquema do item emparelhado no estágio de origem.
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
Ambas as versões do conteúdo mostrado na janela Comparar 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 aparecer na janela Comparar. Nesses casos, o botão Comparar 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.