Firebird РУКОВОДСТВО РАЗРАБОТЧИКА БАЗ ДАННЫХ
Шрифт:
. ! .
Вы можете проверить этот оператор в isql. Откройте базу данных employee.fdb и запустите новую транзакцию следующим образом:
SQL> COMMIT;
SQL> SET TRANSACTION READ WRITE ISOLATION LEVEL SNAPSHOT TABLE STABILITY;
SQL> SELECT EMP_NO, FIRST_NAME, LAST_NAME
CON> FROM EMPLOYEE WHERE FIRST_NAME = 'Robert';
EMP NO FIRST NAME LAST NAME
==========================
2 Robert Nelson
SQL>
! ! !
СОВЕТ. Ключевые слова ISOLATION LEVEL являются необязательными, READ WRITE и WAIT являются значениями по умолчанию и могут быть опущены, если не требуются другие значения.
. ! .
Затем откройте другое окно командной строки и запустите isql или другой
SQL> COMMIT;
SQL> SET TRANSACTION READ WRITE NOWAIT SNAPSHOT;
Теперь через тот же интерфейс попытайтесь изменить любую строку в базе данных tmployee.fdb:
SQL> UPDATE EMPLOYEE SET FIRST_NAME = 'Dodger'
SQL> WHERE FIRST_NAME = 'Roger';
ISC ERROR CODE:335544345
lock coflict on no wait transaction (конфликт блокировки для транзакции, не являющейся ожидаемой)
Как и ожидалось, эта транзакция будет заблокирована для записи любой строки таблицы EMPLOYEE, потому что при выборе данных из той же таблицы первая транзакция запросила блокировку на уровень таблицы. Вторая тарнзакция имеет установку разрешения блокировки NOWAIT и немедленно выдает исключение, потому что не может выполнить изменение.
Следующий оператор также допустим:
SQL> COMMIT;
SQL> SET TRANSACTION;
Он запускает транзакцию, как и большинство операторов, с конфигурацией по умолчанию, что эквивалентно:
SQL> COMMIT;
SQL> SET TRANSACTION READ WRITE WAIT SNAPSHOT;
! ! !
ПРИМЕЧАНИЕ. Существует еще "транзакция по умолчанию", которая используется в клиентах ESQL для сконфигурированной единой транзакции, определенной на сервере и клиенте константой gds trans. Клиент ESQL стартует эту транзакцию автоматически, если он передает оператор запроса, а перед этим никакая транзакция явно не запускалась.
. ! .
API
Функция API, которая выполняет эквивалентную работу, называется isc_start_transaction [102]
Запуск каждой транзакции имеет три части:
1. Создание (при необходимости) и инициализация дескриптора транзакции.
2. Создание (при необходимости) и заполнение буфера параметров транзакции (Transaction Parameter Buffer, TPB) для хранения данных конфигурации. Это не обязательно.
102
Фактически существуют две различные функции для запуска транзакции: isc_start_ transaction используется в языках, которые поддерживают передачу переменного количества аргументов при вызове функций; isc_start_multiple используется в языках, требующих статический список аргументов. isc_start_transaction ограничивается одной транзакцией, которая может использовать до 16 баз данных, в то время как isc_start_multiple О запускает транзакции, обращающиеся к большему количеству баз данных или обращающиеся к переменному количеству баз данных, которое может превышать 16.
3. вызов isc_start_transaction.
При отсутствии необязательного TPB клиент запускает транзакцию точно так же, как и транзакцию по умолчанию, которая стартует при выдаче оператора SET TRANSACTION.
Каждый раз, когда вы собираетесь вызвать эту функцию, вы должны иметь переменную, длинный указатель - называемую дескриптором транзакции - уже объявленную в вашем приложении и инициализированную нулем [103] . Приложение должно иметь один дескриптор транзакции для каждой конкурирующей транзакции, вы также можете повторно использовать дескрипторы, заново проинициализировав их.
103
Тип isc_tr_handle является указателем void, определенным в заголовочном файле ibase.h, который расположен в каталоге /include в каталоге вашей инсталляции Firebird.
Дескриптор транзакции должен быть установлен в ноль при его инициализации до запуска транзакции. Транзакция завершится с ошибкой, если ей будет передан ненулевой дескриптор.
TPB является байтовым массивом (или вектором) констант, каждая из которых представляет параметр транзакции и начинается с префикса isc_tpb_. Первым параметром всегда является константа isc_tpb_version3, которая определяет версию структуры TPB [104] . Все последующие элементы массива являются константами, которые представляют эквивалентные SQL атрибуты транзакции.
104
Если в будущем структура TPB изменится, эта константа также будет изменена, так что сервер легко сможет обрабатывать клиентов, скомпилированных в друrой версии.
В табл. 27.1 показаны параметры транзакции SQL и эквивалентные им константы TPB.
Типичное объявление TPB в языке С выглядит следующим образом:
static char isc_tpb[] =
{
isc_tpb_version3,
isc_tpb_write,
isc_tpb_wait,
isc_read_committed,
isc_tpb_no_rec_version
};
Этот TPB по своему действию идентичен следующему:
SET TRANSACTION READ WRITE WAIT READ COMMITTED NO RECORD_VERSION;
Вы можете использовать один TPB для всех транзакций, которым требуются одинаковые характеристики. Хорошим решением также является использование отдельного TPB для каждой транзакции. Классы транзакций обычно создают экземпляр TPB при необходимости, каждый экземпляр хранит установки интерфейса времени проектирования или времени выполнения в виде свойств, допускающих чтение и запись (или, иначе, элементы данных).
В большинстве случаев вы можете распознать константу TPB по имени свойства (табл. 27.1). В стандартных драйверах DBC имена классов и их элементов больше всего диктуются требованиями стандарта и описывают атрибуты с большим соответствием задаваемой функциональности.
Таблица 27.1. Атрибуты транзакции и эквивалентные константы TPB
Тип атрибута | Атрибут SQL | Константа TPB |
Режим доступа | READ ONLY | isc_tpb_read |
READ WRITE | isc_tpb_write | |
Уровень изоляции | READ COMMITTED | isc_tpb_read committed |
SNAPSHOT | isc_tpb_concurrency | |
SNAPSHOT TABLE STABILITY | isc_tpb_consistency | |
Режим разрешения блокировок | WAIT | isc_tpb_wait |
NO WAIT | isc_tpb_nowait | |
Версия записи | RECORD_VERSION | isc_rec version |
NO RECORD_VERSION | isc_no_rec_version | |
Резервирование таблиц | SHARED | isc_tpb_shared |
PROTECTED | isc_tpb_protected | |
READ | isc_tpb_lock_read | |
WRITE | isc_tpb_lock_write | |
Нет эквивалента SQL | Отключает протокол автоотмены | isc_tpb_no auto undo |