Compartilhar via

Gerenciar ambientes base sem servidor

Importante

Esse recurso está em Visualização Pública.

Esta página explica como criar e gerenciar ambientes base sem servidor em um workspace.

Permissions

  • Somente os administradores do workspace podem criar e gerenciar ambientes base de um workspace.
  • Todos os usuários do workspace têm acesso aos ambientes base de um workspace.
  • Todos os usuários do workspace podem criar especificações de ambiente personalizadas sem servidor.

Como os ambientes base funcionam no Azure Databricks

No Azure Databricks, um ambiente base é uma especificação YAML compartilhável que define uma versão de ambiente sem servidor e um conjunto de dependências adicionais do Python para notebooks sem servidor. Os administradores do workspace criam e gerenciam ambientes base para que os usuários possam começar rapidamente de um ambiente consistente e armazenado em cache e, opcionalmente, adicionar suas próprias bibliotecas.

Criar e exportar uma especificação de ambiente

A maneira mais simples de criar uma especificação YAML válida é criar o ambiente no painel lateral do Ambiente e, em seguida, usar o botão Exportar ambiente para baixar o arquivo YAML.

  1. Abra um notebook e conecte-se à computação sem servidor.
  2. Clique no do Environment icon.Ambiente. No painel lateral do bloco de anotações.
  3. Selecione a versão do Ambiente. O Databricks recomenda usar a versão mais recente do ambiente sem servidor compatível com seu workspace.
  4. No campo Dependências , adicione quaisquer dependências que você gostaria que o ambiente base tivesse. Clique em Adicionar dependência depois de inserir cada dependência. Para obter mais instruções sobre como adicionar dependências, consulte Adicionar dependências ao notebook.
  5. Clique em Aplicar na parte inferior do painel de ambiente para garantir que a especificação seja válida.
  6. Clique no ícone de menu kebab Ícone do menu Kebab. Na parte inferior do painel de ambiente, clique em Exportar ambiente.
  7. Dê um nome ao arquivo YAML e adicione a uma pasta de workspace ou volume do Catálogo do Unity.

Especificação de ambiente de exemplo

O exemplo a seguir yaml é baseado na especificação de ambiente de projetos MLflow. Ele define um ambiente base com algumas dependências de biblioteca:

environment_version: '4'
dependencies:
  - --index-url https://pypi.org/simple
  - -r "/Workspace/Shared/requirements.txt"
  - my-library==6.1
  - /Workspace/Shared/Path/To/simplejson-3.19.3-py3-none-any.whl
  - git+https://github.com/databricks/databricks-cli

Adicionar um ambiente base ao seu workspace

Para adicionar a especificação de ambiente como um ambiente base ao workspace:

  1. No workspace, vá para Configurações.
  2. Em Administrador do Workspace, selecione Computação.
  3. Ao lado de ambientes base para computação sem servidor, clique em Gerenciar.
  4. Clique em Criar novo ambiente.
  5. Dê um nome ao seu ambiente base. Esse é o nome que os usuários verão no menu suspenso ambiente base .
  6. Selecione o arquivo YAML de especificação de ambiente usando o seletor de arquivo. Você pode procurar arquivos de workspace ou volumes do Catálogo do Unity.
  7. Clique em Criar.

O ambiente base começará a ser criado. Verifique a coluna Status na lista de ambientes base. Ele será alterado para Pronto para usar quando estiver pronto.

Observação

Os registros de uso associados à criação e atualização de ambientes base têm a billing_origin_product coluna definida como BASE_ENVIRONMENTS. Além disso, a ID do ambiente base específica é preenchida na usage_metadata.base_environment_id coluna.

Definir o ambiente base padrão do workspace

Por padrão, notebooks sem servidor em um workspace não usam um ambiente base. Os administradores do workspace podem selecionar um ambiente base para aplicar a todos os novos blocos de anotações por padrão.

  1. No workspace, vá para Configurações.
  2. Em Administrador do Workspace, selecione Computação.
  3. Ao lado de ambientes base para computação sem servidor, clique em Gerenciar.
  4. Clique no ícone de estrela ao lado do ambiente base para defini-lo como o padrão.

Todos os novos blocos de anotações sem servidor agora serão padrão para o ambiente base selecionado.

Atualizar um ambiente base

Talvez você queira editar o arquivo de ambiente base para atualizar números de versão ou adicionar ou remover dependências.

Na lista de ambientes base, clique no caminho do arquivo YAML do ambiente base que você deseja atualizar. Isso abre o arquivo em uma nova guia. Você pode examinar ou atualizar o conteúdo do arquivo lá. As alterações são salvas automaticamente.

Depois de fazer uma atualização para a especificação yaml, você deve atualizar o ambiente base para que notebooks e trabalhos escolham a configuração mais recente.

  1. Ao lado do ambiente base que você deseja atualizar, clique no ícone de menu Kebab do ícone de kebab. Em seguida, selecione Atualizar.
  2. Clique em Confirmar.

As novas sessões agora usam o ambiente base atualizado. As sessões de notebook existentes devem ser reiniciadas para obter as atualizações.

Limitações

  • Para trabalhos, somente tarefas de notebook podem usar ambientes base.
  • Não há suporte para o ambiente sem servidor versão 1. Use a versão 2 ou superior.
  • Os ambientes base estão disponíveis para todos os usuários do workspace.
  • Os workspaces são limitados a 10 ambientes base.
  • Last updated on