Свойства sql-соединения

cSetting	Тип	Описание	Статус
"Asynchronous"	L	См. табл. 14.15	Чтение / запись
"BatchMode"	L	Если равно .T. (по умолчанию), то SQLEXEC( ) возвращает все результаты сразу, или порциями посредством SQLMORERESULTS( ), если равно .F.	"
"ConnectBusy"	L	Содержит .T., если разделяемое соединение занято, или .F. – в противном случае	Чтение
"ConnectString"	C	См. табл. 14.15	"
"ConnectTimeout"	N	"	Чтение / запись
"DataSource"	C	"	"
DisconnectRollback	L	"	"
"DispLogin"	N	"	"
"DispWarnings"	L	"	"
"IdleTimeout"	N	"	"
"ODBChdbc"	N	Внутренний ODBC-идентификатор соединения, который может быть использован внешней библиотекой файлов (FLL-файлы) для вызова ODBC	Чтение
"ODBChstmt"	N	Внутренний ODBC-идентификатор SQL-соединения, который может быть использован внешней библиотекой файлов (FLL-файлы) для вызова ODBC	"
"PacketSize"	N	См. табл. 14.15	Чтение / запись
"PassWord"	C	"	Чтение
"QueryTimeout"	N	"	Чтение / запись
"Shared"	L	Содержит .T., если соединение разделяемое, или .F. – в противном случае	Чтение
"Transactions"	N	См. табл. 14.15	Чтение / запись
"UserId"	C	"	Чтение
"WaitTime"	N	"	Чтение / запись

eExpression – значение свойства. Тип значения должен совпадать с типом свойства. Если параметр eExpression опущен, то восстанавливается заданное по умолчанию значение.

Свойства задаются как на уровне VFP в проектировщике соединений (см. рис. 16.4), так и на уровне соединения. Исключение составляет свойство ConnectTimeOut, существующее только на уровне VFP. Значение свойства, заданное на уровне VFP в проектировщике соединений или функцией DBSETPROP( ), берется как значение по умолчанию на уровне соединения при его создании на основе именованного соединения базы данных VFP.

Пример. Изменяется значение свойства IdleTimeout.

&& Неразделяемое SQL-соединение; указываем ODBC-имя источника данных

nStHandle = SQLConnect('BookSaleDataBase')

if nStHandle > 0 then

MessageBox('SQL-соединение создано!')

nSet = SQLSetProp(nStHandle, "IdleTimeout", 2)

if nSet > 0 then

&& Получаем и выводим значение свойства IdleTimeout SQL-соединения

? SQLGetProp(nStHandle, "IdleTimeout") && Напечатает: 2

&& Получаем и выводим значение свойства IdleTimeout окружения

? SQLGetProp(0, "IdleTimeout") && Напечатает: 0

else

MessageBox("Ошибка при задании IdleTimeout")

endif

&& Разрываем SQL-соединение

SQLDisconnect(nStHandle)

else

MessageBox('Не удалось создать SQL-соединение')

endif

Функция

SQLGETPROP(nStatementHandle, cSetting)

возвращает значение свойства заданного параметром nStatementHandle SQL-соединения.

Результат и параметр nStatementHandle функции описаны в разд. 16.3.3. Правда, если качестве nStatementHandle указать 0, то SQLGETPROP( ) вернет значение соответствующей установки окружения.

Параметр:

cSetting – строка с именем свойства, значение которого нужно получить. Возможные значения cSetting см. в табл. 16.7.

Функция

SQLTABLES(nStatementHandle [, cTableTypes] [, cCursorName])

заносит сведения о таблицах источника данных SQL-соединения, заданного параметром nStatementHandle, в курсор VFP.

Функция может выполняться в асинхронном режиме.

Результат и параметр nStatementHandle функции описаны в разд. 16.3.3 и 16.3.4.

Параметры:

cTableTypes – один или более типов таблиц. Возможные значения типа таблицы: 'TABLE', 'VIEW' и 'SYSTEM TABLE'. При задании нескольких типов их значения разделяются запятыми, например:

? SQLTables(nStHandle, "'VIEW', 'SYSTEM TABLE'", "SomeCur")

Если параметр cTableTypes опущен или равен пустой строке, то выберутся имена таблиц всех типов.

Значение типа таблицы задается прописными буквами и обрамляется одинарными кавычками, например "'TABLE'". Внешние или внутренние кавычки могут быть опущены, если cTableTypes содержит один тип, например:

? SQLTables(nStHandle, "TABLE", "SomeCur")

cCursorName – имя курсора VFP, в который посылаются результаты. Если параметр опущен, то будет использовано имя по умолчанию – SQLResult.

Курсор содержит приведенные в табл. 16.8 столбцы.

Таблица 16.8