Книга: Firebird РУКОВОДСТВО РАЗРАБОТЧИКА БАЗ ДАННЫХ

Синтаксис для CREATE TABLE...EXTERNAL FILE

Синтаксис для CREATE TABLE...EXTERNAL FILE

Оператор CREATE TABLE для внешнего файла определяет как спецификацию внешнего файла (размещение и имя файла), так и характеристики столбцов Firebird, представляющих структуру хранимых записей.

CREATE TABLE внешняя-таблица

EXTERNAL FILE спецификация-файла (определение-столбца [, определение-столбца, ...], [разделитель-строки-1 CHAR(l) [,разделитель-строки-2 CHAR(l)]]);

спецификация-файла - полный путь и имя файла для внешнего файла данных. Файл не должен существовать во время создания таблицы. При этом в Firebird 1.5 и выше оператор CREATE будет неудачным, если спецификация ссылается на несконфигуриро- ванное размещение внешнего файла. См. раздел "Организация защиты внешних файлов" далее в этой главе и разд. "Конфигурирование внешних размещений" главы 36.

определение-столбца - обычное определение столбца Firebird. Могут быть заданы не символьные типы данных; при этом обеспечивается неявное преобразование в этот тип каждой строки, выделяемой из местоположения столбца во внешней записи.

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

* В Linux/UNIX это один символ перевода строки ASCII 10.

* В Windows это упорядоченная пара ASCII 13 (возврат каретки) и ASCII 10.

* В Mac OS это ASCII 10 и ASCII 13.

* Другие операционные системы могут использовать другой порядок или другие символы.

Во всех версиях Firebird список каталогов должен быть сконфигурирован для ограничения размещений, где Firebird будет отыскивать или создавать внешние файлы. Параметры конфигурации ExternaiFiieAccess в firebird.conf (для серверов версии 1.5) или external_file_directory В ibconfig/isc_config (для версии 1.0.x) см. В главе 3. По умолчанию Firebird 1.5 инсталлируется без доступа к внешним файлам, в то время как версия 1.0.x дает открытый доступ к любому файлу файловой системы.

! ! !

ПРИМЕЧАНИЕ. Метод конфигурирования и возможности защиты системы от злоумышленных атак через доступ к внешним файлам различаются в разных версиях сервера.

. ! .

Firebird сам создаст внешний файл, если не найдет его по месту, указанному в спецификации CREATE EXTERNAL TABLE ' <спецификация--файла>'. ЕСЛИ файл уже существует, ТО каждая его запись должна быть фиксированной длины, состоять из полей фиксированной длины, которая должна в точности соответствовать длине в байтах спецификациям столбцов в определении таблицы. Если приложение, создавшее файл, использует жесткие символы перевода строки (например, двухбайтовую последовательность возврат каретки и перевод строки в текстовых файлах Windows), включите в описание столбец для приспособления к этой последовательности. См. далее разд. "Символы конца строки".

Данные BLOB и массивы не могут быть считаны или записаны во внешний файл.

Большинство правильно сформированных числовых данных могут читаться непосредственно из внешней таблицы и в большинстве случаев Firebird в состоянии использовать его внутренние правила преобразования для правильной их интерпретации. При этом может оказаться более простым и точным чтение чисел в символьные столбцы и последующее их преобразование с использованием функции CAST().

! ! !

СОВЕТ. Убедитесь, что вы выделили достаточный размер для размещения ваших данных. Для информации о размерах обратитесь к соответствующей главе в части III. Рисунок 8.1 описывает правила преобразования типов данных.

. ! .

Использование VARCHAR в определении столбца внешнего строкового поля не рекомендуется, потому что он не является легко переносимым форматом:

<2-байтовое беззнаковое короткое х строка символьных байтов>

VARCHAR требует начального 2-байтового беззнакового числа для включения количества байтов строки, непосредственно за которым следует строка[44]. Для многих внешних приложений может оказаться трудным или невозможным получить доступ к данным. По этой причине используйте CHAR вместо VARCHAR для строковых полей и убедитесь, что приложение переводит эту строку в полный размер.

Когда вы создаете таблицу, которая будет использована для импорта внешних данных, вы должны определить столбец, содержащий символ конца строки (End-Of-Line, EOL) или новой строки, если приложение, создающее этот файл, включает такой символ. Размер столбца должен быть достаточным, чтобы хранить конкретный системный символ EOL (обычно 1 или 2 байта). Для большинства версий UNIX это 1 байт. Для Windows и Macintosh - 2 байта.

При добавлении данных во внешний файл внешняя функция ASCII_CHAR (десятичный- код-ASCII) из библиотеки функций ib udf может быть использована для передачи в

оператор SQL непечатаемых символов в виде выражения для столбцов разделителей строк. Например, следующий оператор добавляет символы возврата каретки и перевода строки в столбец:

INSERT INTO MY_EXT_TABLE (

столбцы . . .,

CRIIF)

VALUES (

Значение-столбца. . .,

ASCII_CHAR(13) и ASCII_CHAR(10));

Альтернативой этому является создание таблицы специально для хранения непечатаемых символов, которые могут понадобиться вашим приложениям. Просто создайте текстовый файл на той же платформе, что и ваш сервер, используя редактор, который "отображает" непечатаемые символы. Откройте вашу "непечатаемую" таблицу, используя интерактивный инструмент, скопируйте и вставьте символы непосредственно в таблицу. Для операторов, выполняющих добавление во внешний файл, символ может быть получен с помощью подзапроса из таблицы[45].

Только операции INSERT и SELECT могут быть выполнены над строками внешней таблицы. Попытки изменить или удалить строки вернут ошибки.

Поскольку такие данные располагаются вне базы данных, операции с внешней таблицей не находятся под управлением версиями записей сервера Firebird. Поэтому добавления имеют немедленный эффект и не могут быть отменены (rolled back).

! ! !

СОВЕТ. Если вы хотите, чтобы ваша таблица находилась под управлением транзакции, создайте другую, внутреннюю таблицу Firebird и добавьте данные из внешней таблицы во внутреннюю.

. ! .

Если вы используете DROP DATABASE для удаления базы данных, вы должны также удалить внешний файл - он не будет автоматически удален как результат выполнения DROP DATABASE.

Оглавление книги