Связаться с намиПодключиться

Экспорт и импорт воркбуков

Статья создана
Обновлена 20 июня 2025 г.

В DataLens можно переносить воркбуки между инсталляциями с помощью инструментов экспорта и импорта. Например, вы сможете экспортировать готовый воркбук, с его настройками и связями, из облачного Yandex DataLens в инсталляцию open source.

Примечание

  • Экспорт и импорт доступны только для воркбуков.
  • Некоторые типы подключений недоступны для экспорта и импорта.
  • Экспорт может выполнить пользователь с ролью datalens.admin.
  • Импорт может выполнить пользователь с правами, достаточными для создания нового воркбука.

Экспорт воркбука

Чтобы экспортировать воркбук:

  1. На панели слева выберите Коллекции и воркбуки.

  2. Запустите экспорт нужного воркбука одним из способов:

    • У воркбука нажмите → Экспортировать.
    • Откройте воркбук и вверху нажмите → Экспортировать.

  3. Нажмите кнопку Экспортировать. Прогресс будет отображаться на индикаторе. Обратите внимание на следующее:

    • Экспорт выполняется в файл формата JSON.
    • Процесс может занять несколько минут.
    • Чувствительные данные подключений не сохраняются. При импорте пользователю потребуется заново настроить подключения, например указать токен или ввести пароль, а для подключений к файлу, Яндекс Документам и Google Sheets — заново загрузить данные.
    • В других версиях DataLens могут не поддерживаться некоторые типы подключений. При импорте такие подключения работать не будут.

    При попытке закрыть окно с индикатором до завершения процесса появится предупреждение о завершении экспорта. Выберите:

    • Вернуться — продолжить экспорт.
    • Отменить экспорт.

После завершения экспорта могут появиться предупреждения об особенностях воркбука и список объектов, требующих внимания. Нажмите Скачать, чтобы скачать файл экспорта в формате JSON.

Совет

Вы можете внести изменения в экспортированный файл JSON, например добавить пароль для подключения. Но DataLens не гарантирует успешный импорт и корректную работу воркбука, если в его конфигурацию были внесены ручные изменения. Рекомендуем тщательно проверять все изменения перед импортом для минимизации возможных проблем.

Если экспортировать воркбук не удалось, отобразится сообщение об ошибке. Постарайтесь устранить причину ошибки и попробуйте экспортировать воркбук заново.

Импорт воркбука

Чтобы импортировать воркбук:

  1. На панели слева выберите Коллекции и воркбуки.

  2. В правом верхнем углу нажмите Создать → Создать воркбук.

  3. В окне создания воркбука:

    1. Укажите название воркбука.

      Примечание

      Имя воркбука должно быть уникальным в рамках выбранной коллекции.

    2. Внизу нажмите Выбрать файл и выберите файл в формате JSON с конфигурацией воркбука.

    3. Нажмите кнопку Создать.

    Прогресс импорта отобразится на индикаторе. Если закрыть окно с индикатором до завершения импорта, процесс не прервется. До завершения импорта новый воркбук доступен в списке воркбуков с отметкой Импортируется, а при выборе его открывается окно с прогрессом импорта.

После завершения импорта могут появиться предупреждения об особенностях импортируемого воркбука и список объектов, требующих внимания. Нажмите Открыть воркбук, чтобы перейти к созданному воркбуку. При необходимости выполните дополнительные настройки, например введите пароль для подключения.

Примечание

При переносе воркбуков с подключениями к файлу, Яндекс Документам и Google Sheets заново загрузите данные. Для этого в подключении справа от названия файла нажмите → Заменить, затем:

  • в подключении к файлу выберите файл с данными;
  • в подключениях к Яндекс Документам и Google Sheets укажите ссылку на файл с данными.

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

Если импортировать воркбук не удалось, отобразится сообщение об ошибке. Постарайтесь устранить причину ошибки и попробуйте импортировать воркбук заново.

Отключить возможность экспорта воркбуков

Примечание

Функциональность доступна только в рамках тарифного плана Business.

По умолчанию пользователи с ролью datalens.admin могут экспортировать воркбуки. Эту возможность можно отключить на уровне экземпляра DataLens. После запрета экспорта:

  • В интерфейсе воркбуков не будет отображаться кнопка Экспортировать.
  • Пользователи не смогут экспортировать воркбуки.
  • Файлы экспорта в формате JSON, созданные до отключения, можно использовать для импорта в новый воркбук.

Отключить возможность экспорта может только администратор экземпляра DataLens (роль datalens.admin).

Чтобы запретить экспорт воркбуков:

  1. На панели слева выберите Настройки сервиса.
  2. Отключите опцию Экспорт воркбуков (по умолчанию она включена).

Ограничения

Для экспорта и импорта недоступны следующие типы подключений:

Предыдущая
Миграция объектов в воркбуки
Следующая
Ошибки и предупреждения при экспорте и импорте