spreadsheetDatastore

스프레드시트 파일의 데이터저장소

설명

메모리에 맞지 않을 수 있는 대규모 스프레드시트 파일 모음을 관리하기 위해 spreadsheetDatastore 객체를 사용합니다. spreadsheetDatastore 함수를 사용하여 spreadsheetDatastore 객체를 만들고 그 속성을 지정한 다음, 객체 함수를 사용하여 데이터를 가져올 수 있습니다.

생성

구문

ssds = spreadsheetDatastore(location)

ssds = spreadsheetDatastore(location,Name,Value)

설명

ssds = spreadsheetDatastore(location)은 location으로 지정된 데이터 모음에서 스프레드시트 데이터저장소를 만듭니다.

예제

ssds = spreadsheetDatastore(location,Name,Value)는 하나 이상의 이름-값 인수를 사용하여 ssds에 대한 추가 파라미터와 속성을 지정합니다. 예를 들어, spreadsheetDatastore(location,"FileExtensions",[".xlsx",".xls"])는 파일 확장자에 따라 어떤 파일을 데이터저장소에 포함할지 지정합니다.

입력 인수

모두 확장

`location` — 데이터저장소에 포함할 파일 또는 폴더
`FileSet` 객체 | 파일 경로 | `DsFileSet` 객체

데이터저장소에 포함할 파일 또는 폴더로, FileSet 객체, 파일 경로 또는 DsFileSet 객체로 지정됩니다.

FileSet 객체 — location을 FileSet 객체로 지정할 수 있습니다. 위치를 FileSet 객체로 지정하면 경로나 DsFileSet 객체로 지정하는 경우보다 데이터저장소 생성 시간이 빨라집니다. 자세한 내용은 matlab.io.datastore.FileSet 항목을 참조하십시오.
파일 경로 — 문자형 벡터나 string형 스칼라로 하나의 파일 경로를 지정할 수 있습니다. 여러 개의 파일 경로는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 지정하면 됩니다.
DsFileSet 객체 — DsFileSet 객체를 지정할 수 있습니다. 자세한 내용은 matlab.io.datastore.DsFileSet을 참조하십시오.

파일이나 폴더는 로컬 또는 원격이 될 수 있습니다.

로컬 파일 또는 폴더 — 파일 또는 폴더의 로컬 경로를 지정합니다. 파일이 현재 폴더에 없는 경우 전체 경로나 상대 경로를 지정합니다. 지정된 폴더의 하위 폴더 내에 있는 파일은 데이터저장소에 자동으로 포함되지 않습니다. 로컬 경로를 지정할 때에는 와일드카드 문자(*)를 사용할 수 있습니다. 이 문자는 모든 일치하는 파일 또는 일치하는 폴더의 모든 파일을 데이터저장소에 포함하도록 지정합니다.
원격 파일 또는 폴더 — hdfs:///path_to_file 형식의 URL(Uniform Resource Locator)을 사용하여 원격 파일 또는 폴더의 전체 경로로 지정합니다. 자세한 내용은 원격 데이터로 작업하기 항목을 참조하십시오.

폴더를 지정하면 데이터저장소는 지원되는 파일 형식의 파일만 포함하며 그 외 다른 형식의 파일은 무시합니다. 데이터저장소에 포함할 파일 확장자 목록을 사용자 지정하려면 FileExtensions 속성을 참조하십시오.

spreadsheetDatastore 함수가 지원하는 파일의 확장자는 .xls, .xlsx, .xlsm, .xltx, .xltm입니다.

예: "file1.xlsx"

예: "../dir/data/file1.xlsx"

예: ["C:\dir\data\file1.xlsx","C:\dir\data\file2.xlsx"]

예: "s3://bucketname/path_to_files/*.xls"

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: ssds = spreadsheetDatastore("C:\dir\spreadsheetdata","FileExtensions",[".xls",".xlsm"])

`FileExtensions` — 스프레드시트 파일 확장자
문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

스프레드시트 파일 확장자로, "FileExtensions"와 함께 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 구성된 이름-값 인수로 지정됩니다.

"FileExtensions"를 지정하지 않으면 spreadsheetDatastore는 지정된 경로에서 .xls, .xlsx, .xlsm, .xltx, .xltm 확장자가 있는 모든 파일을 자동으로 포함합니다.
SpreadsheetDatastore에 표준이 아닌 파일 확장자가 있는 스프레드시트를 포함하려면 이러한 확장자를 명시적으로 지정하십시오.
확장자가 없는 파일을 위한 SpreadsheetDatastore를 생성하려면 "FileExtensions"를 빈 문자형 벡터 ''로 지정하십시오.

예: "FileExtensions",''

예: "FileExtensions",".xls"

예: "FileExtensions",[".xlsx",".xlsm"]

데이터형: char | cell | string

`IncludeSubfolders` — 하위 폴더 포함 플래그
`true` 또는 `false` | 0 또는 1

하위 폴더 포함 플래그로, "IncludeSubfolders"와 함께 true, false, 0 또는 1로 구성된 이름-값 인수로 지정됩니다. 각 폴더 내에 있는 모든 파일과 하위 폴더를 포함하려면 true를 지정하고, 각 폴더 내에 있는 파일만 포함하려면 false를 지정하십시오.

"IncludeSubfolders"를 지정하지 않은 경우 디폴트 값은 false입니다.

예: "IncludeSubfolders",true

데이터형: logical | double

`OutputType` — 출력 데이터형
`"auto"` (디폴트 값) | `"table"` | `"timetable"`

출력 데이터형으로, "OutputType"과 함께 다음 값 중 하나로 구성된 이름-값 인수로 지정됩니다.

"auto" — "RowTimes" 이름-값 인수가 지정되었는지 여부에 따라 데이터저장소의 출력값이 table형과 timetable형 중 어느 것이어야 하는지 감지합니다. "RowTimes"를 지정할 경우 출력값은 timetable형이고, 지정하지 않을 경우 출력값은 table형입니다.
"table" — table형을 반환합니다.
"timetable" — timetable형을 반환합니다.

OutputType의 값은 preview, read, readall 함수가 반환하는 데이터형을 결정합니다. 이 옵션을 "RowTimes" 이름-값 쌍과 함께 사용하여 spreadsheetDatastore에서 타임테이블을 반환할 수 있습니다.

예: "OutputType","timetable"

데이터형: char | string

`AlternateFileSystemRoots` — 파일 시스템 루트 경로의 대체 경로
string형 벡터 | 셀형 배열

파일 시스템 루트 경로의 대체 경로로, "AlternateFileSystemRoots"와 함께 string형 벡터 또는 셀형 배열로 구성된 이름-값 인수로 지정됩니다. 로컬 컴퓨터에 데이터저장소를 만들지만 다른 컴퓨터(다른 운영 체제의 컴퓨터일 수 있음)의 데이터에 액세스하고 이를 처리해야 하는 경우 "AlternateFileSystemRoots"를 사용합니다. 또한 Parallel Computing Toolbox™와 MATLAB^® Parallel Server™를 사용하여 데이터를 처리하고, 처리한 데이터를 다른 플랫폼 클라우드 또는 다른 클러스터 컴퓨터에 있는 데이터의 복사본과 함께 로컬 컴퓨터에 저장할 경우 "AlternateFileSystemRoots"를 사용하여 루트 경로를 연결해야 합니다.

실질적으로 서로 동일한 루트 경로들의 집합을 연결하려면 "AlternateFileSystemRoots"를 string형 벡터로 지정하십시오. 예를 들면 다음과 같습니다.
```
["Z:\datasets","/mynetwork/datasets"]
```
데이터저장소에 대한 실질적으로 동일한 여러 루트 경로의 집합을 여러 개 연결하려면 "AlternateFileSystemRoots"를 여러 행이 포함된 셀형 배열로 지정하십시오. 여기서 각 행은 실질적으로 동일한 루트 경로들의 집합 하나를 나타냅니다. 셀형 배열의 각 행을 string형 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정합니다. 예를 들면 다음과 같습니다.
- "AlternateFileSystemRoots"를 string형 벡터로 구성된 셀형 배열로 지정합니다.
```
{["Z:\datasets", "/mynetwork/datasets"];...
 ["Y:\datasets", "/mynetwork2/datasets","S:\datasets"]}
```
- 또는 "AlternateFileSystemRoots"를 문자형 벡터로 구성된 셀형 배열로 지정합니다.
```
{{'Z:\datasets','/mynetwork/datasets'};...
 {'Y:\datasets', '/mynetwork2/datasets','S:\datasets'}}
```

"AlternateFileSystemRoots"의 값은 다음 조건을 충족해야 합니다.

하나 이상의 행을 포함합니다. 여기서 각 행은 실질적으로 동일한 여러 루트 경로를 지정합니다.
각 행은 여러 개의 루트 경로를 지정하고, 각 루트 경로는 적어도 두 개의 문자를 포함해야 합니다.
루트 경로는 고유하며 서로의 하위 폴더가 아닙니다.
파일의 위치를 가리키는 적어도 하나의 루트 경로 항목을 포함합니다.

자세한 내용은 Set Up Datastore for Processing on Different Machines or Clusters 항목을 참조하십시오.

예: ["Z:\datasets","/mynetwork/datasets"]

데이터형: string | cell

`TextType` — 텍스트 변수의 출력 데이터형
`"char"` (디폴트 값) | `"string"`

텍스트 변수의 출력 데이터형으로, "TextType"과 함께 "char"이나 "string"으로 구성된 이름-값 인수로 지정됩니다.

read, readall, preview 함수 중 하나의 출력 테이블에 텍스트 변수가 포함된 경우 "TextType"은 이러한 변수의 데이터형을 지정합니다.
"TextType"이 "char"인 경우 출력값은 문자형 벡터로 구성된 셀형 배열입니다.
"TextType"이 "string"인 경우 출력값은 string형입니다.

데이터형: char | string

이 이름-값 쌍 외에도, 이 페이지의 모든 속성(단, Files 속성은 제외)을 이름-값 쌍으로 지정할 수 있습니다.

속성

모두 확장

SpreadsheetDatastore 속성은 datastore 객체에 있는 파일의 형식을 설명하고, 데이터저장소에서 데이터를 읽는 방식을 제어합니다. Files 속성을 제외하고, datastore 객체를 만들 때 이름-값 쌍 인수를 사용하여 SpreadsheetDatastore 속성의 값을 지정할 수 있습니다. 객체를 만든 후 속성을 보거나 수정하려면 점 표기법을 사용하십시오.

ds = spreadsheetDatastore("airlinesmall_subset.xlsx");
ds.Sheets = [1 2];
ds.Range = "A1:C6";

파일 속성

`Files` — 데이터저장소에 포함된 파일
문자형 벡터로 구성된 셀형 배열 | string형 배열

데이터저장소에 포함된 파일로, 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 확인됩니다. 여기서 각 문자형 벡터 또는 string형은 파일에 대한 전체 경로입니다. spreadsheetDatastore와 datastore 함수의 location 인수는 이러한 파일을 정의합니다.

셀형 배열에 지정된 첫 번째 파일은 데이터저장소의 모든 파일에 대한 변수 이름과 형식 정보를 지정합니다.

예: ["C:\dir\data\file1.xls";"C:\dir\data\file2.xls"]

데이터형: cell | string

`NumHeaderLines` — 건너뛸 라인 수
`0` (디폴트 값) | 양의 정수

읽을 때 각 시트의 시작 부분에서 건너뛸 라인 수로, 양의 정수로 지정됩니다. Range 속성도 지정할 경우, NumHeaderLines는 지정된 데이터 블록의 시작 부분에서 건너뛸 라인 수입니다.

데이터형: double

`Sheets` — 파일 내 시트
`""` (디폴트 값) | 시트 이름 | 시트 인덱스

파일 내 시트로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라, 시트 이름이 포함된 string형 배열 또는 시트 인덱스로 구성된 숫자형 벡터로 지정됩니다. 빈 문자형 벡터 ''는 파일 내의 모든 시트가 포함됨을 나타냅니다.

예: ["sheet1","sheet7"]

예: [3 5 7]

데이터형: char | cell | string | double

`Range` — 행과 열 범위
`""` (디폴트 값) | 문자형 벡터 | string형 스칼라

행과 열 범위로, 시트 내 데이터의 사각형 블록을 정의하는 문자형 벡터 또는 string형 스칼라로 지정됩니다. 빈 문자형 벡터 ''는 범위가 파일의 시작과 데이터의 끝임을 나타냅니다.

예: "B1:T7"

예: "A:C"

데이터형: char | string

`ReadVariableNames` — 변수 이름을 읽을지 여부를 나타내는 표시자
`true` (디폴트 값) | `false` | `1` | `0`

데이터저장소에 있는 첫 번째 파일의 첫 번째 행을 변수 이름으로 읽을지 여부를 나타내는 표시자로, true(1) 또는 false(0)로 지정됩니다.

true인 경우 첫 번째 파일에 있는, 제목이 아닌 첫 번째 행은 데이터에 대한 변수 이름을 지정합니다.
false인 경우 첫 번째 파일에 있는, 제목이 아닌 첫 번째 행은 데이터의 첫 번째 행을 포함합니다. 디폴트 변수 이름은 Var1, Var2 등으로 할당됩니다.

데이터형: logical | double

`VariableNamingRule` — 변수 이름을 유지할지 지정하는 플래그
`"modify"` (디폴트 값) | `"preserve"`

변수 이름을 유지할지 지정하는 플래그로, "modify" 또는 "preserve" 중 하나로 지정됩니다.

"modify" — 유효하지 않은 변수 이름(유효 여부는 isvarname 함수의 판정에 따름)을 유효한 MATLAB 식별자로 변환합니다.
"preserve" — 공백과 비ASCII 문자가 포함된 변수 이름과 같이 MATLAB 식별자로 유효하지 않은 변수 이름을 그대로 유지합니다.

R2019b부터 변수 이름과 행 이름에 공백, 비ASCII 문자 등 모든 문자를 사용할 수 있습니다. 또한 영문자뿐만 아니라 어떤 문자로도 시작할 수 있습니다. 변수 이름과 행 이름은 유효한 MATLAB 식별자(유효 여부는 isvarname 함수의 판정에 따름)가 아니어도 됩니다. 변수 이름과 행 이름을 그대로 유지하려면 VariableNamingRule의 값을 "preserve"로 설정하십시오. VariableNamingRule의 값이 "modify"에서 "preserve"로 변경될 때 변수 이름은 새로 고쳐지지 않습니다.

데이터형: char | string

`VariableNames` — 변수 이름
문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

데이터저장소에 있는 변수 이름으로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 지정됩니다. 파일에 나타나는 순서대로 변수 이름을 지정하십시오. 변수 이름을 지정하지 않으면 데이터저장소가 첫 번째 파일에 있는, 제목이 아닌 첫 번째 라인에서 변수 이름을 감지합니다. VariableNames를 문자형 벡터 또는 string형 스칼라로 지정할 수 있으나, 데이터저장소가 이 속성값을 문자형 벡터로 구성된 셀형 배열로 변환하여 저장합니다. VariableNames 속성을 수정할 경우, 새 변수 이름의 개수는 원본 변수 이름의 개수와 일치해야 합니다.

공백과 비ASCII 문자가 포함된 변수 이름과 같이 유효하지 않은 MATLAB 식별자를 변수 이름으로 사용할 수 있도록 하려면 VariableNamingRule 파라미터의 값을 "preserve"로 설정하십시오.

ReadVariableNames가 false인 경우 VariableNames는 디폴트 값 ["Var1","Var2", ...]로 설정됩니다.

예: ["Time","Date","Quantity"]

데이터형: char | cell | string

`VariableTypes` — 변수 유형
`"double"` | `"char"` | `"string"` | `"categorical"` | `"datetime"`

데이터를 읽을 때 각 변수의 유형을 나타내는 변수 유형으로, "double", "char", "string", "categorical" 또는 "datetime"으로 지정됩니다.

변수 유형의 목록은 VariableNames에 있는 변수에 대응합니다. 유형 double, char, datetime은 데이터에서 자동으로 검색될 수 있습니다. VariableTypes를 문자형 벡터 또는 string형 스칼라로 지정할 수 있으나, spreadsheetDatastore에서 자동으로 이를 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 변환합니다.

예: ["char","categorical"]

데이터형: char | cell | string

`preview`, `read`, `readall` 테이블에 대한 속성

`SelectedVariableNames` — 읽을 변수
문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

파일에서 읽을 변수로, 문자형 벡터, 문자형 벡터로 구성된 셀형 배열, string형 스칼라 또는 string형 배열로 지정됩니다. 각 문자형 벡터 또는 string형에는 변수 하나의 이름이 포함됩니다. 변수 이름은 임의의 순서로 지정할 수 있습니다. SelectedVariableNames를 문자형 벡터 또는 string형 스칼라로 지정할 수 있으나, spreadsheetDatastore에서 자동으로 이를 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 변환합니다.

예: ["Var3","Var7","Var4"]

데이터형: char | cell | string

`SelectedVariableTypes` — 선택된 변수 유형
`"double"` | `"char"` | `"string"` | `"categorical"` | `"datetime"`

데이터를 읽을 때 선택된 각 변수의 유형을 나타내는 선택된 변수 유형으로, "double", "char", "string", "categorical" 또는 "datetime"으로 지정됩니다. 변수 유형의 목록은 SelectedVariableNames에 있는 변수에 대응합니다. 유형 double, char, datetime은 데이터에서 자동으로 검색될 수 있습니다. SelectedVariableTypes를 문자형 벡터 또는 string형 스칼라로 지정할 수 있으나, 이는 문자형 벡터로 구성된 셀형 배열 또는 string형 배열로 자동 변환됩니다.

예: ["double","datetime"]

데이터형: char | cell | string

`ReadSize` — 읽을 데이터의 양
`"file"` (디폴트 값) | `"sheet"` | 양의 정수 스칼라

read 함수 호출 시 읽을 데이터의 양으로, "file"이나 "sheet" 또는 양의 정수 스칼라로 지정됩니다.

ReadSize가 "file"이면 read를 호출할 때마다 한 번에 한 파일의 모든 데이터를 읽습니다.
ReadSize가 "sheet"이면 read를 호출할 때마다 한 번에 한 시트의 모든 데이터를 읽습니다.
ReadSize가 양의 정수이면 read를 호출할 때마다 ReadSize로 지정한 만큼의 행을 읽습니다. 또는 데이터의 끝에 도달할 경우 더 적은 행을 읽습니다.

ReadSize를 정수 스칼라에서 "file" 또는 "sheet"로 변경하거나 이와 반대로 변경할 경우, 데이터저장소는 reset 함수를 사용하여 재설정됩니다.

데이터형: char | string | double

`RowTimes` — 행 시간값 변수의 이름
변수 이름 | 변수 인덱스

행 시간값 변수의 이름으로, "RowTimes"와 함께 변수 이름(예: "Date") 또는 변수 인덱스(예: 3)로 구성된 이름-값 인수로 지정됩니다.

RowTimes는 타임테이블 관련 파라미터입니다. 타임테이블의 각 행에는 연관된 시간이 있으며, 이 시간은 타임테이블의 시간 벡터에 캡처됩니다. RowTimes에 지정된 변수는 datetime 또는 duration 벡터를 포함해야 합니다.

"OutputType"의 값이 "timetable"인데 "RowTimes"를 지정하지 않은 경우, spreadsheetDatastore 객체는 첫 번째 datetime형 또는 duration형 변수를 타임테이블의 행 시간값으로 사용합니다.

`writeall`이 사용하는 속성

`Folders` — 데이터저장소를 생성하는 데 사용된 폴더
문자형 벡터로 구성된 셀형 배열

읽기 전용 속성입니다.

데이터저장소를 생성하는 데 사용된 폴더로, 문자형 벡터로 구성된 셀형 배열로 반환됩니다. 셀형 배열은 열 벡터로 방향이 설정됩니다. 각 문자형 벡터는 데이터 파일을 포함하는 폴더의 경로입니다. 데이터저장소를 만들 때 spreadsheetDatastore 함수와 datastore 함수에 지정되는 location 인수에 따라 Folders가 정의됩니다.

SpreadsheetDatastore 객체의 Files 속성을 수정하면 Folders 속성이 재설정됩니다.

데이터형: cell

`SupportedOutputFormats` — 쓰기가 지원되는 형식
string형 행 벡터

읽기 전용 속성입니다.

쓰기가 지원되는 형식으로, string형으로 구성된 행 벡터로 반환됩니다. 이 속성은 writeall을 사용하여 데이터저장소에서 출력 파일을 쓸 때 가능한 출력 형식을 지정합니다.

`DefaultOutputFormat` — 디폴트 출력 형식
string형 스칼라

읽기 전용 속성입니다.

디폴트 출력 형식으로, string형 스칼라로 반환됩니다. 이 속성은 writeall을 사용하여 데이터저장소에서 출력 파일을 쓸 때의 디폴트 형식을 지정합니다.

데이터형: string

객체 함수

`hasdata`	데이터를 읽을 수 있는지 확인
`numpartitions`	데이터저장소 파티션 개수
`partition`	데이터저장소 파티셔닝
`preview`	데이터저장소에 있는 데이터의 서브셋 미리보기
`read`	데이터저장소의 데이터 읽어 들이기
`readall`	데이터저장소의 모든 데이터 읽기
`writeall`	Write datastore to files
`reset`	데이터저장소를 초기 상태로 재설정
`sheetnames`	데이터저장소에서 시트 이름 쿼리
`transform`	데이터저장소 변환
`combine`	여러 데이터저장소의 데이터 결합
`isPartitionable`	Determine whether datastore is partitionable
`isSubsettable`	Determine whether datastore is subsettable
`isShuffleable`	Determine whether datastore is shuffleable

예제

모두 축소

SpreadsheetDatastore 객체 만들기

FileSet 객체 또는 파일 경로를 사용하여 spreadsheetDatastore 객체를 만듭니다.

FileSet 객체를 만듭니다. spreadsheetDatastore 객체를 만듭니다.

fs = matlab.io.datastore.FileSet("airlinesmall_subset.xlsx");
ssds = spreadsheetDatastore(fs)

ssds = 
  SpreadsheetDatastore with properties:

                      Files: {
                             ' ...\Documents\MATLAB\Examples\airlinesmall_subset.xlsx'
                             }
                    Folders: {
                             ' ...\Documents\MATLAB\Examples'
                             }
   AlternateFileSystemRoots: {}
                     Sheets: ''
                      Range: ''

  Sheet Format Properties:
             NumHeaderLines: 0
         VariableNamingRule: 'modify'
          ReadVariableNames: true
              VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableTypes: {'double', 'double', 'double' ... and 26 more}

  Properties that control the table returned by preview, read, readall:
      SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
      SelectedVariableTypes: {'double', 'double', 'double' ... and 26 more}
                   ReadSize: 'file'
                 OutputType: 'table'
                   RowTimes: []

  Write-specific Properties:
     SupportedOutputFormats: ["txt"    "csv"    "xlsx"    "xls"    "parquet"    "parq"]
        DefaultOutputFormat: "xlsx"

또는 파일 경로로 데이터를 지정할 수도 있습니다.

ssds = spreadsheetDatastore("airlinesmall_subset.xlsx");

스프레드시트 파일 읽어 들이기

파일 airlinesmall_subset.xlsx를 포함하는 SpreadsheetDatastore 객체를 만듭니다.

ssds = spreadsheetDatastore("airlinesmall_subset.xlsx")

ssds = 
  SpreadsheetDatastore with properties:

                      Files: {
                             ' ...\Documents\MATLAB\Examples\airlinesmall_subset.xlsx'
                             }
                    Folders: {
                             ' ...\Documents\MATLAB\Examples'
                             }
   AlternateFileSystemRoots: {}
                     Sheets: ''
                      Range: ''

  Sheet Format Properties:
             NumHeaderLines: 0
         VariableNamingRule: 'modify'
          ReadVariableNames: true
              VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableTypes: {'double', 'double', 'double' ... and 26 more}

  Properties that control the table returned by preview, read, readall:
      SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
      SelectedVariableTypes: {'double', 'double', 'double' ... and 26 more}
                   ReadSize: 'file'
                 OutputType: 'table'
                   RowTimes: []

  Write-specific Properties:
     SupportedOutputFormats: ["txt"    "csv"    "xlsx"    "xls"    "parquet"    "parq"]
        DefaultOutputFormat: "xlsx"

파일의 시트 이름을 표시합니다. 이 파일에는 연도당 하나의 시트가 포함되어 있습니다.

sheetnames(ssds,1)

ans = 13x1 string
    "1996"
    "1997"
    "1998"
    "1999"
    "2000"
    "2001"
    "2002"
    "2003"
    "2004"
    "2005"
    "2006"
    "2007"
    "2008"

두 번째 시트에서 원하는 데이터로 변수 FlightNum을 지정하고 처음 8개 행을 미리 봅니다.

ssds.Sheets = 2; 
ssds.SelectedVariableNames = "FlightNum";
preview(ssds)

ans=8×1 table
    FlightNum
    _________

      1014   
      1201   
       702   
      1184   
      1310   
      1759   
      1242   
      1558

첫 번째 시트에서 변수 DepTime과 ArrTime에 대한 처음 3개 행만 읽습니다.

ssds.ReadSize = 3;
ssds.Sheets = 1;
ssds.SelectedVariableNames = ["DepTime","ArrTime"];
read(ssds)

ans=3×2 table
    DepTime    ArrTime
    _______    _______

     2117       2305  
     1252       1511  
     1441       1708

시트 4, 5, 6에 대해서는 모든 행을 읽습니다.

ssds.Sheets = 4:6;
readall(ssds);

스프레드시트 데이터저장소에서 타임테이블 반환하기

라이브 스크립트 열기

OutputType 및 RowTimes 이름-값 쌍을 사용하여 SpreadsheetDatastore가 테이블 대신 타임테이블을 반환하도록 만듭니다.

tsunamis_dated.xlsx에 대해 데이터저장소를 만듭니다. SpreadsheetDatastore가 테이블 대신 타임테이블을 반환하도록 "OutputType"을 "timetable"로 지정합니다.

ssds = spreadsheetDatastore("tsunamis_dated.xlsx","OutputType","timetable");
preview(ssds)

ans=8×15 timetable
       Date        Latitude    Longitude    ValidityCode          Validity          CauseCode               Cause                EarthquakeMagnitude       Country                 Location              MaxHeight    IidaMagnitude    Intensity    NumDeaths    DescDeaths              Time          
    ___________    ________    _________    ____________    ____________________    _________    ____________________________    ___________________    _____________    ____________________________    _________    _____________    _________    _________    __________    ________________________

    04-Mar-1952     42.15        143.85          4          {'definite tsunami'}        1        {'Earthquake'              }            8.1            {'JAPAN'    }    {'SE. HOKKAIDO ISLAND'     }        6.5           2.7              2           33           1         04-Mar-1952 01:22:41.000
    10-Jul-1958     58.34       -136.52          4          {'definite tsunami'}        3        {'Earthquake and Landslide'}            8.3            {'USA'      }    {'SE. ALASKA, AK'          }     524.26           4.6              5            5           1         10-Jul-1958 06:15:53.600
    22-May-1960     -39.5         -74.5          4          {'definite tsunami'}        1        {'Earthquake'              }            9.5            {'CHILE'    }    {'CENTRAL CHILE'           }         25           4.6              4         1260           3         22-May-1960 19:11:17.000
    20-Nov-1960      -6.8         -80.7          4          {'definite tsunami'}        1        {'Earthquake'              }            6.8            {'PERU'     }    {'PERU'                    }          9           3.2            2.5           66           2         20-Nov-1960 22:01:56.400
    28-Mar-1964      61.1        -147.5          4          {'definite tsunami'}        3        {'Earthquake and Landslide'}            9.2            {'USA'      }    {'PRINCE WILLIAM SOUND, AK'}         67           6.1              5          221           3         28-Mar-1964 03:36:14.000
    16-Jun-1964     38.65         139.2          4          {'definite tsunami'}        1        {'Earthquake'              }            7.5            {'JAPAN'    }    {'NW. HONSHU ISLAND'       }        5.8           2.7              2           26           1         16-Jun-1964 04:01:44.300
    14-Aug-1968       0.2         119.8          4          {'definite tsunami'}        1        {'Earthquake'              }            7.8            {'INDONESIA'}    {'BANDA SEA'               }         10           3.3              3          200           3         14-Aug-1968 22:14:19.400
    23-Feb-1969      -3.1         118.9          4          {'definite tsunami'}        1        {'Earthquake'              }            6.9            {'INDONESIA'}    {'MAKASSAR STRAIT'         }          4             2              2          600           3         23-Feb-1969 00:36:56.600

"RowTimes"를 지정하지 않을 경우 spreadsheetDatastore는 첫 번째 datetime형 또는 duration형 변수를 행 시간값으로 사용합니다. 여기서는 Date 변수가 행 시간값으로 사용됩니다. 이 데이터에는 두 개의 datetime형 변수 Date와 Time이 있습니다. Date 변수는 시간, 분, 초에 대한 정보를 포함하지 않는 반면 Time 변수는 각 이벤트의 구체적인 시간을 포함합니다.

이벤트 시간(Time 변수)을 행 시간값으로 사용하도록 "RowTimes" 옵션을 지정합니다.

ssds = spreadsheetDatastore("tsunamis_dated.xlsx","OutputType","timetable","RowTimes","Time");
preview(ssds)

ans=8×15 timetable
              Time              Latitude    Longitude    ValidityCode          Validity          CauseCode               Cause                EarthquakeMagnitude       Country                 Location              MaxHeight    IidaMagnitude    Intensity    NumDeaths    DescDeaths       Date    
    ________________________    ________    _________    ____________    ____________________    _________    ____________________________    ___________________    _____________    ____________________________    _________    _____________    _________    _________    __________    ___________

    04-Mar-1952 01:22:41.000     42.15        143.85          4          {'definite tsunami'}        1        {'Earthquake'              }            8.1            {'JAPAN'    }    {'SE. HOKKAIDO ISLAND'     }        6.5           2.7              2           33           1         04-Mar-1952
    10-Jul-1958 06:15:53.600     58.34       -136.52          4          {'definite tsunami'}        3        {'Earthquake and Landslide'}            8.3            {'USA'      }    {'SE. ALASKA, AK'          }     524.26           4.6              5            5           1         10-Jul-1958
    22-May-1960 19:11:17.000     -39.5         -74.5          4          {'definite tsunami'}        1        {'Earthquake'              }            9.5            {'CHILE'    }    {'CENTRAL CHILE'           }         25           4.6              4         1260           3         22-May-1960
    20-Nov-1960 22:01:56.400      -6.8         -80.7          4          {'definite tsunami'}        1        {'Earthquake'              }            6.8            {'PERU'     }    {'PERU'                    }          9           3.2            2.5           66           2         20-Nov-1960
    28-Mar-1964 03:36:14.000      61.1        -147.5          4          {'definite tsunami'}        3        {'Earthquake and Landslide'}            9.2            {'USA'      }    {'PRINCE WILLIAM SOUND, AK'}         67           6.1              5          221           3         28-Mar-1964
    16-Jun-1964 04:01:44.300     38.65         139.2          4          {'definite tsunami'}        1        {'Earthquake'              }            7.5            {'JAPAN'    }    {'NW. HONSHU ISLAND'       }        5.8           2.7              2           26           1         16-Jun-1964
    14-Aug-1968 22:14:19.400       0.2         119.8          4          {'definite tsunami'}        1        {'Earthquake'              }            7.8            {'INDONESIA'}    {'BANDA SEA'               }         10           3.3              3          200           3         14-Aug-1968
    23-Feb-1969 00:36:56.600      -3.1         118.9          4          {'definite tsunami'}        1        {'Earthquake'              }            6.9            {'INDONESIA'}    {'MAKASSAR STRAIT'         }          4             2              2          600           3         23-Feb-1969

버전 내역

R2016a에 개발됨

참고 항목

mapreduce | tall | readtable

spreadsheetDatastore

설명

생성

구문

설명

입력 인수

location — 데이터저장소에 포함할 파일 또는 폴더 FileSet 객체 | 파일 경로 | DsFileSet 객체

FileExtensions — 스프레드시트 파일 확장자 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

IncludeSubfolders — 하위 폴더 포함 플래그 true 또는 false | 0 또는 1

OutputType — 출력 데이터형 "auto" (디폴트 값) | "table" | "timetable"

AlternateFileSystemRoots — 파일 시스템 루트 경로의 대체 경로 string형 벡터 | 셀형 배열

TextType — 텍스트 변수의 출력 데이터형 "char" (디폴트 값) | "string"

속성

파일 속성

Files — 데이터저장소에 포함된 파일 문자형 벡터로 구성된 셀형 배열 | string형 배열

NumHeaderLines — 건너뛸 라인 수 0 (디폴트 값) | 양의 정수

Sheets — 파일 내 시트 "" (디폴트 값) | 시트 이름 | 시트 인덱스

Range — 행과 열 범위 "" (디폴트 값) | 문자형 벡터 | string형 스칼라

ReadVariableNames — 변수 이름을 읽을지 여부를 나타내는 표시자 true (디폴트 값) | false | 1 | 0

VariableNamingRule — 변수 이름을 유지할지 지정하는 플래그 "modify" (디폴트 값) | "preserve"

VariableNames — 변수 이름 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

VariableTypes — 변수 유형 "double" | "char" | "string" | "categorical" | "datetime"

preview, read, readall 테이블에 대한 속성

SelectedVariableNames — 읽을 변수 문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

SelectedVariableTypes — 선택된 변수 유형 "double" | "char" | "string" | "categorical" | "datetime"

ReadSize — 읽을 데이터의 양 "file" (디폴트 값) | "sheet" | 양의 정수 스칼라

RowTimes — 행 시간값 변수의 이름 변수 이름 | 변수 인덱스

writeall이 사용하는 속성

Folders — 데이터저장소를 생성하는 데 사용된 폴더 문자형 벡터로 구성된 셀형 배열

SupportedOutputFormats — 쓰기가 지원되는 형식 string형 행 벡터

DefaultOutputFormat — 디폴트 출력 형식 string형 스칼라

객체 함수

예제

SpreadsheetDatastore 객체 만들기

스프레드시트 파일 읽어 들이기

스프레드시트 데이터저장소에서 타임테이블 반환하기

버전 내역

참고 항목

도움말 항목

`location` — 데이터저장소에 포함할 파일 또는 폴더
`FileSet` 객체 | 파일 경로 | `DsFileSet` 객체

`FileExtensions` — 스프레드시트 파일 확장자
문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

`IncludeSubfolders` — 하위 폴더 포함 플래그
`true` 또는 `false` | 0 또는 1

`OutputType` — 출력 데이터형
`"auto"` (디폴트 값) | `"table"` | `"timetable"`

`AlternateFileSystemRoots` — 파일 시스템 루트 경로의 대체 경로
string형 벡터 | 셀형 배열

`TextType` — 텍스트 변수의 출력 데이터형
`"char"` (디폴트 값) | `"string"`

`Files` — 데이터저장소에 포함된 파일
문자형 벡터로 구성된 셀형 배열 | string형 배열

`NumHeaderLines` — 건너뛸 라인 수
`0` (디폴트 값) | 양의 정수

`Sheets` — 파일 내 시트
`""` (디폴트 값) | 시트 이름 | 시트 인덱스

`Range` — 행과 열 범위
`""` (디폴트 값) | 문자형 벡터 | string형 스칼라

`ReadVariableNames` — 변수 이름을 읽을지 여부를 나타내는 표시자
`true` (디폴트 값) | `false` | `1` | `0`

`VariableNamingRule` — 변수 이름을 유지할지 지정하는 플래그
`"modify"` (디폴트 값) | `"preserve"`

`VariableNames` — 변수 이름
문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

`VariableTypes` — 변수 유형
`"double"` | `"char"` | `"string"` | `"categorical"` | `"datetime"`

`preview`, `read`, `readall` 테이블에 대한 속성

`SelectedVariableNames` — 읽을 변수
문자형 벡터 | 문자형 벡터로 구성된 셀형 배열 | string형 스칼라 | string형 배열

`SelectedVariableTypes` — 선택된 변수 유형
`"double"` | `"char"` | `"string"` | `"categorical"` | `"datetime"`

`ReadSize` — 읽을 데이터의 양
`"file"` (디폴트 값) | `"sheet"` | 양의 정수 스칼라

`RowTimes` — 행 시간값 변수의 이름
변수 이름 | 변수 인덱스

`writeall`이 사용하는 속성

`Folders` — 데이터저장소를 생성하는 데 사용된 폴더
문자형 벡터로 구성된 셀형 배열

`SupportedOutputFormats` — 쓰기가 지원되는 형식
string형 행 벡터

`DefaultOutputFormat` — 디폴트 출력 형식
string형 스칼라