Оператор Store создает файл QVD, Parquet, CSV или TXT.
Синтаксис:
Store [ fieldlist from] table into filename [ format-spec ];
Оператор создаст файл с заданным именем QVD, Parquet или текстовый файл.
Оператор может экспортировать поля только из одной таблицы данных. Если требуется экспортировать поля из нескольких таблиц, необходимо заранее сформировать явное объединение join в скрипте для создания таблицы данных, которую следует экспортировать.
Текстовые значения экспортируются в файл CSV в формате UTF-8. Можно указать разделитель. См. LOAD. Оператор store для файла CSV не поддерживает экспорт BIFF.
Аргументы:
| Аргумент | Описание |
|---|---|
| fieldlist::= ( * | field) { , field } ) |
Список полей, которые необходимо выбрать. Символ «*» в качестве списка полей обозначает все поля. field::= fieldname [as aliasname ] fieldname — это текст, идентичный имени поля в элементе table. (Обратите внимание, что для указания имени поля необходимо заключить его в прямые двойные кавычки или квадратные скобки, если имя содержит пробелы или другие нестандартные символы.) aliasname — альтернативное имя поля, которое предназначено для использования в результирующем файле QVD или CSV. |
| table | Метка скрипта, представляющая уже загруженную таблицу, которую планируется использовать в качестве источника данных. |
| filename |
Имя целевого файла, включая действительный путь к существующему подключению к данным папки. Пример: 'lib://Table Files/target.qvd' В прежней версии режима написания скриптов следующие форматы пути тоже поддерживаются:
|
| format-spec ::=( ( txt | qvd | parquet), compression is codec) |
Можно установить спецификацию формата на любой из этих форматов файлов. Если формат не указан, то используется qvd.
Если используется parquet, также можно задать, какой кодек сжатия будет использоваться вместе с параметром compression is. Если не указать кодек сжатия для параметра compression is, используется snappy. Доступны следующие настройки сжатия:
Пример: Store mytable into [lib://DataFiles/myfile.parquet] (parquet, compression is lz4); |
Примеры:
Store mytable into xyz.qvd (qvd);
Store * from mytable into 'lib://FolderConnection/myfile.qvd';
Store Name, RegNo from mytable into xyz.qvd;
Store Name as a, RegNo as b from mytable into 'lib://FolderConnection/myfile.qvd';
Store mytable into myfile.txt (txt);
Store mytable into myfile.parquet (parquet);
Store * from mytable into 'lib://FolderConnection/myfile.qvd';
Хранение в файлах Parquet
Parquet — это строго типизированный формат файлов, в котором каждое поле содержит один определенный тип данных (например, in32, double, timestamp или text). Qlik Sense хранит внутренние данные в виде свободно типизированной дуальной системы, где данные из разных источников могут смешиваться в одних и тех же полях. Поскольку в каждом поле Parquet может храниться только одна часть дуальной системы, важно знать, что содержит каждое поле. По умолчанию Qlik Sense использует тип поля для определения способа его хранения. При хранении данных в файлах Parquet в определенном формате при их загрузке необходимо указать, к какому типу данных относятся ваши поля. Если попытаться сохранить данные в несовместимых полях файла Parquet, например, числа в текстовом поле или текст в поле временной метки, то в итоге будут получены нулевые значения.
При загрузке данных, которые предполагается хранить в Parquet, можно изменить поведение по умолчанию. Можно либо отформатировать их для изменения типа данных, либо пометить его для принудительного использования определенных типов столбцов в Parquet.
Форматирование данных для хранения в Parquet
Для классификации данных можно использовать функции форматирования Qlik Sense. Например, Text(), Num(), Interval() или Timestamp() могут обеспечивать соблюдение форматов данных при их хранении в Parquet. Qlik Sense может хранить данные почти в 20 типах данных в зависимости от атрибутов поля и автоматических тегов поля. Для получения дополнительной информации см. раздел Функции интерпретации.
Пример: Форматирование данных с помощью Num() и Text()
Следующий пример демонстрирует подготовку данных для хранения в Parquet. Num() применяется к числовому полю. Text() применяется к полю как текстового, так и смешанного типа. В случае смешанного поля Text() предотвращает его обработку в Parquet как числового поля и замену текстовых значений на нулевые.
NoConcatenate LOAD num, text, Text(mixed) as mixed RESIDENT Data; STORE Format INTO [lib://DataFiles/Tmp.parquet] (parquet);
Пометка данных тегами для хранения в Parquet
Для принудительного использования определенных типов столбцов при хранении данных в Parquet применяются теги $parquet. Каждый тип данных может быть принудительно установлен путем добавления соответствующего управляющего тега. Например, чтобы сохранить поле как INT32 в Parquet, пометьте его тегом $parquet-int32 в скрипте загрузки. В зависимости от типа данных будет храниться либо строковое, либо числовое представление двойных данных.
Следующие управляющие теги Parqeut могут использоваться для пометки полей для хранения в файлах Parquet.
| Управляющий тег | Двойное значение | Физический тип | Логический тип | Преобразованный тип |
|---|---|---|---|---|
| $parquet-boolean | Число | BOOLEAN | NONE | NONE |
| $parquet-int32 | Число | INT32 | NONE | NONE |
| $parquet-int64 | Число | INT64 | NONE | NONE |
| $parquet-float | Число | FLOAT; | NONE | NONE |
| $parquet-double | Число | DOUBLE | NONE | NONE |
| $parquet-bytearray | Строка | BYTE_ARRAY | NONE | UTF8 |
| $parquet-bytearrayfix | Число | FIXED_LEN_BYTE_ARRAY | NONE | DECIMAL |
| $parquet-decimal | Число | INT64 | DECIMAL | DECIMAL |
| $parquet-date | Число | INT32 | DATE | DATE |
| $parquet-time | Число | INT64 | TIME | TIME_MICROS |
| $parquet-timestamp | Число | INT64 | TIMESTAMP | TIMESTAMP_MICROS |
| $parquet-string | Строка | BYTE_ARRAY | STRING | UTF8 |
| $parquet-enum | Строка | BYTE_ARRAY | ENUM | ENUM |
| $parquet-interval | Число | FIXED_LEN_BYTE_ARRAY | INTERVAL | INTERVAL |
| $parquet-json | Строка | BYTE_ARRAY | JSON | JSON |
| $parquet-bson | Строка | BYTE_ARRAY | BSON | BSON |
| $parquet-uuid | Строка | FIXED_LEN_BYTE_ARRAY | UUID | NONE |
Пример: Пометка данных тегами для хранения в Parquet
В этом примере для определения данных для Parquet используются два тега. Поле num помечается тегом $parquet-int32, определяющим его как числовое поле, которое в Parquet будет установлено как INT32.