JDBCConnectionOptions

(Будет удалено) Задать опции подключения JDBC для базы данных

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

Описание

The 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' - Окна® идентификация

Можно задать эти значения как вектор символов или строковый скаляр.

Только база данных 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'

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

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

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

   1

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

saveAsJDBCDataSource(opts)

Подключиться к новому источнику данных можно с помощью database функцию или приложение Database Explorer.

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

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

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

Введенный в R2019b