Partilhar via

Gerencie ambientes básicos sem servidor

Importante

Este recurso está no Public Preview.

Esta página explica como criar e gerenciar ambientes básicos sem servidor em um espaço de trabalho.

Permissions

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

Como funcionam os ambientes base 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 Python adicionais para blocos de anotações sem servidor. Os administradores de espaço de trabalho criam e gerenciam ambientes básicos para que os usuários possam iniciar rapidamente a partir 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 é construir o ambiente no painel lateral Ambiente e, em seguida, usar o botão Exportar ambiente para baixar o arquivo YAML.

  1. Abra um bloco de anotações e conecte-se à computação sem servidor.
  2. Clique no ícone Ambiente no painel lateral do bloco de anotações.
  3. Selecione a versão Ambiente. O Databricks recomenda o uso da versão mais recente do ambiente sem servidor suportada pelo seu espaço de trabalho.
  4. No campo Dependências , adicione as 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 bloco de anotações.
  5. Clique em Aplicar na parte inferior do painel de ambiente para garantir que a especificação seja válida.
  6. Clique no ícone do menu kebab Ícone do menu Kebab. na parte inferior do painel do ambiente e, em seguida, clique em Exportar ambiente.
  7. Dê um nome ao arquivo YAML e adicione a uma pasta Workspace ou a um volume do Unity Catalog.

Exemplo de especificação de ambiente

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 espaço de trabalho

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

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

O ambiente de base começará a ser construído. Verifique a coluna Status na lista de ambientes básicos. Ele mudará para Pronto para uso 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, o ID do ambiente base específico é preenchido na coluna usage_metadata.base_environment_id.

Definir o ambiente base padrão do espaço de trabalho

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

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

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

Atualizar um ambiente base

Talvez você queira editar o arquivo de ambiente base para atualizar os 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 revisar ou atualizar o conteúdo do arquivo lá. As alterações são guardadas automaticamente.

Depois de fazer uma atualização para a especificação YAML, você deve atualizar o ambiente base para que os blocos de anotações e trabalhos peguem a configuração mais recente.

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

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

Limitações

  • Para trabalhos, apenas tarefas de bloco de anotações podem usar ambientes básicos.
  • O ambiente sem servidor versão 1 não é suportado. Use a versão 2 ou superior.
  • Os ambientes básicos estão disponíveis para todos os usuários do espaço de trabalho.
  • Os espaços de trabalho são limitados a 10 ambientes básicos.
  • Last updated on