Настройка настроек импорта для данных базы данных
настраивает настройки импорта для импорта данных из базы данных в 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 и 11.00.5058 драйверов Microsoft SQL Server.
Создайте подключение базы данных к базе данных 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 и 11.00.5058 драйверов Microsoft SQL Server.
Создайте подключение базы данных к базе данных 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 и 11.00.5058 драйверов Microsoft SQL Server.
Создайте подключение базы данных к базе данных 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 и 11.00.5058 драйверов Microsoft SQL Server.
Создайте подключение базы данных к базе данных 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 и 11.00.5058 драйверов Microsoft SQL Server.
Создайте подключение базы данных к базе данных 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 и 11.00.5058 драйверов Microsoft SQL Server.
Создайте подключение базы данных к базе данных 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
- Имена переменныхИмена переменных, заданные как вектор символов, массив ячеек из векторов символов, строковый скаляр, строковые массивы или числовой вектор. The 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 |
|
duration |
|
categorical |
|
Можно задать настройки импорта, чтобы изменить значение переменных с типом текстовых данных. Эти настройки импорта применяются к переменным, которые являются либо векторами символов, либо строковыми массивами, заданными varnames
или index
входной параметр. Можно задать значения настроек импорта как вектор символов или строковый скаляр.
Имя настройки импорта | Описание | Импортируйте значения опций |
---|---|---|
'WhiteSpaceRule' | Ведущие и конечные белые пространства |
|
'TextCaseRule' | Текстовый случай |
|
datetime
Тип данныхМожно задать настройки импорта, чтобы изменить значение переменных с помощью datetime
тип данных. Эти настройки импорта применяются к переменным с datetime
тип данных, заданный любым из varnames
или index
входной параметр.
Имя настройки импорта | Описание | Импортируйте значения опций | Значение настройки импорта по умолчанию |
---|---|---|---|
'DatetimeFormat' | Формат отображения дат и времени | Допустимые значения см. в описании | 'default' |
'DatetimeLocale' | Локаль, используемая для интерпретации дат | Допустимые значения см. в описании | 'en-US' |
'TimeZone' | Часовой пояс | Допустимые значения см. в описании | '' |
'InputFormat' | Формат входного текста, представляющего даты и времена | Допустимые значения см. в описании infmt входной параметр в datetime функция. | 'yyyy-MM-dd HH:mm:ss.SSSSSSSSS' |
duration
Тип данныхМожно задать настройки импорта, чтобы изменить значение переменных с помощью duration
тип данных. Эти настройки импорта применяются к переменным с duration
тип данных, заданный любым из varnames
или index
входной параметр.
Имя настройки импорта | Описание | Импортируйте значения опций | Значение настройки импорта по умолчанию |
---|---|---|---|
'InputFormat' | Формат входного текста, представляющего время | Допустимые значения см. в описании infmt входной параметр в duration функция. | '' |
'DurationFormat' | Формат отображения времени | Допустимые значения см. в описании Format свойство в duration функция. | 'hh:mm:ss' |
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.