Команда IMPORT

Вставляет данные из внешнего файла с поддерживаемым форматом файла в таблицу.

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

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

>--+------------------------------------+------------------------------------------------>
   '-XMLPARSE--+-STRIP----+--WHITESPACE-'
               '-PRESERVE-'
 
>----XMLVALIDATE USING--+-XDS--+----------------------+--| Параметры Ignore и Map |-+---->
                        |      '-DEFAULT--sqlid-схемы-'                             |
                        +-SCHEMA--sqlid-схемы---------------------------------------+
                        '-SCHEMALOCATION HINTS--------------------------------------'

>----+-INSERT---------+--INTO----имя-таблицы--+--------------------------+---------------><
     +-INSERT_UPDATE--+                       |   .-,---------------.    | 
     +-REPLACE--------+                       |   V                 |    | 
     '-REPLACE_CREATE-'                       '-(---столбец-вставки-+--)-' 

Параметры Ignore и Map:
 
|--+------------------------------+--+-------------------------------------------------+---|
   |           .-,--------------. |  |        .-----------------------------------.    |
   |           V                | |  |        V                                   |    |
   '-IGNORE--(---sqlid-схемы--)-+-'  '-MAP--(---(--sqlid-схемы--,--sqlid-схемы--)-+--)-'
 

Параметры команды FROM имя-файла

Задает имя внешнего файла в локальной файловой системе

OF тип-файла

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

XML FROM маршрут-xml

Задает один или более маршрутов, которые содержат XML-файлы.

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

Следующие модификаторы типа имеют отношение к XML-данным:

codepage=x (форматы файлов ASC и DEL)

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

xmlchar (форматы файлов ASC и DEL)

Задает, что XML-документы кодируются в символьной кодовой странице. Эта опция полезна, для обработки XML-документов, которые кодированы в определенной символьной кодовой странице, но не содержат объявления кодировки. Для каждого документа, если тег объявления существует и содержит атрибут кодировки, кодировка должна соответствовать символьной кодовой странице, иначе строка, содержащая документ, будет отбракована. Заметьте, что символьная кодовая страница является значением, задаваемым модификатором типа файла CODEPAGE или кодовой страницей приложения, если модификатор не задан. По умолчанию, либо документы кодируются в Unicode, либо они содержат тег объявление с атрибутом кодировки.

xmlgraphic (форматы файлов ASC и DEL)

Задает, что XML-документы кодируются в графической кодовой странице. Эта опция полезна, для обработки XML-документов, которые кодированы в определенной графической кодовой странице, но не содержат объявления кодировки. Для каждого документа, если тег объявления существует и содержит атрибут кодировки, кодировка должна соответствовать графической кодовой странице, иначе строка, содержащая документ, будет отбракована. Заметьте, что графическая кодовая страница является значением, задаваемым модификатором типа файла CODEPAGE или графической компонентой кодовой страницы приложения, если модификатор не задан. По умолчанию, либо документы кодируются в Unicode, либо они содержат тег объявление с атрибутом кодировки.

indexschema=схема (формат файлов IXF)

Использует заданную схему для имен индексов при их создании. Если схема не задана (но ключевое слово indexschema задано), используется ID соединения пользователя. Если ключевое слово не задано, используется схема из IXF-файла.

XMLPARSE

Задает, как разбираются XML-документы. Если эта опция не задана, поведение разбора XML-документов будет определяться значением специального регистра CURRENT XMLPARSE OPTION.

STRIP WHITESPACE

Задает удаление пробельных символов при разборе XML-документа.

PRESERVE WHITESPACE

Задает сохранение пробельных символов при разборе XML-документа.

XMLVALIDATE

Задает, что правильность XML-документов проверяется по схеме.

USING XDS

XML-документы проверяются на правильность по XML-схеме, идентифицируемой Спецификатором Данных XML Specifier (XDS) в исходном XML-документе. По умолчанию, опция XMLVALIDATE вызывается с фразой USING XDS, схема, используемая для проверке правильности определяется атрибутом xsi:schemaLocation (SCH) в XDS. Если атрибута SCH нет в XDS, никакой проверке по схеме не происходит, если только не задана схема по умолчанию в фразе DEFAULT. Фраза DEFAULT, IGNORE и MAP могут использоваться для модификации поведения при определении схемы. Эти три необязательные фразы применяются непосредственно к спецификации XDS, а не одна к другой. Например, если схема выбрана потому, что она задана в фразе DEFAULT, не будет также проигнорирована схема, заданная в фразе IGNORE. Аналогично, если схема выбрана потому, что она задана в первой части пары фразы MAP, она не будет переотображена, если также задана и во второй части пары фразы MAP.

DEFAULT sqlid-схемы

Эта опция может использоваться только, если задан параметр USING XDS. Схема, заданная в фразе DEFAULT, идентифицирует схему, которая используется для проверки правильности, если XDS импортируемого XML-документа не содержит атрибута SCH, идентифицирующего XML-схему Фраза DEFAULT имеет приоритет над фразами IGNORE и MAP. Если XDS удовлетворяет фразе DEFAULT, спецификации фраз IGNORE и MAP игнорируются.

USING SCHEMA

XML-документы проверяются на правильность по XML-схеме, которая задается идентификатором SQL. В этом случае атрибут SCH в XDS игнорируется для всех XML-столбцов.

USING SCHEMALOCATION HINTS

XML-документы проверяются на правильность по XML-схеме, идентифицируемой указанием на расположение XML-схемы в исходных XML-документах. Если атрибут SCH не найден в XML-документе, не происходит никакой проверки. Если задана фраза USING SCHEMALOCATION HINTS, атрибут SCH в XDS игнорируется для всех XML-столбцов.

IGNORE sqlid-схемы

Эта опция может использоваться только, если задан параметр USING XDS. Фраза IGNORE задает список из одной или нескольких схем для игнорирования их, если они идентифицируются в атрибуте SCH. Если атрибут SCH имеется в XDS для импортируемого XML-документа и схема, идентифицируемая атрибутом SCH включена в список схем для IGNORE, то проверка правильности по схеме для импортируемого XML-документа не происходит. Если схема включена в фразу IGNORE, она может также присутствовать в левой части пары схем в фразе MAP. Фраза IGNORE применяется только к XDS. Схема, которая отображается фразой MAP, следовательно, не будет игнорироваться, если она задана в фразе IGNORE.

MAP sqlid-схемы

Эта опция может использоваться только, если задан параметр USING XDS. Используйте фразу MAP для задания альтернативных схем вместо тех, которые заданы в атрибуте SCH в XDS для каждого импортируемого XML-документа. Фраза MAP задает список из одной или нескольких пар схем, в котором каждая пара представляет отображение одной схемы на другую. Первая схема пары представляет схему, на которую ссылается атрибут SCH в XDS. Вторая схема пары представляет схему, которая должна использоваться при проверке правильности. Если схема присутствует в левой части пары в фразе MAP, она не может быть также задана в фразе IGNORE. После того, как отображение пары схем применено, его результат является окончательным. Операция отображения нетранзитивна, следовательно, выбранная схема не будет последовательно применяться к отображению другой пары схем. Схема не может быть отображена более одного раза, значит, она не может появляться в левой части более, чем одной пары.

INSERT

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

INSERT_UPDATE

Добавляет строки импортируемых данных в целевую таблицу или изменять существующие строки (в целевой таблице) с соответствующими первичными ключами.

REPLACE

Удаляет все существующие данные из таблицы и вставляет импортируемые данные. Определение таблицы и определения индексов не меняются. Опция может применяться только, если таблица уже существует.

REPLACE_CREATE

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

INTO имя-таблицы

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

Задает имя столбца таблицы, в который вставляются данные.

Примечания:

1. Все XML-данные должны быть в отдельных от основного файла данных XML-файлах. Для каждого столбца XML основном файле данных должен существовать XDS (или значение NULL).
2. Предполагается, что XML-документы имеют формат Unicode или содержат тег объявления, включающий в себя атрибут кодировки, если не заданы модификаторы типа файла XMLCHAR или XMLGRAPHIC.
3. Строки, содержащие документы, которые не являются правильно форматированными, отбраковываются.
4. Если задана опция XMLVALIDATE, документы, которые успешно проверены по соответствующей схеме, будут при вставке аннотированы информацией схемы. Строки, содержащие документы, в которых выявлены ошибки при проверке по соответствующей схеме, будут отбракованы.