Перейти к основному содержанию
chDB-go предоставляет привязки chDB для Go, позволяя выполнять запросы ClickHouse прямо в ваших приложениях Go без каких-либо внешних зависимостей.

Установка

1

Установите libchdb

Сначала установите библиотеку chDB:
2

Установите chdb-go

Установите пакет для Go:
Или добавьте его в go.mod:

Использование

Интерфейс командной строки

В chDB-go есть интерфейс командной строки для быстрых запросов:

Библиотека Go — быстрый старт

Запросы без сохранения состояния

Для простых разовых запросов:

Запросы с сохранением состояния в рамках сеанса

Для сложных запросов с сохранением состояния:

Интерфейс SQL-драйвера

chDB-go реализует интерфейс Go database/sql:

Потоковые запросы для больших датасетов

Для обработки больших датасетов, которые не умещаются в памяти, используйте потоковые запросы:
Преимущества потокового запроса:
  • Эффективное использование памяти - Обрабатывайте большие наборы данных, не загружая всё в память
  • Обработка в реальном времени - Начинайте обрабатывать данные, как только поступит первый фрагмент
  • Поддержка отмены - Долгие запросы можно отменять с помощью Cancel()
  • Обработка ошибок - Проверяйте ошибки во время потоковой обработки с помощью Error()

Документация по API

chDB-go предоставляет как высокоуровневые, так и низкоуровневые API:

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

  • Go 1.21 или более поздней версии
  • Совместимо с Linux и macOS