...
- Развернутое ПО «QvDB-Qlever» , согласно инструкции по установке
- Развернутая и настроенная СУБД PostgreSQL версии 11 и выше, Postgres Pro версии 11 ивыше или Clickhouse версии 22.12 и выше
- Учетные данные данные, необходимые для подключения к базе данных
- Имя пользователя
- Пароль пользователя
- Ия Имя компьютера или IP адрес
- Номер порта
- Имя базы данных
...
Перейдите в каталог в котором находится развёрнутое ПО «QvDB-Qlever»
| Code Block | ||||
|---|---|---|---|---|
| ||||
cd ~/qvdb |
Скриншот команды:
...
Вызов справки
| Code Block | ||||
|---|---|---|---|---|
| ||||
./qvdb.bin -h |
Альтернативная команда: ./qvdb.bin --help
Скриншот команды:
Здесь мы видим что у нас доступно 2 подкоманды:
load-qvd-to-clickhouse
Аргументы:
path QVD_FILE - обязательный позиционный аргумент, путь до .qvd файла.;
--host connect_uri - обязательный позиционный именованный аргумент, строка подключения к БД в формате RFC-1738. Пример: postgresql://scott:tiger@localhost:5432/mydatabase .
-t, --table - опциональный аргумент, позволяющий задать имя таблицы назначения в БД, если не указан, то берется название таблицы в Qlik, при сторе qvd файла.
-s, --safe-mode - включить принудительное приведение всех значений к String
-e, --exists - опциональный аргумент, позволяющий задать реакцию на существования таблицы назначения в БД, если не указан - fail.
Возможные варианты Exists: (fail - вызвать ошибку, replace - заменить, append - добавить данные в низ таблицы, только если схемы одинаковые, иначе будет ошибка).
Конвертирование фала QVD
указывающий на IP или DNS адрес машины с БД, в которую производится выгрузка;
--port - обязательный именованный аргумент, указывающий на порт БД, в которую производится выгрузка;
--username - обязательный именованный аргумент, содержащий имя пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--password - обязательный именованный аргумент, содержащий пароль пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--table - обязательный именованный аргумент, содержащий имя таблицы, которая будет создана в БД, в которую производится выгрузка;
--database - необязательный именованный аргумент(default: default), содержащий имя таблицы, в которой будут созданы таблица и схема в БД, в которую производится выгрузка.
Конвертирование файла QVD
| Code Block | |||
|---|---|---|---|
| |||
| |||
./qvdb.bin -t 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 postgresql://1sdbwrite:51X2k7MK9PT@192.168.50.20:5432/1sdb |
При выполнении данной команды: будет создана таблица с названием test02 из файла qvd, который находится по пути ~/qvdb/raw_test_data.qvd.
Строка подключения к базе данных: postgresql://1sdbwrite:51X2k7MK9PT@192.168.50.20:5432/1sdb
Где:
- 1sdbwrite - имя пользователя
- 51X2k7MK9PT - пароль пользователя
- 192.168.50.20 - хост базы данных
- 5432 - порт базы данных
- 1sdb - база данных в которой будет создаваться таблица
Общая форма URI для подключения к postgresql такова:
postgresql://[user[:password]@][host][:port][/dbname][?param1=value1&...]
Более подробно про подключение указано в документации PostgreSQL по ссылке: https://www.postgresql.org/docs/current/libpq-connect.html
Скриншот команды:
load-qvd-to-posgresql
Аргументы:
QVD_FILE - обязательный позиционный аргумент, путь до .qvd файла;
--host - обязательный именованный аргумент, указывающий на IP или DNS адрес машины с БД, в которую производится выгрузка;
--port - обязательный именованный аргумент, указывающий на порт БД, в которую производится выгрузка;
--username - обязательный именованный аргумент, содержащий имя пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--password - обязательный именованный аргумент, содержащий пароль пользователя, из-под которого осуществляется доступ к БД, в которую производится выгрузка;
--table - обязательный именованный аргумент, содержащий имя таблицы, которая будет создана в БД, в которую производится выгрузка;
--schema - необязательный именованный аргумент(default: public), содержащий имя схемы, в которой будет создана таблица в БД, в которую производится выгрузка;
--database - необязательный именованный аргумент(default: default), содержащий имя таблицы, в которой будут созданы таблица и схема в БД, в которую производится выгрузка.
Конвертирование фала QVD
| Code Block | ||||
|---|---|---|---|---|
| ||||
./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.