testConnection

Протестируйте связь источника данных JDBC

Описание

пример

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

пример

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

Примеры

свернуть все

Создайте, сконфигурируйте, протестируйте и сохраните источник данных JDBC для базы данных Microsoft® SQL Server®.

Создайте источник данных SQL Server.

opts = configureJDBCDataSource('Vendor','Microsoft SQL Server')
opts = 
  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: ''

                DatabaseName: ''
                      Server: 'localhost'
                  PortNumber: 1433
                    AuthType: 'Server'

          JDBCDriverLocation: ''

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

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

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

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

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

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

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

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

Сконфигурируйте источник данных путем установки опций связи JDBC для источника данных SQLServerDataSource, сервер базы данных dbtb04, номер порта 54317, полный путь к файлу драйвера JDBC и аутентификация Windows®.

opts = setConnectionOptions(opts, ...
    'DataSourceName','SQLServerDataSource', ...
    'Server','dbtb04','PortNumber',54317, ...
    'JDBCDriverLocation','C:\Drivers\sqljdbc4.jar', ...
    'AuthType','Windows')
opts = 
  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: 'SQLServerDataSource'

                DatabaseName: ''
                      Server: 'dbtb04'
                  PortNumber: 54317
                    AuthType: 'Windows'

          JDBCDriverLocation: 'C:\Drivers\sqljdbc4.jar'

setConnectionOptions функционируйте устанавливает DataSourceName, Server, PortNumber, AuthType, и JDBCDriverLocation свойства в JDBCConnectionOptions объект.

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

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

Сохраните сконфигурированный источник данных.

saveAsJDBCDataSource(opts)

Можно соединиться с новым источником данных с помощью database функционируйте или приложение Database Explorer.

Создайте и сконфигурируйте источник данных JDBC к базе данных Microsoft® SQL Server®. Протестируйте соединение с базой данных к источнику данных JDBC и получите сообщение об ошибке.

Создайте источник данных SQL Server.

opts = configureJDBCDataSource('Vendor','Microsoft SQL Server')
opts = 
  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: ''

                DatabaseName: ''
                      Server: 'localhost'
                  PortNumber: 1433
                    AuthType: 'Server'

          JDBCDriverLocation: ''

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

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

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

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

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

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

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

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

Сконфигурируйте источник данных путем установки опций связи JDBC для источника данных SQLServerDataSource, сервер базы данных dbtb04, номер порта 54317, и полный путь к файлу драйвера JDBC.

opts = setConnectionOptions(opts, ...
    'DataSourceName','SQLServerDataSource', ...
    'Server','dbtb04','PortNumber',54317, ...
    'JDBCDriverLocation','C:\Drivers\sqljdbc4.jar')
opts = 
  JDBCConnectionOptions with properties:

                      Vendor: 'Microsoft SQL Server'
              DataSourceName: 'SQLServerDataSource'

                DatabaseName: ''
                      Server: 'dbtb04'
                  PortNumber: 54317
                    AuthType: 'Server'

          JDBCDriverLocation: 'C:\Drivers\sqljdbc4.jar'

setConnectionOptions функционируйте устанавливает DataSourceName, Server, PortNumber, и JDBCDriverLocation свойства в JDBCConnectionOptions объект.

Протестируйте соединение с базой данных с неправильным именем пользователя и паролем. 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:e857629d-1eb3-4e46-a015-6cbe380f4bd6'

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

свернуть все

Опции связи JDBC в виде JDBCConnectionOptions объект.

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

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

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

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

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

свернуть все

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

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

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

Приложение

Можно протестировать связь источника данных JDBC при помощи диалогового окна JDBC Data Source Configuration в приложении Database Explorer . В разделе Data Source вкладки Database Explorer выберите Configure Data Source> Configure JDBC data source.

Введенный в R2019b

Для просмотра документации необходимо авторизоваться на сайте