setdbprefs

(Не рекомендуемый) Установите настройки для формата извлечения, ошибок, NULL и многого другого

setdbprefs функция не рекомендуется. Для получения дополнительной информации о функциональности, которая будет использоваться вместо этого, см. «Вопросы совместимости».

Синтаксис

setdbprefs

v = setdbprefs

setdbprefs(preference)

setdbprefs(preference,value)

setdbprefs(s)

Описание

пример

setdbprefs возвращает текущие значения для настроек базы данных.

пример

v = setdbprefs возвращает текущие значения в структуру v.

пример

setdbprefs(preference) возвращает текущее значение для заданного preference.

пример

setdbprefs(preference,value) устанавливает заданную preference на value. После того, как вы задаете настройки базы данных, они сохраняются в MATLAB^® сеансов.

пример

setdbprefs(s) устанавливает настройки, заданные в структуре s к заданным значениям.

Примеры

свернуть все

Отображение текущих значений

Отображение всех настроек базы данных и их текущих значений.

setdbprefs

ans = 

  struct with fields:

    DataReturnFormat: 'table'
       ErrorHandling: 'store'
      NullNumberRead: 'NaN'
     NullNumberWrite: 'NaN'
      NullStringRead: 'null'
     NullStringWrite: 'null'

Отображение текущего значения для заданных выборов базы данных.

setdbprefs('ErrorHandling')

ans =

    'report'

Изменение выбора

Установите другое значение для выбора базы данных. Измените отображение ошибок в MATLAB, изменив выбора обработки ошибок в базе данных.

Задайте store формат для ErrorHandling выбор.

setdbprefs('ErrorHandling','store')

Когда вы выполняете database function, Database Toolbox™ сохраняет все сгенерированные ошибки в Message свойство возвращенного connection объект.

Установите соединение conn на MySQL^® база данных с именем пользователя username и недопустимый пароль.

conn = database('MySQL','username','invalid');

Доступ к сообщению об ошибке в Message свойство connection объект.

conn.Message

ans =

    'ODBC Driver Error: [MySQL][ODBC 5.3(a) Driver]Access denied for user 'username'@'servername' (using password: YES)'

Задайте report формат для ErrorHandling выбор.

setdbprefs('ErrorHandling','report')

Снова подключитесь к базе данных с помощью недопустимого пароля. С ErrorHandling для выбора задано значение report, ошибка, сгенерированная при запуске database функция появится сразу в Командном окне.

conn = database('MySQL','username','invalid')

Error using database (line 156)
ODBC Driver Error: [MySQL][ODBC 5.3(a) Driver]Access denied for user
'username'@'servername' (using password: YES)

Присвоение значений структуре

Назначьте значения для определенных настроек в структуре, чтобы можно было изменять несколько настроек базы данных одновременно.

Присвойте значения для настроек полям в структуре s.

s.ErrorHandling = 'report'; 
s.NullStringRead = 'null';
s

s = 

  struct with fields:

       ErrorHandling: 'report'
      NullStringRead: 'null'

Установите настройки, используя значения в s.

setdbprefs(s)

Управляемый setdbprefs чтобы проверить настройки выбора базы данных.

setdbprefs

ans = 

  struct with fields:

    DataReturnFormat: 'table'
       ErrorHandling: 'report'
      NullNumberRead: 'NaN'
     NullNumberWrite: 'NaN'
      NullStringRead: 'null'
     NullStringWrite: 'null'

Возврат значений в структуру

Присвойте значения для всех настроек базы данных s.

s = setdbprefs

s = 

  struct with fields:

    DataReturnFormat: 'table'
       ErrorHandling: 'report'
      NullNumberRead: 'NaN'
     NullNumberWrite: 'NaN'
      NullStringRead: 'null'
     NullStringWrite: 'null'

Сохранение настроек

Сохраните настройки базы данных в MAT-файле, чтобы использовать их в будущих сеансах работы с MATLAB.

Присвойте настройки переменной ImportData и сохраните их в MAT-файл ImportDataPrefs в текущей папке.

ImportData = setdbprefs;
save ImportDataPrefs.mat ImportData

Загрузите данные и восстановите настройки.

load ImportDataPrefs.mat
setdbprefs(ImportData)

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

свернуть все

`preference` - выбор базы данных
вектор символов | массив ячеек

Выбор базы данных, заданное как вектор символов или массив ячеек. Чтобы задать несколько настроек базы данных, введите значения выборов в массив ячеек из векторов символов. Затем сопоставьте порядок с соответствующими значениями в value аргумент.

Можно задать настройки базы данных для обработки и импорта ошибок NULL строки из базы данных в MATLAB.

'ErrorHandling' - Задайте, как обрабатывать ошибки при импорте данных. Установите этот параметр перед выполнением database функция. Чтобы задать ошибки отображения в Командном окне, введите setdbprefs('ErrorHandling','report'). В противном случае вы можете получить доступ к сообщению об ошибке в Message свойство connection объект.
NULL данные - Задайте, как импортировать NULL строки в рабочее пространство MATLAB. Для импорта NULL строки как вектор символов 'null', введите setdbprefs('NullStringRead','null'). Установите этот параметр перед запуском fetch.

Пример: 'ErrorHandling'

Пример: {'ErrorHandling';'NullStringRead'}

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

`value` - Значение выбора базы данных
вектор символов | массив ячеек

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

Пример: 'NaN'

Пример: {'numeric';'NaN'}

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

`s` - Настройки базы данных
структура

Настройки базы данных, заданные как структура, включающая все заданные настройки.

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

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

свернуть все

`v` - Настройки базы данных
структура

Настройки базы данных, возвращенные как структура, содержащая настройки выбора базы данных и значения.

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

Для визуального способа задать настройки базы данных щелкните Preferences в Environment разделе панели инструментов MATLAB и затем нажмите Database Toolbox. Введите значения для каждого выбора базы данных.

Вопросы совместимости

расширить все

`setdbprefs` функция не рекомендуется

Не рекомендуемый запуск в R2019a

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

Формат возврата данных - Для 'DataReturnFormat' выборы базы данных, эти значения не рекомендуются:
- 'numeric'
- 'cellarray'
- 'structure'
Обработка ошибок - The 'ErrorHandling' выбор базы данных не рекомендуется.
Отсутствующие данные - The 'NullNumberWrite', 'NullStringWrite', и 'NullNumberRead' настройки базы данных для обработки NULL значения данных не рекомендуются.

Нет планов по удалению setdbprefs функцию в это время.

Код обновления

Чтобы задать формат возврата данных в предыдущих релизах, вы задали возврат импортированных данных в виде числовой матрицы путем установки 'DataReturnFormat' выбор базы данных значению 'numeric'. Для примера:

setdbprefs('DataReturnFormat','numeric')
results = fetch(conn,sqlquery);

Теперь можно задать то же значение при помощи 'DataReturnFormat' Аргумент пары "имя-значение" из fetch функция.

results = fetch(conn,sqlquery,'DataReturnFormat','numeric');

Или можно настроить настройки импорта.

opts = databaseImportOptions(conn,tablename);
varnames = "quantity";
opts = setoptions(opts,varnames,'Type','int64');

Чтобы задать обработку ошибок в предыдущих релизах, установите 'ErrorHandling' выбор базы данных значению 'report' или 'store' при помощи setdbprefs функция. Для примера:

setdbprefs('ErrorHandling','store')

Теперь вы задаете обработку ошибок при помощи 'ErrorHandling' Аргумент пары "имя-значение" из database функцию или 'ErrorHandling' Аргумент пары "имя-значение" из executeSQLScript функция.

conn = database(datasource,username,password,'ErrorHandling','store');

Чтобы задать обработку отсутствующих данных в предыдущих релизах, установите 'NullNumberWrite' Выбор базы данных к определенному значению, для примера. В этой таблице показаны параметры выбора базы данных, которые не рекомендованы, и функциональные возможности, которые можно использовать.

Обескураженная функциональность	Рекомендуемая замена
`setdbprefs ('NullNumberWrite', 'NaN')`	`data` входной параметр `sqlwrite`
`setdbprefs ('NullStringWrite', 'null')`	`data` входной параметр `sqlwrite`
`setdbprefs ('NullNumberRead', '0')`	`SQLImportOptions` объект

См. также

clear | close | database | fetch | getdatasources

Представлено до R2006a

Документация

setdbprefs

Синтаксис

Описание

Примеры

Отображение текущих значений

Изменение выбора

Присвоение значений структуре

Возврат значений в структуру

Сохранение настроек

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

`preference` - выбор базы данных
вектор символов | массив ячеек

`value` - Значение выбора базы данных
вектор символов | массив ячеек

`s` - Настройки базы данных
структура

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

`v` - Настройки базы данных
структура

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

Вопросы совместимости

`setdbprefs` функция не рекомендуется

См. также

Документация по Database Toolbox

Поддержка

Документация

setdbprefs

Синтаксис

Описание

Примеры

Отображение текущих значений

Изменение выбора

Присвоение значений структуре

Возврат значений в структуру

Сохранение настроек

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

preference - выбор базы данных вектор символов | массив ячеек

value - Значение выбора базы данных вектор символов | массив ячеек

s - Настройки базы данных структура

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

v - Настройки базы данных структура

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

Вопросы совместимости

setdbprefs функция не рекомендуется

См. также

Документация по Database Toolbox

Поддержка

`preference` - выбор базы данных
вектор символов | массив ячеек

`value` - Значение выбора базы данных
вектор символов | массив ячеек

`s` - Настройки базы данных
структура

`v` - Настройки базы данных
структура

`setdbprefs` функция не рекомендуется