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