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 функционируйте или приложение Database Explorer.

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

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

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

Введенный в R2019b