Golang migrate.New как указывать параметры для Clickhouse

Библиотека migrate (из пакета github.com/golang-migrate/migrate) поддерживает ClickHouse как источник данных для миграций. Чтобы использовать migrate.New или другие методы для миграции в ClickHouse, параметры подключения задаются через строку DSN.

---

Указание параметров для ClickHouse в migrate

При использовании migrate.New для работы с ClickHouse, строка подключения указывается в следующем формате:

• <username>: Имя пользователя (по умолчанию default).
• <password>: Пароль (по умолчанию пустой).
• <host>: Хост ClickHouse (например, 127.0.0.1).
• <port>: Порт (обычно 9000).
• <database>: Имя базы данных.
• <query_parameters>: Дополнительные параметры подключения.

Пример использования migrate.New с ClickHouse

Поддерживаемые параметры строки DSN

Для ClickHouse поддерживаются следующие параметры в строке DSN:

• read_timeout: Тайм-аут чтения (например, 10s).
• write_timeout: Тайм-аут записи.
• secure: Включение TLS-соединения (true или false).
• debug: Включение отладочного режима (true или false).
• compress: Использовать сжатие (true или false).

---

Примеры строк DSN

1. Подключение без пароля
   
   Shell

   clickhouse://default:@127.0.0.1:9000/default

   1 2	clickhouse://default:@127.0.0.1:9000/default

    
2. С параметрами отладки и сжатия
   
   Default

   clickhouse://default:@127.0.0.1:9000/default?debug=true&compress=true

   1 2	clickhouse://default:@127.0.0.1:9000/default?debug=true&compress=true

    
3. С тайм-аутами
   
   Default

   clickhouse://default:@127.0.0.1:9000/default?read_timeout=10s&write_timeout=10s

   1 2	clickhouse://default:@127.0.0.1:9000/default?read_timeout=10s&write_timeout=10s

    
4. С TLS
   
   Default

   clickhouse://default:@127.0.0.1:9440/default?secure=true

   1 2	clickhouse://default:@127.0.0.1:9440/default?secure=true

    

Организация миграций

1. Формат миграционных файлов Миграции для ClickHouse обычно пишутся в формате SQL-файлов:
   
   Default

   0001_create_table.up.sql 0001_create_table.down.sql

   1 2 3

   0001_create_table.up.sql 0001_create_table.down.sql

    
2. Пример содержимого миграции 0001_create_table.up.sql:
   
   PgSQL

   CREATE TABLE example ( id UInt64, name String, created_at DateTime ) ENGINE = MergeTree() ORDER BY id;

   1 2 3 4 5 6 7

   CREATE TABLE example (     id UInt64,     name String,     created_at DateTime ) ENGINE = MergeTree() ORDER BY id;

   0001_create_table.down.sql:
   
   PgSQL

   DROP TABLE example;

   1 2	DROP TABLE example;

    

Установка библиотеки migrate

Убедитесь, что библиотека migrate и её зависимости для ClickHouse установлены: