предварительный просмотр

Предварительный просмотр восемь строк от базы данных с помощью настроек импорта

Синтаксис

T = preview(opts)

Описание

пример

T = preview(opts) возвращает таблицу, содержащую первые восемь строк данных о базе данных при помощи объекта SQLImportOptions. Значение свойства SelectedVariableNames объекта SQLImportOptions задает переменные, которые появляются в таблице.

Обычно, таблица содержит восемь строк данных. Однако в некоторых случаях количество строк отличается в зависимости от значений свойств, заданных в объекте SQLImportOptions. Функция preview возвращает меньше чем восемь строк если:

  • SQL-запрос или таблица содержат меньше чем восемь строк данных.

  • SQL-запрос или таблица пусты, или настройка импорта MissingRule (переменных настроек импорта) задает, чтобы не использовать строки, которые содержат недостающие данные. Чтобы получить доступ к значениям переменных настроек импорта, используйте функцию getoptions.

Примеры

свернуть все

Настройте настройки импорта при импортировании текстовых данных от таблицы базы данных. Управляйте настройками импорта путем создания объекта 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.

varnames = 'LastName';
varOpts = getoptions(opts,varnames)
varOpts = 
  SQLVariableImportOptions with properties:

  Variable Properties :
               Name: 'LastName'
               Type: 'char'
        MissingRule: 'fill'
          FillValue: ''

  String Properties :
     WhitespaceRule: 'preserve'
       TextCaseRule: 'preserve'

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

index = 1;
opts = setoptions(opts,index,'Type','string', ...
    'FillValue','NoName');

Предварительно просмотрите первые восемь строк данных о базе данных с помощью настроек импорта. Предварительный просмотр данных показывает, что переменная LastName имеет тип данных string.

T = preview(opts)
T=8×10 table
     LastName      Gender     Age             Location              Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    __________    ________    ___    ___________________________    ______    ______    ______    ________    _________    ________________________

    "Smith"       'Male'      38     'County General Hospital'        71       176        1         124          93              'Excellent'       
    "Johnson"     'Male'      43     'VA Hospital'                    69       163        0         109          77              'Fair'            
    "Williams"    'Female'    38     'St. Mary's Medical Center'      64       131        0         125          83              'Good'            
    "Jones"       'Female'    40     'VA Hospital'                    67       133        0         117          75              'Fair'            
    "Brown"       'Female'    49     'County General Hospital'        64       119        0         122          80              'Good'            
    "Davis"       'Female'    46     'St. Mary's Medical Center'      68       142        0         121          70              'Good'            
    "Miller"      'Female'    33     'VA Hospital'                    64       142        1         130          88              'Good'            
    "Wilson"      'Male'      40     'VA Hospital'                    68       180        0         115          82              'Good'            

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

opts.SelectedVariableNames = 'LastName';
data = sqlread(conn,tablename,opts);
head(data)
ans=8×1 table
     LastName 
    __________

    "Smith"   
    "Johnson" 
    "Williams"
    "Jones"   
    "Brown"   
    "Davis"   
    "Miller"  
    "Wilson"  

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

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

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

close(conn)

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

свернуть все

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

Введенный в R2019a

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