Implantar pacotes e executar fluxos de trabalho a partir do espaço de trabalho

Os ativos que fazem parte de seus Databricks Asset Bundles podem ser criados e modificados a partir de um ambiente de desenvolvimento local ou do espaço de trabalho, mas para que as alterações sejam sincronizadas com os recursos Databricks correspondentes, os pacotes devem ser implantados. Os pacotes têm identidades exclusivas em um espaço de trabalho, portanto, independentemente de um pacote ser implantado a partir de uma máquina local ou do espaço de trabalho, os ativos do pacote não são duplicados.

Para obter os requisitos para usar pacotes no espaço de trabalho, consulte Databricks Asset Bundles nos requisitos do espaço de trabalho.

Para obter mais informações sobre pacotes, consulte O que são Databricks Asset Bundles?.

Implantar um pacote

Para implantar um pacote a partir do espaço de trabalho:

1. Navegue até o pacote no espaço de trabalho e clique em um arquivo YAML de configuração do pacote, como databricks.yml.

2. Clique no ícone de implantações.

3. No painel Implantações , escolha um espaço de trabalho de destino. Os espaços de trabalho de destino são definidos no targets mapeamento do pacote databricks.yml. Consulte Modos de implantação do Databricks Asset Bundle.

   

4. Clique em Implementar. O pacote é validado e os detalhes da validação aparecem em uma caixa de diálogo.

5. Revise os detalhes da implantação nesta caixa de diálogo de confirmação para desenvolvimento e clique em Implantar.

   

   Importante

   Implantar pacotes e executar recursos de pacote executa o código como o usuário atual. Certifique-se de confiar no código do pacote, incluindo YAML, que pode conter definições de configuração que executam comandos.

O estado da implantação é apresentado na janela de saída do projeto. Quando a implantação for concluída, os recursos do pacote implantado serão listados no painel Recursos do pacote .

Implantações vinculadas à origem

Por padrão, quando você implanta um pacote em um destino de desenvolvimento por meio do espaço de trabalho, os recursos criados durante a implantação fazem referência aos arquivos de origem no espaço de trabalho em vez de suas cópias do espaço de trabalho. A sincronização de arquivos com ${workspace.file_path} é ignorada. Se você excluir um pacote, somente os recursos definidos no pacote serão excluídos; os arquivos permanecem.

Para desabilitar esse comportamento, no arquivo de configuração do pacote databricks.yml , defina a predefinição do source_linked_deployment modo de implantação como false.

Importante

As implantações vinculadas à origem só são aplicáveis para Databricks Asset Bundles no espaço de trabalho. A source_linked_deployment predefinição será ignorada se você implantar um pacote usando o comando Databricks CLI databricks bundle deploy .

targets:
  # Disable source_linked_deployment in dev
  dev:
    mode: development
    presets:
      source_linked_deployment: false

Para obter mais informações sobre modos de implantação, consulte Modos de implantação do Databricks Asset Bundle.

Executar um fluxo de trabalho em um pacote

Você pode acionar uma execução de um recurso definido no pacote depois que o pacote tiver sido implantado com êxito:

1. Navegue até o pacote no espaço de trabalho e clique em um arquivo YAML de configuração do pacote, como databricks.yml.

2. Clique no ícone de implantações.

   

3. No painel Recursos do pacote , clique no ícone executar (reproduzir) associado a qualquer recurso para executá-lo.

   

   Se um recurso estiver desativado e não tiver um ícone de execução, ele ainda não foi implantado. Implante o pacote antes de tentar executar o recurso. Consulte Implantar um pacote.

Colabore, revise e implemente em produção

O Databricks Asset Bundles no espaço de trabalho permite personalizar permissões para modificar, implantar e executar o pacote para facilitar a colaboração e a solução de problemas. O Databricks recomenda colaborar em seu pacote por meio do Git, mas para uma solução de problemas simples, você pode compartilhar um pacote com seus colaboradores no espaço de trabalho Databricks. Navegue até a visualização do projeto do pacote e clique em Compartilhar. Os pacotes herdam as permissões de sua pasta Git pai, portanto, compartilhar um pacote aplica as alterações à pasta Git pai.

Quando você terminar a colaboração e o teste do seu pacote no dev, altere a implantação de destino para prod para implantar no espaço de trabalho atual.

Observação

Se um usuário não tiver acesso a um espaço de trabalho de produção, ele não poderá implantá-lo nesse espaço de trabalho. Além disso, não há suporte para a implantação de pacotes em espaços de trabalho diferentes quando você usa a interface do usuário para implantar pacotes.

Defina um espaço de trabalho de produção diferente para suas implantações automatizadas no databricks.yml arquivo de configuração. Veja o espaço de trabalho.