Операционная система ЗОСРВ «Нейтрино» > Описание базовых компонентов целевой системы > Утилиты > Q > qdbc



qdbc

Клиент менеджера qdb, позволяющий выполнять SQL запросы к библиотеке sqlite

Синтаксис:

qdbc [опции] [SQL-запрос]

Опции:

-a область_действия
Задает область действия параметров -B, -S и -V. Используются следующие области действия:
default
Присоединенные базы данных, которые указаны в объекте конфигурации (с учетом значений параметров Vacuum Attached, Backup Attached и Size Attached). Это значение обеспечивает обратную совместимость.
all
Все присоединенные базы данных независимо от настроек объекта конфигурации.
none
Только подключенная база данных без присоединенных баз данных.
-B
Выполняет резервное копирование (эквивалент вызова функции qdb_backup()). Область действия этой операции определяется объектом конфигурации базы данных, которая указана в опции -d, переменной QDBC_DBNAME, либо опцией -a если она применяется.
-b
Аналогично -B .
-C имя_сортировки
Задает имя сортировки, применяемой к выражению, определению столбца или определению базы данных. Поддерживаются следующие значения аргумента имя_сортировки:
uca
Алгоритм сортировки всего набора символов Unicode.
-c имя_сортировки
Аналогично -C .
-d база_данных
База данных, над которой будет выполнен оператор SQL или другая операция. Если этот параметр не указан, используется значение переменной окружения QDBC_DBNAME.
-f формат
Формат результатов. Поддерживаются следующие форматы:
simple (по умолчанию)
Обычный текст с названиями столбцов и данными, разделенными вертикальной чертой ("|").
html
Текст в кодировке HTML.
sgml
Текст в кодировке SGML.
data
Обычный текст без названий столбцов и с данными, разделенными символом табуляции.
-q
Отключает вывод результатов.
-S
Печатает информацию о размере базы данных (эквивалентно вызову функции qdb_getdbsize()) указанной в параметре -d или переменной окружения QDBC_DBNAME. Область действия этой операции определяется объектом конфигурации базы данных или опцией -a (если она указан).
-i
Аналогично -S .
-m
Печатает текущее состояние базы данных указанной в параметре -d или переменной окружения QDBC_DBNAME.
-t интервал_ожидания
Интервал ожидания подключения к базе данных в миллисекундах. Поддерживаются следующие значения аргумента интервал_ожидания:
nonblock
Отключает таймаут ожидания.
block
Устанавливает максимальный таймаут ожидания.
интервал_ожидания
Устанавливает пользовательский таймаут ожидания.
-V
Выполняет очистку (эквивалентно вызову функции qdb_vacuum()). Область действия этой операции определяется объектом конфигурации базы данных, которая указана в параметре -d, переменной QDBC_DBNAME или параметре -a (если он используется).
-v[v...]
Повышает уровень детализации результатов.
sql
Выполняет оператор SQL над указанной базой данных. Оператор указывается в кавычках и завершается точкой с запятой. Если оператор SQL не указан, qdbc входит в интерактивный режим и считывает операторы, которые вводит пользователь, из командной строки. По окончании ввода операторов SQL нажмите Ctrl - C, чтобы выйти из интерактивного режима.

Платформы:

ЗОСРВ «Нейтрино»

Целевые архитектуры:

aarch64, arm, armv7, e2k, mips, ppc, x86

Описание:

Клиент QDB позволяет выполнять операторы SQL над базой данных qdb без написания кода, а также операции резервного копирования, очистки и определения размера базы данных. Это может быть полезно при разработке приложений для QDB.


Caution: Опции -B, -S, -V и являются взаимоисключающими ― можно указывать только один из них.

Если параметр -q не задан, qdbc отображает результат каждого оператора SQL на стандартном устройстве вывода. Также можно перенаправлять файл, который содержит операторы SQL, на вход QDB: qdbc < sql.txt. Кроме того, qdbc поддерживает интерактивный режим, в котором можно последовательно вводить любое количество операторов SQL. Эти операторы не нужно заключать в кавычки, но необходимо завершать их точкой с запятой.

Возвращаемое значение:

0
Успешное выполнение SQL оператора.
>0
Возникла ошибка.

Классификация:

Базовые подсистемы ЗОСРВ «Нейтрино»

Тематические ссылки:

qdb, Библиотека менеджера QDB




Предыдущий раздел: Утилиты