Замечания по выпуску

40.6 Глава 3. Using Advanced Features (Использование дополнительных возможностей)

|40.6.1 Writing Multi-Threaded Applications

|В конец раздела "Multi-Threaded Mixed Applications" (Создание многопоточных |программ) надо добавить:

|Прим.:
НЕ рекомендуется использовать размер стека по умолчанию; вместо этого |лучше увеличить размер по крайней мере до 256 000. При вызове функции |DB2 требуется размер стека минимум 256 000. Размер стека надо задать |так, чтоб он был достаточным и для вашей программы, и для вызова функции |DB2. |

40.6.2 Написание прикладной программы Unicode CLI DB2

Дальше приведен новый раздел для этой главы.

Существуют две основных области поддержки для прикладных программ Unicode CLI DB2:

  1. Добавление набора функций, который может принимать строчные аргументы Unicode вместо строчных аргументов ANSI.
  2. Добавление новых типов данных C и SQL для описания данных данных ANSI или Unicode. В следующих разделах приводится дополнительная информация для обеих этих областях. Чтобы программа считалась прикладной программой Unicode, перед выполнением соединения он должна задать для атрибута соединения SQL_ATTR_ANSI_APP значение SQL_AA_FALSE. Этим достигается то, что CLI будет связываться как клиент Unicode, а все данные Unicode будут посылаться либо в UTF-8 для данных CHAR, либо в UCS-2 для данных GRAPHIC.

40.6.2.1 Функции Unicode

Далее приводится список функций API ODBC, которые поддерживают версии как Unicode (W), так ANSI (A) (в Unicode в имени функции будет присутствовать W): 

SQLBrowseConnect        SQLForeignKeys          SQLPrimaryKeys
SQLColAttribute         SQLGetConnectAttr       SQLProcedureColumns
SQLColAttributes        SQLGetConnectOption     SQLProcedures
SQLColumnPrivileges     SQLGetCursorName        SQLSetConnectAttr
SQLColumns              SQLGetDescField         SQLSetConnectOption
SQLConnect              SQLGetDescRec           SQLSetCursorName
SQLDataSources          SQLGetDiagField         SQLSetDescField
SQLDescribeCol          SQLGetDiagRec           SQLSetStmtAttr
SQLDriverConnect        SQLGetInfo              SQLSpecialColumns
SQLDrivers              SQLGetStmtAttr          SQLStatistics
SQLError                SQLNativeSQL            SQLTablePrivileges
SQLExecDirect           SQLPrepare              SQLTables

Функции Unicode всегда возвращают или принимают аргументы длины строки в виде числа символов. Для функций, возвращающих информацию о длине для данных сервера, размер и точность вывода на экран описываются числом символов. Когда длина (размер передаваемых данных) может относиться и к строчным, и к другим данным, эта длина описывается в длинах октетов. Например, для SQLGetInfoW длина - это число байтов, а для SQLExecDirectW - число символов. CLI будет возвращать наборы результатов либо в Unicode, либо в ANSI, в зависимости от связывания прикладной программы. Если прикладная программа связывается с SQL_C_CHAR, драйвер будет преобразовывать данные SQL_WCHAR в SQL_CHAR. Менеджер драйверов отображает SQL_C_WCHAR в SQL_C_CHAR для драйверов ANSI, но не производит отображения для драйверов Unicode.

40.6.2.2 Новые типы данных и действительные преобразования

Есть два новых определенных типа данных CLI или ODBC, SQL_C_WCHAR и SQL_WCHAR. SQL_C_WCHAR указывает, что буфер C содержит данные UCS-2. SQL_WCHAR указывает, что маркер конкретного столбца или параметра содержит данные Unicode. Для серверов Unicode DB2 графические столбцы будут описываться как SQL_WCHAR. Преобразование будет разрешено между SQL_C_WCHAR и SQL_CHAR, SQL_VARCHAR, SQL_LONGVARCHAR и SQL_CLOB, а также между графическими типами данных.


Табл. 10. Поддерживаемые преобразования данных

Тип данных SQL
 S
Q
L
_
C
_
C
H
A
R
 S
Q
L
_
C
_
W
C
H
A
R
 S
Q
L
_
C
_
L
O
N
G
 S
Q
L
_
C
_
S
H
O
R
T
 S
Q
L
_
C
_
T
I
N
Y
I
N
T
 S
Q
L
_
C
_
F
L
O
A
T
 S
Q
L
_
C
_
D
O
U
B
L
E
 S
Q
L
_
C
_
T
Y
P
E
_
D
A
T
E
 S
Q
L
_
C
_
T
Y
P
E
_
T
I
M
E
 S
Q
L
_
C
_
T
Y
P
E
_
T
I
M
E
S
T
A
M
P
 S
Q
L
_
C
_
B
I
N
A
R
Y
 S
Q
L
_
C
_
B
I
T
 S
Q
L
_
C
_
D
B
C
H
A
R
 S
Q
L
_
C
_
C
L
O
B
_
L
O
C
A
T
O
R
 S
Q
L
_
C
_
B
L
O
B
_
L
O
C
A
T
O
R
 S
Q
L
_
C
_
D
B
C
L
O
B
_
L
O
C
A
T
O
R
 S
Q
L
_
C
_
B
I
G
I
N
T
 S
Q
L
_
C
_
N
U
M
E
R
I
C
BLOB
 X
 X









D




X
CHAR
D
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X




X
 X
CLOB
D
 X









X



X


DATE
X
 X






D


X






DBCLOB


X









X


D



X
DECIMAL
 D
 X
 X
 X
 X
 X
 X




X
 X




X
 X
DOUBLE
X
 X
 X
 X
 X
 X
 D





X




X
 X
FLOAT
X
 X
 X
 X
 X
 X
 D





X




X
 X
GRAPHIC
(Не Unicode)
 X
 X











D



GRAPHIC (Unicode)
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 D




X


INTEGER
X
 X
 D
 X
 X
 X
 X





X




X
 X
LONG
VARCHAR
 D
 X









X





LONG
VARGRAPHIC
(Не Unicode)
 X
 X









X


D



LONG
VARGRAPHIC
(Unicode)
 X
 X









X


D






NUMERIC
D
 X
 X
 X
 X
 X
 X





X




X
REAL
X
 X
 X
 X
 X
 D
 X





X




X
SMALLINT
 X
 X
 X
 D
 X
 X
 X





X




X
 X
BIGINT
 X
 X
 X
 X
 X
 X
 X




X
 X




D
 X
TIME
X
 X







D
 X






TIMESTAMP
X
 X






X
 X
 D






VARCHAR
D
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X




X
 X
VARGRAPHIC
(Не Unicode)
 X
 X











D



VARGRAPHIC
(Unicode)
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 X
 D




X


Прим.:

D
Преобразование поддерживается. Это - используемое по умолчанию преобразование для этого типа данных SQL.

X
Все СУБД IBM поддерживают это преобразование.

пробел
Никакие СУБД IBM не поддерживают это преобразование.

40.6.2.3 Устаревшее значение ключевого слова для исправления

До того, как стали поддерживаться прикладные программы Unicode, программы, написанные для работы с однобайтными символьными данными, можно было заставить работать с двухбайтными графическими данными при помощи нескольких последовательных ключевых слов файлов cli ini, таких как GRAPHIC=1,2 или 3, Patch2=7. Такой подход представляет графические данные как символьные и оказывает влияние на сообщаемую длину данных.

|Для прикладных программ Unicode такие ключевые слова теперь не |нужны, и не должны использоваться из-за потенциального риска побочных |эффектов. Если достоверно не известно, является ли конкретная |прикладная программа программой Unicode, советуем попробовать обойтись без |ключевых слов, влияющих на обработку графических данных.

40.6.2.4 Литералы в базах данных Unicode

В базах данных не Unicode нельзя сравнивать данные в столбцах LONG VARGRAPHIC и LONG VARCHAR. Столбцы GRAPHIC/VARGRAPHIC и CHAR/VARCHAR можно только сравнивать или назначать друг другу, явным образом используя функции преобразования типов, поскольку неявное преобразование кодовых страниц не поддерживается как таковое. Это относится к литералам GRAPHIC/VARGRAPHIC и CHAR/VARCHAR, когда литерал GRAPHIC/VARGRAPHIC отличается от литерала CHAR/VARCHAR при помощи префикса G.

В базах данных Unicode не требуется преобразование между литералами GRAPHIC/VARGRAPHIC и CHAR/VARCHAR. Кроме того, в них перед литералом GRAPHIC/VARGRAPHIC не требуется префикс G. Если, по крайней мере, один из аргументов является литералом, происходят неявные преобразования. Это позволяет применять литералы с префиксом G или без него в операторах, использующих либо SQLPrepareW(), либо SQLExecDirect(). При этом литералы для LONG VARGRAPHIC могут сохранять префикс G.

Дополнительную информацию смотрите в разделе "Casting Between Data Types" (Преобразование типов данных) Главы 3 "Language Elements" (Элементы языка) справочника SQL Reference.

40.6.2.5 Новые ключевые слова для конфигурации CLI

С целью устранения дополнительных издержек при связи прикладных программ Unicode с базой данных были добавлены следующие три ключевых слова.

  1. DisableUnicode

    Описание ключевого слова:
    Отключает базовую поддержку Unicode.

    Синтаксис ключевого слова db2cli.ini:
    DisableUnicode = 0 | 1

    Значение по умолчанию:
    0 (ложь)

    Вкладка Параметры CLI/ODBC DB2:
    Это ключевое слово нельзя задать через записную книжку Параметры CLI/ODBC. Для использования этого ключевого слова надо непосредственно изменить файл db2cli.ini.

    Замечания по использованию

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

    Задание значения True для этого ключевого слова значения приведет к преобразованию всех данных Unicode в локальную кодовую страницу прикладной программы перед их отправкой на сервер. Это может привести к потере любых данных, которые нельзя представить в локальной кодовой странице.

  2. ConnectCodepage

    Описание ключевого слова:
    Указывает конкретную кодовую страницу для использования при связи с источником данных для минимизации расходов соединения.

    Синтаксис ключевого слова db2cli.ini:
    ConnectCodepage = 0 | 1 <любая действительная кодовая страница db2>

    Значение по умолчанию:
    0

    Вкладка Параметры CLI/ODBC DB2:
    Это ключевое слово нельзя задать через записную книжку Параметры CLI/ODBC. Для использования этого ключевого слова надо непосредственно изменить файл db2cli.ini.

    Замечания по использованию

    Прикладные программы не Unicode всегда связываются с базой данных, используя локальную страницу прикладной программы или установку среды кодовой страницы DB2. По умолчанию CLI будет обеспечивать связь прикладных программ Unicode с базами данных Unicode с использованием кодовых страниц UTF-8 и UCS-2, а с базами данных не Unicode - с использованием кодовых страниц этих баз данных. Этим предотвращается необязательная потеря данных из-за преобразования кодовых страниц.

    Это ключевое слово позволяет пользователю указывать кодовую страницу базы данных при связывании с базой данных не Unicode, чтобы при этом соединении не было ненужных дополнительных затрат.

    Укажите значение 1, чтобы SQLDriverConnect() возвращало правильное значение в строке вывода соединения, чтобы использовать это значение при последующих вызовах SQLDriverConnect().

  3. UnicodeServer

    Описание ключевого слова:
    Указывает, что источником данных является сервер Unicode. Эквивалентно значению ConnectCodepage=1208.

    Синтаксис ключевого слова db2cli.ini:
    UnicodeServer = 0 | 1

    Значение по умолчанию:
    0

    Вкладка Параметры CLI/ODBC DB2:
    Это ключевое слово нельзя задать через записную книжку Параметры CLI/ODBC. Для использования этого ключевого слова надо непосредственно изменить файл db2cli.ini.

    Замечания по использованию

    Это ключевое слово эквивалентно ConnectCodepage=1208 и добавлено только для удобства. Установите это ключевое слово для предотвращения избыточных расходов на связь с DB2 for OS/390 Версии 7 или более поздней. Нет необходимости устанавливать это ключевое слово для баз данных DB2 for Windows, DB2 for Unix или DB2 for OS/2, поскольку при этом не требуется дополнительная обработка.

|40.6.3 Microsoft Transaction Server (MTS) как монитор транзакций

|Необходимо исправить значение по умолчанию для ключевого слова конфигурации |DISABLEMULTITHREAD в подразделе "Installation and Configuration" (Установка и |конфигурирование) : |

40.6.4 Scrollable Cursors (Указатели с возможностью прокрутки)

В раздел "Scrollable Cursors" (Указатели с возможностью прокрутки) надо добавить следующую информацию:

40.6.4.1 Поддержка указателей с возможностью прокрутки на стороне сервера для OS/390

Клиент UDB для платформ Unix, Windows и OS/2 при применении к базе данных OS/390 Версии 7 поддерживает указатели с возможностью изменения и прокрутки на стороне сервера. Для обращения к указателю OS/390 с возможностью прокрутки в трехуровневой среде на клиенте и на шлюзе должны работать с DB2 UDB Версии 7.1, FixPak 3 или новее.

Существует два программных интерфейса программ, обеспечивающих доступ к указателям с возможностью прокрутки: ODBC и JDBC. Интерфейс JDBC позволяет обращаться только к статическим указателям с прокруткой; интерфейс ODBC позволяет обращаться как к статическим, так и к управляемым клавиатурой указателям с прокруткой на стороне сервера.

Атрибуты указателя

В следующей таблице приведены значения по умолчанию атрибутов указателей OS/390 Версии 7 в ODBC.

Табл. 11. Атрибуты по умолчанию для указателей OS/390 в ODBC

Тип указателя Чувствительность указателя Возможность изменения указателя Одновременность указателя Возможность прокрутки указателя
только-впередa не задается без возможности изменения одновременность только для чтения без возможности прокрутки
статический нечувствительный без возможности изменения одновременность только для чтения с возможностью прокрутки
управляемый чувствительный с возможностью изменения одновременность значений с возможностью прокрутки

a Только-вперед - это поведение по умолчанию указателя с прокруткой без условия FOR UPDATE. Если для указателя только-вперед задать FOR UPDATE, будет создан указатель с возможностью изменения, одновременностью блокировок, без возможности прокрутки.


Поддерживаемые направления выборки

Все направления выборки ODBC поддерживаются с помощью интерфейсов SQLFetchScroll или SQLExtendedFetch.

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

Управляемый указатель - это указатель с возможностью изменения. Драйвер CLI добавляет условие FOR UPDATE к запросу, кроме случаев, когда запрос введен как запрос SELECT ... FOR READ ONLY или условие FOR UPDATE уже есть. Реализованный в DB2 для OS/390 управляемый указатель - это указатель одновременности значений. Указатель одновременности значений выражается в оптимистичной блокировке, то есть блокировка не производится, пока не будет предпринята попытка произвести изменение или удаление. При попытке произвести изменение или удаление сервер базы данных сравнивает предыдущие значения, извлеченные программой, с текущими значениями в основной таблице. Если эти значения совпадают - изменение или удаление успешно выполняется. Если значения не совпадают - операция завершается неудачно. Если происходит ошибка, программа должна опять запросить значения и, если нужно, повторить операцию изменения или удаления.

Программа может изменять управляемый указатель двумя способами:

Устранение неисправностей в программах, созданных до появления поддержки указателей с возможностью прокрутки

Так как поддержка указателей с возможностью прокрутки появилась недавно, у некоторых прикладных программ ODBC, работавших с предыдущими версиями UDB для OS/390 или UDB для Unix, Windows, и OS/2 может измениться поведение или производительность. Это происходит из-за того, что до появления поддержки указателей с прокруткой, программы, требовавшие такой указатель, получали указатель только-вперед. Чтобы восстановить поведение программы до появления поддержки указателей с прокруткой, задайте следующие ключевые слова конфигурации в файле db2cli.ini:

Табл. 12. Значения ключевых слов конфигурации, восстанавливающие поведение программ до появления поддержки указателей с возможностью прокрутки

Задание ключевого слова конфигурации Описание
PATCH2=6 Возвращает сообщение, что указатели с возможностью прокрутки (как управляемые, так и статические) не поддерживаются. CLI автоматически заменяет требование указателя с прокруткой на требование указателя только-вперед.
DisableKeysetCursor=1 Запрещает управляемые указатели с прокруткой с обеих сторон - сервера и клиента. Можно использовать, чтобы драйвер CLI предоставлял программе статический указатель, когда затребован управляемый указатель.
UseServerKeysetCursor=0 Запрещает управляемые указатели на стороне сервера для программ, использующих библиотеку управляемых указателей клиентской стороны, чтобы симулировать управляемый указатель. Используйте эту возможность, только если возникли проблемы с управляемым указателем на стороне сервера, так как указатель на стороне клиента приводит к значительным издержкам и обычно имеет худшую производительность, чем указатель на стороне сервера.

40.6.5 Using Compound SQL (Использование составного SQL)

В этой книге пропущен следующий комментарий: 

   Все операторы SQL, которые могут быть подготовлены динамически и не являются
   запросами, могут выполняться как операторы внутри составного оператора.
 
    Примечание: Внутри составного оператора Atomic Compound SQL не разрешены
    также операторы SQL savepoint, release savepoint и rollback to savepoint.
    И наоборот, оператор Atomic Compound SQL нельзя использовать в точке
    сохранения.

40.6.6 Использование хранимых процедур

40.6.6.1 Написание хранимой процедуры в CLI

Недокументированное ограничение на хранимые процедуры CLI: 

    Выполняя вызовы нескольких хранимых процедур CLI, прикладная программа
    должна закрыть открытые указатели, полученные от одной хранимой процедуры,
    перед вызовом другой хранимой процедуры. Это значит, что первый набор
    открытых указателей должен быть закрыт прежде, чем следующая хранимая
    процедура попытается открыть указатель.

40.6.6.2 Хранимые процедуры и автоматическое связывание CLI

Следующая информация дополняет приведенную в книге:

Драйвер CLI/ODBC в норме будет автоматически связывать пакеты CLI при первом выполнении прикладной программой CLI/ODBC SQL для базы данных при условии, что у пользователя есть надлежащие привилегия или авторизация. Автоматическое связывание пакетов CLI не может быть выполнено из хранимой процедуры и поэтому не произойдет, если самым первым действием прикладной программы будет вызов хранимой процедуры CLI. Перед запуском прикладной программы CLI, вызывающей хранимую процедуру CLI для новой базы данных DB2, необходимо один раз связать пакеты CLI при помощи следующей команды:

UNIX 
db2 bind <BNDPATH>/@db2cli.lst blocking all

Windows и OS/2 
db2bind "%DB2PATH%\bnd\@db2cli.lst" blocking

Во избежание автоматического связывания во время выполнения рекомендуется всегда связывать эти пакеты во время создания базы данных. Автоматическое связывание может закончиться неудачно, если у пользователя нет привилегии или если в это же самое время пытается автоматически связаться другая программа.

[ Начало страницы | Страница назад | Страница вперед | Содержание | Индекс ]