Тип файла, заданный как разделенная разделенными запятой парами, состоящая из 'FileType' и один из разрешенных типов файлов: 'auto', 'mat', 'parquet', 'seq', 'text', или 'spreadsheet'.

Используйте 'FileType' Пара "имя-значение" со location аргумент, чтобы указать тип файлов для записи. По умолчанию, write пытается автоматически определить правильный тип файла. Вам не нужно указывать 'FileType' аргумент пары "имя-значение", если write может определить тип файла по расширению в location или filepattern аргументы. write может определить тип файла по следующим расширениям:

Пример: write('C:\myData', D, 'FileType', 'text')

Пользовательская функция записи, заданная как разделенная разделенными запятой парами, состоящая из 'WriteFcn' и указатель на функцию. Заданная функция получает блоки данных от D и отвечает за создание файлов выхода. Можно использовать 'WriteFcn' аргумент пары "имя-значение" для записи данных в различные форматы, даже если выходной формат не поддерживается непосредственно write.

Функциональная сигнатура

Пользовательская функция записи должна принимать два входных параметров, info и data:

function myWriter(info, data)

Именование файлов

Имя файла, используемое для выходных файлов, определяет порядок чтения файлов позже. datastore. Если порядок файлов имеет значение, то лучшая практика - использовать SuggestedFilename поле для присвоения имени файлам, поскольку предлагаемое имя гарантирует порядок файла. Если вы не используете предлагаемое имя файла, пользовательская функция записи должна создать глобально уникальные, правильно упорядоченные имена файлов. Имена файлов должны соответствовать шаблону именования, описанному в RequiredFilePattern. Имена файлов должны быть уникальными и правильно упорядоченными между работниками, даже если каждый работник записывает в свою собственную локальную папку.

Массивы с несколькими разделами

Распределенный массив разделяется на разделы, чтобы облегчить выполнение вычислений на массиве параллельно с Parallel Computing Toolbox™. При записи распределенного массива каждый из разделов разделяется на меньшие блоки.

info содержит несколько полей, связанных с разделами: PartitionIndex, NumPartitions, BlockIndexInPartition, и IsFinalBlock. Эти поля полезны, когда вы записываете один файл и добавляете к нему, что является общей задачей для массивов с большими разделами, которые были разделены на многие блоки. Пользовательская функция записи вызывается один раз на блок, и блоки в одном разделе всегда записываются по порядку на одном работнике. Однако разные разделы могут быть написаны разными работниками.

Функция , взятая в качестве примера,

Простая функция записи, которая записывает файлы электронной таблицы, является:

function dataWriter(info, data)
  filename = info.SuggestedFilename;
  writetable(data, filename, 'FileType', 'spreadsheet')
end

D = distributed(array2table(rand(5000,3)));
location = '/tmp/MyData/D_*.xlsx';
write(location, D, 'WriteFcn', @dataWriter);

Типы данных: function_handle

Индикатор записи имен переменных в качестве заголовков столбца, заданный как разделенная разделенными запятой парами, состоящая из 'WriteVariableNames' и числовое или логическое 1 (true) или 0 (false).

Локаль для записи дат, заданная как разделенная разделенными запятой парами, состоящая из 'DateLocale' и вектор символов или строковый скаляр. При записи datetime значения в файл, используйте DateLocale для определения локали, в которой write писать имена месяцев и дней недели и сокращений. Векторы символов или строка принимает форму xx_ YY, где xx является строчным двухбуквенным кодом ISO 639-1, указывающим на язык, и YY - заглавный код ISO 3166-1 альфа-2, указывающий страну. Список общих значений для локали см. в Locale аргумент пары "имя-значение" для datetime функция.

Для Excel^® файлы, write записывает переменные, содержащие datetime массивы как даты Excel и игнорирует 'DateLocale' значение параметров. Если на datetime переменные содержат годы до 1900 или 1904, затем write записывает переменные как текст. Для получения дополнительной информации о датах Excel, смотрите Различия между системой дат 1900 и 1904 в Excel.

Пример: 'DateLocale','ja_JP' или 'DateLocale',"ja_JP"

Типы данных: char | string

Символ разделителя полей, заданный как разделенная разделенными запятой парами, состоящая из 'Delimiter' и один из следующих спецификаторов:

Можно использовать 'Delimiter' аргумент пары "имя-значение" только для текстовых файлов с разделителями.

Пример: 'Delimiter','space' или 'Delimiter',"space"

Индикатор записи цитируемого текста, заданный как разделенная разделенными запятой парами, состоящая из 'QuoteStrings' и любой из них false или true. Если 'QuoteStrings' является true, затем write заключает текст в двойные кавычки и заменяет любые символы с двойной кавычкой, которые появляются как часть этого текста, два символов с двойной кавычкой. Для получения примера смотрите Запись текста с кавычками в файл CSV.

Можно использовать 'QuoteStrings' аргумент пары "имя-значение" только с разделителями текстовых файлов.

Схема кодирования символов, сопоставленная с файлом, задается как разделенная разделенными запятой парами, состоящая из 'Encoding' и 'system' или стандартное имя схемы кодирования символов, подобное одному из значений в этой таблице. Когда вы не задаете ни одну кодировку или не задаете кодировку следующим 'system', write функция использует кодировку по умолчанию системы для записи файла.

Пример: 'Encoding','system' или 'Encoding',"system" использует системную кодировку по умолчанию.

Целевой лист, заданный как разделенная разделенными запятой парами, состоящая из 'Sheet' и вектор символов или строковый скаляр, содержащий имя листа или положительное целое число, указывающее индекс листа. Имя листа не может содержать двоеточие (:). Для определения имен листов в файле электронной таблицы используйте [status,sheets] = xlsfinfo(filename).

Если лист не существует, то write добавляет новый лист в конец набора листов. Если лист является индексом, большим, чем количество листов, то write добавляет пустые листы до тех пор, пока количество листов в книге не будет равно индексу листов. В любом случае, write генерирует предупреждение о добавлении нового листа.

Можно использовать 'Sheet' аргумент пары "имя-значение" только с файлами электронной таблицы.

Пример: 'Sheet', 2

Пример: 'Sheet', 'MySheetName'

Типы данных: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Алгоритм сжатия Parquet, заданный в качестве одного из следующих значений.

В целом, 'snappy' имеет лучшую эффективность для чтения и записи, 'gzip' имеет более высокую степень сжатия за счет увеличения времени вычислений центрального процессора, и 'brotli' обычно создает наименьший размер файла за счет скорости сжатия.

Пример: write('C:\myData',D,'FileType','parquet','VariableCompression','brotli')

Пример: write('C:\myData', D, 'FileType', 'parquet', 'VariableCompression', {'brotli' 'snappy' 'gzip'})

Имена схем кодирования, заданные как одно из следующих значений:

В целом, 'dictionary' кодировка приводит к меньшим размерам файлов, но 'plain' кодирование может быть более быстрым для переменных, которые не содержат много повторяющихся значений. Если размер словаря или количества уникальных значений увеличивается, чтобы быть слишком большим, то кодировка автоматически возвращается к простой кодировке. Для получения дополнительной информации о кодировках Parquet, смотрите Определения кодировки Parquet.

Пример: write('myData.parquet', D, 'FileType', 'parquet', 'VariableEncoding', 'plain')

Пример: write('myData.parquet', D, 'FileType', 'parquet', 'VariableEncoding', {'plain' 'dictionary' 'plain'})

Используемая версия Parquet, заданная как '1.0' или '2.0'. По умолчанию '2.0' предлагает наиболее эффективную систему хранения данных, но вы можете выбрать '1.0' для самой широкой совместимости с внешними приложениями, поддерживающими формат Parquet.