Command Reference

Разъяснение о параметре команды db2licm - инструмента управления лицензиями

Это исправление документации относится к параметру -p команды db2licm. |Ключевое слово MEASURED более недопустимо; оно игнорируется DB2.

Пример команды RESTORE DATABASE для TSM

В примере для TSM (пример 6) пропущены одинарные кавычки у опций TSM; этот пример следует читать так:

|
• Задание строки с ограничителями:

db2 restore db sample use TSM options "'-fromnode bar -fromowner dmcinnis'"

Примеры использования db2demigdbd

Ниже приведены примеры использования db2demigdbd, сгруппированные по операционным системам.

Чтобы выполнить обратную перенастройку файлов системного каталога баз данных в UNIX и Linux:

 db2demigdbd $HOME/sqllib 1 

Чтобы выполнить обратную перенастройку файлов локального системного каталога баз данных в UNIX и Linux: |

 db2demigdbd  ~/user/NODE0000  1 

Чтобы выполнить обратную перенастройку системы и всех файлов локального каталога баз данных в экземпляре в UNIX и Linux:

 db2demigdbd  $HOME/sqllib  2 

Чтобы выполнить обратную перенастройку файлов системного каталога баз данных в Windows:

 db2demigdbd  d:\sqllib\db2  1 

где db2 - текущий экземпляр.

Чтобы выполнить обратную перенастройку файлов локального системного каталога баз данных в Windows: |

 db2demigdbd  d:\db2\NODE0000  1 

Чтобы выполнить обратную перенастройку системы и всех файлов локального каталога баз данных в экземпляре в Windows:

 db2demigdbd  d:\sqllib\db2 2 

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

Если вы запустили команду db2updv8 для обновления системных каталогов |до текущего уровня Версии 8 возврат к Версии 8.1 не поддерживается.

Дополнительная информация:

Пример использования команды в середе DPF (Database Partitioning |Feature - возможность разделения данных) смотрите в техническом замечании по адресу http://www.ibm.com/support/docview.wss?rs=71&uid=swg21217949

Исправление замечания об использовании команды db2ckbkp

Опция '-p' выводит число страниц для каждого типа объектов. Однако если резервная копия была сделана для данных из табличных пространств |DMS, команда db2ckbkp с опцией '-p' не выводит число |страниц для всех различных типов объектов. В этом случае выводится только общее число всех страниц (SQLUDMSTABLESPACEDATA). |Для табличных пространств DMS выводятся нулевые значения |SQLUDMSLOBDATA и SQLUDMSLONGDATA.

Пример отрывка вывода команды db2ckbkp -p с резервной |копией, сделанной для данных из табличных пространств DMS:

      SQLUDMSTABLESPACEDATA (0c):  87 
|      SQLUDMSLOBDATA (0e):          0 
|      SQLUDMSLONGDATA (0f):         0                              

Соглашения об именах для объектов баз данных и для ID

Для имен объектов менеджера баз данных, например, баз данных и таблиц, применяются следующие соглашения.

|
• Символьные строки, представляющие имена объектов менеджера баз данных, |могут содержать любые из следующих символов: a-z, A-Z, 0-9, @, # и $.
|
• Если не указано иное, можно вводить имена в нижнем регистре, однако менеджер |баз данных будет обрабатывать их как набранные в верхнем регистре. |

  Исключение из этого соглашения - символьные строки, представляющие имена в SNA (Systems Network Architecture). Многие значения регистрозависимы, например, имена логических устройств (partner_lu и local_lu). Имя должно вводиться точно так же, как оно выглядит в определениях SNA, соответствующих этим терминам.

|
• Имя или алиас базы данных - уникальная символьная строка, содержащая от |одной до восьми букв, цифр или символов из указанного выше набора. |

  Базы данных каталогизируются в системе и в локальных каталогах баз данных с |указанием их алиасов в одном поле и фактических имен в другом. Для большинства функций менеджер баз данных использует имя, введенное в поле алиаса в каталогах баз данных. Исключения - CHANGE DATABASE COMMENT и CREATE DATABASE, где надо указать путь к каталогу.

|
• Имя или алиас таблицы или производной таблицы - идентификатор SQL, который должен быть уникальной символьной строкой длиной от 1 до 128 символов. Длина имен столбцов - от 1 до 30 символов. |

  Полное имя таблицы имеет вид схема.имя_таблицы. Схема - это уникальный ID пользователя, под которым создана таблица. Для объявленной временной таблицы надо использовать имя схемы SESSION.

|
• Длина локальных алиасов для удаленных узлов, каталогизируемых в каталоге узлов, не должна превышать 8 символов.
|
• Первый символ в строке должен быть буквой или одним из символов @, |# или $, но не цифрой; строка не может начинаться с |последовательностей символов SYS, DBM или IBM.

Для имен ID пользователей и ID аутентификации применяются следующие соглашения.

|
• Символьные строки, представляющие имена объектов менеджера баз данных, |могут содержать любые из следующих символов: a-z, A-Z, 0-9, @, # и $.
|
• Кроме того, ID пользователей и групп могут содержать любые из |следующих символов, если это поддерживается подключаемым модулем защиты: |_, !, %, (, ), {, }, -, ., ^.
|
• При вводе в командной строке ID пользователей и групп, содержащие |следующие символы, надо указывать в кавычках: !, %, (, |), {, }, -, ., ^.
|
• Первый символ в строке должен быть буквой или одним из символов @, |# или $, но не цифрой; строка не может начинаться с |последовательностей символов SYS, DBM или IBM.
|
• Длина ID аутентификации не должна превышать 30 символов в 32-битные операционные системы Windows и 8 |символов в других операционных системах.
|
• Длина ID групп не должна превышать 30 символов.

Команда REORGCHK

Формулы статистики индекса, используемые в команде REORGCHK, были исправлены. Ниже приводятся новые формулы и объяснения к ним:

• Формула F5:

  100 * (KEYS * (ISIZE + LEAF_REC_OVERHEAD) + (CARD - KEYS) 
              * DUPKEYSIZE ) 
      / ((NLEAF - NUM EMPTY LEAFS - 1) * 
         (INDEXPAGESIZE - 96) > MIN(50, (100 - PCTFREE))

  где LEAF_REC_OVERHEAD = 9, а DUPKEYSIZE = 5.

  Если свободное пространство в индексе превышает 50 процентов (или превышает значение PCTFREE%, если PCTFREE больше 50), рекомендуется реорганизация. Эта формула проверяется, только если значение NLEAF - NUM EMPTY LEAFS - 1 больше нуля. (Из значения NLEAF вычитается единица, поскольку конечная выделенная страница обычно не заполнена.)

• Формула F6:

  (100 - PCTFREE) * 
       [ Floor((100 - min(10, PCTFREE)) / 100 * (INDEXPAGESIZE - 96) 
               / (ISIZE + NONLEAF_REC_OVERHEAD)) ** (NLEVELS - 2)] 
       * (INDEXPAGESIZE - 96) / 
         (KEYS * (ISIZE + LEAF_REC_OVERHEAD) 
               + (CARD - KEYS) * DUPKEYSIZE) < 100

  где NONLEAF_REC_OVERHEAD = 12.

  Позволяет определить, даст ли повторное создание индекса дерево с меньшим числом уровней. Эта формула проверяет отношение между объемом пространства в дереве индекса с числом уровней на единицу меньше, чем у текущего дерева индекса, и необходимым объемом пространства. Если удается создать дерево с меньшим на единицу числом уровней и оставить при этом доступное PCTFREE, рекомендуется реорганизация. Фактическое число записей индекса должно превышать 90% (или 100 - PCTFREE) от числа записей, которые может обработать дерево индекса NLEVELS - 1 (проверяется, только если NLEVELS > 1).

Команда REORG INDEXES/TABLE

Реорганизует индекс или таблицу.

Опция REORG INDEXES ALL FOR TABLE имя-таблицы реорганизует все определенные на таблице индексы при помощи перестройки данных индексов в нефрагментированные, физически непрерывные страницы. Если задана опция CLEANUP ONLY, выполняется очистка без перестройки индексов. При попытке применить эту команду для индексов на объявленных временных таблицах будет возвращена ошибка SQLSTATE 42995.

Опция REORG TABLE имя-таблицы реорганизует таблицу; она перестраивает строки, устраняя фрагментированные данные, и сжимает информацию. Реорганизация таблицы выполняется одним из двух методов:

Классическая реорганизация

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

Реорганизация на месте

К данным разрешен доступ на протяжении всей реорганизации, но без гарантии оптимального упорядочивания данных. Реорганизация таблицы на месте может выполняться только для таблицы с индексами типа 2 и без расширенных индексов.

При выборе любого из типов реорганизации после реорганизации таблицы выполняется обновление индексов для этой таблицы. Однако в методе реорганизации на месте индекс будет реорганизован не оптимально, и позже может потребоваться реорганизовать индексы для снижения их фрагментации и освобождения пространства объектов индекса.

   db2 reorg table employee index empid allow no access indexscan 
      longlobdata

Команда BACKUP DATABASE

Перенастройка баз данных

db2inidb - команда инициализации зеркальной копии базы данных

Не используйте команду db2 connect to база_данных, пока не выполните команду db2inidb база_данных as mirror.

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

Соединение переводит базу данных назад в то состояние, в котором она была при приостановке этой базы данных. Если база данных помечена как согласованная в момент приостановки, DB2 Universal Database делает вывод, что восстановление после сбоя для нее не требуется и очищает журналы для будущего использования. В этом случае попытка повтора транзакций вызывает ошибку SQL4970.

Замечание об использовании команды db2iupdt

Начиная с Версии 8.2, при обновлении экземпляра DB2 Universal Database при помощи команды db2iupdt необходимо сначала остановить все выполняемые в этом экземпляре процессы DB2.

Новый параметр команды db2sqljcustomize

У команды db2sqljcustomize появился новый параметр.

Новый параметр команды sqlj

У команды sqlj появился новый параметр.

Изменения в команде мониторинга и устранения неисправностей (db2pd)

Команда мониторинга и устранения неисправностей DB2 (db2pd) получает информацию из наборов памяти DB2 UDB. В системную команду db2pd внесены следующие усовершенствования:

Новый параметр -hadr

Введенный в Версии 8.2 (эквивалентной Версии 8.1 FixPak 7) параметр -hadr выводит информацию о HADR (High Availability Disaster Recovery, высокая доступность - восстановление после аварий). Описания всех элементов отчета есть в справочнике System Monitor Guide and Reference в разделе о высокой доступности и восстановлении после аварий.

Новый параметр -utilities

Введенный в Версии 8.2 (эквивалентной Версии 8.1 FixPak 7) параметр -utilities выводит информацию об утилитах. Описания всех элементов отчета есть в справочнике System Monitor Guide and Reference в разделе утилит.

Новый параметр -activestatements

Введенный в Версии 8.2.2 (эквивалентной Версии 8.1 FixPak 9) параметр -activestatements возвращает информацию об активных операторах. Возвращается следующая информация:

AppHandl

Хэндл прикладной программы, использующей активный оператор (включая узел и индекс).

UOW-ID

Идентификатор единицы работы для прикладной программы, связанной с AppHandl, в которой стал активным оператор.

StmtID

Идентификатор оператора в единице работы.

AnchID

Идентификатор для хэш-привязки динамического SQL кэша пакетов.

StmtUID

Уникальный идентификатор для динамического SQL кэша пакетов в хэш-привязке.

EffISO

Действующий уровень изоляции оператора.

EffLockTOut

Действующее значение срока ожидания для оператора.

EffDegree

Действующая степень параллелизма оператора.

StartTime

Время начала выполнения оператора.

LastRefTime

Время последнего использования оператора в прикладной программе.

Новая опция wait для параметра -locks

Начиная с Версии 8.2.2 (эквивалентной Версии 8.1 FixPak 9), можно задать для параметра -locks опцию wait, чтобы вернуть только информацию о блокировках в состоянии ожидания и блокировках, которых ожидают программы.

Параметр -applications возвращает новые поля

Начиная с Версии 8.2.2 (эквивалентной Версии 8.1 FixPak 9), параметр -applications возвращает четыре новых поля:

C-AnchID

Это новое поле содержит идентификатор для хэш-привязки динамического SQL кэша пакетов для текущего оператора. Если текущего оператора нет, значение этого поля равно 0. Текущий идентификатор хэш-привязки содержит ненулевое значение, только когда прикладная программа выполняет требование оператора, например, требование FETCH для указателя. Когда выполнение требования завершено, идентификатору присваивается значение 0. Для статических операторов SQL идентификатору также присваивается значение 0.

C-StmtUID

Это новое поле содержит уникальный идентификатор для динамического SQL кэша пакетов в хэш-привязке для текущего оператора. Если текущего оператора нет, значение этого поля равно 0. Текущий уникальный идентификатор оператора содержит ненулевое значение, только когда прикладная программа выполняет требование оператора. Когда выполнение требования завершено, идентификатору присваивается значение 0. Для статических операторов SQL идентификатору также присваивается значение 0.

L-AnchID

Это новое поле содержит идентификатор хэш-привязки динамического SQL кэша пакетов для последнего выполненного оператора прикладной программы. Если последнего выполненного оператора нет (например, перед выполнением динамических операторов SQL), значение этого поля равно 0. Для статических операторов SQL идентификатору также присваивается значение 0. Значение присваивается идентификатору последней хэш-привязки после завершения выполнения каждого требования; это значение сохраняется до завершения выполнения следующего требования.

L-StmtUID

Это новое поле содержит уникальный идентификатор для динамического SQL кэша пакетов в хэш-привязке для последнего выполненного оператора прикладной программы. Если последнего выполненного оператора нет или если последний выполнявшийся оператор был статическим оператором SQL, значение этого поля равно 0. Значение присваивается идентификатору последнего оператора после завершения выполнения текущего требования; это значение сохраняется до завершения выполнения следующего требования.

Изменение в команде SET CLIENT

Команда SET CLIENT задает параметры соединения для внутреннего процесса.

Параметр SYNCPOINT этой команды в Версии 8 игнорируется. Параметр SYNCPOINT оставлен только для обратной совместимости.

Изменение в команде PRECOMPILE

Команда PRECOMPILE обрабатывает исходный файл прикладной программы, содержащий встроенные операторы SQL. Генерируется модифицированный исходный файл, содержащий вызовы языка хоста для этих операторов SQL, и, по умолчанию, в базе данных создается пакет.

Параметр SYNCPOINT этой команды в Версии 8 игнорируется. Параметр SYNCPOINT оставлен только для обратной совместимости.

Изменение в команде UPDATE HISTORY FILE

Изменяет положение, тип устройства или комментарий в записи файла хронологии.

Параметр STATUS этой команды задает новое состояние для записи.

Предыдущая версия документации содержит неверное утверждение, что параметр STATUS команды может принимать значение "I", при котором запись отмечается как неактивная. Допустимые значения:

A

Отмечает запись как активную.

E

Отмечает запись как устаревшую.

Изменения в командах EXPORT и IMPORT

Весь подраздел "Требуемое соединение" для команд EXPORT и IMPORT должен выглядеть так:

Изменение в команде LOAD

Полная информация о значении AUTOSELECT параметра INDEXING MODE должна выглядеть так:

Модификаторы типов файлов для утилиты загрузки

Изменена команда SET INTEGRITY в описании модификатора "generatedoverride".

Описание модификатора "usedefaults" также изменено.

Внесены следующие изменения:

SET INTEGRITY FOR < имя-таблицы > GENERATED COLUMN 
  IMMEDIATE UNCHECKED

SET INTEGRITY FOR < имя-таблицы > IMMEDIATE CHECKED.

Модификаторы типов файлов для утилиты импорта

Описание модификаторов "usedefaults" и "codepage=x" изменено следующим образом:

Команда ATTACH

Параметр USER команды ATTACH задает идентификатор аутентификации. При подключении к экземпляру DB2 Universal Database в операционной системе Windows имя пользователя можно задать в формате, совместимом с Microsoft Windows NT Security Account Manager (SAM). Спецификатор должен быть именем в стиле NetBIOS, с максимальной длиной 15 символов. Например, domainname\username.

Команда RECOVER DATABASE

В разделе примеров документации по команде RECOVER DATABASE для Версии 8.2 приведен неверный формат отметки времени гггг:мм:дд:чч:мм:сс.

Правильный формат - гггг-мм-дд-чч.мм.сс

Команда UPDATE HISTORY FILE

>>-UPDATE HISTORY--+-FOR--часть-объекта-+--WITH----------------->
                   '-EID--eid-----------'
 
>--+-LOCATION--новое-положение--DEVICE TYPE--новый-тип-устройства-+-><
   +-COMMENT--новый-комментарий-----------------------------------+
   '-STATUS--новое-состояние--------------------------------------'
 

db2updv8 - Команда обновления базы данных до текущего уровня версии 8

Эта команда обновляет системные каталоги в базе данных для поддержки текущего уровня:

|
• Вносит информацию о новых подпрограммах, поставляемых с текущим менеджером баз данных
|
• Каталогизирует процедуры схемы ODBC/CLI/JDBC как доверенные процедуры, чтобы повысить |производительность и масштабируемость
|
• Исправляет две опечатки в возвращаемых параметрах табличной функции |SYSPROC.SNAPSHOT_QUIESCERS: |
  |
  • OUIESCER_TBS_ID исправлено на QUIESCER_TBS_ID
  |
  • OUIESCER_STATE исправлено на QUIESCER_STATE
|
• Исправляет дескрипторы столбцов больших объектов, чтобы |бит "logged" был согласован с таблицами каталогов
|
• Создает производную таблицу SYSIBM.SYSREVTYPEMAPPINGS
|
• Обновляет определения производных таблиц SYSSTAT.COLUMNS и SYSSTAT.TABLES
|
• Делает изменяемым столбец SYSCOLDIST.DISTCOUNT
|
• Сбрасывает флаги столбца SYSINDEXES.TBSPACEID
|
• Исправляет длины параметров 17 табличных функций. Полный список функций смотрите в |теме Column expansion for snapshot UDFs в разделе |Documentation updates | SQL Administrative Routines |Замечаний по выпуску Версии 8.2
|
• Включает следующие встроенные подпрограммы: |
  |
  • HEALTH_DBM_INFO
  |
  • HEALTH_DBM_HI
  |
  • HEALTH_DBM_HI_HIS
  |
  • HEALTH_DB_INFO
  |
  • HEALTH_DB_HI
  |
  • HEALTH_DB_HI_HIS
  |
  • HEALTH_TBS_INFO
  |
  • HEALTH_TBS_HI
  |
  • HEALTH_TBS_HI_HIS
  |
  • HEALTH_CONT_INFO
  |
  • HEALTH_CONT_HI
  |
  • HEALTH_CONT_HI_HIS
  |
  • GET_WRAP_CFG_C
  |
  • LIST_FILES_C
  |
  • ODBC_DISCOVERY
  |
  • HEALTH_HI_REC
  |
  • EXEC_DB2_SCRIPT
  |
  • HEALTH_HI_REC
  |
  • EXEC_DB2_SCRIPT
  |
  • ADMIN_LIST_HIST
  |
  • GET_DBM_CONFIG
|
• Заменяет 33 пользовательские функции снимка SYSPROC на THREADSAFE: |
  |
  • SNAPSHOT_DBM
  |
  • SNAPSHOT_FCM
  |
  • SNAPSHOT_FCMNODE
  |
  • SNAPSHOT_SWITCHES
  |
  • SNAPSHOT_APPL_INFO
  |
  • SNAPSHOT_APPL
  |
  • SNAPSHOT_STATEMENT
  |
  • SNAPSHOT_LOCKWAIT
  |
  • SNAPSHOT_AGENT
  |
  • SNAPSHOT_SUBSECT
  |
  • SNAPSHOT_DATABASE
  |
  • SNAPSHOT_BP
  |
  • SNAPSHOT_LOCK
  |
  • SNAPSHOT_TABLE
  |
  • SNAPSHOT_DYN_SQL
  |
  • SNAPSHOT_TBS
  |
  • SNAPSHOT_TBS_CFG
  |
  • SNAPSHOT_QUIESCERS
  |
  • SNAPSHOT_CONTAINER
  |
  • SNAPSHOT_RANGES
  |
  • SNAPSHOT_TBREORG
  |
  • HEALTH_DBM_INFO
  |
  • HEALTH_DBM_HI
  |
  • HEALTH_DBM_HI_HIS
  |
  • HEALTH_DB_INFO
  |
  • HEALTH_DB_HI
  |
  • HEALTH_DB_HI_HIS
  |
  • HEALTH_TBS_INFO
  |
  • HEALTH_TBS_HI
  |
  • HEALTH_TBS_HI_HIS
  |
  • HEALTH_CONT_INFO
  |
  • HEALTH_CONT_HI
  |
  • HEALTH_CONT_HI_HIS
|
• Изменяет длины параметров следующих функций: |
  |
  • SQLCACHE_SNAPSHOT
  |
  • SNAPSHOT_APPL_INFO
  |
  • SNAPSHOT_STATEMENT
  |
  • SNAPSHOT_LOCKWAIT
  |
  • SNAPSHOT_DATABASE
  |
  • SNAPSHOT_BP
  |
  • SNAPSHOT_LOCK
  |
  • SNAPSHOT_TABLE
  |
  • SNAPSHOT_TBREORG
  |
  • SNAPSHOT_SUBSECT
  |
  • SNAPSHOT_DYN_SQL
  |
  • HEALTH_DBM_INFO
  |
  • HEALTH_DBM_HI
  |
  • HEALTH_DBM_HI_HIS
  |
  • HEALTH_DB_INFO
  |
  • HEALTH_DB_HI
  |
  • HEALTH_DB_HI_HIS
  |
  • DB_PARTITIONS
  |
  • GROUPS_FOR_USER
  |
  • DB_PARTITION
|
• Изменяет следующие функции так, что в них используется схема |db2schema вместо прежней |db2schem и позволяет им изменять данные SQL: |
  |
  • SQLTABLES
  |
  • SQLTABLEPRIVILEGES
  |
  • SQLSTATISTICS
  |
  • SQLSPECIALCOLUMNS
  |
  • SQLPROCEDURES
  |
  • SQLPROCEDURECOLS
  |
  • SQLPRIMARYKEYS
  |
  • SQLFOREIGNKEYS
  |
  • SQLCOLUMNS
  |
  • SQLCOLPRIVILEGES
|
• Изменяет следующие функции так, что в них используется схема |db2schema вместо прежней |db2schem: |
  |
  • SQLUDTS
  |
  • SQLGETTYPEINFO

|>>-db2updv8-- -d--имя-базы-данных------------------------------->
| 
|>--+-----------------------------------+--+-----+--------------><
|   '- -u--ID_пользователя-- -p--пароль-'  '- -h-'
| 

db2updv8 -d база-данных-примера

Форматирование файлов перехвата (Windows)

Появился новый инструмент db2xprt.exe для форматирования файлов перехвата (*.TRP). Этот инструмент форматирует двоичные файлы перехвата DB2 Universal Database в файл в читаемом формате ASCII. Файлы перехвата по умолчанию находятся в каталоге экземпляра (DB2INSTPROF) или же в каталоге данных диагностики, если задан параметр конфигурации менеджера баз данных DIAGPATH.

>>-db2xprt--+----------+--+----+--+----+------------------------>
            +-/p--путь-+  '-/m-'  '-/n-'
            '-/v-------'
 
>--входной-файл--+---------------+-----------------------------><
                 '-выходной-файл-'