Настройте настройки импорта для данных о базе данных
opts = setoptions(opts,varnames,Option1,OptionValue1,...,OptionN,OptionValueN)opts = setoptions(opts,index,Option1,OptionValue1,...,OptionN,OptionValueN) настраивает настройки импорта для того, чтобы импортировать данные от базы данных в MATLAB®. Функция возвращает объект opts = setoptions(opts,varnames,Option1,OptionValue1,...,OptionN,OptionValueN)SQLImportOptions. Чтобы импортировать данные, вы используете объект SQLImportOptions, заданные имена переменных и настройки импорта с их соответствующими значениями.
настраивает настройки импорта для переменных, заданных числовым индексом.opts = setoptions(opts,index,Option1,OptionValue1,...,OptionN,OptionValueN)
Настройте настройки импорта при импортировании числовых данных от таблицы базы данных. Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем настройте настройки импорта для числового столбца базы данных. Импортируйте данные с помощью функции sqlread .
Этот пример использует электронную таблицу patients.xls , которая содержит столбец Weight. Кроме того, пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Драйвер Microsoft SQL Server 11.00.5058.
Создайте соединение с базой данных к базе данных Microsoft SQL Server с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.
datasource = 'MS SQL Server Auth'; conn = database(datasource,'','');
Загрузите терпеливую информацию в рабочую область MATLAB®.
patients = readtable('patients.xls');Создайте таблицу базы данных patients с помощью терпеливой информации.
tablename = 'patients';
sqlwrite(conn,tablename,patients)Создайте объект SQLImportOptions с помощью таблицы базы данных patients и функции databaseImportOptions.
opts = databaseImportOptions(conn,tablename);
Настройте настройки импорта для столбца Weight в таблице базы данных patients. Поскольку этот столбец является числовым, измените тип данных на int64.
varnames = 'Weight'; opts = setoptions(opts,varnames,'Type','int64');
Импортируйте числовые данные в заданном столбце и отобразите сводные данные импортированной переменной. Сводные данные показывают, что переменная имеет тип данных int64.
opts.SelectedVariableNames = {'Weight'};
data = sqlread(conn,tablename,opts);
summary(data)Variables:
Weight: 100×1 int64
Values:
Min 111
Median 143
Max 202
Удалите таблицу базы данных patients с помощью функции execute.
sqlquery = ['DROP TABLE ' tablename];
execute(conn,sqlquery)Закройте соединение с базой данных.
close(conn)
Настройте настройки импорта при импортировании текстовых данных от таблицы базы данных. Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем настройте настройки импорта для столбца базы текстовых данных. Импортируйте данные с помощью функции sqlread .
Этот пример использует электронную таблицу patients.xls, которая содержит первый столбец LastName. Кроме того, пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Драйвер Microsoft SQL Server 11.00.5058.
Создайте соединение с базой данных к базе данных Microsoft SQL Server с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.
datasource = "MS SQL Server Auth"; conn = database(datasource,"","");
Загрузите терпеливую информацию в рабочую область MATLAB®.
patients = readtable("patients.xls");Создайте таблицу базы данных patients с помощью терпеливой информации.
tablename = "patients";
sqlwrite(conn,tablename,patients)Создайте объект SQLImportOptions с помощью таблицы базы данных patients и функции databaseImportOptions.
opts = databaseImportOptions(conn,tablename);
Получите настройки импорта по умолчанию для переменных LastName и SelfAssessedHealthStatus.
varnames = ["LastName" "SelfAssessedHealthStatus"]; varOpts = getoptions(opts,varnames)
varOpts =
1x2 SQLVariableImportOptions array with properties:
Variable Options:
(1) | (2)
Name: 'LastName' | 'SelfAssessedHealthStatus'
Type: 'char' | 'char'
MissingRule: 'fill' | 'fill'
FillValue: '' | ''
To access sub-properties of each variable, use getoptions
Установите настройки импорта для типа данных переменной LastName к string. Задайте переменную LastName при помощи числового индекса, который находит переменную в свойстве SelectedVariables объекта SQLImportOptions. Кроме того, установите настройки импорта заменять недостающие данные в переменной LastName со значением заливки NoName.
index = 1; opts = setoptions(opts,index,'Type',"string", ... 'FillValue',"NoName");
Установите настройки импорта для текстового случая переменной SelfAssessedHealthStatus к верхнему регистру.
varname = "SelfAssessedHealthStatus"; opts = setoptions(opts,varname,'TextCaseRule',"upper");
Импортируйте текстовые данные в выбранных переменных и отобразите первые восемь строк. Импортированные данные показывают, что переменная LastName имеет тип данных string, и текст переменной SelfAssessedHealthStatus является прописным.
opts.SelectedVariableNames = ["LastName" "SelfAssessedHealthStatus"]; T = sqlread(conn,tablename,opts); head(T)
ans=8×2 table
LastName SelfAssessedHealthStatus
__________ ________________________
"Smith" 'EXCELLENT'
"Johnson" 'FAIR'
"Williams" 'GOOD'
"Jones" 'FAIR'
"Brown" 'GOOD'
"Davis" 'GOOD'
"Miller" 'GOOD'
"Wilson" 'GOOD'
Удалите таблицу базы данных patients с помощью функции execute.
sqlstr = "DROP TABLE ";
sqlquery = strcat(sqlstr,tablename);
execute(conn,sqlquery)Закройте соединение с базой данных.
close(conn)
Настройте настройки импорта при импортировании данных о дате и времени от таблицы базы данных. Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем настройте настройки импорта для столбцов базы данных, которые содержат данные о дате и времени. Импортируйте данные с помощью функции sqlread .
Этот пример использует файл outages.csv , который содержит столбцы OutageTime и RestorationTime. Кроме того, пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Драйвер Microsoft SQL Server 11.00.5058.
Создайте соединение с базой данных к базе данных Microsoft SQL Server с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.
datasource = 'MS SQL Server Auth'; conn = database(datasource,'','');
Загрузите информацию об отключении электричества в рабочую область MATLAB®.
outages = readtable('outages.csv');Создайте таблицу базы данных outages с помощью информации об отключении электричества.
tablename = 'outages';
sqlwrite(conn,tablename,outages)Получите данные с помощью sqlread, функционируют и отображают первые восемь строк. Вторая строка переменной RestorationTime содержит недостающие данные.
data = sqlread(conn,tablename); head(data)
ans=8×6 table
Region OutageTime Loss Customers RestorationTime Cause
___________ _________________________ ______ __________ _________________________ _________________
'SouthWest' '2002-02-01 12:18:00.000' 458.98 1.8202e+06 '2002-02-07 16:50:00.000' 'winter storm'
'SouthEast' '2003-01-23 00:49:00.000' 530.14 2.1204e+05 '' 'winter storm'
'SouthEast' '2003-02-07 21:15:00.000' 289.4 1.4294e+05 '2003-02-17 08:14:00.000' 'winter storm'
'West' '2004-04-06 05:44:00.000' 434.81 3.4037e+05 '2004-04-06 06:10:00.000' 'equipment fault'
'MidWest' '2002-03-16 06:18:00.000' 186.44 2.1275e+05 '2002-03-18 23:23:00.000' 'severe storm'
'West' '2003-06-18 02:49:00.000' 0 0 '2003-06-18 10:54:00.000' 'attack'
'West' '2004-06-20 14:39:00.000' 231.29 NaN '2004-06-20 19:16:00.000' 'equipment fault'
'West' '2002-06-06 19:28:00.000' 311.86 NaN '2002-06-07 00:51:00.000' 'equipment fault'
Создайте объект SQLImportOptions с помощью таблицы базы данных outages и функции databaseImportOptions.
opts = databaseImportOptions(conn,tablename);
Получите настройки импорта по умолчанию для переменных OutageTime и RestorationTime .
varnames = {'OutageTime','RestorationTime'};
varOpts = getoptions(opts,varnames)varOpts =
1x2 SQLVariableImportOptions array with properties:
Variable Options:
(1) | (2)
Name: 'OutageTime' | 'RestorationTime'
Type: 'char' | 'char'
FillValue: '' | ''
To access sub-properties of each variable, use getoptions
Установите настройки импорта для типа данных заданных переменных к datetime. Кроме того, установите настройки импорта заменять недостающие данные в заданных переменных с текущей датой и время.
opts = setoptions(opts,varnames,'Type','datetime', ... 'FillValue',datetime('now'));
Импортируйте данные о дате и времени в выбранных переменных и отобразите первые восемь строк. Импортированные данные показывают, что переменные имеют тип данных datetime. Отсутствующее значение во второй строке переменной RestorationTime заполнено текущей датой и время.
opts.SelectedVariableNames = varnames; T = sqlread(conn,tablename,opts); head(T)
ans=8×2 table
OutageTime RestorationTime
____________________ ____________________
01-Feb-2002 12:18:00 07-Feb-2002 16:50:00
23-Jan-2003 00:49:00 19-Jun-2018 15:30:14
07-Feb-2003 21:15:00 17-Feb-2003 08:14:00
06-Apr-2004 05:44:00 06-Apr-2004 06:10:00
16-Mar-2002 06:18:00 18-Mar-2002 23:23:00
18-Jun-2003 02:49:00 18-Jun-2003 10:54:00
20-Jun-2004 14:39:00 20-Jun-2004 19:16:00
06-Jun-2002 19:28:00 07-Jun-2002 00:51:00
Удалите таблицу базы данных outages с помощью функции execute.
sqlquery = ['DROP TABLE ' tablename];
execute(conn,sqlquery)Закройте соединение с базой данных.
close(conn)
Настройте настройки импорта при импортировании данных о категориальном массиве от таблицы базы данных. Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем настройте настройки импорта для столбцов базы данных, которые содержат данные о категориальном массиве. Импортируйте данные с помощью функции sqlread .
Этот пример использует файл outages.csv , который содержит столбцы Region и Cause. Кроме того, пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Драйвер Microsoft SQL Server 11.00.5058.
Создайте соединение с базой данных к базе данных Microsoft SQL Server с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.
datasource = 'MS SQL Server Auth'; conn = database(datasource,'','');
Загрузите информацию об отключении электричества в рабочую область MATLAB®.
outages = readtable('outages.csv');Создайте таблицу базы данных outages с помощью информации об отключении электричества.
tablename = 'outages';
sqlwrite(conn,tablename,outages)Создайте объект SQLImportOptions с помощью таблицы базы данных outages и функции databaseImportOptions.
opts = databaseImportOptions(conn,tablename);
Получите настройки импорта по умолчанию для переменных Region и Cause .
varnames = {'Region','Cause'};
varOpts = getoptions(opts,varnames)varOpts =
1x2 SQLVariableImportOptions array with properties:
Variable Options:
(1) | (2)
Name: 'Region' | 'Cause'
Type: 'char' | 'char'
FillValue: '' | ''
To access sub-properties of each variable, use getoptions
Установите настройки импорта для типа данных заданных переменных к categorical. Кроме того, установите настройки импорта заменять недостающие данные в заданных переменных со значением заливки unknown.
opts = setoptions(opts,varnames,'Type','categorical', ... 'FillValue','unknown');
Импортируйте данные о категориальном массиве в выбранных переменных и отобразите сводные данные данных. Импортированные данные показывают, что переменные имеют тип данных categorical. Отсутствующие значения обеих переменных заполнены значением unknown.
opts.SelectedVariableNames = varnames; T = sqlread(conn,tablename,opts); summary(T)
Variables:
Region: 1468×1 categorical
Values:
MidWest 142
NorthEast 557
SouthEast 389
SouthWest 26
West 354
unknown 0
Cause: 1468×1 categorical
Values:
attack 294
earthquake 2
energy emergency 188
equipment fault 156
fire 25
severe storm 338
thunder storm 201
unknown 24
wind 95
winter storm 145
Удалите таблицу базы данных outages с помощью функции execute.
sqlquery = ['DROP TABLE ' tablename];
execute(conn,sqlquery)Закройте соединение с базой данных.
close(conn)
Настройте настройки импорта при импортировании логических данных от таблицы базы данных. Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем настройте настройки импорта для столбцов базы данных, которые содержат логические данные. Импортируйте данные с помощью функции sqlread .
Этот пример использует электронную таблицу airlinesmall_subset.xls , которая содержит столбец Cancelled. Кроме того, пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Драйвер Microsoft SQL Server 11.00.5058.
Создайте соединение с базой данных к базе данных Microsoft SQL Server с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.
datasource = 'MS SQL Server Auth'; conn = database(datasource,'','');
Загрузите информацию о рейсе в рабочей области MATLAB®.
flights = readtable('airlinesmall_subset.xlsx');Создайте таблицу базы данных flights с помощью информации о рейсе.
tablename = 'flights';
sqlwrite(conn,tablename,flights)Создайте объект SQLImportOptions с помощью таблицы базы данных flights и функции databaseImportOptions.
opts = databaseImportOptions(conn,'flights');Получите настройки импорта по умолчанию для переменной Cancelled .
varnames = 'Cancelled';
varOpts = getoptions(opts,varnames)varOpts =
SQLVariableImportOptions with properties:
Variable Properties :
Name: 'Cancelled'
Type: 'double'
FillValue: NaN
Установите настройки импорта для типа данных заданной переменной к logical. Кроме того, установите настройки импорта заменять недостающие данные в заданной переменной со значением заливки true.
opts = setoptions(opts,varnames,'Type','logical', ... 'FillValue',true);
Импортируйте логические данные в выбранной переменной и отобразите сводные данные данных. Импортированные данные показывают, что переменная имеет тип данных logical.
opts.SelectedVariableNames = varnames; T = sqlread(conn,tablename,opts); summary(T)
Variables:
Cancelled: 1338×1 logical
Values:
True 29
False 1309
Удалите таблицу базы данных flights с помощью функции execute.
sqlquery = 'DROP TABLE flights';
execute(conn,sqlquery)Закройте соединение с базой данных.
close(conn)
Настройте настройки импорта при импортировании данных от таблицы базы данных. Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем настройте настройки импорта, чтобы не использовать недостающие данные. Импортируйте данные с помощью функции sqlread.
Этот пример использует файл outages.csv, который содержит данные об отключении электричества. Кроме того, пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Драйвер Microsoft SQL Server 11.00.5058.
Создайте соединение с базой данных к базе данных Microsoft SQL Server с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.
datasource = "MS SQL Server Auth"; conn = database(datasource,"","");
Загрузите информацию об отключении электричества в рабочую область MATLAB®.
outages = readtable("outages.csv");Создайте таблицу базы данных outages с помощью информации об отключении электричества.
tablename = "outages";
sqlwrite(conn,tablename,outages)Создайте объект SQLImportOptions с помощью таблицы базы данных outages и функции databaseImportOptions.
opts = databaseImportOptions(conn,tablename);
Определите размер outages.
size(outages)
ans = 1×2
1468 6
Установите настройки импорта не использовать строки, которые имеют недостающие данные в переменной Customers.
varnames = "Customers"; opts = setoptions(opts,varnames,'MissingRule',"omitrow");
Импортируйте данные и отобразите первые восемь строк. Импортированные данные не содержат недостающих данных в переменной Customers.
T = sqlread(conn,tablename,opts); head(T)
ans=8×6 table
Region OutageTime Loss Customers RestorationTime Cause
___________ _________________________ ______ __________ _________________________ _________________
'SouthWest' '2002-02-01 12:18:00.000' 458.98 1.8202e+06 '2002-02-07 16:50:00.000' 'winter storm'
'SouthEast' '2003-01-23 00:49:00.000' 530.14 2.1204e+05 '' 'winter storm'
'SouthEast' '2003-02-07 21:15:00.000' 289.4 1.4294e+05 '2003-02-17 08:14:00.000' 'winter storm'
'West' '2004-04-06 05:44:00.000' 434.81 3.4037e+05 '2004-04-06 06:10:00.000' 'equipment fault'
'MidWest' '2002-03-16 06:18:00.000' 186.44 2.1275e+05 '2002-03-18 23:23:00.000' 'severe storm'
'West' '2003-06-18 02:49:00.000' 0 0 '2003-06-18 10:54:00.000' 'attack'
'NorthEast' '2003-07-16 16:23:00.000' 239.93 49434 '2003-07-17 01:12:00.000' 'fire'
'MidWest' '2004-09-27 11:09:00.000' 286.72 66104 '2004-09-27 16:37:00.000' 'equipment fault'
Определите размер T. Количество строк в импортированных данных меньше, потому что программное обеспечение удаляет все строки с недостающими данными в переменной Customers.
size(T)
ans = 1×2
1140 6
Удалите таблицу базы данных outages с помощью функции execute.
sqlstr = "DROP TABLE ";
sqlquery = strcat(sqlstr,tablename);
execute(conn,sqlquery)Закройте соединение с базой данных.
close(conn)
opts — Настройки импорта базы данныхSQLImportOptionsНастройки импорта базы данных, заданные как объект SQLImportOptions.
varnames Имена переменныхИмена переменных, заданные как вектор символов, массив ячеек из символьных векторов, представляют в виде строки скаляр, массив строк или числовой вектор. Входной параметр varnames указывает на переменные в свойстве VariableNames объекта SQLImportOptions использовать для того, чтобы импортировать данные.
Пример: 'productname'
Типы данных: double | char | string | cell
index — ИндексИндексируйте, заданный как числовой вектор, который идентифицирует переменные в свойстве VariableNames объекта SQLImportOptions использовать для того, чтобы импортировать данные.
Пример: [1,2,3]
Типы данных: double
Option1,OptionValue1,...,OptionN,OptionValueN — Настройки импортаНастройки импорта, заданные как один или несколько аргументов пары "имя-значение". Option является вектором символов или скаляром строки, который задает имя настройки импорта. OptionValue задает значение настройки импорта.
Пример: 'FillValue',true,'Type','logical' устанавливает тип данных заданной переменной как logical и устанавливает значение заливки для недостающих данных в заданной переменной как true.
Пример:
'Name',"Location" изменяет название заданной переменной к Location.
Можно установить настройки импорта изменять значение недостающих данных, имя переменной или тип данных переменной. Эти настройки импорта применяются ко всем переменным, заданным или varnames или входным параметром index.
| Имя настройки импорта | Описание | Значения настройки импорта |
|---|---|---|
'FillValue' | Пропавшие без вести значения данных | Значение должно быть скаляром для одной переменной или массивом ячеек для нескольких переменных. Допустимые типы данных:
Тип данных зависит от типа переменной в базе данных. |
'MissingRule' | Недостающее правило данных | Значение должно быть одним из следующего:
Можно задать эти значения как вектор символов или представить скаляр в виде строки. Установка настройки импорта |
'Name' | Имя переменной | Значение должно быть вектором символов или представить скаляр в виде строки для одной переменной или массива ячеек из символьных векторов или массива строк для нескольких переменных. |
'Type' | Тип данных | Значение должно быть вектором символов или представить скаляр в виде строки для одной переменной или массива ячеек из символьных векторов или массива строк для нескольких переменных. |
Следующая таблица описывает допустимые значения настройки импорта для настройки импорта 'Type'. Первый столбец показывает типы данных в свойстве VariableTypes объекта SQLImportOptions. Второй столбец показывает допустимые типы данных, чтобы задать в векторе символов. Чтобы использовать допустимое значение типа данных, заключите его в кавычки (например, 'single').
| Типы данных переменных | Допустимые значения типа данных для настройки импорта 'Type' |
|---|---|
|
Неопределенные числа с плавающей запятой
Для получения дополнительной информации смотрите То же преобразование применяется ко всем целочисленным классам. |
logical |
|
char или string |
Можно изменить свойство |
datetime |
|
categorical |
|
Можно установить настройки импорта изменять значение переменных с типом данных text. Эти настройки импорта применяются к переменным, которые являются или векторами символов или строковыми массивами, заданными или varnames или входным параметром index. Можно задать значения настройки импорта как вектор символов или представить скаляр в виде строки.
| Имя настройки импорта | Описание | Значения настройки импорта |
|---|---|---|
'WhiteSpaceRule' | Продвижение и конечные пробелы |
|
'TextCaseRule' | Текстовый случай |
|
datetimeМожно установить настройки импорта изменять значение переменных с типом данных datetime. Эти настройки импорта применяются к переменным с типом данных datetime, заданным или varnames или входным параметром index.
| Имя настройки импорта | Описание | Значения настройки импорта | Значение настройки импорта по умолчанию |
|---|---|---|---|
'DatetimeFormat' | Формат отображения дат и времен | Для допустимых значений см. описание свойства | 'default' |
'DatetimeLocale' | Локаль, чтобы использовать для интерпретации дат | Для допустимых значений см. описание аргумента пары "имя-значение" | 'en-US' |
'TimeZone' | TimeZone | Для допустимых значений см. описание свойства | '' |
'InputFormat' | Формат входного текста, представляющего даты и времена | Для допустимых значений см. описание входного параметра infmt в функции datetime. | 'yyyy-MM-dd HH:mm:ss.SSSSSSSSS' |
categoricalМожно установить настройки импорта изменять значение переменных с типом данных categorical. Эти настройки импорта применяются к переменным с типом данных categorical, заданным или varnames или входным параметром index.
| Имя настройки импорта | Описание | Значения настройки импорта | Значение настройки импорта по умолчанию |
|---|---|---|---|
'Categories' | Ожидаемые категории | Для допустимых значений см. описание входного параметра | {} |
'Protected' | Индикатор защиты категории | Для допустимых значений см. описание аргумента пары "имя-значение" | false |
'Ordinal' | Математический индикатор упорядоченного расположения | Для допустимых значений см. описание аргумента пары "имя-значение" | false |
Типы данных: char | string
close | database | databaseImportOptions | execute | getoptions | preview | reset | sqlread | sqlwrite
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.