preview

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

Синтаксис

Описание

пример

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 'FillValue' .

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