Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Important
Эта функция доступна в бета-версии. Чтобы включить предпросмотр этой функции в рабочем пространстве, перейдите в настройку Databricks Sandbox на странице предварительного просмотра рабочего пространства. См. статью "Управление предварительными версиями Azure Databricks".
В настоящее время Databricks не взимает плату за использование этой функции. Однако стоимость и ценообразование функций в бета-версии могут меняться.
Sandbox Databricks позволяет запускать ненадёжный код в изолированной среде через REST API, SDK или Databricks CLI. Песочница обеспечивает бессерверные вычисления по запросу для динамического запуска кода.
Каждая песочница содержит постоянную домашнюю директорию. Вы можете остановиться и запустить песочницу в любой момент, и данные в вашей домашней папке сохраняются.
Песочница идеально подходит для:
- Запускаю агентскую упряжку.
- Выполнение кода, написанного пользователями или ИИ.
- Выполнение фоновых задач или рабочих.
- Запуск интерактивных сессий IDE или SSH.
Prerequisites
Рабочая область должна находиться в поддерживаемом регионе. См. Функции с ограниченной региональной доступностью.
Для использования SDK — Python 3.10 или выше.
Чтобы использовать Databricks CLI через SSH, установите Databricks CLI и выполните его аутентификацию с помощью
databricks auth login:databricks auth login # authenticate to a Databricks workspace
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 (рекомендую)
Рекомендуемым способом доступа к песочнице является 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 могут меняться в любой момент. Вход в песочницу по умолчанию закрыт для всего трафика. Сейчас это нельзя изменить.
- Вы не можете настраивать окружение при запуске или сохранять окружение вне домашней директории. Чтобы повторно использовать пакеты или конфигурации между сессиями, храните их в домашней директории.