databaseConnectionOptions

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

Описание

пример

opts = databaseConnectionOptions(drivertype,vendor) создает SQLConnectionOptions opts объекта использование указанного типа драйвера и поставщика базы данных. The 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"

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.

Отредактируйте существующий источник данных 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"

Проверьте подключение к базе данных с пустым именем пользователя и паролем. The 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

    • "Cassandra" - Апаче Кассандра® интерфейс C++ базы данных

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

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

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

Пример: "myDataSource"

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

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

свернуть все

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

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

Приложение

Можно открыть диалоговые окна Строения источника данных JDBC, Строение источника данных MySQL или Строение источника данных PostgreSQL с помощью приложения 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