Начать пакетное добавление

Функция

Определение запроса инициирования пакетного добавления.

Спецификация
   
< начать пакетное добавление >::=
START APPEND INTO [имя схемы.] {имя таблицы |имя представления}
[#[группа]#[RAL]#[WAL]] [формат пакета]
[формат столбца]
[VALUES (? [,…])]
[WAIT | NOWAIT]
[{QUANT | QUANTUM} TIMEOUT время]
< формат пакета >::=
BYTE | CHAR
< формат столбца >::=
< спецификация столбца >::=
< формат даты >::=
Синтаксические правила
  1. < RAL >, < WAL > – уровни доступа на чтение и запись (см. документ «СУБД ЛИНТЕР. Администрирование комплекса средств защиты данных», раздел «Уровни доступа»).

    Примечание

    Поддерживается только в СУБД ЛИНТЕР БАСТИОН.

  2. < Имя таблицы > должно ссылаться на пользовательскую базовую таблицу или обновляемое представление.

  3. < Дата-время литерал > допустимо применять только для столбцов с типом данных DATE.

  4. < Имя столбца > не должно быть именем BLOB-столбца (столбец типа EXTFILE является допустимым).

  5. Опция VALUES задает список параметров для данной конструкции. Количество параметров (знаков ?) должно строго соответствовать количеству загружаемых столбцов. Используется после претрансляции для автоматического определения типов данных и длин загружаемых значений.

Общие правила
  1. < Формат пакета > задает формат представления данных, используемый для всех столбцов таблицы. В формате BYTE преобразование полей записи пакета не производится – данные в таблицу записываются в том виде, в каком они содержатся во входном буфере данных. В формате CHAR выполняется преобразование данных из символьного вида к типу данных соответствующего столбца. Если < формат пакета > не задан, по умолчанию используется CHAR.

    Примечание

    При формировании пакета PUTM для значений переменной длины с последующим преобразованием их к типу BYTE требуется обязательное выделение двух байт, содержащих длину значения переменного типа данных.

  2. < Формат столбца > задает формат индивидуального представления данного столбца. Преобразование по форматам BYTE и CHAR выполняется подобно преобразованию по этим форматам для всей таблицы. < Формат даты > используется для преобразования столбцов, имеющих тип данных DATE. Если < формат столбца > задан без указания типа преобразования, по умолчанию используется CHAR.

  3. Если одновременно заданы < формат пакета > и < форматы столбцов >, то высший приоритет имеет < формат столбца >.

  4. Параметр < время > задает максимально допустимую продолжительность выполнения запроса (от 1 до 65535 сек.). Если запрос в отведенное для него время не был выполнен, его обработка прекращается с выдачей соответствующего кода завершения.

  5. Если для таблицы, в которую выполняется пакетная загрузка данных, задано ограничение целостности CHECK, и хотя бы одна из записей в порции не удовлетворяет условию CHECK, то вся порция не будет добавлена.

Примечание

При пакетной вставке данных триггеры, настроенные на вставку данных, срабатывать не будут.

Пример

См. приложение 10 в документе «СУБД ЛИНТЕР. Интерфейс нижнего уровня».