Импорт и экспорт

Экспорт в файл

Кнопка Экспорт есть на панели инструментов открытой таблицы или коллекции, в заголовке результата запроса и на панели результатов задачи.

1. Нажмите Экспорт.
2. В окне Экспорт результата выберите Формат файла: CSV, JSON, JSONL или Excel.
3. В блоке Какие записи экспортировать выберите:
   • Все записи: весь результат, а не только загруженную страницу. Для таблицы учитываются текущие фильтры и сортировка.
   • Текущая страница: записи, которые видны сейчас.
   • Выбранные записи: строки, выделенные в таблице.
4. Нажмите Экспортировать и выберите, куда сохранить файл.

Когда экспорт закончится, уведомление покажет число строк и путь к файлу. Если для результата запроса написано Полный результат больше недоступен, выполните запрос ещё раз, чтобы выгрузить все записи.

Для результата задачи формат CSV доступен, только если результат является списком строк.

Что попадает в файл:

• CSV: UTF-8 с меткой порядка байтов (BOM) и строкой заголовков. К значению, которое начинается с =, +, - или @, добавляется ' в начале, чтобы табличные редакторы не выполнили его как формулу.
• JSON: один массив объектов. JSONL: по объекту на строку.
• Excel: книга .xlsx с одним листом Data. Числа остаются числами.

В CSV и Excel вложенные объекты и массивы записываются как текст JSON, а двоичные значения в Base64.

Импорт из файла

Мастер импорта загружает файлы CSV, TSV, JSON, JSONL, XML, XLSX и XLS в таблицу или коллекцию. Открыть его можно так:

• откройте таблицу или коллекцию и нажмите Импорт на панели инструментов;
• в обозревателе щёлкните таблицу или коллекцию правой кнопкой и выберите Импорт;
• щёлкните правой кнопкой группу Таблицы или Коллекции, чтобы загрузить данные в новый объект.

В мастере шесть шагов. Чтобы вернуться к пройденному шагу, нажмите на него в списке шагов сверху.

1. Источник. Нажмите Выбрать файл для импорта.

2. Структура. Сверьте Параметры чтения с блоком Превью источника: Кодировка, Разделитель и заголовки для текстовых файлов, Путь к записям для JSON и XML, Лист и Ячейки с формулами для Excel. После изменений нажмите Обновить превью, затем Далее.

3. Назначение. Выберите Существующий объект и укажите Таблица или коллекция либо выберите Создать новую таблицу (Создать новую коллекцию в MongoDB) и введите Имя объекта.

4. Поля. Для каждого поля источника включите или выключите Брать и выберите Поле назначения. В Преобразование задаются значения NULL, логические значения, разделители чисел, формат даты и часовой пояс.

5. Запись. Выберите Режим записи:

   • Добавить: строки добавляются к существующим.
   • Создать объект: сначала создаётся новая таблица или коллекция.
   • Заменить содержимое: все строки объекта заменяются после подтверждения.
   • Обновить или добавить: строки, совпавшие по Ключи конфликта, обновляются, остальные добавляются. В ClickHouse этого режима нет.

   В Некорректные строки источника выберите Остановить импорт или Пропустить. Гарантия записи показывает, откатывается ли вся запись при ошибке. Нажмите Проверить все строки, чтобы проверить файл без изменений в базе, затем Начать импорт.

6. Результат. Сводка показывает, сколько строк добавлено, обновлено, пропущено и не записано. Открыть назначение открывает данные. Показать отклоненные строки выводит ошибки: их можно выгрузить через Экспорт CSV или Экспорт JSONL, исправить и загрузить снова через Импортировать исправленные строки.

Файл XLSX может занимать до 500 МБ, файл XLS до 50 МБ. Одна запись может содержать до 5 000 полей и занимать до 10 МБ.

Копирование между подключениями

Строки можно скопировать в то же или другое подключение без промежуточного файла:

• в обозревателе щёлкните таблицу или коллекцию правой кнопкой и выберите Копировать данные, чтобы скопировать все строки;
• в открытой таблице выделите строки и нажмите Копировать выбранные строки;
• в результате запроса откройте Действия с результатом рядом с Экспорт и выберите Копировать данные.

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

См. также Результаты и правка. Для файлов GridFS есть отдельные загрузка и скачивание, они описаны на странице MongoDB.