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"

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 для соединения с базой данных 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"

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

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

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

свернуть все

Состояние Connection, возвращенное как логический true если тестовые передачи связи или false если тест связи перестал работать.

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

Введенный в R2020b