HarborDB

Экспорт данных в HarborDB

Guides
•Последнее обновление: 16 февраля 2026 г.

HarborDB предоставляет мощные возможности экспорта для сохранения результатов запросов в различных форматах. Независимо от того, нужно ли вам поделиться данными с коллегами, импортировать их в другие приложения или архивировать результаты для последующего анализа, это руководство охватывает всё, что вам нужно знать об эффективном и безопасном экспорте данных.

Обзор форматов экспорта

HarborDB поддерживает несколько форматов экспорта, каждый из которых подходит для разных случаев использования:

CSV (Comma-Separated Values, значения, разделённые запятыми)

  • Лучше всего подходит для: Электронных таблиц (Excel, Google Sheets), импорта/экспорта данных, базового обмена данными
  • Особенности: Пользовательские разделители, заголовки, ограничители текста, параметры кодировки
  • Ограничения: Нет поддержки иерархических данных, ограниченное сохранение типов данных

JSON (JavaScript Object Notation, нотация объектов JavaScript)

  • Лучше всего подходит для: Веб-приложений, API, баз данных NoSQL, обмена данными
  • Особенности: Красивое форматирование, компактное форматирование, сохранение типов данных
  • Ограничения: Больший размер файла, не идеален для электронных таблиц

Excel (скоро)

  • Лучше всего подходит для: Бизнес-отчётности, форматированных электронных таблиц, сложного представления данных
  • Особенности: Несколько листов, формулы, форматирование, диаграммы
  • Статус: Запланировано для будущего релиза

Базовый процесс экспорта

Шаг 1: Подготовка данных

  1. Выполните запрос или выберите таблицу в боковой панели
  2. Проверьте результаты, чтобы убедиться, что они содержат данные, которые вы хотите экспортировать
  3. Рассмотрите фильтрацию, если вам нужны только определённые строки или столбцы

Шаг 2: Инициирование экспорта

Есть несколько способов начать экспорт:

Из результатов запроса

  1. Нажмите кнопку "Экспорт" (📤) на панели инструментов результатов
  2. Или щёлкните правой кнопкой мыши в любом месте сетки результатов
  3. Выберите "Экспортировать результаты" из контекстного меню

Из навигации по таблице

  1. Щёлкните правой кнопкой мыши по таблице в боковой панели
  2. Выберите "Экспортировать данные"
  3. Выберите область экспорта:
    • Вся таблица: Все данные (используйте с осторожностью для больших таблиц)
    • Первые N строк: Ограниченная выборка (рекомендуется для тестирования)
    • Пользовательский запрос: Напишите конкретный оператор SELECT

Сочетания клавиш

  • ⌘ + E: Диалоговое окно быстрого экспорта
  • ⌘ + Shift + E: Экспорт с последними использованными настройками

Шаг 3: Настройка параметров экспорта

Диалоговое окно экспорта предоставляет параметры конфигурации:

Общие настройки

  • Имя файла: Автоматически сгенерированное или пользовательское имя
  • Место сохранения: Выберите папку назначения
  • Включать заголовки: Имена столбцов в качестве первой строки (CSV)
  • Кодировка: UTF-8 (рекомендуется), Latin-1 или системная по умолчанию

Опции, специфичные для CSV

  • Разделитель: Запятая, точка с запятой, табуляция, вертикальная черта или пользовательский символ
  • Ограничитель текста: Кавычки, двойные кавычки или отсутствие
  • Окончания строк: macOS/Linux (LF), Windows (CRLF) или системные по умолчанию
  • Представление NULL: Пустая строка, "NULL" или пользовательский текст

Опции, специфичные для JSON

  • Формат: Красивый (читаемый человеком) или Компактный (минимизированный)
  • Формат массива: Массив объектов или объект со свойством данных
  • Включать метаданные: Информация о выполнении запроса, типы столбцов, временные метки

Шаг 4: Выполнение и проверка

  1. Нажмите "Экспорт", чтобы сохранить файл
  2. Следите за прогрессом для больших экспортов
  3. Проверьте размер файла и содержимое
  4. Откройте экспортированный файл, чтобы подтвердить форматирование

Расширенные техники экспорта

Экспорт определённых подмножеств данных

Выбор столбцов

Экспортируйте только определённые столбцы, изменяя ваш запрос:

-- Вместо SELECT *
SELECT customer_id, email, last_purchase_date
FROM customers
WHERE active = true;

Фильтрация строк

Используйте условия WHERE для ограничения экспортируемых данных:

-- Экспортируйте только недавние данные
SELECT * FROM orders
WHERE order_date >= CURRENT_DATE - INTERVAL '30 days';

Агрегированные данные

Экспортируйте сводные результаты:

-- Экспортируйте ежедневные итоги продаж
SELECT
    DATE(order_date) as day,
    COUNT(*) as order_count,
    SUM(total_amount) as daily_revenue
FROM orders
GROUP BY DATE(order_date)
ORDER BY day DESC;

Пакетный экспорт

Для больших наборов данных, превышающих ограничения памяти:

Экспорт частями

-- Экспортируйте партиями по 10 000 строк
SELECT * FROM large_table
ORDER BY id
LIMIT 10000 OFFSET 0;

-- Затем увеличивайте OFFSET для следующей партии
SELECT * FROM large_table
ORDER BY id
LIMIT 10000 OFFSET 10000;

Курсоры на стороне сервера

Включите курсоры на стороне сервера в Настройки → Производительность для потоковой передачи больших наборов результатов без проблем с памятью.

Планируемый экспорт (продвинутый уровень)

Хотя HarborDB не имеет встроенного планирования, вы можете:

  1. Сохранять запросы экспорта как файлы
  2. Использовать macOS Automator для запуска экспортов
  3. Планировать с помощью cron или launchd (продвинутые пользователи)
  4. Экспортировать в отслеживаемые папки для автоматизированной обработки

Рекомендации по конкретным форматам

Лучшие практики экспорта CSV

Подготовка данных

  1. Очистите специальные символы, которые могут нарушить анализ CSV:
-- Удалите или экранируйте запятые в текстовых полях
SELECT
    id,
    REPLACE(description, ',', ';') as description,
    amount
FROM products;
  1. Обработайте разрывы строк в текстовых полях:
-- Замените переводы строк пробелами
SELECT
    id,
    REPLACE(REPLACE(notes, CHR(10), ' '), CHR(13), ' ') as notes_clean
FROM customer_notes;

Настройки CSV, удобные для импорта

Для максимальной совместимости с другими приложениями:

| Приложение | Рекомендуемые настройки | | ------------------- | ------------------------------------------------------------ | | Excel | Разделитель запятая, ограничитель двойные кавычки, кодировка UTF-8 | | Google Sheets | Разделитель запятая, кодировка по умолчанию | | Python/R Pandas | Разделитель запятая, без ограничителя текста | | PostgreSQL COPY | Разделитель запятая, заголовок CSV, кавычки двойные кавычки |

Лучшие практики экспорта JSON

Экспорт структурированных данных

-- Экспортируйте иерархические данные
SELECT
    order_id,
    order_date,
    JSON_BUILD_OBJECT(
        'customer_id', c.customer_id,
        'name', c.name,
        'email', c.email
    ) as customer,
    JSON_AGG(
        JSON_BUILD_OBJECT(
            'product_id', p.product_id,
            'name', p.name,
            'quantity', oi.quantity,
            'price', oi.price
        )
    ) as items
FROM orders o
JOIN customers c ON o.customer_id = c.customer_id
JOIN order_items oi ON o.order_id = oi.order_id
JOIN products p ON oi.product_id = p.product_id
GROUP BY o.order_id, o.order_date, c.customer_id, c.name, c.email;

Соображения по схеме JSON

  • Единообразная структура: Убедитесь, что все строки имеют одинаковые ключи
  • Типы данных: JSON сохраняет строки, числа, логические значения, null
  • Глубина вложенности: Рассмотрите возможность выравнивания для некоторых приложений

Оптимизация производительности

Экспорт больших наборов данных

Управление памятью

  1. Включите режим потоковой передачи в Настройки → Производительность
  2. Увеличьте размер части для более быстрого экспорта (при достаточном объеме ОЗУ)
  3. Закройте другие приложения, чтобы освободить системные ресурсы
  4. Следите за Мониторингом активности за использованием памяти

Сетевые соображения

Для экспорта с удалённых баз данных:

  1. Экспортируйте на сервере, если возможно (используйте SSH или удалённый рабочий стол)
  2. Сжимайте экспорты (HarborDB автоматически сжимает большие JSON)
  3. Планируйте в непиковые часы для рабочих баз данных
  4. Используйте условия WHERE для ограничения передачи данных

Советы по скорости экспорта

  1. Выбирайте только нужные столбцы (не SELECT *)
  2. Избегайте дорогостоящих вычислений в запросах экспорта
  3. Используйте индексированные столбцы в условиях WHERE
  4. Экспортируйте на SSD для более быстрого ввода-вывода на диск
  5. Отключите антивирусное сканирование в реальном времени для папки экспорта (временно)

Безопасность и конфиденциальность

Обработка конфиденциальных данных

Редактирование данных

-- Экспорт без конфиденциальной информации
SELECT
    user_id,
    LEFT(email, 3) || '***@***' as email_masked,
    '***' as password_hash,
    created_at
FROM users;

Соображения по соответствию требованиям

  1. GDPR/CCPA: Удалите персональные идентифицирующие данные (PII)
  2. HIPAA: Обезличьте защищённую медицинскую информацию (PHI)
  3. PCI DSS: Никогда не экспортируйте полные номера кредитных карт
  4. Внутренние политики: Следуйте правилам обработки данных вашей организации

Безопасные практики экспорта

  1. Шифруйте конфиденциальные экспорты с помощью macOS FileVault или сторонних инструментов
  2. Используйте безопасные методы передачи для экспортированных файлов (SFTP, зашифрованная электронная почта)
  3. Установите соответствующие права доступа к файлам (chmod 600 для конфиденциальных файлов)
  4. Автоматически удаляйте временные файлы экспорта
  5. Аудируйте журналы экспорта (доступно в Настройки → Журналы)

Устранение распространённых проблем

Проблемы с CSV

"Столбцы смещены в Excel"

  • Причина: Встроенные запятые или разрывы строк в данных
  • Решение: Используйте ограничители текста или очистите данные перед экспортом

"Проблемы с кодировкой символов"

  • Причина: Символы не в UTF-8 в данных
  • Решение: Экспортируйте с кодировкой UTF-8 с BOM для Excel

"Ошибки импорта больших файлов"

  • Причина: Ограничения Excel по строкам/столбцам (1 048 576 строк, 16 384 столбца)
  • Решение: Разделите данные или используйте инструменты CSV без ограничений

Проблемы с JSON

"Неверный синтаксис JSON"

  • Причина: Специальные символы не экранированы должным образом
  • Решение: Используйте функции JSON PostgreSQL для очистки данных

"Ошибки памяти при больших экспортах"

  • Причина: Попытка загрузить весь набор данных в память
  • Решение: Включите потоковый экспорт или экспортируйте частями

"Слишком сложные вложенные данные"

  • Причина: Глубоко вложенный JSON трудно анализировать
  • Решение: Выровняйте структуру или упростите запрос

Общие проблемы

"Экспорт слишком медленный"

  • Возможные причины: Задержка сети, скорость диска, производительность запроса
  • Шаги отладки:
    1. Сначала протестируйте с небольшим набором данных
    2. Проверьте сетевое подключение
    3. Убедитесь, что на диске есть свободное место
    4. Оптимизируйте запрос к базе данных

"Отсутствуют данные в экспорте"

  • Проверьте: Фильтры условия WHERE, выбор столбцов, обработка NULL
  • Убедитесь: Количество строк соответствует ожиданиям, все столбцы включены

"Ошибки отказа в доступе"

  • Решение:
    1. Выберите другое место сохранения
    2. Проверьте права доступа к папке
    3. Запустите HarborDB с соответствующими привилегиями
    4. Временно отключите программное обеспечение безопасности

Интеграция с другими инструментами

Автоматизация с помощью скриптов

Пример скрипта оболочки

#!/bin/bash
# Экспорт ежедневного отчёта и отправка по электронной почте
EXPORT_FILE="/Users/$(whoami)/Exports/daily_sales_$(date +%Y%m%d).csv"

# Здесь вам нужно будет скриптовать действия HarborDB
# Рассмотрите возможность использования инструментов командной строки PostgreSQL для автоматизации
pg_dump -t sales -c --inserts your_database > "$EXPORT_FILE"

# Сжатие и отправка по электронной почте
gzip "$EXPORT_FILE"
echo "Ежедневный экспорт продаж прикреплён" | mail -s "Ежедневный отчёт о продажах" \
  -a "$EXPORT_FILE.gz" team@example.com

Импорт в другие приложения

Excel/Google Sheets

  1. CSV: Прямой импорт через Данные → Из текста/CSV
  2. JSON: Используйте Power Query (Excel) или Apps Script (Sheets)

Системы баз данных

-- Команда COPY PostgreSQL (из экспортированного CSV)
COPY customers FROM '/path/to/export.csv' DELIMITER ',' CSV HEADER;

-- LOAD DATA MySQL
LOAD DATA LOCAL INFILE '/path/to/export.csv'
INTO TABLE customers
FIELDS TERMINATED BY ','
ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 ROWS;

Языки программирования

# Пример Python pandas
import pandas as pd

# Чтение экспорта CSV HarborDB
df = pd.read_csv('export.csv', encoding='utf-8')
print(f"Импортировано {len(df)} строк")

# Или экспорт JSON
df_json = pd.read_json('export.json', orient='records')

Резюме лучших практик

Перед экспортом

  1. Сначала протестируйте с небольшим набором данных
  2. Убедитесь, что результаты запроса соответствуют ожиданиям
  3. Проверьте доступное место на диске
  4. Учитывайте конфиденциальность данных и требования соответствия

Во время экспорта

  1. Выберите подходящий формат для вашего случая использования
  2. Используйте описательные имена файлов с датами
  3. Включайте заголовки/метаданные для ясности
  4. Следите за прогрессом для больших экспортов

После экспорта

  1. Проверьте целостность файла (откройте и проверьте образец)
  2. Защитите конфиденциальные файлы (зашифруйте при необходимости)
  3. Очистите временные файлы
  4. Документируйте экспорт для воспроизводимости

Следующие шаги

Теперь, когда вы можете эффективно экспортировать данные:

  1. Основы запросов — Освойте написание SQL-запросов
  2. Навигация по базе данных — Изучите структуру базы данных
  3. Оптимизация производительности — Оптимизируйте скорость экспорта
  4. Интеграция с macOS — Используйте родные функции macOS

Получение помощи

Если у вас возникли проблемы с экспортом:

  1. Проверьте наше Руководство по поддержке для устранения неполадок
  2. Посетите Часто задаваемые вопросы (FAQ) для получения ответов на общие вопросы
  3. Свяжитесь со службой поддержки для получения персональной помощи
Назад к категорииНазад к документации

Обратная связь

Помогите нам улучшить документацию

Сообщить о проблемеСвязаться с поддержкойEdit this page