Песочница Databricks

Important

Эта функция доступна в бета-версии. Чтобы включить предпросмотр этой функции в рабочем пространстве, перейдите в настройку Databricks Sandbox на странице предварительного просмотра рабочего пространства. См. статью "Управление предварительными версиями Azure Databricks".

В настоящее время Databricks не взимает плату за использование этой функции. Однако стоимость и ценообразование функций в бета-версии могут меняться.

Sandbox Databricks позволяет запускать ненадёжный код в изолированной среде через REST API, SDK или Databricks CLI. Песочница обеспечивает бессерверные вычисления по запросу для динамического запуска кода.

Каждая песочница содержит постоянную домашнюю директорию. Вы можете остановиться и запустить песочницу в любой момент, и данные в вашей домашней папке сохраняются.

Песочница идеально подходит для:

  • Запускаю агентскую упряжку.
  • Выполнение кода, написанного пользователями или ИИ.
  • Выполнение фоновых задач или рабочих.
  • Запуск интерактивных сессий IDE или SSH.

Prerequisites

Quickstart

Начните с создания песочницы с несколькими строками кода:

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.sandbox import Sandbox

w = WorkspaceClient()

created = w.sandbox.create_sandbox(
    sandbox=Sandbox(),
    sandbox_id="my-sandbox",
)
print(created.name)   # "sandboxes/my-sandbox"

Для полного прохождения по созданию песочницы, выполнению в нём команд и управлению жизненным циклом смотрите раздел «Создание и управление песочницами с помощью SDK».

Объем вычислительных ресурсов

Databricks Sandbox оснащен 4 vCPU и 8 ГБ оперативной памяти. Этот размер ненастраиваем.

Хранение

Предупреждение

В конце бета-периода Databricks может провести одноразовую очистку данных, хранящихся в песочницах. Не храните ничего, что не можете позволить себе потерять.

Sandbox Databricks оснащён сетевым хранилищем.

  • Данные в вашем домашнем каталоге (/home/sandbox-agent) сохраняются в течение всего срока существования песочницы Databricks. Даже после остановки песочницы Databricks данные в вашем домашнем каталоге будут доступны, когда вы начнёте следующий сеанс.
  • Ваш домашний каталог может хранить до 100 ГБ. В настоящее время это нельзя изменить.
  • Вы можете хранить до 10 ГБ вне домашней папки, но эти данные удаляются, когда вы останавливаете песочницу.

Networking

Для исходящего сетевого трафика из песочницы ограничения отсутствуют, и его нельзя настроить.

Затраты на использование

Полная информация об использовании для биллинга см. цены на Databricks. Databricks предполагает использование песочницы для биллинга для:

  • Runtime Compute: Оплачивается почасово, пока ваш Databricks Sandbox работает.
  • Постоянное хранилище: С вас взимается плата за данные, хранящиеся в вашем домашнем каталоге, пока ваша среда Databricks Sandbox не будет удалена. За хранилище взимается плата, пока существует экземпляр Databricks Sandbox. Чтобы перестать платить за хранение, нужно удалить песочницу.
  • Передача данных

Рекомендуемым способом доступа к песочнице является SDK Databricks для Python. См. справочную документацию по песочнице Databricks SDK for Python для получения сведений о доступных командах, а также Создание песочниц и управление ими с помощью SDK с примерами.

Доступ к песочнице можно получить через CLI

Вы также можете получить доступ к песочнице через SSH. Это позволяет выполнять длительные задачи агента без необходимости держать локальный компьютер включённым. Например, доступны следующие возможности:

  • Управляйте своим программным агентом напрямую из CLI Databricks через SSH.
  • Подключите настольную IDE или среду для агентов, такую как Cursor, Claude или Codex.

Чтобы создать песочницу и подключиться к нему с помощью CLI Databricks, запустите:

databricks sandbox create      # create your sandbox
databricks sandbox register    # optional: register SSH keys
databricks sandbox ssh         # SSH to your default sandbox

Когда вы подключаете SSH в песочницу, CLI Databricks устанавливается и аутентифицируется в рабочем пространстве Databricks, где работает ваша песочница. Возможно, вам также стоит настроить учетные данные Git. См. статью "Подключение поставщика Git к Databricks".

Для подробной помощи с командами запустите databricks sandbox -h, или смотрите sandbox командную группу.

Когда вы впервые подключаетесь к песочнице по SSH, Databricks автоматически настраивает распространённые инструменты для программирования, такие как Claude и Codex, для использования AI Gateway, если AI Gateway настроен для вашего рабочего пространства. Дополнительные сведения см. в разделе «Создание пользовательского сервиса моделей».

Управляемый Omnigent

Managed Omnigent использует Databricks Sandbox в качестве бэкенда для выполнения. Дополнительные сведения см. в Omnigent on Databricks.

Limitations

  • Квоты соблюдаются. На пользователя может быть максимум 40 активных песочниц (всего 400 во всех штатах), а в рабочем пространстве — максимум 100 активных песочниц (всего 1000).
  • Databricks Sandbox — это вычислительный примитив для выполнения кода, а не универсальное Spark-runware. Для задач Spark используйте Подключение к бессерверным вычислительным ресурсам.
  • Публичные IP-адреса вашей песочницы Databricks могут меняться в любой момент. Вход в песочницу по умолчанию закрыт для всего трафика. Сейчас это нельзя изменить.
  • Вы не можете настраивать окружение при запуске или сохранять окружение вне домашней директории. Чтобы повторно использовать пакеты или конфигурации между сессиями, храните их в домашней директории.