testConnection

Тестирование подключения к базе данных JDBC

Описание

пример

status = testConnection(opts,username,password) проверяет соединение с базой данных JDBC, заданное SQLConnectionOptions opts объекта, имя пользователя и пароль.

пример

[status,message] = testConnection(opts,username,password) также возвращает сообщение об ошибке, связанное с проверкой подключения к базе данных.

Примеры

свернуть все

Создание, настройка, тестирование и сохранение источника данных 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 для подключения к базе данных 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и проверку подлинности SQL Server.

opts = setoptions(opts, ...
    'DataSourceName',"SQLServerDataSource", ...
    'JDBCDriverLocation',"C:\Drivers\mssql-jdbc-7.0.0.jre8.jar", ...
    'DatabaseName',"toystore_doc",'Server',"dbtb04", ...
    'PortNumber',54317,'AuthenticationType',"Server")
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: "Server"

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

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

username = "wronguser";
password = "wrongpassword";
[status,message] = testConnection(opts,username,password)
status = logical
   0

message = 
'JDBC Driver Error: Login failed for user 'wronguser'. ClientConnectionId:dfe57aed-973f-4c5f-838b-d733a24c40f0'

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

свернуть все

Опции подключения к базе данных, заданные как SQLConnectionOptions объект.

Имя пользователя, требуемое для доступа к базе данных, задается как вектор символов или строковый скаляр. Если имя пользователя не требуется, задайте пустое значение "".

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

Пароль, требуемый для доступа к базе данных, задается как вектор символов или строковый скаляр. Если пароль не требуется, задайте пустое значение "".

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

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

свернуть все

Состояние соединения, возвращенное как логическое true если тест соединения прошел или false если тест соединения завершается неуспешно.

Сообщение об ошибке, возвращенное как вектор символов. Если тест соединения пройден, сообщение об ошибке представляет собой пустой символьный вектор. В противном случае сообщение об ошибке содержит текст из неудачного подключения к базе данных.

Введенный в R2020b