Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

Документация
Функция htCreateClusterTable - Создать таблицу кластеров для связки таблиц

htCreateClusterTable - Создать таблицу кластеров для связки таблиц

Назначение:

Функция предназначена для вывода результатов связывания таблиц (htTablesJoin/htTablesLink) в отдельную таблицу - таблицу кластеров. Таблица будет содержать некоторое число полей по числу связанных таблиц. Имя каждого поля будет являться именем соответствующей таблицы в связке. Тип поля - ET_LONG и оно ключевое (но не уникальное). Каждое поле таблицы хранит адреса записей одной из связанных таблиц так, что одна запись таблицы кластеров содержит экземпляр установленного соответствия записей связанных таблиц. Следует подчеркнуть, что как и в результатах (htTablesJoin/htTablesLink) храняться адреса записей (не их физические номера).

Функция создает таблицу кластеров. Созданная таблица кластеров остается закрытой. Если таблица с таким именем уже существовала она будет уничтожена.

Прототип:

 int HTAPI htCreateClusterTable(
	LPSAB	 fpLink,	/* БДС со связкой таблиц */
	char far *fpTabName,	/* Имя таблицы кластеров */
	char far *fpCryptoKey,	/* Ключ для крипто-закрытия данных */
	char far *fpReadPswd,	/* Пароль доступа на чтение */
	char far *fpWritePswd,	/* Пароль доступа на запись */
	int	 nIndex	/* !=0 - индексировать таблицу кластеров */
 );

Параметры

fpLink
задает адрес БДС, содержащего результата связки нескольких таблиц. Именно это соответствие и будет оформлено как таблица кластеров
fpTabName
задает имя файла описания таблицы (с указанием полного или частичного пути), расширение задавать не обязательно
fpCryptoKey
задает строку, используемую в качестве пароля для крипто-закрытия данных. Значащими являются только первые 8 символов. Если пароль не нужен, можно задать NULL или пустую строку "".
fpReadPswd
задает строку, используемую в качестве пароля для доступа к таблице на чтение. Значащими являются только первые 8 символов. Если пароль не нужен, можно задать NULL или пустую строку "".
fpWritePswd
задает строку, используемую в качестве пароля для доступа к таблице на запись. Значащими являются только первые 8 символов. Если пароль не нужен, можно задать NULL или пустую строку "".
nIndex
является флагом индексации таблицы. Если его значение отлично от 0, таблица кластеров будет проиндексирована

Результат:

0 при успешном завершении
отрицательное число код ошибки