setdbprefs

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

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

Синтаксис

setdbprefs

v = setdbprefs

setdbprefs(preference)

setdbprefs(preference,value)

setdbprefs(s)

Описание

пример

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

пример

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

пример

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

пример

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

пример

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

Примеры

свернуть все

Отобразите текущие значения

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

setdbprefs

ans = 

  struct with fields:

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

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

setdbprefs('ErrorHandling')

ans =

    'report'

Измените установку Preference

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

Задайте store формат для ErrorHandling preference.

setdbprefs('ErrorHandling','store')

Когда вы выполняете database функция, 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 preference.

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 проверять ваши настройки базы данных preference.

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` — База данных preference
вектор символов | массив ячеек

База данных 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
вектор символов | массив ячеек

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

Пример: 'NaN'

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

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

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

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

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

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

свернуть все

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

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

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

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

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

развернуть все

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

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

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

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

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

Обновите код

Чтобы установить данные возвращают формат в предшествующих релизах, вы указали, что возврат импортировал данные как числовую матрицу путем установки 'DataReturnFormat' база данных preference к значению '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' база данных preference к значению 'report' или 'store' при помощи setdbprefs функция. Например:

setdbprefs('ErrorHandling','store')

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

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

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

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

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

setdbprefs

Синтаксис

Описание

Примеры

Отобразите текущие значения

Измените установку Preference

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

Возвращаемые значения к структуре

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

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

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

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

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

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

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

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

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

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

Обновите код

Смотрите также

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

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

Поддержка

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

setdbprefs

Синтаксис

Описание

Примеры

Отобразите текущие значения

Измените установку Preference

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

Возвращаемые значения к структуре

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

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

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

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

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

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

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

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

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

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

Обновите код

Смотрите также

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

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

Поддержка

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

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

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

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

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