Sybase

Взаимодействие с базами данных

🕛 01.11.2006, 13:59

Sybase connect

Подключение к серверу Sybase

int sybase_connect (string server-name, string username, string ' password [, string charset])

Возвращает дескриптор подключения к серверу Sybase или FALSE -при ошибке. Аргумент servername должен быть действительным именем, определенном в файле interfaces.

Если функция повторно вызывается с теми же аргументами, новое подключение не создастся, а возвращается идентификатор имеющегося.

Подключение к серверу закрывается при завершении сценария или ранее, если явно вызывается функция sybase_close().

См. также: sybase_pconnect(), sybase_close().

sybase_close

Закрытие подключения к Sybase

bool sybase_close (int link_identifier)

Возвращает TRUE или FALSE - при ошибке.

Идентификатор закрываемого подключения указывается в аргументе; если его не указывать, то закрывается последнее открытое данным сценарием подключение.

Фактически использование данной функции не является обязательным, так как РНР автоматически закрывает все незакрытые неустойчивые подключения при завершении сценария. Заметьте: устойчивые подключения, созданные функцией sybase_pconnect(), не закрываются.

См. также: sybase_connect(), sybase_pconnect().

sybase_pconnect

Создание устойчивого подключения к серверу Sybase

int sybase_pconnect (string servername, string username, string password [, string charset])

Возвращает дескриптор устойчивого подключения или FALSE - при ошибке. sybase_pconnect() действует подобно sybase_connect() с двумя отличиями.

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

При завершении сценария подключение не закрывается, а остается действительным для дальнейшего использования. (Функция sybase_ close() не может закрыть подключения, созданные с помощью sybase_ pconnect().)

sybase_select_db

Выбор БД Sybase

bool sybase_se!ect_db (string databasejiame, int link_identifier) Возвращает TRUE или FALSE - при ошибке.

Устанавливает БД с именем database_name в качестве активной для текущего подключения или указанного в link_identifier. Если подключений не имеется, то косвенно вызывается функция sybase_connect() с параметрами по умолчанию.

Последующие запросы, выполняемые функцией, будут адресованы данной БД.

См. также: sybase_connect(), sybase_pconnect() и sybase_query()

sybase_query

Выполнение запроса к БД Sybase

int sybase_query (string query, int link_identifier)

Посылает запрос текущей БД, активной для текущего (последнего открытого) подключения или указанного в link_identifier. Если подключений не имеется, то косвенно вызывается функция sybase_ connect() с параметрами по умолчанию.

Возвращает дескриптор набора возвращенных записей или FALSE -при ошибке.

См. также: sybase_select_db() и sybase_connect().

sybase_affected_rows

Получение числа измененных последним запросом записей int sybase_affected_rows ([int link_identifier]}

Возвращается число записей, измененных в результате выполнения запросом DELETE, INSERT, REPLACE или UPDATE.

Если последним запросом была команда DELETE без ограничения WHERE, то из таблицы будут удалены все записи, но эта функция возвратит 0.

Чтобы выяснить, сколько записей было возвращено командой SELECT, используйте функцию sybase_num_rows().

Функция доступна только при использовании библиотеки интерфейса СТ Sybase, но не D В Sybase.

Sybase_num_rows

Получение числа записей, возвращенных запросом

int sybase_num_rows (int result)

См. также: sybase_query() и sybase_fetch_row().

sybase_num_fields

Получение числа полей в наборе записей

int sybase_num_fields (int result)

См. также: sybase_query(), sybase_fetch_field(), sybase_num_rows().

sybase_data_seek

Перемещение внутреннего указателя записи

bool sybase_data_seek (int result_identifier. int row_number)

При каждом вызове функции sybase_fetch row() (или подобной) внутренний курсор записи смещается на следующую запись. Данная функция позволяет свободно перемещать курсор в наборе записей res ul t_ identifier так, чтобы он указывал на запись с номером row_number (нумерация начинается с 0) при следующем вызове sybase_fetch_rov*().

Она возвращает TRUE или FALSE - при ошибке.

Sybase_result

Получение определенного элемента набора записей

string sybase_result (int result, int row, mixed field)

Возвращает содержимое ячейки из набора записей resul t. В аргументе row указывается номер записи (нумерация начинается с 0), в аргументе field можно указать индекс поля (число), имя поля, полное имя поля (вида: имя_таблицы.имя_поля) или псевдоним поля (для запросов типа 'SELECT foo AS bar FROM...).

При работе с большими наборами записей быстрее выполняются функции типа _fetch_ (см. ниже). Также заметьте, что численные индексы обрабатываются быстрее строковых.

Не следует вызывать функцию mysql_result() в сочетании с другими функциями обработки набора записей.

Рекомендуется использовать альтернативные функции: sybase_fetch_ row(), sybase_fetch_array() и sybase_fetch_object().

sybase_fetch_row

Занесение записи в нумерованный массив

array sybase_fetch_row (int result)

Возвращает массив, соответствующий текущей записи, из набора записей result, возвращенных запросом (последующий вызов функции возвращает следующую запись), или FALSE, если записей более не имеется. Каждое поле записи сохраняется в нумерованном элементе массива (нумерация начинается с 0).

См. также: sybase_fetch_array(), sybase_fetch_object(), sybase_data_seek(), sybase_result().

sybase_fetch_array

Занесение записи в массив

array sybase_fetch_array (int result)

Возвращает массив, соответствующий текущей записи, из набора записей result, возвращенных запросом, или FALSE, если записей более не имеется (при этом курсор записи перемещается на следующую).

Данная функция является расширением функции sybase_fetch_row(), и она возвращает объединенный нумерование-ассоциативный массив. Доступ к элементам массива может осуществляться как через имена полей, так и по их номеру.

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

См. также sybase_fetch_row().

sybase_fetch_object

Получение записи в свойствах объекта

int sybase_fetch_object (int result)

Возвращает объект, в свойствах которого находятся поля текущей записи, или FALSE, если записей более не имеется.

По скорости выполнения (и функциональности) функция идентична sybase_fetch_array() и почти идентична sybase_fetch_row().

См. также: sybase_fetch_array() и sybase_fetch_row().

sybase_free_result

Уничтожение набора записей

bool sybase_free_result (int result)

Функция освобождает память, занимаемую набором записей result, возвращенным запросом. Ее следует использовать только в том случае, если требуется экономить память, так как память автоматически освобождается при завершении сценария.

sybase_fetch_field

Получение информации о поле записи в свойствах объекта

object sybase_fetch_field (int result [, int field_offset])

Если номер поля field_offset не указан, при каждом вызове функции возвращаются свойства следующего поля из набора записей resul t.

Возвращаемый объект имеет следующие свойства (и содержит информацию):

name - имя поля. Если поле - результат выполнения функции, имя возвращается в виде computed#N, где #М - порядковый номер;
column_source - имя таблицы, которой принадлежит поле;
numeric - 1, если поле числовое;
type - тип поля.
См. также sybase_field_seek().

sybase_field_seek

Перемещение к указанному полю

int sybase_field_seek (int result, int field_offset)

Перемещается к указанному числом field_offset нолю. И если при следующем вызове sybase_fetch_field () не указывается номер поля, будет возвращено это поле.

См. также sybase_fetch_field().

sybase_get_last_message

Получение последнего сообщения сервера string sybase_getjast_message (void)

sybase_min_client_severity

Установка минимального уровня требовательности клиента

void sybasejnin_client_severity (int severity)

Функция доступна только при использовании библиотеки интерфейса СТ Sybase, но не DB Sybase.

См. также sybase_min_server_severity().

sybase_min_server_severity

Установка минимального уровня требовательности сервера

void sybase_min_server_severity (int severity)

Функция доступна только при использовании библиотеки интерфейса СТ Sybase, но не DB Sybase.

См. также sybaseji)in_client_severity().

sybase_min_message_severity

Установка минимального уровня возвращаемых сообщений

void sybase_min_message_severity (int severity)

См. также sybase_min_error_seventy().

sybase_min_error_severity

Установка минимального уровня сообщаемых ошибок

void sybase_min_error_severity (int severity)

См. также sybase_rain_message_severity().