exponenta event banner

addConnectionOptions

(Требуется удалить) Добавить параметры подключения для драйвера JDBC

addConnectionOptions функция будет удалена в следующей версии. Используйте setoptions вместо этого функция. Дополнительные сведения см. в разделе Вопросы совместимости.

Описание

пример

opts = addConnectionOptions(opts,Option1,OptionValue1,...,OptionN,OptionValueN) добавляет параметры подключения для драйвера JDBC с помощью JDBCConnectionOptions объект opts.

Примеры

свернуть все

Создайте источник данных JDBC для базы данных Microsoft ® SQL Server ®, настройте источник данных, задав параметры подключения JDBC, задайте дополнительный параметр для драйвера JDBC и сохраните источник данных.

Создайте источник данных SQL Server.

opts = configureJDBCDataSource('Vendor','Microsoft SQL Server')
opts = 

  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: ''

                DatabaseName: ''
                      Server: 'localhost'
                  PortNumber: 1433
                    AuthType: 'Server'

          JDBCDriverLocation: ''

opts является JDBCConnectionOptions объект со следующими свойствами:

  • Vendor - Имя поставщика базы данных

  • DataSourceName - Наименование источника данных

  • DatabaseName - Имя базы данных

  • Server - Имя сервера базы данных

  • PortNumber - Номер порта

  • AuthType - Тип аутентификации

  • JDBCDriverLocation - Полный путь к файлу драйвера JDBC

Настройка источника данных путем установки параметров подключения JDBC для источника данных SQLServerDataSource, сервер базы данных dbtb04, номер порта 54317, полный путь к файлу драйвера JDBC и проверка подлинности Windows ® .

opts = setConnectionOptions(opts, ...
    'DataSourceName','SQLServerDataSource', ...
    'Server','dbtb04','PortNumber',54317, ...
    'JDBCDriverLocation','C:\Drivers\sqljdbc4.jar', ...
    'AuthType','Windows')
opts = 

  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: 'SQLServerDataSource'

                DatabaseName: ''
                      Server: 'dbtb04'
                  PortNumber: 54317
                    AuthType: 'Windows'

          JDBCDriverLocation: 'C:\Drivers\sqljdbc4.jar'

setConnectionOptions функция устанавливает DataSourceName, Server, PortNumber, AuthType, и JDBCDriverLocation свойства в JDBCConnectionOptions объект.

Добавьте параметр подключения для драйвера JDBC, используя аргумент пары имя-значение. Параметр указывает значение тайм-аута для установки подключения к базе данных. opts содержит новый раздел свойств для дополнительного параметра подключения JDBC.

opts = addConnectionOptions(opts,'loginTimeout',20)
opts = 

  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: 'SQLServerDataSource'

                DatabaseName: ''
                      Server: 'dbtb04'
                  PortNumber: 54317
                    AuthType: 'Windows'

          JDBCDriverLocation: 'C:\Drivers\sqljdbc4.jar'

  Additional JDBC Connection Options:

                loginTimeout: '20'

Проверьте подключение к базе данных с помощью пустого имени пользователя и пароля. testConnection функция возвращает логическое 1, что указывает на успешное подключение к базе данных.

username = "";
password = "";
status = testConnection(opts,username,password)
status = logical

   1

Сохраните настроенный источник данных.

saveAsJDBCDataSource(opts)

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

свернуть все

Параметры подключения JDBC, указанные как JDBCConnectionOptions объект.

Параметры драйвера JDBC, указанные как один или несколько аргументов пары имя-значение. Option - символьный вектор или строковый скаляр, указывающий имя параметра подключения, специфичного для драйвера JDBC. OptionValue задает значение параметра подключения. OptionValue может быть символьным вектором, строковым скаляром, логическим скаляром или числовым скаляром. Можно указать любой параметр подключения, разрешенный драйвером JDBC. Доступные параметры подключения см. в документации драйвера JDBC.

Примечание

Параметр подключения, специфичный для драйвера JDBC, можно задать двумя способами: с помощью этого входного аргумента или с помощью URL-адреса подключения к базе данных. Если указать один и тот же параметр с различными значениями как во входном аргументе, так и в URL, реализация драйвера JDBC определяет, какое значение имеет приоритет. Для обеспечения максимальной переносимости укажите параметр подключения для драйвера JDBC только одним из этих способов.

Пример: 'useSSL',true указывает, что подключение к базе данных использует SSL-аутентификацию.

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

свернуть все

Параметры подключения JDBC, возвращенные как JDBCConnectionOptions объект.

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

Приложение

Параметры подключения для драйвера JDBC можно добавить с помощью диалогового окна «Настройка источника данных JDBC» в приложении «Обозреватель баз данных». В разделе «Источник данных» вкладки «Обозреватель баз данных» выберите «Настройка источника данных» > «Настройка источника данных JDBC».

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

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

Не рекомендуется начинать с R2020b

Представлен в R2019b