addConnectionOptions

Добавьте специфичные для драйвера опции связи JDBC

Описание

пример

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 Data Source Configuration в приложении Database Explorer . В разделе Data Source вкладки Database Explorer выберите Configure Data Source> Configure JDBC data source.

Введенный в R2019b