Тип файла, указанный как разделенная запятыми пара, состоящая из '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

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

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

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

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

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

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

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

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

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