Exponenta Banner
exponenta event banner

testConnection

(Подлежит удалению) Проверить подключение к источнику данных JDBC

свернуть все на странице

testConnection функция будет удалена в следующей версии. Используйте testConnection функции SQLConnectionOptions вместо этого объект. Дополнительные сведения см. в разделе Вопросы совместимости.

Синтаксис

status = startConnection (параметры, имя пользователя, пароль)
[status, message] = startConnection (параметры, имя пользователя, пароль)

Описание

пример

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 или приложение «Обозреватель баз данных».

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

свернуть все

Параметры подключения JDBC, указанные как JDBCConnectionOptions объект.

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

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

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

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

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

свернуть все

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

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

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

Приложение

Можно протестировать подключение источника данных JDBC с помощью диалогового окна «Настройка источника данных JDBC» в приложении «Обозреватель баз данных». В разделе «Источник данных» вкладки «Обозреватель баз данных» выберите «Настройка источника данных» > «Настройка источника данных JDBC».

Вопросы совместимости

развернуть все

Не рекомендуется начинать с R2020b

См. также

Объекты

Функции

Темы

Представлен в R2019b

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

Поддержка