SQLConnectionOptions

Задайте опции подключения к базе данных JDBC

Описание

Создайте опции подключения для подключения к базе данных JDBC.

После создания SQLConnectionOptions объект, установите опции подключения, протестируйте подключение и сохраните источник данных, можно создать соединение с базой данных JDBC с помощью сохраненного источника данных. Подключение опций включать опции, необходимые для подключения к базе данных. Можно также задать дополнительные опции подключения для определенного драйвера базы данных.

Создание

Создайте SQLConnectionOptions использование объекта databaseConnectionOptions функция.

Свойства

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

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

Имя источника данных, заданное как строковый скаляр. Вы можете использовать имя источника данных в database функция для создания соединения с базой данных JDBC.

Пример: "MSSQLServer"

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

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

Поставщик базы данных, заданный как строковый скаляр. Установите это свойство с помощью vendor входной параметр в databaseConnectionOptions функция.

Пример: "Microsoft SQL Server"

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

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

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

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

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

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

Пример: "mydatabase"

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

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

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

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

  • Microsoft® SQL Server® — 1433

  • MySQL® — 3306

  • Oracle® — 1521

  • PostgreSQL - 5432

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

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

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

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

  • "Windows" - Окна® идентификация

Задайте значение как строковый скаляр.

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

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

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

  • "oci" - Аутентификация Windows или драйвер OCI

Задайте значение как строковый скаляр.

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

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

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

Пример: org.sqlite.JDBC

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

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

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

Пример: jdbc:sqlite:C:\Databases\sqlite.db

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

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

setoptionsУстановка опций подключения JDBC
rmoptionsУдаление опций подключения JDBC
resetСбросьте опции подключения JDBC по умолчанию
testConnectionТестирование подключения к базе данных JDBC
saveAsDataSourceСохраните источник данных JDBC

Примеры

свернуть все

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

Создайте источник данных SQL Server для подключения к базе данных JDBC.

vendor = "Microsoft SQL Server";
opts = databaseConnectionOptions("jdbc",vendor)
opts = 
  SQLConnectionOptions with properties:

              DataSourceName: ""
                      Vendor: "Microsoft SQL Server"

          JDBCDriverLocation: ""
                DatabaseName: ""
                      Server: "localhost"
                  PortNumber: 1433
          AuthenticationType: "Server"

opts является SQLConnectionOptions объект со следующими свойствами:

  • DataSourceName - Имя источника данных

  • Vendor - Имя поставщика базы данных

  • JDBCDriverLocation - Полный путь к файлу драйвера JDBC

  • DatabaseName - Имя базы данных

  • Server - Имя сервера базы данных

  • PortNumber - Номер порта

  • AuthenticationType - Тип проверки подлинности

Сконфигурируйте источник данных путем установки опций подключения JDBC для источника данных SQLServerDataSource, полный путь к файлу драйвера JDBC, имя базы данных toystore_doc, сервер баз данных dbtb04, номер порта 54317и проверку подлинности Windows ® .

opts = setoptions(opts, ...
    'DataSourceName',"SQLServerDataSource", ...
    'JDBCDriverLocation',"C:\Drivers\mssql-jdbc-7.0.0.jre8.jar", ...
    'DatabaseName',"toystore_doc",'Server',"dbtb04", ...
    'PortNumber',54317,'AuthenticationType',"Windows")
opts = 
  SQLConnectionOptions with properties:

              DataSourceName: "SQLServerDataSource"
                      Vendor: "Microsoft SQL Server"

          JDBCDriverLocation: "C:\Drivers\mssql-jdbc-7.0.0.jre8.jar"
                DatabaseName: "toystore_doc"
                      Server: "dbtb04"
                  PortNumber: 54317
          AuthenticationType: "Windows"

The setoptions функция устанавливает DataSourceName, JDBCDriverLocation, DatabaseName, Server, PortNumber, и AuthenticationType свойства в SQLConnectionOptions объект.

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

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

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

saveAsDataSource(opts)

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

Введенный в R2020b