Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
Введение в СУБД HyTech.doc
Скачиваний:
11
Добавлен:
01.03.2025
Размер:
2.67 Mб
Скачать

7.1.5 Функции для пакетного ввода данных Пакетное добавление строк в таблицу

Пакетное добавление строк в таблицу достаточно часто встречается в информационных системах, по этой причине данная функциональность нашла отражение в API HyTech для PHP. Пакетное добавление строк включает следующие шаги:

  • Открытие таблицы;

  • Добавление строк в буфер, зарезервированный для пакетного ввода;

  • Сохранение строк из буфера в БД;

  • Закрытие таблицы.

Открытие таблицы

Функция hytech_open_table используется для открытия таблицы.

Формат вызова:

TableId = hytech_open_table ( ConnId, TableName[, BuffSize] );

Аргументы:

Аргумент

Тип

Значение

ConnId

Resource

Идентификатор соединения, возвращенный функцией hytech_connect или hytech_pconnect.

TableName

String

Имя таблицы.

BuffSize

Integer

Задает размер буфера (максимальное количество строк), которое может быть добавлено при пакетном добавлении строк в таблицу. По умолчанию параметр равен 1.

Параметр BuffSize не обязательный.

Результат:

Тип

Значение

Resource

Идентификатор таблицы или false в случае ошибки.

Добавление строки в буфер пакетного ввода

Функция hytech_record_add_assoc также используется для добавления новой строки в буфер пакетного ввода. Строка представляется в виде массива значений полей. В качестве ключей элементов массива используются имена полей.

Формат вызова:

RowCount = hytech_record_add_assoc ( TableId, DataArray );

Аргументы:

Аргумент

Тип

Значение

TableId

Resource

Идентификатор таблицы, возвращенный функцией hytech_open_table.

DataArray

Array

Массив значений полей в добавляемой строке, в качестве ключей элементов массива используются имена полей.

Результат:

Тип

Значение

Integer

Количество строк, находящихся в буфере. Ошибка проверяется по несовпадению количества строк добавляемых и добавленных.

Функция hytech_record_add_array используется для добавления новой строки в буфер пакетного ввода. Строка представляется в виде массива значений полей. В качестве ключей элементов массива используются целые числа от 0 до <количество полей> – 1.

Формат вызова:

RowCount = hytech_record_add_array ( TableId, DataArray );

Аргументы:

Аргумент

Тип

Значение

TableId

Resource

Идентификатор таблицы, возвращенный функцией hytech_open_table.

DataArray

Array

Массив значений полей в добавляемой строке, в качестве ключей используются целые числа от 0 до <количество полей> – 1. Порядок элементов массива должен соответствовать порядку полей в таблице, т.е. значение 0-го элемента помещается в 1-ое поле, 1-го элемента во второе поле и т.п.

Результат:

Тип

Значение

Integer

Количество строк, находящихся в буфере. Ошибка проверяется по несовпадению количества строк добавляемых и добавленных.