Настройте настройки импорта для данных о базе данных
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.