Histórico de implementação do pacote

Importante

Esta funcionalidade está em Pré-visualização Privada. Para experimentar, contacte o seu contacto do Azure Databricks.

O histórico de implementação fornece um registo estruturado e auditável de cada implementação do Declarative Automation Bundles no seu espaço de trabalho. Uma implantação é um pacote implantado num destino específico. Sempre que faz uma implementação, é registada uma nova versão.

Para cada implantação, pode consultar:

  • Metadados da implantação: A identidade de quem efetuou a implantação, a data e hora, o alvo e o estado resultante.
  • Contexto do controlo de código-fonte: O repositório Git, o ramo, o SHA do commit e qualquer etiqueta de lançamento associada à versão.
  • Alterações de recursos: Os recursos criados, atualizados, eliminados ou recriados em cada versão, juntamente com as diferenças de configuração.
  • Estado pós-implementação: O inventário completo dos recursos geridos pela implementação, como tarefas, pipelines do Lakeflow, painéis e tabelas do Unity Catalog.

O histórico de implementação é um único local para validar implementações, investigar regressões e responder a perguntas como quem modificou por último um trabalho ou pipeline. É a base para implementações governadas para equipas que gerem os recursos do Databricks como código.

Para uma visão geral dos bundles, veja O que são Declarative Automation Bundles?. Para saber como implementar um pacote, consulte Implementar pacotes e executar fluxos de trabalho a partir do espaço de trabalho e Modos de implementação dos Pacotes de Automação Declarativa.

Ativar o histórico de implementação

Para registar o histórico de implementação de um bundle, defina experimental.record_deployment_history para true na configuração bundle. Consulte Referência de configuração.

Ver implantações

Para visualizar as implementações, faça uma das seguintes opções:

  • A partir do painel de Implementações de um pacote, abra o histórico de implementação desse pacote. Consulte Implantar pacotes e executar fluxos de trabalho a partir do espaço de trabalho.
  • Para uma tarefa, pipeline ou dashboard gerido por um pacote, use o indicador Gerido por para ir para a implementação a que pertence.
  • Procure um bundle pelo nome para abrir diretamente o histórico de implementação.

A lista de implementações mostra todas as implementações (e as versões e recursos correspondentes) a que CAN_READ tem acesso.

Pode filtrar e ordenar a lista pelas seguintes colunas:

Coluna Descrição
Name O pacote e o destino, ou o nome apresentado da implementação.
Target O alvo de implantação, como dev ou prod.
Situação O estado da última missão.
Última missão em / por Quando foi a última vez que a implementação foi executada e a identidade que a executou.
Contagem de recursos O número de recursos que a implantação gere.

Ver detalhes da versão de implementação

Selecione uma implementação a partir do histórico de implementação para abrir os seus detalhes, depois selecione uma versão para descobrir informações como quando a implementação foi iniciada e por quem, o repositório e branch Git de origem, o commit SHA (ligado ao diff no seu fornecedor Git) e a etiqueta release, se aplicável.

Utilize o menu pendente do histórico de versões no cabeçalho para mudar entre versões.

Alterações de recursos

A aba Alterações lista alterações feitas aos recursos na versão selecionada. Inclui:

  • Alterações de recursos: Uma tabela das ações realizadas por recurso, mostrando a chave de recurso (como jobs.ETL_Main), a ação (Crear, Atualizar, Eliminar ou Recriar), o estado e o carimbo temporal.
  • Diferença de configuração: Uma comparação lado a lado que destaca quais as definições alteradas, como o tamanho do cluster ou o cronograma.
  • Instantâneos do bloco de notas: Para recursos do bloco de notas, uma ligação para a revisão do bloco de notas que foi implementado.
  • Erros: Atualizações falhadas mostram uma mensagem de erro em linha.

Estado pós-implementação

O separador do estado pós-implementação mostra o inventário dos recursos ativos que a implementação gere após a aplicação da versão:

  • Chave e tipo de recurso: O nome lógico e o tipo de recurso.
  • ID do Databricks: O ID físico do recurso, associado ao recurso no espaço de trabalho.
  • Última alteração: A versão que último modificou o recurso, como Changed in v42.

Histórico de implementação a partir do CLI

Para fluxos de trabalho automatizados, pode aceder ao histórico de implementação com os comandos CLI bundle-deployments do Databricks. Ver databricks bundle-deployments.

Limitations

  • O histórico de implementação está disponível apenas para novos alvos de implementação em bundles. Ainda não existe uma via de migração para os pacotes ou alvos existentes.
  • As entidades subjacentes das implementações (como execuções de tarefas) podem ter políticas de retenção.
  • Apenas implementações que utilizam o motor direto são suportadas. Veja Migração para o motor de implementação direta.

Recursos adicionais

  • Last updated on