addConnectionOptions

(Будет удалено) Добавить опции подключения для конкретного драйвера JDBC

Свернуть все на странице

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

Синтаксис

opts = addConnectionOptions(opts,Option1,OptionValue1,...,OptionN,OptionValueN)

Описание

пример

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'

The 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'

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

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

   1

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

saveAsJDBCDataSource(opts)

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

свернуть все

Опции подключения JDBC, заданные как JDBCConnectionOptions объект.

Опции конкретного драйвера JDBC, заданные как один или несколько аргументы пары "имя-значение". Option - вектор символов или строковый скаляр, задающий имя конкретного для драйвера опции подключения. 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.

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

расширить все

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

См. также

Объекты

Функции

Темы

Введенный в R2019b

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

Поддержка

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