databaseConnectionOptions

Создайте опции соединения с базой данных

Описание

пример

opts = databaseConnectionOptions(drivertype,vendor) создает SQLConnectionOptions объект opts использование заданного типа драйвера и поставщика базы данных. SQLConnectionOptions объект содержит опции соединения с базой данных.

пример

opts = databaseConnectionOptions(datasource) позволяет вам отредактировать существующий источник данных с помощью его имени.

Примеры

свернуть все

Создайте, сконфигурируйте, протестируйте и сохраните источник данных 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.

Отредактируйте существующий источник данных JDBC для базы данных Microsoft® SQL Server®. Установите дополнительную специфичную для драйвера опцию JDBC и сохраните источник данных.

Получите существующий источник данных SQL Server SQLServerDataSource.

datasource = "SQLServerDataSource";
opts = databaseConnectionOptions(datasource)
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"

opts SQLConnectionOptions объект с этими свойствами:

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

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

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

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

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

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

  • AuthenticationType — Тип аутентификации

Добавьте специфичную для драйвера опцию связи JDBC при помощи аргумента пары "имя-значение". Опция задает значение тайм-аута для установления соединения с базой данных. opts содержит новый раздел свойств для дополнительной опции связи JDBC.

opts = setoptions(opts,'loginTimeout',"20")
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"

	Additional Connection Options:

                loginTimeout: "20"

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

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

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

saveAsDataSource(opts)

Входные параметры

свернуть все

Тип драйвера в виде одного из этих значений:

  • "jdbc" — Драйвер JDBC

  • "native" — Нативный интерфейс

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

Поставщик базы данных в виде одного из этих значений:

  • Для драйверов JDBC:

    • "Microsoft SQL Server"База данных Microsoft® SQL Server®

    • "MySQL" — База данных MySQL®

    • "Oracle" — База данных Oracle®

    • "PostgreSQL" — База данных PostgreSQL

    • "Other" — Другая база данных

  • Для нативных интерфейсов:

    • "MySQL" — Собственный интерфейс MySQL

    • "PostgreSQL" — Собственный интерфейс PostgreSQL

Если drivertype входным параметром является "jdbc", затем vendor аргумент должен быть одним из значений для драйверов JDBC. Если drivertype входным параметром является "native", затем vendor аргумент должен быть одним из значений для нативных интерфейсов.

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

Имя источника данных в виде вектора символов или строкового скаляра. Задайте имя существующего источника данных.

Пример: "myDataSource"

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

Выходные аргументы

свернуть все

Опции соединения с базой данных, возвращенные как один из следующих объектов:

  • SQLConnectionOptions — Опции соединения с базой данных JDBC

  • SQLConnectionOptions — Собственный компонент MySQL соединяет интерфейсом с опциями связи

  • SQLConnectionOptions — Собственный компонент PostgreSQL соединяет интерфейсом с опциями связи

Альтернативная функциональность

Приложение

Можно открыть Конфигурацию источника данных JDBC, MySQL Data Source Configuration или диалоговые окна PostgreSQL Data Source Configuration с помощью приложения Database Explorer . В разделе Data Source вкладки Database Explorer выберите один из них соответственно:

  • Configure Data Source> Configure JDBC data source

  • Configure Data Source> Configure native data source> MySQL

  • Configure Data Source> Configure native data source> PostgreSQL

Введенный в R2020b