Функция Server_ColumnInfo( )
Функция Server_ColumnInfo( )
Назначение:
Возвращает информацию о столбцах результирующего набора.
Синтаксис:
Server_ColumnInfo(StatementNumber, ColumnNo, Attr)
StatementNumber – целое значение, номер SQLLоператора.
ColumnNo – номер столбца в наборе; нумерация слева направо, начиная с 1.
Attr – код, указывающий характер возвращаемой информации.
Возвращаемое значение:
Возвращаемое значение зависит от значения атрибута (параметр Attr).
Описание:
Функция Server_ColumnInfo() возвращает информацию о текущем выбранном столбце результирующего набора (определенного ранее исполненным SQLLоператором Select) в удаL ленной базе данных. Параметр StatementNumber задает номерLуказатель (handle) SQLL оператора, ассоциированный с данным соединением с сервером данных. Параметр ColumnNo указывает столбец, информацию о котором Вы хотите получить. Параметр Attr выбирает тип возвращаемой информации.
В следующей таблице перечислены возможные атрибуты (значения параметра Attr; определены в файле MAPBASIC.DEF).
Атрибут |
Server_ColumnInfo() возвращает: |
SRV_COL_INFO_NAME |
Имя столбца. |
SRV_COL_INFO_TYPE |
Целый результат; код типа столбца: |
|
SRV_COL_TYPE_NONE |
|
SRV_COL_TYPE_CHAR |
|
SRV_COL_TYPE_DECIMAL |
|
SRV_COL_TYPE_INTEGER |
|
SRV_COL_TYPE_SMALLINT |
|
SRV_COL_TYPE_DATE |
|
SRV_COL_TYPE_LOGICAL |
|
SRV_COL_TYPE_FLOAT |
|
SRV_COL_TYPE_FIXED_LEN_STRING |
|
SRV_COL_TYPE_BIN_STRING |
|
Информацию об интерпретации типов данных приложением |
|
MapInfo Вы можете найти в Руководстве пользователя Map |
|
Basic. |
Справочник MapBasic |
447 |
Функция Server_ColumnInfo( )
SRV_COL_INFO_SCALE |
Целый результат, указывающий число разрядов справа от |
|
десятичной точки для столбца типа |
|
SRV_COL_TYPE_DECIMAL, или L1 для столбца любого |
|
другого типа. |
SRV_COL_INFO_PRECISION |
Целый результат, указывающий общее число разрядов для |
|
столбца типа SRV_COL_TYPE_DECIMAL, или L1 для |
|
столбца любого другого типа. |
SRV_COL_INFO_WIDTH |
Целый результат, указывающий максимальное число симвоL |
|
лов в столбце типа SRV_COL_TYPE_CHAR или |
|
SRV_COL_TYPE_FIXED_LEN_CHAR. |
|
Замечание: При использовании модуля QELIB пустой |
|
терминатор не учитывается. |
|
Замечание: Возвращаемое значение совпадает с шириной |
|
столбца таблицы базы данных. |
SRV_COL_INFO_VALUE |
Тип результата варьируется. Возвращается актуальное |
|
значение данных в столбце для текущей выбранной записи. |
|
Длинные строковые значения столбца, превышающие 32766 |
|
символов, усекаются. Двоичные (неструктурированные) |
|
значения столбца возвращаются в виде шестнадцатиричных |
|
символьных строк двойной длины. |
SRV_COL_INFO_STATUS |
Целый результат; статус значения столбца: |
|
SRV_NULL_DATA – возвращается, если столбец не имеет |
|
данных для выбранной строки. |
|
SRV_TRUNCATED_DATA – возвращается, если в столбце |
|
содержится больше данных, чем может быть сохранено в укаL |
|
занной переменной. |
|
Положительное целое значение – число байт, возвращенных |
|
сервером данных. |
SRV_COL_INFO_ALIAS |
Строковый результат; псевдоним столбца, если в запросе данL |
|
ных использовался псевдоним. |
Пример:
Dim hdbc, Stmt As Integer Dim Col As Integer
hdbc = Server_Connect(”QELIB”, ”DSN=ORACLE7;DLG=1”) Stmt = Server_Execute(hdbc, ”Select * from emp”) Server Stmt Fetch NEXT
For Col = 1 To Server_NumCols(Stmt)
Print Server_ColumnInfo(Stmt, Col, SRV_COL_INFO_NAME) + ” = ” + Server_ColumnInfo(Stmt, Col, SRV_COL_INFO_VALUE)
Next
Смотрите также:
Server Bind Column, Server Fetch, Server_NumCols()
448 |
Справочник MapBasic |
Оператор Server Commit
Оператор Server Commit
Назначение:
Вызывает фиксацию транзакции в удаленной базе данных.
Синтаксис:
Server ConnectionNumber Commit
ConnectionNumber – целое значение, номер соединения с сервером данных.
Описание:
Оператор Server Commit фиксирует транзакцию, т.е. сохраняет в базе данных изменения, произведенные в данном сеансе соединения всеми удаленными SQLLоператорами, выполненL ными с момента исполнения оператора Server Begin Transaction. Оператор Server Commit исполняется только при наличии открытой транзакции, инициированной оператором Server Begin Transaction. Для запуска новой транзакции Вы должны выдать серверу новый оператор Server Begin Transaction, за которым в дальнейшем должен быть исполнен оператор Server Commit.
Пример:
hdbc = Server_Connect(”QELIB”, ”DSN=ORACLE7;DLG=1”) Server hdbc Begin Transaction
hstmt = Server_Execute(hdbc, ”Update Emp Set salary = salary * 1.5”) Server hdbc Commit
Смотрите также:
Server Begin Transaction, Server Rollback
Справочник MapBasic |
449 |
Функция Server_Connect( )
Функция Server_Connect( )
Назначение:
Устанавливает соединение с удаленным сервером данных.
Синтаксис:
Server_Connect(toolkit, connect_string)
Параметр toolkit указывает модуль интерфейса удаленного доступа MapInfo, через который будет осуществляться соединение с сервером данных.
Параметр connect_string предоставляет интерфейсному модулю дополнительную информацию, необходимую для подключения к серверу данных.
Возвращаемое значение:
Целое.
Описание:
Функция Server_Connect() выполняет соединение с базой данных и возвращает номерL указатель соединения, который должен быть передан всем операторам удаленного доступа (как параметр ConnectionNumber), которые Вы хотите выполнить в данном сеансе соединения с сервером данных.
Параметр toolkit определяет модуль интерфейса удаленного доступа MapInfo (динамически загружаемую библиотеку), через который будет осуществляться соединение с сервером данных. Информация о возможных значениях параметра может быть получена вызовом функций
Server_NumDrivers и Server_DriverInfo().
Параметр connect_string передает модулю toolkit дополнительную информацию, необходимую для подключения к серверу данных. Значение строки подключения определяется требованиями удаленного сервера данных, к которому осуществляется доступ.
Строка подключения, задаваемая в функции Server_Connect(), имеет формат:
attribute=value[;attribute=value...]
(В строке подключения должны отсутствовать пробелы.)
Атрибуты Microsoft ACCESS
В следующей таблице перечислены атрибуты, используемые СУБД ACCESS:
Атрибут |
Описание |
DSN |
Имя ODBCLисточника для Microsoft ACCESS. |
UID |
Регистрационный идентификатор пользователя. |
PWD |
Пароль пользователя. |
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, то |
|
библиотека ODBC не используется для этого соединения, дающего |
|
возможность вызывать первую, последнюю, предыдущую или произвольную |
|
запись в базе данных. |
Пример строки подключения для СУБД ACCESS: |
|
450 |
Справочник MapBasic |
Функция Server_Connect( )
”DSN=MI ACCESS;UID=ADMIN;PWD=SECRET”
Атрибуты DB2
В следующей таблице перечислены атрибуты, используемые СУБД DB2:
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для DB2. |
DB |
Database. Имя базы данных, к которой Вы хотите подключиться. |
SI |
Sysibm. В большинстве реализаций СУБД DB2/2 владельцем |
|
таблиц системных каталогов является SYSIBM. Если Вы имеете |
|
доступ для чтения к системным таблицам, Вам не требуется |
|
изменять это значение; в противном случае администратор базы |
|
данных должен создать представление системных таблиц, |
|
оформив его как отдельный системный ресурс (account), и |
|
предоставить Вам права доступа к этому представлению. В этом |
|
случае укажите идентификатор авторизации (Authorization ID) |
|
ресурса L владельца представлений системных таблиц. Если Вы |
|
применяете DDCS/2 для подключения к серверу данных SQL/ |
|
400, задайте список разделенных запятыми идентификаторов |
|
наборов (Collection ID), к которым Вы хотите получить доступ в |
|
Вашем ODBCLприложении. Если Вы применяете DDCS/2 для |
|
подключения к серверу данных SQL/DS, задайте SYSTEM в |
|
качестве владельца. |
GRP |
Groups. Значение, определяющее множество таблиц, к которым |
|
Вы можете иметь доступ. Ваш системный администратор может |
|
поместить Вас в “группу” пользователей и определить права |
|
доступа для всей группы. В этом случае задайте список |
|
разделенных запятыми имен групп, к которым Вы принадлежите. |
|
Режим Groups=ALL позволяет Вашему приложению |
|
просматривать имена всех таблиц независимо от возможности |
|
доступа к ним. |
UID |
LogonID. Стандартный регистрационный идентификатор для |
|
подключения к СУБД DB2/2. Задание атрибута необходимо |
|
только при включенной системе защиты в Вашей СУБД. В этом |
|
случае Вам необходимо получить регистрационный |
|
идентификатор у системного администратора. |
PWD |
Password. Пароль пользователя. |
Справочник MapBasic |
451 |
Функция Server_Connect( )
CB |
CursorBehavior. Значение, определяющее поведение курсоров по |
|
завершении транзакции. Допустимые значения: 1 (курсоры |
|
сохраняются) и 0 (курсоры закрываются, начальное значение по |
|
умолчанию). Задайте CD=1, если Вы хотите, что бы курсоры |
|
удерживались в текущей позиции по завершении транзакции; |
|
учтите, что это может снизить эффективность работы с базой |
|
данных. Этот атрибут не применим для сервера SQL/DS. |
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, |
|
то библиотека ODBC не используется для этого соединения, |
|
дающего возможность вызывать первую, последнюю, |
|
предыдущую или произвольную запись в базе данных. |
Пример строки подключения к СУБД DB2/2:
DSN=MI DB2;DB=PAYROLL;UID=JOHN;PWD=XYZZY;GRP=ACCTNG
ODBCLДрайвер для доступа к СУБД DB2/2 именуется MIDBM07.DLL.
Для операционной системы Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2, маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
Атрибуты INFORMIX
В следующей таблице перечислены атрибуты, используемые СУБД INFORMIX :
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для INFORMIX. |
DB |
Database. Имя базы данных, к которой Вы хотите |
|
подключиться. |
HOST |
HostName. Имя резидентной машины сервера INFORMIX |
|
5. |
UID |
LogonID. Ваше имя пользователя для сервера INFORMIX . |
PWD |
Password. Пароль. |
SERV |
Service. Имя службы, определенное для резидентной |
|
машины: назначается системным администратором. |
PRO |
Protocol. Протокол связи с сервером. Допустимые |
|
значения: FTP, IPX, LANMAN или TCP/IP. Вы можете |
|
задать несколько значений, разделенных запятыми. |
452 |
Справочник MapBasic |
|
Функция Server_Connect( ) |
|
|
|
|
YLD |
YieldProc. Значение, определяющее возможность работы в |
|
|
других WindowsLприложениях в случае занятости сервера |
|
|
INFORMIX 5. Этот атрибут полезен для разработки |
|
|
ODBCLприложений. |
|
|
YieldProc=0 (прочитывать и отсылать) инструктирует |
|
|
драйвер проверять очередь сообщений Windows и |
|
|
пересылать любые сообщения соответствующим WindowsL |
|
|
приложениям. |
|
|
YieldProc=1 (нет выдачи сообщений, начальное значение |
|
|
по умолчанию) не позволяет Вам работать в других |
|
|
приложениях. |
|
|
YieldProc=2 (процедура выдачи INFORMIX) задает |
|
|
применение стандартной процедуры обработки сообщений |
|
|
сервера INFORMIX. |
|
|
YieldProc=3 (пересылка посредством WindowsLфункции |
|
|
Yield) передает (при необходимости) управление ядру |
|
|
Windows, которое проверяет очередь сообщений и |
|
|
пересылает любые сообщения в соответствующие окна |
|
|
приложений. |
|
|
Рекомендуется значение YieldProc=1, так как указание |
|
|
других значений YieldProc=0, YieldProc=2 и YieldProc=3 не |
|
|
обеспечивает работу всех WindowsLприложений. |
|
CB |
CursorBehavior. Значение, определяющее поведение |
|
|
курсоров по завершении транзакции. Допустимые |
|
|
значения: 1 (курсоры сохраняются) и 0 (курсоры |
|
|
закрываются, начальное значение по умолчанию). |
|
|
Задавайте CB=1, если Вы хотите, что бы курсоры |
|
|
удерживались в текущей позиции по завершении |
|
|
транзакции; учтите, что это может снизить эффективность |
|
|
исполнения операций над базой данных. |
|
SCROLL |
По умолчанию присваивается значение YES. Если |
|
|
SCROLL=NO, то библиотека ODBC не используется для |
|
|
этого соединения, дающего возможность вызывать первую, |
|
|
последнюю, предыдущую или произвольную запись в базе |
|
|
данных. |
|
Пример строки подключения для СУБД INFORMIX 5:
“DSN=MI INFORMIX;DB=PAYROLL”
ODBCLДрайвер для доступа к СУБД INFORMIX именуется MIINF507.DLL.
Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной РАTH. Для операционной системы OS/2, маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
Справочник MapBasic |
453 |
|
Функция Server_Connect( ) |
|
|
|
|
YLD |
YieldProc. Значение, определяющее возможность работы |
|
|
в других приложениях в случае занятости сервера |
|
|
INGRES. Этот атрибут полезен для пользователей |
|
|
ODBCLприложений. |
|
|
YieldProc=0 (прочитывать и отсылать) инструктирует |
|
|
драйвер проверять очередь сообщений Windows и |
|
|
пересылать любые сообщения соответствующим WinL |
|
|
dowsLприложениям. |
|
|
YieldProc=1 (нет выдачи сообщений), не позволяет Вам |
|
|
работать в других приложениях. Принимается по |
|
|
умолчанию для драйвера INGRES 6.4/03, и |
|
|
рекомендуется для применения с этим драйвером. Это |
|
|
значение недопустимо для драйвера INGRES 6.4/04. |
|
|
YieldProc=2 (процедура выдачи INGRES) задает |
|
|
применение стандартной процедуры обработки |
|
|
сообщений сервера INGRES. Принимается по |
|
|
умолчанию для драйвера INGRES 6.4/04, и |
|
|
рекомендуется для применения с этим драйвером. |
|
|
YieldProc=3 (пересылка посредством WindowsLфункции |
|
|
Yield) передает (при необходимости) управление ядру |
|
|
Windows, которое проверяет очередь сообщений и |
|
|
пересылает любые сообщения в соответствующие окна |
|
|
приложений. |
|
SCROLL |
По умолчанию присваивается значение YES. Если |
|
|
SCROLL=NO, то библиотека ODBC не используется для |
|
|
этого соединения, дающего возможность вызывать |
|
|
первую, последнюю, предыдущую или произвольную |
|
|
запись в базе данных. |
|
Пример строки подключения для СУБД INGRES:
“DSN=MI INGRES;SRVR=QESERV;DB=PAYROLL;UID=JOHN”
ODBCLДрайвер используемый для доступа к системе базы данных INGRES называется MIING07.DLL.
Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем катаL логе или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2 маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
Атрибуты ORACLE
В следующей таблице перечислены атрибуты, используемые СУБД ORACLE.
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для ORACLE. |
Справочник MapBasic |
455 |
Функция Server_Connect( )
UID |
LogonID. Регистрационное имя пользователя для подключения к СУБД |
|
ORACLE. Задание атрибута необходимо только при включенной системе |
|
защиты в Вашей СУБД. В этом случае Вам необходимо получить регистрациL |
|
онное имя у системного администратора. |
PWD |
Password. Пароль пользователя. |
LTO |
LockTimeOut. Значение, задающее необходимость ожидания снятия |
|
блокировки данных перед генерацией сообщения об ошибке при обработке |
|
оператора Select...For Update Of. Допустимые значения: L1 (ждать до снятия |
|
блокировки, начальное значение по умолчанию) или 0 (сгенерировать |
|
сообщение, не ожидая снятия блокировки). |
AS |
ArraySize. Объем в байтах буфера, используемого драйвером для выборки |
|
записей. Диапазон значений 0L65536. Начальное значение по умолчанию: |
|
60000. Увеличение объема буфера повышает производительность вследствие |
|
уменьшения числа выборок данных через сеть. Уменьшение объема буфера |
|
улучшает реакцию системы, так как уменьшается время ожидания передачи |
|
данных сервером. |
SRVR |
ServerName. Строка подключения к SQL*Net, указывающая сервер и базу |
|
данных, к которым Вы хотите получить доступ. Конкретное значение зависит |
|
от используемого Вами драйвера SQL*Net. Строка подключения к SQL*Net |
|
имеет следующий формат: |
|
driver_prefix:computer_name[:sid] |
|
driver_prefix – буква, указывающая сетевой протокол. Возможные значения: |
|
P (именованные линии), X (SPX), B (NetBIOS), |
|
T (TCP/IP), D (DECNet), A (Oracle Async) или AT (AppleTalk). Смотрите |
|
значения для других протоколов в Вашей документации к СУБД ORACLE. |
|
computer_name – имя коммуникационного сервера (Oracle Listener) в Вашей |
|
сети. |
|
sid – системный идентификатор (Oracle System Identifier), относящийся к |
|
экземпляру СУБД ORACLE, работающему на главной машине. Его указание |
|
необходимо при подключении к системам, поддерживающим несколько |
|
экземпляров СУБД ORACLE. |
|
Если строка подключения SQL*Net содержит точки с запятой, заключите ее в |
|
кавычки. Более подробную информацию смотрите в Вашей документации по |
|
SQL*Net. |
CCCatalogComments. Значение, определяющее возврат драйвером содержимого столбца COMMENTS из таблиц ORACLE. Допустимые значения: 1 (возвращать комментарии) или 0 (не возвращать комментарии, начальное значение по умолчанию).
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, то |
|
библиотека ODBC не используется для этого соединения, дающего |
|
возможность вызывать первую, последнюю, предыдущую или произвольную |
|
запись в базе данных. |
|
|
456 Справочник MapBasic
Функция Server_Connect( )
Пример строки подключения к серверу ORACLE7 по протоколу TCP/IP:
”DSN=MI ORACLE;SRV=T:SRVR1=ORACLE;USR=SCOTT;PWD=TIGER”
Требуемое значение атрибута SRV зависит от используемого Вами драйвера SQL*Net. Смотрите Вашу документацию по SQL*Net для получения подробной информации.
ODBCLДрайвер для доступа к СУБД ORACLE именуется MIOR707.DLL. Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2 маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
Атрибуты Oracle8i Spatial
Введение
Oracle8i Spatial это новое издание прастранственной базы данных от Oracle Corporation.
Здесь есть сходство с ранним Oracle SDO. MapInfo не поддерживает реляционную схему Oracle SDO через OCI. MapInfo не поддерживает одновременные соединения с Oracle8i через OCI и с другими базами данных через ODBC. MapInfo не поддерживает загрузку геометрических таблиц Oracle8I Spatial через ODBC используя текущий драйвер ODBC фирмы Intersolv.
Атрибут |
Описание |
LogonID (UID) |
Имя пользователя (logon ID) которое приложение |
|
использует для с вязи с Вашей базой данных Oracle. Имя |
|
пользователя требуется , если на Вашей базе есть |
|
возможность установить защиту данных. В этом случае |
|
обратитесь к системному администратору для получения |
|
имени. |
Password (PWD) |
Ваш пароль. Его тоже выдает системный администратор. |
ServerName (SRVR) |
Имя сервера Oracle. |
Здесь нет компоненты DSN. |
|
Пример строки соединения для доступа к серверу Oracle8i Spatial с использованием TCP/IP:
“SRVR=FATBOY;USR=SCOTT;PWD=TIGER”
Атрибуты SQLBase
В следующей таблице перечислены атрибуты, используемые СУБД SQLBase.
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для SQLBase. |
DB |
Database. Имя базы данных, к которой Вы хотите подключиться. |
Справочник MapBasic |
457 |
Функция Server_Connect( )
UID |
LogonID. Стандартный регистрационный идентификатор для подключения к |
|
СУБД SQLBase. Задание атрибута необходимо только при включенной сисL |
|
теме защиты в Вашей СУБД. В этом случае Вам необходимо получить |
|
регистрационный идентификатор у системного администратора. |
SRVR |
ServerName. Имя сервера, на котором размещены таблицы базы данных SQLL |
|
Base, к которым Вы хотите получить доступ. Укажите SRVR=LOCAL, если |
|
Вы используете локальный сервер. |
SRVRLIST |
Servers. Разделенный запятыми список серверов, объявляемых пользователю |
|
в диалоговом окне Logon. Задайте значение LOCAL для включения локальL |
|
ного сервера в список. |
PWD |
Password. Пароль (с различением регистра). |
CSS |
CursorCacheSize. Число курсоров, поддерживаемых курсорным кэшем. |
|
Курсорный кэш повышает эффективность, но использует ресурсы сервера |
|
данных. Начальное значение по умолчанию: 6. |
IMS |
InputMessageSize. Объем в байтах буфера входных сообщений. Увеличение |
|
объема буфера приводит к увеличению числа записей, передаваемых по сети |
|
за одну выборку. Начальное значение по умолчанию определяется сервером |
|
SQLBase. |
LTO |
LockTimeOut. Временной интервал в секундах, в течение которого SQLBase |
|
будет ожидать снятия блокировки перед генерацией сообщения об ошибке. |
|
Диапазон значений: от L1 до 1800; L1 означает ожидание до снятия |
|
блокировки. Начальное значение по умолчанию: 300. |
DIL |
DB2IsolationLevel. Уровень изоляции DB2, применяемый SQLHost; испольL |
|
зуется для SQLHostLподключений. Установите DIL=CS, если DB2 испольL |
|
зует уровень изоляции Cursor Stability, или DIL=RR (принимается по |
|
умолчанию), если DB2 использует уровень изоляции Repeatable Read. |
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, то |
|
библиотека ODBC не используется для этого соединения, дающего |
|
возможность вызывать первую, последнюю, предыдущую или произвольную |
|
запись в базе данных. |
Пример строки подключения для СУБД SQLBase:
”DSN=MI SQLBASE;SRVR=QESRVR;DB=PAYROLL;UID=JOHN;PWD=XYZZY”
ODBCLДрайвер для доступа к СУБД SQLBase именуется MIGUP07.DLL. Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2 маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
458 |
Справочник MapBasic |
Функция Server_Connect( )
Атрибуты SQL SERVER
В следующей таблице перечислены атрибуты, используемые СУБД SQL Server.
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для SQL Server. |
SRVR |
ServerName. Имя сервера, на котором размещены таблицы базы данных |
|
SQL Server, к которым Вы хотите получить доступ. |
DB |
Database. Имя базы данных, к которой Вы хотите подключиться. |
UID |
LogonID. Регистрационный идентификатор (с различением регистра для |
|
подключения к СУБД SQL Server. Задание атрибута необходимо только при |
|
включенной системе защиты в Вашей СУБД. В этом случае Вам необходимо |
|
получить регистрационный идентификатор у системного администратора. |
PWD |
Password. Пароль (с различением регистра). |
LANG |
Language. Национальный язык, используемый клиентом. Начальное |
|
значение по умолчанию – English. |
APP |
ApplicationName. Имя, используемое сервером SQL Server для идентификаL |
|
ции Вашего приложения. |
WKID |
WorkstationID. Идентификатор рабочей станции клиента. |
CSS |
CursorCacheSize. Число курсоров, поддерживаемых курсорным кэшем. |
|
Курсорный кэш повышает эффективность, но использует ресурсы сервера |
|
данных. Начальное значение по умолчанию: 1. |
YLD |
YieldProc. Значение, определяющее возможность работы в других WindowsL |
|
приложениях в случае занятости сервера SQL Server. Этот атрибут полезен |
|
для пользователей ODBCLприложений: |
|
YieldProc=0 (прочитывать и отсылать) инструктирует драйвер проверять |
|
очередь сообщений Windows и пересылать любые сообщения соответL |
|
ствующему WindowsLприложению. |
|
YieldProc=1 (никакой выдачи, начальное значение по умолчанию) не позвоL |
|
ляет Вам работать в других приложениях. |
|
YieldProc=3 (пересылка посредством WindowsLфункции Yield) передает (при |
|
необходимости) управление ядру Windows, которое проверяет очередь сообL |
|
щений и пересылает любые сообщения в соответствующие окна приложений. |
|
Рекомендуется значение YLD=1, так как указание других значений (0 или 3) |
|
не обеспечивает работу всех WindowsLприложений. |
CCCharConv. Значение, управляющее преобразованием таблиц кодировки симL волов между сервером SQL Server (версия 4.8 или более поздняя) и приложеL ниемLклиентом. Обычные значения: iso–1 (стандарт ISOL8859L1), cp850 для кодовой страницы 850, roman8 для символьного набора Roman8, и SJIS для Японии. Смотрите полный список значений в Вашей документации к СУБД SQL Server.
Справочник MapBasic |
459 |
Функция Server_Connect( )
CAN |
Cancel. Значение, задающее порядок отмены ранее исполненного оператора. |
|
Допустимые значения: |
|
Cancel=0 обеспечивает выборку всех оставшихся записей, если отмененным |
|
оператором был оператор Select. |
|
Cancel=1 задает отмену оператора посредством вызова процедуры dbcancel. |
|
Специфицируйте CAN=1, если процедура dbcancel поддерживается Вашей |
|
конфигурацией “клиентLсервер”. Начальное значение по умолчанию. |
|
Cancel=2 приводит к закрытию подключения к серверу для отменяемого |
|
оператора. Задайте значение CAN=2 только в том случае, если в Вашей конL |
|
фигурации не поддерживается dbcancel, а эффективность метода выборки |
|
оставшихся записей (CAN=0) неприемлема. |
GW |
Gateway. Значение, определяющее использование шлюза Sybase Net–GateL |
|
way для доступа к источнику данных через сервер данных DB2. При испольL |
|
зовании шлюза укажите Gateway=1; в противном случае укажите Gateway=0 |
|
(начальное значение по умолчанию). |
TPC |
TwoPhaseCommit. Этот атрибут позволяет Вам иметь два и более активных |
|
оператора в рамках транзакции, используя возможности двухфазной фиксаL |
|
ции сервера SQL Server. Задайте значение TPC=1 для использования этих |
|
возможностей; учтите, что несколько активных операторов могут |
|
заблокировать друг друга при ссылке на одну и ту же таблицу SQL Server. |
|
Начальное значение по умолчанию – TPC=0. |
NAPI |
Netapi. Значение, определяющее доступность динамической библиотеки |
|
NETAPI.DLL. Спецификация Netapi=0, принимаемая по умолчанию, указыL |
|
вает на недоступность библиотеки; Netapi=1, напротив, указывает на доступL |
|
ность NETAPI.DLL. Если Вы задали значение атрибута WKID |
|
(WorkstationID), атрибут NAPI игнорируется. |
MS |
ModifySQL. Этот атрибут предназначен для обеспечения совместимости с |
|
ранними версиями SQL Server. Спецификация ModifySQL=1, принимаемая |
|
по умолчанию, инструктирует драйвер модифицировать SQLLоператоры для |
|
обеспечения соответствия со спецификациями ODBC. Указание MS=0 |
|
позволяет драйверу интерпретировать диалекты SQL, используемые |
|
ранними версиями драйверов. |
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, то |
|
библиотека ODBC не используется для этого соединения, дающего |
|
возможность вызывать первую, последнюю, предыдущую или произвольную |
|
запись в базе данных. |
|
|
Пример строки подключения для СУБД SQL Server:
”DSN=MI SQLSERVER;DB=PAYROLL;UID=JOHN;PWD=XYZZY”
460 |
Справочник MapBasic |
Функция Server_Connect( )
ODBCLДрайвер для доступа к СУБД SQL SERVER именуется MISS07.DLL. Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2 маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
Атрибуты SYBASE System 10
В следующей таблице перечислены атрибуты, используемые СУБД SYBASE.
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для SYBASE. |
SRVR |
ServerName. Имя сервера, на котором размещены таблицы базы данных, к |
|
которым Вы хотите получить доступ. Начальное значение по умолчанию – |
|
имя сервера в переменной окружения DSQUERY. |
UID |
LogonID. Регистрационный идентификатор (с различением регистра) для |
|
подключения к Вашей СУБД SYBASE System 10. Задание атрибута необхоL |
|
димо только при включенной системе защиты в Вашей СУБД. В этом случае |
|
Вам необходимо получить регистрационный идентификатор у системного |
|
администратора. |
PWD |
Password. Пароль (с различением регистра). |
DB |
Database. Имя базы данных, к которой Вы хотите подключиться. |
LANG |
Language. Национальный язык, соответствующий подкаталогу в $SYBASE/ |
|
locales. |
CS |
Charset. Имя таблицы кодировки символов, соответствующее подкаталогу в |
|
$SYBASE/charsets. |
WKID |
WorkstationID. Идентификатор рабочей станции клиента. |
APP |
ApplicationName. Имя используемое сервером SYBASE System 10 для иденL |
|
тификации Вашего приложения. |
IFILE |
InterfacesFile. Маршрутное имя файла интерфейсов. |
AS |
ArraySize. Число записей, извлекаемых драйвером из базы данных для |
|
последующей выборки (но не число записей, передаваемых пользователю). |
|
Увеличивает эффективность работы вследствие снижения сетевого трафика. |
|
Начальное значение по умолчанию – AS=0. |
Справочник MapBasic |
461 |
Функция Server_Connect( )
YLD |
YieldProc. Значение, определяющее возможность работы в других WindowsL |
|
приложениях в случае занятости сервера SYBASE System 10. Этот атрибут |
|
полезен для пользователей ODBCLприложений: |
|
YieldProc=0 (прочитывать и отсылать) инструктирует драйвер проверять |
|
очередь сообщений Windows и пересылать любые сообщения соответL |
|
ствующему WindowsLприложению. |
|
YieldProc=1 (никакой выдачи, начальное значение по умолчанию) не позвоL |
|
ляет Вам работать в других приложениях. |
|
YieldProc=3 (пересылка посредством WindowsLфункции Yield) передает (при |
|
необходимости) управление ядру Windows, которое проверяет очередь сообL |
|
щений и пересылает любые сообщения в соответствующие окна приложений. |
|
Рекомендуется значение YLD=1, так как указание других значений (0 или 3) |
|
не обеспечивает работу всех WindowsLприложений. |
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, то |
|
библиотека ODBC не используется для этого соединения, дающего |
|
возможность вызывать первую, последнюю, предыдущую или произвольную |
|
запись в базе данных. |
Пример строки подключения для СУБД SYBASE:
”DSN=MI SYBASE;SRV=DSQUERY;USR=TONY;PWD=JAZZ”
ODBCLДрайвер для доступа к СУБД SYBASE именуется MISS07.DLL. Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2 маршрут к DLLLфайлу драйвера должен быть указан в переменной LIBPATH.
Атрибуты SQS
В следующей таблице перечислены атрибуты, используемые СУБД SQS:
Атрибут |
Описание |
DSN |
Имя ODBCLисточника данных для SQS. |
SRVR |
ServerName. Имя сервера, на котором размещены таблицы базы данных SQS, |
|
к которым Вы хотите получить доступ. Начальное значение по умолчанию – |
|
имя сервера в переменной окружения DSQUERY. |
UID |
LogonID. Регистрационный идентификатор (с различением регистра) для |
|
подключения к Вашей СУБД SQS. Задание атрибута необходимо только при |
|
включенной системе защиты в Вашей СУБД. В этом случае Вам необходимо |
|
получить регистрационный идентификатор у системного администратора. |
PWD |
Password. Пароль (с различением регистра). |
DB |
Database. Имя базы данных, к которой Вы хотите подключиться. |
462 Справочник MapBasic
|
Функция Server_Connect( ) |
|
|
LANG |
Language. Национальный язык, соответствующий подкаталогу в $SYBASE/ |
|
locales. |
CS |
Charset. Имя таблицы кодировки символов, соответствующее подкаталогу в |
|
$SYBASE/charsets. |
WKID |
WorkstationID. Идентификатор рабочей станции клиента. |
APP |
ApplicationName. Имя используемое сервером SQS для идентификации |
|
Вашего приложения. |
IFILE |
InterfacesFile. Маршрутное имя файла интерфейсов. |
AS |
ArraySize. Число записей, извлекаемых драйвером из базы данных для |
|
последующей выборки (но не число записей, передаваемых пользователю). |
|
Увеличивает эффективность работы вследствие снижения сетевого трафика. |
|
Начальное значение по умолчанию – 10. |
YLD |
YieldProc. Значение, определяющее возможность работы в других WindowsL |
|
приложениях в случае занятости сервера SQS. Этот атрибут полезен для |
|
пользователей ODBCLприложений: |
|
YieldProc=0 (прочитывать и отсылать) инструктирует драйвер проверять |
|
очередь сообщений Windows и пересылать любые сообщения соответL |
|
ствующему WindowsLприложению. |
|
YieldProc=1 (никакой выдачи, начальное значение по умолчанию) не позвоL |
|
ляет Вам работать в других приложениях. |
|
YieldProc=3 (пересылка посредством WindowsLфункции Yield) передает (при |
|
необходимости) управление ядру Windows, которое проверяет очередь сообL |
|
щений и пересылает любые сообщения в соответствующие окна приложений. |
|
Рекомендуется значение YLD=1, так как указание других значений (0 или 3) |
|
не обеспечивает работу всех WindowsLприложений. |
SCROLL |
По умолчанию присваивается значение YES. Если SCROLL=NO, то |
|
библиотека ODBC не используется для этого соединения, дающего |
|
возможность вызывать первую, последнюю, предыдущую или произвольную |
|
запись в базе данных. |
Пример строки подключения для СУБД SQS:
”DSN=MI SQS;SRV=DSQUERY;USR=TONY;PWD=JAZZ”
ODBCLДрайвер для доступа к СУБД SQS именуется MISS07.DLL.
Для операционной среды Windows этот DLLLфайл должен размещаться в Вашем текущем каталоге или в каталоге \WINDOWS\SYSTEM, либо маршрут к этому файлу должен быть указан в DOSLпеременной PATH. Для операционной системы OS/2 маршрут к DLLLфайлу должен быть указан в переменной LIBPATH.
Пример:
Dim hdbc As Integer
hdbc = Server_Connect(”QELIB”, ”DLG=1”)
Смотрите также:
Server Disconnect
Справочник MapBasic |
463 |