CONNECT Создать таблицу Опции
Выражения CREATE TABLE для таблиц «CONNECT» — стандартные выражения MariaDB CREATE, определяющие engine=CONNECT. Существуют несколько дополнительных параметров таблиц и столбцов, специфичных для CONNECT.
Параметры таблицы
| Параметр таблицы | Тип | Описание |
|---|---|---|
AVG_ROW_LENGTH |
Целое | Можно указать, чтобы CONNECT оценил размер переменной длины записи таблицы. |
BLOCK_SIZE |
Целое | Количество строк в каждом блоке таблицы FIX, BIN, DBF или VEC. Для таблицы ODBC это опция размера набора строк. Для таблицы JDBC это размер выборки. |
CATFUNC |
Строка | Функция каталога, используемая таблицей каталога. |
COLIST |
Строка | Список столбцов таблиц OCCUR или $project таблиц MONGO. |
COMPRESS |
Число |
1 или 2 , если файл данных сжат с помощью g-zip. По умолчанию 0. До CONNECT 1.05.0001 это было булевым значением, и true, если файл данных сжат. |
CONNECTION |
Строка | Указывает подключение таблицы ODBC, JDBC или MYSQL. |
DATA_CHARSET |
Строка | Набор символов, используемый во внешнем файле или источнике данных. |
DBNAME |
Строка | Целевая база данных для таблиц ODBC, JDBC, MYSQL, каталога и таблиц PROXY. Иногда концепция базы данных называется схемой. |
ENGINE |
Строка | Должно быть указано как CONNECT. |
ENDING |
Целое | Длина конца строки. По умолчанию 1 для Unix/Linux и 2 для Windows. |
FILE_NAME |
Строка | Имя файла (путь) для всех типов таблиц, основанных на файлах. Может быть абсолютным или относительным к текущей директории данных. Если не указано, это внешняя таблица, и используется значение по умолчанию. |
FILTER |
Строка | Для фильтрации внешней таблицы. В настоящее время только таблицы MONGO. |
HEADER |
Целое | Относится к файлам CSV, VEC и HTML. Его значение зависит от типа таблицы. |
HTTP |
Строка | HTTP клиента REST запросов. От Connect 1.06.0010. |
HUGE |
Булево | Указывает, что файл таблицы может быть больше 2 ГБ. Для таблицы MYSQL предотвращает хранение набора результатов в памяти. |
LRECL |
Целое | Размер записи файла (часто вычисляется по умолчанию). |
MAPPED |
Булево | Указывает, используется ли отображение файла для обработки файла таблицы. |
MODULE |
Строка | Имя (путь) DLL или общей библиотеки, реализующей доступ к таблице нестандартного типа (OEM). |
MULTIPLE |
Целое | Используется для указания нескольких таблиц файлов. |
OPTION_LIST |
Строка | Используется для указания других параметров, которые пока не определены напрямую. |
QCHAR |
Строка | Указывает символ, используемый для кавычек некоторых полей таблицы CSV или идентификаторов таблиц ODBC/JDBC. |
QUOTED |
Целое | Уровень кавычек, используемый в файлах таблицы CSV. |
READONLY |
Булево | True, если файл данных не должен быть изменен или удален. |
SEP_CHAR |
Строка | Указывает разделитель полей таблицы CSV или XCOL. Также используется для указания разделителя Jpath для JSON-таблиц. |
SEPINDEX |
Булево | Если true, индексы сохраняются в отдельных файлах. |
SPLIT |
Булево | True для таблицы VEC, когда все столбцы находятся в отдельных файлах. |
SRCDEF |
Строка | Определение источника таблицы, полученной через ODBC, JDBC или API MySQL, или используемой таблицей PIVOT. |
SUBTYPE |
Строка | Подтип типа таблицы OEM. |
TABLE_LIST |
Строка | Список TBL подтаблиц, разделенных запятыми. |
TABLE_TYPE |
Строка | Внешний тип таблицы type: DOS, FIX, BIN, CSV, FMT, XML, JSON, INI, DBF, VEC, ODBC, JDBC, MYSQL, TBL, PROXY, XCOL, OCCUR, PIVOT, ZIP, VIR, DIR, WMI, MAC и OEM. По умолчанию DOS, MYSQL или PROXY в зависимости от используемых параметров. |
TABNAME |
Строка | Целевая таблица или узел для ODBC, JDBC, MYSQL, PROXY или таблиц каталога; или имя узла верхнего уровня для таблиц XML. |
URI |
Строка | URI REST запроса. От Connect 1.06.0010. |
XFILE_NAME |
Строка | Базовое имя файла (путь) для файлов индексов таблицы. Может быть абсолютным или относительным к директории данных. По умолчанию — имя файла. |
ZIPPED |
Булево | True, если файл(ы) таблицы сжат(ы) в один или несколько файлов ZIP. |
Все целые числа в приведенной выше таблице — это неотрицательные целые числа большого размера.
Так как CONNECT обрабатывает много типов таблиц, многие параметры, специфичные для типа таблицы, не указаны в списке выше и должны быть введены с помощью параметра OPTION_LIST. Синтаксис:
... option_list='opname1=opvalue1,opname2=opvalue2...'
Обратите внимание, что до Connect 1.5.5 не должно быть пробелов до или после символов '=' и ','. Имя параметра — всё, что находится между началом строки или последним символом ',' и следующим символом '='. Значение параметра — всё, что находится между этим символом '=' и следующим ',' или концом строки. Например:
option_list='name=TABLE,coltype=HTML,attribute=border=1;cellpadding=5,headattr=bgcolor=yellow';
Это определяет четыре параметра, 'name', 'coltype', 'attribute', и 'headattr'; со значениями 'TABLE', 'HTML', 'border=1;cellpadding=5', и 'bgcolor=yellow', соответственно. Единственное ограничение заключается в том, что значения не могут содержать запятых, но могут содержать знаки равенства.
Параметры столбца
| Параметр столбца | Тип | Описание |
|---|---|---|
DATE_FORMAT |
Строка | Формат, указывающий, как дата хранится в файле. |
DISTRIB |
Перечисление | «разбросанные», «кластеризованные», «отсортированные» (по возрастанию). |
FIELD_FORMAT |
Строка | Формат столбца для некоторых типов таблиц. |
FIELD_LENGTH |
Целое число | Устанавливает внутреннюю длину поля для столбцов DATE. |
FLAG |
Целое число | Целое значение, смысл которого зависит от типа таблицы. |
JPATH |
Строка | Путь Json для столбцов таблиц JSON. |
MAX_DIST |
Целое число | Максимальное количество различных значений в этом столбце. |
SPECIAL |
Строка | Имя столбца SPECIAL, который задаёт значение этого столбца. |
XPATH |
Строка | Путь XML для столбцов таблиц XML. |
- Параметры столбцов
MAX_DISTиDISTRIBиспользуются для блочного индексирования. - Все целые числа в таблице выше — это беззнаковые целые числа большой размерности.
- JPATH и XPATH были добавлены для повышения читабельности операторов CREATE TABLE, но они выполняют ту же функцию, что и FIELD_FORMAT, и любой из них можно использовать с тем же результатом.
Параметры индексов
| Параметр индекса | Тип | Описание |
|---|---|---|
| DYNAM | Булево | Устанавливает индекс как «динамический». |
| MAPPED | Булево | Использовать отображение файла индекса. |
Примечание 1: Создание таблицы CONNECT на основе файла не удаляет и не создаёт файл, если имя файла указано в операторе CREATE TABLE (“внешняя” таблица). Если файл не существует, он будет заполнен последующими командами INSERT или LOAD или выражением «AS select statement» команды CREATE TABLE. В отличие от движка CSV, CONNECT легко позволяет создавать таблицы на основе уже существующих файлов, например, файлов, созданных другими приложениями. Однако, если имя файла не указано, в каталоге данных будет создан файл с именем по умолчанию tablename.tabletype (“внутренняя” таблица).
Примечание 2: Удаление таблицы CONNECT выполняется с помощью стандартного оператора DROP. Для внешних таблиц это удаляет только определение таблицы CONNECT, но не удаляет соответствующий файл данных и файлы индексов. Используйте DELETE или TRUNCATE для этого. Это отличается от файлов данных и индексов внутренних таблиц, которые удаляются при DROP, как и для других движков MariaDB.
© 2023 MariaDB
Licensed under the Creative Commons Attribution 3.0 Unported License and the GNU Free Documentation License.
https://mariadb.com/kb/en/connect-create-table-options/