setdbprefs

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

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

Синтаксис

setdbprefs

v = setdbprefs

setdbprefs (предпочтение)

setdbprefs (настройка, значение)

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 функция, База данных 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 data - Укажите способ импорта 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'
Обработка ошибок - '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' например, предпочтения базы данных определенному значению. В этой таблице показаны параметры предпочтений базы данных, которые не рекомендуются, и функциональные возможности, которые можно использовать вместо них.

Обескураженные функциональные возможности	Рекомендуемая замена
`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` функция не рекомендуется

См. также

Документация панели инструментов базы данных

Поддержка

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

setdbprefs

Синтаксис

Описание

Примеры

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

Изменить настройку

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Документация панели инструментов базы данных

Поддержка

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

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

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

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

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