SQL/XML DB2

Команда EXPORT

Экспортирует данные из базы данных во внешний файл.

Синтаксис команды

>>-EXPORT TO--имя-файла--OF--тип-файла---------------------------->
 
>--+------------------------+--+-----------------------+---------->
   |         .-,----------. |  |          .-,--------. |
   |         V            | |  |          V          | |
   '-XML TO---маршрут-xml-+-'  '-XMLFILE---имя-файла-+-'
 
>--+----------------------------------+--+---------------+-------->
   |              .-----------------. |  '-XMLSAVESCHEMA-'
   |              V                 | |
   '-MODIFIED BY---модиф-типа-файла-+-'

>---- оператор-выборки--------------------------------------------><

Параметры команды

TO имя-файла

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

OF тип-файла

Задает формат данных в выходном файле (cм. Типы и формат файлов экспорта-импорта)

XML TO маршрут-xml

Задает один или более маршрутов к каталогам, в которые будут сохранены XML-файлы. В каждом маршруте-xml будет, как минимум, один файл, и каждый файл будет содержать, как минимум, один экземпляр Модели Данных XQuery (QDM). Если задано более одного маршрута-xml, экземпляры QDM равномерно распределяются между маршрутами.

XMLFILE имя-файла

Задает одно или более базовых имен для XML-файлов. Если пространство имен для первого имени исчерпано, применяется второе имя и т.д.
При создании во время операции экспорта XML-файла, имена файлов конструируются добавлением текущего базового имени из этого списка к текущему маршруту (из маршрута-xml) и добавлением 3-значного номера и 3-символьного идентификатора "xml". Например, если текущий маршрут - каталог /u/foo/lob/path/, а текущее имя файла - bar, создаваемые XML-файлы будут: /u/foo/lob/path/bar.001.xml, /u/foo/lob/path/bar.002.xml и т.д.

MODIFIED BY модиф-типа-файла

Следующие модификаторы типа имеют отношение к XML-данным:
codepage=x (форматы файлов ASC и DEL)
x - символьная строка ASCII. Значение интерпретируется как кодовая страница данных в файле. Преобразует во время операции импорта символьные данные из этой кодовой страницы в кодовую страницу приложения.

xmlinsepfiles (все форматы файлов)
Каждый экземпояр QDM записывается в отдельный файл. По умолчанию множественные значения сцепляются вместе в одном файле.

xmlnodeclaration (все форматы файлов)
Экземпляр QDM записывается без тега объявления XML. По умолчанию экземпляры QDM экспортируются с тегами объявления XML в начале, которые включают в себя атрибут кодировки.

xmlchar (все форматы файлов)
Экземпляр QDM записывается в символьной кодовой странице. Заметьте, что символьная кодовая страница является значением, задаваемым модификатором типа файла CODEPAGE или кодовой страницей приложения, если модификатор не задан. По умолчанию экземпляр QDM сохраняется в Unicode.

xmlgraphic (все форматы файлов)
Экземпляр QDM записывается в графической кодовой странице. Заметьте, что графическая кодовая страница является значением, задаваемым модификатором типа файла CODEPAGE или графической компонентой кодовой страницы приложения, если модификатор не задан. По умолчанию экземпляр QDM сохраняется в Unicode.

XMLSAVESCHEMA

Задает, что для всех столбцов XML должна быть сохранена XML-схема. Для каждого экспортируемого XML-документа, который был проверен по XML-схеме, полный квалифицированный SQL-идентификатор схемы будет записан как атрибут xsi:schemaLocation (SCH) в соответствующем Спецификаторе Данных XML (XDS). Если экспортируемый документ не был проверен по XML-схеме, атрибут SCH не включатся в XDS.
Части схемы и имени SQL-идентификатора сохраняются как значения OBJECTSCHEMA и OBJECTNAME в строке каталога SYSCAT.XSROBJECTS таблицы, соответствующей XML-схеме.
Опция XMLSAVESCHEMA не совместима с последовательностями XQuery, которые не вырабатывают правильно форматированные XML-документы.

оператор-выборки

Задает оператор SELECT или XQUERY, который будет возвращать экспортируемые данные. Если в операторе происходит ошибка, сообщение записывается в файл сообщений (или в стандартный вывод). Если код ошибки - один из: SQL0012W, SQL0347W, SQL0360W, SQL0437W или SQL1824W, операция экспорта продолжается, иначе она прерывается.

Примечания:

Все экземпляры QDM записываются в XML-файл, отдельный от основного файла данных даже, если не заданы ни фраза XMLFILE, ни фраза XML TO. По умолчанию XML-файлы записываются по тому же маршруту, что и файл экспортируемых данных. Базовое имя по умолчанию для XML-файл - имя файла экспортируемых данных с добавленным к нему ".xml".
Все экземпляры QDM записываются с тегами объявления XML в начале, которые включают в себя атрибут кодировки, если не задан модификатор типа файла XMLNODECLARATION.
По умолчанию все экземпляры QDM записываются в Unicode, если не задан модификатор типа файла XMLCHAR или XMLGRAPHIC.
Маршрутом по умолчанию для XML-данных является маршрут основного файла данных. Базовое имя XML-файла по умолчанию есть имя основного файла данных. Например, если имя основного файла данных:
```
/mypath/myfile.del
```
, маршрут по умолчанию для XML-данных:
```
/mypath"
```
, базовое имя XML-файла по умолчанию:
```
myfile.del
```
Утилита экспорта добавляет числовой идентификатор к каждому имени XML-файла. Идентификаторы 3-значные с добавлением нулей в начале, начиная с:
```
.001
```
. После 999-го XML-файла к идентификатору уже не добавляются нули; например, 1000-ый XML-файл будет иметь расширение:
```
.1000
```
. За числовым идентификатором следует 3-символьный идентификатор типа:
```
.xml
```
. Например, сгенерированный XML-файл может иметь имя в формате:
```
myfile.del.001.xml
```
Возможно, применив XQuery, заставить утилиту экспорта экспортировать экземпляры QDM, которые не являются правильно форматированными. Но вы не сможете потом импортировать или загрузить эти экспортированные документы в столбец XML, поскольку столбцы XML могут содержать только правильно форматированные документы.