主要内容

数据存储

为大型数据集合创建数据存储

折叠所有页面

语法

Ds =数据存储(位置)
ds =数据存储(位置，名称，值)

描述

例子

ds=数据存储(位置）从指定的数据集合创建数据存储位置．数据存储是存储大到无法装入内存的数据集合的存储库。在创建ds，您可以读取和处理数据。

例子

ds=数据存储(位置，名称,值）为ds使用一个或多个名称-值对参数。例如，可以为映像文件创建一个数据存储“类型”,“图像”．

例子

全部折叠

创建与示例文件关联的数据存储airlinesmall.csv．该文件包含1987年至2008年的航空公司数据。

若要管理数字列中缺失数据的导入，请使用“TreatAsMissing”而且“MissingValue”名称-值参数。替换的每个实例“NA”的值，在导入的数据中使用0“TreatAsMissing”作为“NA”而价值“MissingValue”为0。

数据存储(“airlinesmall.csv”，“TreatAsMissing”，“NA”，.．.“MissingValue”, 0)
ds = TabularTextDatastore属性:文件:{' B:\matlab\toolbox\matlab\demos\airlinesmal .csv'}文件夹:{' B:\matlab\toolbox\matlab\demos'} FileEncoding: 'UTF-8' AlternateFileSystemRoots: {} variablenamgrule: 'modify' ReadVariableNames: true VariableNames:{'年'，'月'，'月日'…和26个更多}DatetimeLocale: en_US文本格式属性:NumHeaderLines: 0分隔符:'，' RowDelimiter: '\r\n' TreatAsMissing: 'NA' MissingValue: 0高级文本格式属性:TextscanFormats: {'%f'， '%f'， '%f'…TextType: 'char' ExponentCharacters: 'eEdD' CommentStyle: "空格:' \b\t' MultipleDelimitersAsOne: false属性，控制表返回预览，读取，readall: SelectedVariableNames:{'年'，'月'，'月日'…和26}SelectedFormats: {% f ', ' % f ', ' % f '……ReadSize: 20000行OutputType: 'table' RowTimes:[]写属性:supportedoutputformat: ["txt" "csv" "xlsx" 金宝app"xls" "parquet" "parq"] DefaultOutputFormat: "txt"

数据存储创建一个TabularTextDatastore．

创建一个包含所有的数据存储.tifMATLAB®路径下的文件及其子文件夹。

Ds =数据存储(fullfile(matlabroot，“工具箱”，“matlab”)，.．.“IncludeSubfolders”,真的,“FileExtensions”，“.tif”，“类型”，“图像”）
ds =ImageDatastore的属性:文件:{'H:\matlab\toolbox\matlab\demos\example.tif';'H:\matlab\toolbox\matlab\imagesci\玉米.tif'}文件夹:{'H:\matlab\toolbox\matlab'} AlternateFileSystemRoots: {} ReadSize: 1标签:{}SupportedOutputFor金宝appmats: ["png" "jpg" "jpeg" "tif" "tiff"] DefaultOutputFormat: "png" ReadFcn: @readDatastoreImage

输入参数

全部折叠

包含在数据存储中的文件或文件夹，指定为文件集对象作为文件路径，或作为DsFileSet对象。

  • 文件集object -可以指定位置作为一个文件集对象。指定位置为文件集对象相比于指定路径或DsFileSet对象。有关更多信息，请参见matlab.io.datastore.FileSet．

  • 文件路径—您可以将单个文件路径指定为字符向量或字符串标量。您可以将多个文件路径指定为字符向量的单元格数组或字符串数组。

  • DsFileSetobject -可以指定DsFileSet对象。有关更多信息，请参见matlab.io.datastore.DsFileSet．

文件或文件夹可以是本地的或远程的:

  • 本地文件或文件夹—指定文件或文件夹的本地路径。如果文件不在当前文件夹中，则指定完整路径或相对路径。指定文件夹的子文件夹中的文件不会自动包含在数据存储中。当指定本地路径时，可以使用通配符*。此字符指定数据存储包括所有匹配文件或匹配文件夹中的所有文件。

  • 远程文件或文件夹——指定远程文件或文件夹的完整路径作为格式的统一资源定位符(URL)hdfs: / / /path_to_file．有关更多信息，请参见使用远程数据．

指定文件夹时，数据存储只包括支持的文件格式的文件，而忽略任何其他格式的文件。金宝app若要指定要包含在数据存储中的自定义文件扩展名列表，请参见FileExtensions财产。

为KeyValueDatastore时，文件必须是mat文件或序列文件mapreduce函数。MAT-files必须在本地文件系统或网络文件系统中。序列文件可以在本地、网络或HDFS™文件系统中。为DatabaseDatastore，位置参数不必是文件。有关更多信息，请参见DatabaseDatastore(数据库工具箱)．

例子:“file1.csv”

例子:“. . / dir /数据/ file1.jpg”

例子:{“C: \ dir \ data \ file1.xls”,“C: \ dir \ data \ file2.xlsx”}

例子:“C: \ dir \ data \ * .mat’

例子:“hdfs: / / /数据/中”

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:FileExtensions,{“jpg”、“.tif”}的所有扩展jpg或.tif扩展至ImageDatastore对象。

数据存储的类型，指定为逗号分隔的对，由“类型”和以下其中之一:

的价值“类型” 描述
“tabulartext” 包含表格数据的文本文件。数据编码必须为ASCII或UTF-8。
“图像” JPEG或PNG等格式的图像文件。可接受的文件包括imformats格式。
“表格” 包含一个或多个表的电子表格文件。
“keyvalue” mat文件或序列文件中包含的键值对数据mapreduce．
“文件” 自定义格式文件，需要指定的读取函数来读取数据。有关更多信息，请参见FileDatastore．
“高” 生成的mat文件或序列文件写的功能高数据类型。欲了解更多信息，TallDatastore．
“铺” 包含面向列数据的拼花文件。欲了解更多信息，ParquetDatastore．
“数据库” 存储在数据库中的数据。需要数据库工具箱™。属性时要求指定额外的输入参数类型参数。有关更多信息，请参见DatabaseDatastore(数据库工具箱)．

  • 如果有多种类型支持文件的格式，则使用金宝app“类型”参数指定数据存储类型。

  • 如果没有指定值“类型”,然后数据存储根据文件扩展名自动确定要创建的数据存储的适当类型。

数据类型:字符|字符串

包含文件夹中的子文件夹，指定为逗号分隔的对，由“IncludeSubfolders”而且真正的(1)或假(0)指定真正的在每个文件夹或中包含所有文件和子文件夹假只包括每个文件夹中的文件。

当你不指定时“IncludeSubfolders”，则默认值为假．

的“IncludeSubfolders”名称-值对仅在创建以下对象时有效:

  • TabularTextDatastore

  • ImageDatastore

  • SpreadsheetDatastore

  • FileDatastore

  • KeyValueDatastore

  • ParquetDatastore

例子:“IncludeSubfolders”,真的

数据类型:逻辑|双

文件的扩展名，指定为逗号分隔的对，由“FileExtensions”字符向量，字符向量的单元格数组，字符串标量，或者字符串数组。当指定“FileExtensions”，也指定“类型”．可以使用空引号”表示没有扩展名的文件。

如果“FileExtensions”没有指定，那么数据存储根据数据存储类型自动包含所有支持的文件扩展名。金宝app如果要包含不受支持的扩展，请单独指定要包含的每个扩金宝app展。

  • 为TabularTextDatastore对象，支持的扩展包金宝app括. txt，. csv，.dat，.dlm，.asc，。text，且没有延期。

  • 为ImageDatastore对象，支持的扩展包金宝app括所有imformats扩展。

  • 为SpreadsheetDatastore对象，支持的扩展包金宝app括xls，.xlsx，.xlsm，.xltx,.xltm．

  • 为TallDatastore对象，支持的扩展包金宝app括.mat而且.seq．

  • 为ParquetDatastore对象，支持的扩展包金宝app括.parquet而且.parq．

的“FileExtensions”名称-值对仅在创建以下对象时有效:

  • TabularTextDatastore

  • ImageDatastore

  • SpreadsheetDatastore

  • FileDatastore

  • KeyValueDatastore

  • ParquetDatastore

例子:“FileExtensions”、“jpg”

例子:FileExtensions, {' . txt ', '。text '}

数据类型:字符|细胞|字符串

可选文件系统根路径，指定为由“AlternateFileSystemRoots”一个字符串向量或者单元格数组。使用“AlternateFileSystemRoots”在本地机器上创建数据存储，但需要在另一台机器(可能是不同的操作系统)上访问和处理数据。此外，在使用并行计算工具箱™和MATLAB®并行服务器™，并且数据存储在您的本地机器上，不同平台云或集群机器上可用的数据副本，您必须使用“AlternateFileSystemRoots”关联根路径。

  • 若要关联一组等价的根路径，请指定“AlternateFileSystemRoots”作为一个字符串向量。例如,

    [" Z: \数据集”、“/ mynetwork /数据集”)

  • 若要关联多个与数据存储等效的根路径集，请指定“AlternateFileSystemRoots”作为包含多行的单元格数组，其中每行表示一组等效根路径。将单元格数组中的每一行指定为字符串向量或字符向量的单元格数组。例如:

    • 指定“AlternateFileSystemRoots”作为字符串向量的单元格数组。

      {[Z: \“数据集”、“/ mynetwork /数据集”);…[" Y: \数据集”、“/ mynetwork2 /数据集”、“年代:\数据集”)}

    • 另外,指定“AlternateFileSystemRoots”作为字符向量的单元格数组的单元格数组。

      {{“Z: \数据集”、“mynetwork /数据集”},…{“Y: \数据集”,“mynetwork2 /数据集”,年代:\数据集的}}

的价值“AlternateFileSystemRoots”必须满足这些条件:

  • 包含一行或多行，其中每行指定一组等效的根路径。

  • 每行指定多个根路径，每个根路径至少包含两个字符。

  • 根路径是唯一的，并且不是彼此的子文件夹。

  • 包含至少一个指向文件位置的根路径条目。

有关更多信息，请参见为不同机器或集群上的处理设置数据存储．

例子:[" Z: \数据集”、“/ mynetwork /数据集”)

数据类型:字符串|细胞

输出数据类型的文本变量，指定为由逗号分隔的对组成“TextType”,要么“字符”或“字符串”．如果输出表来自读，readall,或预览函数包含文本变量“TextType”指定这些变量的数据类型TabularTextDatastore而且SpreadsheetDatastore只有对象。如果“TextType”是“字符”，则输出为字符向量的单元格数组。如果“TextType”是“字符串”，则输出有type字符串．

数据类型:字符|字符串

类型导入的日期和时间数据，指定为逗号分隔的对，由“DatetimeType”其中一个价值观是:“datetime”或“文本”．的“DatetimeType”参数仅在创建TabularTextDatastore对象。

价值 导入日期和时间数据的类型
“datetime”

MATLABdatetime数据类型

有关更多信息，请参见datetime．
“文本”

如果“DatetimeType”指定为“文本”属性中指定的值，则导入的日期和时间数据的类型取决于“TextType”参数:

  • 如果“TextType”是“字符”，则数据存储返回日期作为字符向量的单元格数组。

  • 如果“TextType”是“字符串”，则数据存储以字符串数组形式返回日期。

例子:“DatetimeType”、“日期时间的

数据类型:字符|字符串

文本文件中持续时间数据的输出数据类型，指定为由逗号分隔的对组成“DurationType”,要么“持续时间”或“文本”．

价值 导入时长数据的类型
“持续时间”

MATLAB持续时间数据类型

有关更多信息，请参见持续时间．
“文本”

如果“DurationType”指定为“文本”属性中指定的值，则导入的持续时间数据的类型取决于“TextType”参数:

  • 如果“TextType”是“字符”，则导入函数将持续时间数据作为字符向量的单元格数组返回。

  • 如果“TextType”是“字符串”，则导入函数以字符串数组的形式返回持续时间数据。

数据类型:字符|字符串|datetime

标记以保留变量名，指定为任意一种“修改”或“保存”．

  • “修改”-转换无效的变量名(由isvarname函数)到有效的MATLAB标识符。

  • “保存”-保留不是有效MATLAB标识符的变量名，例如包含空格和非ascii字符的变量名。

从R2019b开始，变量名和行名可以包含任何字符，包括空格和非ascii字符。此外，他们可以从任何字符开始，而不仅仅是字母。变量名和行名不必是有效的MATLAB标识符(由isvarname功能)。若要保留这些变量名和行名，请设置值VariableNamingRule来“保存”．的值时，变量名不会刷新VariableNamingRule从“修改”来“保存”．

数据类型:字符|字符串

除了这些名称-值对之外，还可以将下列对象的任何属性指定为名称-值对，但是文件属性:

输出参数

全部折叠

数据集合的数据存储，作为以下对象之一返回:TabularTextDatastore，ImageDatastore，SpreadsheetDatastore，KeyValueDatastore，FileDatastore，TallDatastore，ParquetDatastore,或DatabaseDatastore．数据存储的类型取决于文件类型或位置论点。如需详细信息，请单击下表中的数据存储名称。

类型 输出
文本文件 TabularTextDatastore
图像文件 ImageDatastore
电子表格文件 SpreadsheetDatastore
生成的mat文件或序列文件mapreduce KeyValueDatastore
自定义格式文件 FileDatastore
生成的mat文件或序列文件写的功能高数据类型。 TallDatastore
镶花的文件 ParquetDatastore
数据库 DatabaseDatastore(数据库工具箱)

对于这些数据存储类型中的每一种文件属性是字符向量的单元格数组。属性解析的文件的绝对路径位置论点。

版本历史

在R2014b中引入

另请参阅

|||||||||||

主题