Необходимое окружение:
- Развернутое ПО «QvDB-Qlever» согласно инструкции по установке
- Развернутая и настроенная СУБД PostgreSQL версии 11 и выше, Postgres Pro версии 11 и выше или Clickhouse версии 22.12 и выше
- Учетные данные, необходимые для подключения к базе данных
- Имя пользователя
- Пароль пользователя
- Имя компьютера или IP адрес
- Номер порта
- Имя базы данных
Инструкция по использованию ПО «QvDB-Qlever»
Перейдите в каталог в котором находится развёрнутое ПО «QvDB-Qlever»
cd ~/qvdb
Скриншот команды:
Вызов справки
./qvdb.bin -h
Альтернативная команда: ./qvdb.bin --help
Скриншот команды:
Здесь мы видим что у нас доступно 2 подкоманды:
load-qvd-to-clickhouse
Аргументы:
QVD_FILE - обязательный позиционный аргумент, путь до .qvd файла;
--host - обязательный именованный аргумент, указывающий на IP или DNS адрес машины с БД, в которую производится выгрузка;
--port - обязательный именованный аргумент, указывающий на порт БД, в которую производится выгрузка;
--username - обязательный именованный аргумент, содержащий имя пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--password - обязательный именованный аргумент, содержащий пароль пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--table - обязательный именованный аргумент, содержащий имя таблицы, которая будет создана в БД, в которую производится выгрузка;
--database - необязательный именованный аргумент(default: default), содержащий имя таблицы, в которой будут созданы таблица и схема в БД, в которую производится выгрузка.
Конвертирование файла QVD
./qvdb.bin load-qvd-to-clickhouse --host 1.1.1.1 --port 5432 --username admin --password admin --schema --database analytics_base_qvd --table test02 ~/qvdb/raw_test_data.qvd
При выполнении данной команды: будет создана таблица с названием test02 из файла qvd, который находится по пути ~/qvdb/raw_test_data.qvd.
load-qvd-to-posgresql
Аргументы:
QVD_FILE - обязательный позиционный аргумент, путь до .qvd файла;
--host - обязательный именованный аргумент, указывающий на IP или DNS адрес машины с БД, в которую производится выгрузка;
--port - обязательный именованный аргумент, указывающий на порт БД, в которую производится выгрузка;
--username - обязательный именованный аргумент, содержащий имя пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--password - обязательный именованный аргумент, содержащий пароль пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--table - обязательный именованный аргумент, содержащий имя таблицы, которая будет создана в БД, в которую производится выгрузка;
--schema - необязательный именованный аргумент(default: public), содержащий имя схемы, в которой будет создана таблица в БД, в которую производится выгрузка;
--database - необязательный именованный аргумент(default: default), содержащий имя таблицы, в которой будут созданы таблица и схема в БД, в которую производится выгрузка.
Конвертирование фала QVD
./qvdb.bin load-qvd-to-posgresql --host 1.1.1.1 --port 5432 --username admin --password admin --schema analytics_base_qvd --database main --table test02 ~/qvdb/raw_test_data.qvd
При выполнении данной команды: будет создана таблица с названием test02 из файла qvd, который находится по пути ~/qvdb/raw_test_data.qvd.