setdbprefs

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

Функция 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'

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

setdbprefs('ErrorHandling')

ans =

    'report'

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

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

Задайте формат store для настройки ErrorHandling.

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.

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.

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

Пример: 'ErrorHandling'

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

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

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

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

Пример: 'NaN'

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

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

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

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

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

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

свернуть все

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

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

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

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

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

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

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

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

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

Данные возвращают формат — Для настройки базы данных 'DataReturnFormat', эти значения не рекомендуются:
- 'numeric'
- 'cellarray'
- 'structure'
Обработка ошибок — настройка базы данных 'ErrorHandling' не рекомендуется.
Недостающие данные — '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' на определенное значение, например. Эта таблица показывает настройки базы данных preference, которые не рекомендуются и функциональность, которую можно использовать вместо этого.

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

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

setdbprefs

Синтаксис

Описание

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновите код

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

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

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

Поддержка

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

setdbprefs

Синтаксис

Описание

Примеры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновите код

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

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

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

Поддержка

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

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

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

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