select

Выполните SQL SELECT оператор и импортирует данные в MATLAB

Описание

пример

data = select(conn,selectquery) возвращает импортированные данные в соединение с базой данных conn для заданного SQL SELECT оператор selectquery.

пример

data = select(conn,selectquery,Name,Value) задает дополнительные опции с помощью одного или нескольких аргументов пары "имя-значение". Например, 'MaxRows',10 определяет максимальный номер строк, чтобы возвратиться к 10 строкам.

пример

[data,metadata] = select(___) возвращает информацию об импортированных данных с помощью любой из комбинаций входных аргументов в предыдущих синтаксисах. Используйте эту информацию, чтобы изменить отсутствующие значения в импортированных данных и типах данных представления для каждой переменной.

Примеры

свернуть все

Импортируйте данные от базы данных за один шаг с помощью select функция. Можно получить доступ к данным и выполнить мгновенный анализ данных.

Код принимает, что у вас есть таблица базы данных Patients сохраненный на базе данных Microsoft® SQL Server®. Эта таблица содержит данные о пациентах в 10 столбцах и строках. Табличное определение:

CREATE TABLE Patients(
      LastName VARCHAR(50),
      Gender VARCHAR(10),
      Age TINYINT,
      Location VARCHAR(300),
      Height SMALLINT,
      Weight SMALLINT,
      Smoker BIT,
      Systolic FLOAT,
      Diastolic NUMERIC,
      SelfAssessedHealthStatus VARCHAR(20))

Этот пример использует базу данных Microsoft® SQL Server® Version 11.00.2100 и Microsoft® SQL Server® Driver 11.00.5058.

Создайте соединение с базой данных к базе данных Microsoft® SQL Server® с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.

datasource = 'MS SQL Server Auth';
conn = database(datasource,'','');

Импортируйте все данные от Patients таблица путем выполнения SQL SELECT оператор с помощью select функция. data таблица, которая содержит импортированные данные.

selectquery = 'SELECT * FROM Patients';

data = select(conn,selectquery)
data =

  10×10 table

     LastName      Gender     Age             Location             Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    __________    ________    ___    __________________________    ______    ______    ______    ________    _________    ________________________

    'Smith'       'Male'      38     'Country General Hospital'    -32768       176    true      124          93          'Excellent'             
    'Johnson'     'Male'      43     'VA Hospital'                     69       163    false     NaN          77          'Fair'                  
    'Williams'    'Female'    38     ''                                64       131    false     125          83          'Good'                  
    'Jones'       'Female'     0     'VA Hospital'                     67       133    false     117          75          'Fair'                  
    'Broen'       'Female'    49     'Country General Hospital'        64       119    false     122          80          'Good'                  
    'Davis'       'Female'    46     'St Mary's Medical Center'        68       142    false     121         NaN          'Good'                  
    'Miller'      'Female'    33     'VA Hospital'                     64       142    true      130          88          'Good'                  
    'Wilson'      'Male'      40     'VA Hospital'                 -32768       180    false     115          82          'Good'                  
    'Moore'       'Male'      28     'St Mary's Medical Center'        68    -32768    false     115          78          'Excellent'             
    'Taylor'      'Female'    31     'Country General Hospital'        68       132    false     NaN          86          'Excellent'             

Определите количество штекерных пациентов путем мгновенного доступа к данным. Используйте count функционируйте, чтобы найти случаи в гендерных данных вектора символов, который представляет штекер. Определите общее количество случаев.

males = count(data.Gender,'Male');
sum(males)
ans =

     4

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

close(conn)

Импортируйте ограниченное количество строк от базы данных за один шаг с помощью select функция. Database Toolbox™ импортирует данные с помощью типов числовых данных MATLAB®, которые соответствуют типам данных в таблице базы данных. После импортирования данных можно получить доступ к данным и выполнить мгновенный анализ данных.

Код принимает, что у вас есть таблица базы данных Patients сохраненный на базе данных Microsoft® SQL Server®. Эта таблица содержит данные о пациентах в 10 столбцах и строках. Табличное определение:

CREATE TABLE Patients(
      LastName VARCHAR(50),
      Gender VARCHAR(10),
      Age TINYINT,
      Location VARCHAR(300),
      Height SMALLINT,
      Weight SMALLINT,
      Smoker BIT,
      Systolic FLOAT,
      Diastolic NUMERIC,
      SelfAssessedHealthStatus VARCHAR(20))

Здесь, соединитесь с базой данных Microsoft® SQL Server® Version 11.00.2100 с помощью Microsoft® SQL Server® Driver 11.00.5058.

Создайте соединение с базой данных к базе данных Microsoft® SQL Server® с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.

datasource = 'MS SQL Server Auth';
conn = database(datasource,'','');

Импортируйте данные от Patients таблица путем выполнения SQL SELECT оператор с помощью select функция. Ограничьте количество импортированных строк с помощью аргумента пары "имя-значение" 'MaxRows'.

data таблица. Типы данных MATLAB® в таблице соответствуют типам данных в базе данных. Здесь, Age имеет тип данных uint8 это соответствует TINYINT в табличном определении.

metadata таблица, которая содержит дополнительную информацию о каждой переменной в data.

  • VariableType - Тип данных MATLAB®

  • MissingValue пустой указатель представление значения

  • MissingRows - Вектор из индексов строки, которые содержат отсутствующее значение

selectquery = 'SELECT * FROM Patients';

[data,metadata] = select(conn,selectquery,'MaxRows',5)
data =

  5×10 table

     LastName      Gender     Age             Location             Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    __________    ________    ___    __________________________    ______    ______    ______    ________    _________    ________________________

    'Smith'       'Male'      38     'Country General Hospital'    -32768    176       true      124         93           'Excellent'             
    'Johnson'     'Male'      43     'VA Hospital'                     69    163       false     NaN         77           'Fair'                  
    'Williams'    'Female'    38     ''                                64    131       false     125         83           'Good'                  
    'Jones'       'Female'     0     'VA Hospital'                     67    133       false     117         75           'Fair'                  
    'Broen'       'Female'    49     'Country General Hospital'        64    119       false     122         80           'Good'                  


metadata =

  10×3 table

                                VariableType    MissingValue    MissingRows 
                                ____________    ____________    ____________

    LastName                    'char'          ''              [0×1 double]
    Gender                      'char'          ''              [0×1 double]
    Age                         'uint8'         [     0]        [         4]
    Location                    'char'          ''              [0×1 double]
    Height                      'int16'         [-32768]        [         1]
    Weight                      'int16'         [-32768]        [0×1 double]
    Smoker                      'logical'       [     0]        [0×1 double]
    Systolic                    'single'        [   NaN]        [         2]
    Diastolic                   'double'        [   NaN]        [0×1 double]
    SelfAssessedHealthStatus    'char'          ''              [0×1 double]

Определите количество штекерных пациентов путем мгновенного доступа к данным. Используйте count функционируйте, чтобы найти случаи в гендерных данных вектора символов, который представляет штекер. Определите общее количество случаев.

males = count(data.Gender,'Male');
sum(males)
ans =

     2

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

close(conn)

Импортируйте данные от базы данных за один шаг с помощью select функция. Database Toolbox™ импортирует данные с помощью типов числовых данных MATLAB®, которые соответствуют типам данных в таблице базы данных. Можно просмотреть информацию о типе данных в импортированных данных. Можно также получить доступ к данным и выполнить мгновенный анализ данных.

Код принимает, что у вас есть таблица базы данных Patients сохраненный на базе данных Microsoft® SQL Server®. Эта таблица содержит данные о пациентах в 10 столбцах и строках. Табличное определение:

CREATE TABLE Patients(
      LastName VARCHAR(50),
      Gender VARCHAR(10),
      Age TINYINT,
      Location VARCHAR(300),
      Height SMALLINT,
      Weight SMALLINT,
      Smoker BIT,
      Systolic FLOAT,
      Diastolic NUMERIC,
      SelfAssessedHealthStatus VARCHAR(20))

Здесь, соединитесь с базой данных Microsoft® SQL Server® Version 11.00.2100 с помощью Microsoft® SQL Server® Driver 11.00.5058.

Создайте соединение с базой данных к базе данных Microsoft® SQL Server® с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.

datasource = 'MS SQL Server Auth';
conn = database(datasource,'','');

Импортируйте все данные от Patients таблица путем выполнения SQL SELECT оператор с помощью select функция.

data таблица. Типы данных MATLAB® в таблице соответствуют типам данных в базе данных. Здесь, Age имеет тип данных MATLAB® uint8 это соответствует TINYINT в табличном определении.

metadata таблица, которая содержит дополнительную информацию о каждой переменной в data.

  • VariableType - Тип данных MATLAB®

  • MissingValue - Представление нулевого значения

  • MissingRows - Вектор из индексов строки, которые содержат отсутствующее значение

selectquery = 'SELECT * FROM Patients';

[data,metadata] = select(conn,selectquery)
data =

  10×10 table

     LastName      Gender     Age             Location             Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    __________    ________    ___    __________________________    ______    ______    ______    ________    _________    ________________________

    'Smith'       'Male'      38     'Country General Hospital'    -32768       176    true      124          93          'Excellent'             
    'Johnson'     'Male'      43     'VA Hospital'                     69       163    false     NaN          77          'Fair'                  
    'Williams'    'Female'    38     ''                                64       131    false     125          83          'Good'                  
    'Jones'       'Female'     0     'VA Hospital'                     67       133    false     117          75          'Fair'                  
    'Broen'       'Female'    49     'Country General Hospital'        64       119    false     122          80          'Good'                  
    'Davis'       'Female'    46     'St Mary's Medical Center'        68       142    false     121         NaN          'Good'                  
    'Miller'      'Female'    33     'VA Hospital'                     64       142    true      130          88          'Good'                  
    'Wilson'      'Male'      40     'VA Hospital'                 -32768       180    false     115          82          'Good'                  
    'Moore'       'Male'      28     'St Mary's Medical Center'        68    -32768    false     115          78          'Excellent'             
    'Taylor'      'Female'    31     'Country General Hospital'        68       132    false     NaN          86          'Excellent'             


metadata =

  10×3 table

                                VariableType    MissingValue    MissingRows 
                                ____________    ____________    ____________

    LastName                    'char'          ''              [0×1 double]
    Gender                      'char'          ''              [0×1 double]
    Age                         'uint8'         [     0]        [         4]
    Location                    'char'          ''              [0×1 double]
    Height                      'int16'         [-32768]        [2×1 double]
    Weight                      'int16'         [-32768]        [         9]
    Smoker                      'logical'       [     0]        [0×1 double]
    Systolic                    'single'        [   NaN]        [2×1 double]
    Diastolic                   'double'        [   NaN]        [         6]
    SelfAssessedHealthStatus    'char'          ''              [0×1 double]

Просмотрите типы данных каждой переменной в таблице.

metadata.VariableType
ans =

  10×1 cell array

    'char'
    'char'
    'uint8'
    'char'
    'int16'
    'int16'
    'logical'
    'single'
    'double'
    'char'

Определите количество штекерных пациентов путем мгновенного доступа к данным. Используйте count функционируйте, чтобы найти случаи в гендерных данных вектора символов, который представляет штекер. Определите общее количество случаев.

males = count(data.Gender,'Male');
sum(males)
ans =

     4

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

close(conn)

Импортируйте данные от базы данных за один шаг с помощью select функция. Во время импорта, select функционируйте устанавливает значения по умолчанию для недостающих данных в каждой строке. Используйте информацию об импортированных данных, чтобы изменить значения по умолчанию.

Код принимает, что у вас есть таблица базы данных Patients сохраненный на базе данных Microsoft® SQL Server®. Эта таблица содержит данные о пациентах в 10 столбцах и строках. Табличное определение:

CREATE TABLE Patients(
      LastName VARCHAR(50),
      Gender VARCHAR(10),
      Age TINYINT,
      Location VARCHAR(300),
      Height SMALLINT,
      Weight SMALLINT,
      Smoker BIT,
      Systolic FLOAT,
      Diastolic NUMERIC,
      SelfAssessedHealthStatus VARCHAR(20))

Здесь, соединитесь с базой данных Microsoft® SQL Server® Version 11.00.2100 с помощью Microsoft® SQL Server® Driver 11.00.5058.

Создайте соединение с базой данных к базе данных Microsoft® SQL Server® с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.

datasource = 'MS SQL Server Auth';
conn = database(datasource,'','');

Импортируйте все данные от Patients таблица путем выполнения SQL SELECT оператор с помощью select функция.

data таблица, которая содержит импортированные данные.

metadata таблица, которая содержит дополнительную информацию о каждой переменной в data.

  • VariableType - Тип данных MATLAB®

  • MissingValue пустой указатель представление значения

  • MissingRows - Вектор из индексов строки, которые указывают на местоположение отсутствующих значений

selectquery = 'SELECT * FROM Patients';

[data,metadata] = select(conn,selectquery)
data =

  10×10 table array

     LastName      Gender     Age             Location             Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    __________    ________    ___    __________________________    ______    ______    ______    ________    _________    ________________________

    'Smith'       'Male'      38     'Country General Hospital'    -32768       176    true      124          93          'Excellent'             
    'Johnson'     'Male'      43     'VA Hospital'                     69       163    false     NaN          77          'Fair'                  
    'Williams'    'Female'    38     ''                                64       131    false     125          83          'Good'                  
    'Jones'       'Female'     0     'VA Hospital'                     67       133    false     117          75          'Fair'                  
    'Broen'       'Female'    49     'Country General Hospital'        64       119    false     122          80          'Good'                  
    'Davis'       'Female'    46     'St Mary's Medical Center'        68       142    false     121         NaN          'Good'                  
    'Miller'      'Female'    33     'VA Hospital'                     64       142    true      130          88          'Good'                  
    'Wilson'      'Male'      40     'VA Hospital'                 -32768       180    false     115          82          'Good'                  
    'Moore'       'Male'      28     'St Mary's Medical Center'        68    -32768    false     115          78          'Excellent'             
    'Taylor'      'Female'    31     'Country General Hospital'        68       132    false     NaN          86          'Excellent'             


metadata =

  10×3 table array

                                VariableType    MissingValue    MissingRows 
                                ____________    ____________    ____________

    LastName                    'char'          ''              [0×1 double]
    Gender                      'char'          ''              [0×1 double]
    Age                         'uint8'         [     0]        [         4]
    Location                    'char'          ''              [0×1 double]
    Height                      'int16'         [-32768]        [2×1 double]
    Weight                      'int16'         [-32768]        [         9]
    Smoker                      'logical'       [     0]        [0×1 double]
    Systolic                    'single'        [   NaN]        [2×1 double]
    Diastolic                   'double'        [   NaN]        [         6]
    SelfAssessedHealthStatus    'char'          ''              [0×1 double]

Получите индексы, которые указывают на местоположение отсутствующих значений в Height переменная с помощью metadata выходной аргумент.

values = metadata.MissingRows{'Height'}
values =

     1
     8

Измените значение по умолчанию для недостающих данных из -32768 к 0 использование цикла for. Доступ к импортированным данным с помощью индексов.

for i = 1:length(values)
    data.Height(values(i)) = 0;
end

Просмотрите импортированные данные.

data.Height
ans =

  10×1 int16 column vector

    0
   69
   64
   67
   64
   68
   64
    0
   68
   68

Отсутствующие значения появляются как 0.

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

close(conn)

Импортируйте данные от базы данных за один шаг с помощью select функция. Во время импорта, select функционируйте устанавливает значения по умолчанию для недостающих данных в каждой строке. Используйте информацию об импортированных данных, чтобы изменить значения по умолчанию путем индексации в вектор.

Код принимает, что у вас есть таблица базы данных Patients сохраненный на базе данных Microsoft® SQL Server®. Эта таблица содержит данные о пациентах в 10 столбцах и строках. Табличное определение:

CREATE TABLE Patients(
      LastName VARCHAR(50),
      Gender VARCHAR(10),
      Age TINYINT,
      Location VARCHAR(300),
      Height SMALLINT,
      Weight SMALLINT,
      Smoker BIT,
      Systolic FLOAT,
      Diastolic NUMERIC,
      SelfAssessedHealthStatus VARCHAR(20))

Здесь, соединитесь с базой данных Microsoft® SQL Server® Version 11.00.2100 с помощью Microsoft® SQL Server® Driver 11.00.5058.

Создайте соединение с базой данных к базе данных Microsoft® SQL Server® с аутентификацией Windows®. Задайте пустое имя пользователя и пароль.

datasource = 'MS SQL Server Auth';
conn = database(datasource,'','');

Импортируйте все данные от Patients таблица путем выполнения SQL SELECT оператор с помощью select функция.

data таблица, которая содержит импортированные данные.

metadata таблица, которая содержит дополнительную информацию о каждой переменной в data.

  • VariableType - Тип данных MATLAB®

  • MissingValue пустой указатель представление значения

  • MissingRows - Вектор из индексов строки, которые указывают на местоположение отсутствующих значений

selectquery = 'SELECT * FROM Patients';

[data,metadata] = select(conn,selectquery)
data =

  10×10 table array

     LastName      Gender     Age             Location             Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    __________    ________    ___    __________________________    ______    ______    ______    ________    _________    ________________________

    'Smith'       'Male'      38     'Country General Hospital'    -32768       176    true      124          93          'Excellent'             
    'Johnson'     'Male'      43     'VA Hospital'                     69       163    false     NaN          77          'Fair'                  
    'Williams'    'Female'    38     ''                                64       131    false     125          83          'Good'                  
    'Jones'       'Female'     0     'VA Hospital'                     67       133    false     117          75          'Fair'                  
    'Broen'       'Female'    49     'Country General Hospital'        64       119    false     122          80          'Good'                  
    'Davis'       'Female'    46     'St Mary's Medical Center'        68       142    false     121         NaN          'Good'                  
    'Miller'      'Female'    33     'VA Hospital'                     64       142    true      130          88          'Good'                  
    'Wilson'      'Male'      40     'VA Hospital'                 -32768       180    false     115          82          'Good'                  
    'Moore'       'Male'      28     'St Mary's Medical Center'        68    -32768    false     115          78          'Excellent'             
    'Taylor'      'Female'    31     'Country General Hospital'        68       132    false     NaN          86          'Excellent'             


metadata =

  10×3 table array

                                VariableType    MissingValue    MissingRows 
                                ____________    ____________    ____________

    LastName                    'char'          ''              [0×1 double]
    Gender                      'char'          ''              [0×1 double]
    Age                         'uint8'         [     0]        [         4]
    Location                    'char'          ''              [0×1 double]
    Height                      'int16'         [-32768]        [2×1 double]
    Weight                      'int16'         [-32768]        [         9]
    Smoker                      'logical'       [     0]        [0×1 double]
    Systolic                    'single'        [   NaN]        [2×1 double]
    Diastolic                   'double'        [   NaN]        [         6]
    SelfAssessedHealthStatus    'char'          ''              [0×1 double]

Получите индексы, которые указывают на местоположение отсутствующих значений в Height переменная с помощью metadata выходной аргумент.

values = metadata(5,3)
valuesindex = values.MissingRows{1}
values =

  table

              MissingRows 
              ____________

    Height    [2×1 double]


valuesindex =

     1
     8

Измените значение по умолчанию для недостающих данных из -32768 к 0 использование векторной индексации.

data.Height(valuesindex) = 0;

Просмотрите импортированные данные.

data.Height
ans =

  10×1 int16 column vector

    0
   69
   64
   67
   64
   68
   64
    0
   68
   68

Отсутствующие значения появляются как 0.

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

close(conn)

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

свернуть все

Соединение с базой данных в виде connection объект, созданный с database функция.

SQL SELECT оператор в виде вектора символов или строки. select функция только выполняет SQL SELECT операторы. Чтобы выполнить другие SQL-операторы, используйте exec функция.

Пример: 'SELECT * FROM inventoryTable'

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

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'MaxRows',100,'QueryTimeOut',5 возвращает 100 строк данных и ожидает 5 секунд, чтобы выполнить SQL SELECT оператор.

Максимальное количество строк, чтобы возвратиться в виде разделенной запятой пары, состоящей из 'MaxRows' и положительный числовой скаляр. По умолчанию, select функция возвращает все строки в выполняемый SQL-запрос. Используйте этот аргумент пары "имя-значение", чтобы ограничить количество строк, импортированных в MATLAB®.

Пример: 'MaxRows',10

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

Тайм-аут SQL-запроса в виде разделенной запятой пары, состоящей из 'QueryTimeOut' и положительный числовой скаляр. По умолчанию, select функция игнорирует значение тайм-аута. Используйте этот аргумент пары "имя-значение", чтобы задать номер секунд, чтобы ожидать выполнения SQL-запроса selectquery.

Пример: 'QueryTimeOut',15

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

свернуть все

Импортированные данные, возвращенные как таблица. Строки таблицы соответствуют строкам данных, возвращенных в выполняемый SQL-запрос selectquery. Имена переменных таблицы задают столбцы в SQL-запросе.

select функция возвращает дату или данные времени как векторы символов в таблице. Эта функция возвращает текст как векторы символов или массив ячеек из символьных векторов. Строки не поддерживаются в таблице.

Если никакие данные, чтобы импортировать не существуют, то data пустая таблица.

Информация об импортированных данных, возвращенных как таблица. Имена строки metadata имена переменных в data. Эта функция хранит каждое имя переменной в metadata таблица как массив ячеек. metadata имеет эти имена переменных:

  • VariableType — Типы данных каждой переменной в data

  • MissingValue — Представление отсутствующего значения для каждой переменной в data

  • MissingRows — Вектор из индексов строки, которые указывают на местоположения отсутствующих значений для каждой переменной в data

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

Тип данных базы данных NULL по умолчанию Значение

SIGNED TINYINT

-128

UNSIGNED TINYINT

0

SIGNED SMALLINT

-32768

UNSIGNED SMALLINT

0

SIGNED INT

-2147483648

UNSIGNED INT

0

SIGNED BIGINT

-9223372036854775808

UNSIGNED BIGINT

0

REAL

NaN

FLOAT

NaN

DOUBLE

NaN

DECIMAL

NaN

NUMERIC

NaN

Булевская переменная

false

Дата, время или текст

''

Изменить NULL представление значения в импортированных данных, замените значение по умолчанию цикличным выполнением через импортированные данные или использующий векторную индексацию.

Ограничения

  • Вы не можете настроить отсутствующие значения в выходном аргументе data использование select функция. Индексируйте в импортированные данные с помощью metadata выходной аргумент вместо этого.

  • Выходной аргумент data не поддерживает cell и struct типы данных. select функционируйте только поддерживает table.

Альтернативная функциональность

Используйте exec и fetch функции для полной функциональности при импортировании данных. Для различий между select функционируйте и эта альтернатива, смотрите, что Импорт Данных Использует Приложение Database Explorer или Командную строку.

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