exponenta event banner

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" - Проверка подлинности 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"

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

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

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

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

saveAsDataSource(opts)

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

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