exponenta event banner

JDBCConnectionOptions

(Подлежит удалению) Определение параметров подключения JDBC для базы данных

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

Описание

JDBCConnectionOptions позволяет настроить источник данных JDBC и задать параметры подключения JDBC.

Создание

Создать JDBCConnectionOptions объект с configureJDBCDataSource функция.

Свойства

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

Все базы данных

Расположение драйвера JDBC, указанное как вектор символа или скаляр строки. Укажите полный путь к файлу драйвера JDBC, включая имя файла.

Пример: "C:\drivers\sqljdbc4.jar"

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

Это свойство доступно только для чтения.

Поставщик базы данных, указанный как символьный вектор.

Пример: 'MySQL'

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

Имя источника данных, указанное как вектор символа или скаляр строки.

Пример: "mydatasource"

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

Общие свойства баз данных Microsoft SQL Server, MySQL, Oracle и PostgreSQL

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

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

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

  • Microsoft ® SQL Server ® - 1433

  • MySQL ® - 3306

  • Oracle ® - 1521

  • PostgreSQL - 5432

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

Имя базы данных на сервере, указанное как вектор символов или скаляр строки.

Пример: "mydatabase"

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

Только база данных Microsoft SQL Server

Тип аутентификации, указанный как одно из следующих значений:

  • 'Server' - Проверка подлинности Microsoft SQL Server

  • 'Windows' - Проверка подлинности Windows ®

Эти значения можно указать как вектор символа или скаляр строки.

Только база данных Oracle

Тип драйвера, указанный как одно из следующих значений:

  • 'thin' - Тонкий драйвер

  • 'oci' - Проверка подлинности Windows

    Эти значения можно указать как вектор символа или скаляр строки.

Другие базы данных

Имя драйвера JDBC, указанное как вектор символов или скаляр строки, который ссылается на драйвер Java ®, реализующий java.sql.Driver интерфейс.

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

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

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

Дополнительные сведения об URL-адресе подключения к базе данных см. в документации драйвера базы данных.

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

Функции объекта

setConnectionOptions(Для удаления) Установка параметров подключения JDBC
addConnectionOptions(Требуется удалить) Добавить параметры подключения для драйвера JDBC
rmConnectionOptions(Требуется удалить) Удалить параметры подключения для драйвера JDBC
testConnection(Подлежит удалению) Проверить подключение к источнику данных JDBC
saveAsJDBCDataSource(Подлежит удалению) Сохранить источник данных JDBC

Примеры

свернуть все

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

Создайте источник данных 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 объект.

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

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

   1

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

saveAsJDBCDataSource(opts)

Можно подключиться к новому источнику данных с помощью database или приложение «Обозреватель баз данных».

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

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

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

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