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

Введенный в R2020b