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 и 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 переменная.

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