Доступные версии документации

Выполнение программы

Запуск

Запуск утилиты осуществляется стандартными средствами запуска задач, имеющимися в каждой операционной системе. Исполняемый файл утилиты – testdb.exe для ОС Windows, testdb – для ОС UNIX, QNX.

Командная строка:

testdb [<командная строка>]
<командная строка>::=<ключ>[...] [каталог БД]

За один сеанс работы утилита обрабатывает только одну командную строку.

Синтаксические правила

  1. Для передачи утилите параметров используется набор ключей, позволяющих однозначно интерпретировать вид параметра. Все ключи имеют уникальное мнемоническое обозначение.

  2. Признаком ключа является знак минус «-», альтернативный признак ключа «/» (обратная косая черта) допустим во всех ОС, кроме UNIX.

    Эти конструкции эквивалентны:
    testdb -e -r -de
    testdb /e /r /de
    testdb -e /r -de
  3. Имена ключей регистронезависимы, за исключением -statistics и -version.

    Эти конструкции эквивалентны:
    testdb -e -r -de
    testdb -E -R -De
    testdb -e -R -de
  4. Значения ключей, относящиеся к объектам БД (имена, пароли, наименования таблиц и т.п.) регистрозависимы.

    Эти конструкции неэквивалентны:
    testdb -p 50 -t BANK
    testdb -p 50 -t Bank
  5. Именование объектов БД должно выполняться в соответствии с требованиями документа «СУБД ЛИНТЕР. Справочник по SQL».

    testdb -p 50 -t BANK
    testdb -p 50 -t "Bank"
    testdb -p 50 -t "БАНК"
    testdb -p 50 -t "АКБ ""Промстройбанк"""
  6. Если задан ключ, не относящийся к команде, то ошибка не фиксируется, а ключ программой не обрабатывается (игнорируется).

  7. Параметр <каталог БД> может быть задан перед, после или внутри списка ключей.

    testdb [каталог БД] <ключ1> <ключ2> <ключ3>
    testdb <ключ1> <ключ2> <ключ3> [каталог БД]
    testdb <ключ1> <ключ2> [каталог БД] <ключ3>
  8. Некоторые ключи работают только в комбинации с другими ключами. Местоположение в командной строке каждого ключа такой комбинации может быть произвольным.

Структура генерируемых SQL-скриптов

Генерируемые testdb SQL-скрипты предназначены для выполнения утилитой inl (они могут содержать управляющие команды этой утилиты). При необходимости SQL-скрипт может быть отредактирован вручную для выполнения с помощью других утилит СУБД ЛИНТЕР.

Правила формирования SQL-скрипта следующие:

  1. все SQL-операторы, модифицирующие объекты БД и для выполнения которых требуются регистрационные данные их владельца, объединяются в одну группу;

  2. перед выполнением этой группы SQL-операторов на консоль выдается подсказка, информирующая о пользователе БД, от чьего имени должно продолжаться выполнение SQL-скрипта;

  3. после этого на консоль выдается запрос для подтверждения регистрационных данных (имени и пароля) декларированного пользователя;

  4. после обработки SQL-операторов текущего пользователя процедура идентификации пользователя и выполнения SQL-скрипта повторяется;

  5. для пользователя БД по умолчанию (SYSTEM/MANAGER) регистрационные данные не запрашиваются, если до этого не был установлен другой пользователь.

Пример сгенерированного SQL-скрипта:

UPDATE "SYSTEM"."T1" SET "I" = NULL WHERE ROWID = 1;
DROP INDEX "I" on "SYSTEM"."T1";
CREATE INDEX "I" on "SYSTEM"."T1";
! User name:TEST
USERNAME "TEST"
UPDATE "TEST"."T1" SET "I" = NULL WHERE ROWID = 1;
DROP INDEX "I" on "TEST"."T1";
CREATE INDEX "I" on "TEST"."T1";
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter