getoptions

Получите настройки импорта для данных о базе данных

Синтаксис

varOpts = getoptions(opts)
varOpts = getoptions(opts,varnames)
varOpts = getoptions(opts,index)

Описание

пример

varOpts = getoptions(opts) возвращает настройки импорта для всех переменных в объекте SQLImportOptions.

пример

varOpts = getoptions(opts,varnames) возвращает настройки импорта для заданных имен переменных.

пример

varOpts = getoptions(opts,index) возвращает настройки импорта для переменных, заданных числовым индексом.

Примеры

свернуть все

Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем получите настройки импорта по умолчанию из таблицы базы данных.

Этот пример использует электронную таблицу patients.xls , которая содержит терпеливую информацию. Кроме того, пример использует базу данных 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);

Получите и отобразите настройки импорта по умолчанию для таблицы базы данных patients.

varOpts = getoptions(opts)
varOpts = 
    1x10 SQLVariableImportOptions array with properties:

   Variable Options:
                    (1) |      (2) |      (3) |        (4) |      (5) |      (6) |      (7) |        (8) |         (9) |                       (10)  
       Name: 'LastName' | 'Gender' |    'Age' | 'Location' | 'Height' | 'Weight' | 'Smoker' | 'Systolic' | 'Diastolic' | 'SelfAssessedHealthStatus'
       Type:     'char' |   'char' | 'double' |     'char' | 'double' | 'double' | 'double' |   'double' |    'double' |                     'char'
  FillValue:         '' |       '' |    [NaN] |         '' |    [NaN] |    [NaN] |    [NaN] |      [NaN] |       [NaN] |                         ''

	To access sub-properties of each variable, use getoptions

Чтобы изменить переменные настройки импорта, смотрите, что setoptions функционирует.

Удалите таблицу базы данных patients с помощью функции execute.

sqlquery = ['DROP TABLE ' tablename];
execute(conn,sqlquery)

Закройте соединение с базой данных.

close(conn)

Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем получите настройки импорта по умолчанию для нескольких столбцов от таблицы базы данных. Задайте столбцы, чтобы получить при помощи имен столбцов базы данных.

Этот пример использует электронную таблицу patients.xls , которая содержит столбцы LastName, Age и Location. Кроме того, пример использует базу данных 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);

Задайте имена столбцов базы данных в таблице базы данных patients.

varnames = {'LastName','Age','Location'};

Получите и отобразите настройки импорта по умолчанию для заданных столбцов базы данных.

varOpts = getoptions(opts,varnames)
varOpts = 
    1x3 SQLVariableImportOptions array with properties:

   Variable Options:
                    (1) |      (2) |        (3)  
       Name: 'LastName' |    'Age' | 'Location'
       Type:     'char' | 'double' |     'char'
  FillValue:         '' |    [NaN] |         ''

	To access sub-properties of each variable, use getoptions

Чтобы изменить переменные настройки импорта, смотрите, что setoptions функционирует.

Удалите таблицу базы данных patients с помощью функции execute.

sqlquery = ['DROP TABLE ' tablename];
execute(conn,sqlquery)

Закройте соединение с базой данных.

close(conn)

Управляйте настройками импорта путем создания объекта SQLImportOptions. Затем получите настройки импорта по умолчанию для нескольких столбцов от таблицы базы данных. Задайте столбцы, чтобы получить при помощи числового индекса.

Этот пример использует электронную таблицу patients.xls , которая содержит столбцы LastName, Gender и Age. Кроме того, пример использует базу данных 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);

Задайте первые три столбца базы данных при помощи числового индекса.

index = [1,2,3];

Получите и отобразите настройки импорта по умолчанию для заданных столбцов базы данных.

varOpts = getoptions(opts,index)
varOpts = 
    1x3 SQLVariableImportOptions array with properties:

   Variable Options:
                    (1) |      (2) |      (3)  
       Name: 'LastName' | 'Gender' |    'Age'
       Type:     'char' |   'char' | 'double'
  FillValue:         '' |       '' |    [NaN]

	To access sub-properties of each variable, use getoptions

Чтобы изменить переменные настройки импорта, смотрите, что setoptions функционирует.

Удалите таблицу базы данных patients с помощью функции execute.

sqlquery = ['DROP TABLE ' tablename];
execute(conn,sqlquery)

Закройте соединение с базой данных.

close(conn)

Входные параметры

свернуть все

Настройки импорта базы данных, заданные как объект SQLImportOptions.

Имена переменных, заданные как вектор символов, массив ячеек из символьных векторов, представляют в виде строки скаляр, массив строк или числовой вектор. Входной параметр varnames указывает на переменные в свойстве VariableNames объекта SQLImportOptions использовать для того, чтобы импортировать данные.

Пример: 'productname'

Типы данных: double | char | string | cell

Индексируйте, заданный как числовой вектор, который идентифицирует переменные в свойстве VariableNames объекта SQLImportOptions использовать для того, чтобы импортировать данные.

Пример: [1,2,3]

Типы данных: double

Выходные аргументы

свернуть все

Зависимые типом опции для выбранных переменных, возвращенных как массив переменных объектов настроек импорта. Массив содержит объект, соответствующий каждой переменной во входном параметре opts или в выбранных переменных, заданных входным параметром index или varnames. Тип данных каждого объекта в массиве зависит от типа данных соответствующей переменной.

Для categorical и типов данных datetime, каждый переменный объект настроек импорта содержит дополнительные свойства, которые соответствуют типу данных.

Чтобы изменить свойства отдельных объектов, используйте функцию setoptions.

Введенный в R2018b

Для просмотра документации необходимо авторизоваться на сайте