Exponenta Banner
exponenta event banner

testConnection

(Будет удалено) Тестирование соединения с источником данных JDBC

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

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

Синтаксис

status = testConnection(opts,username,password)
[status,message] = testConnection(opts,username,password)

Описание

пример

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'

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

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

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

   1

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

saveAsJDBCDataSource(opts)

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

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

свернуть все

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

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

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

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

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

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

свернуть все

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

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

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

Приложение

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

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

расширить все

Не рекомендуемый запуск в R2020b

См. также

Объекты

Функции

Темы

Введенный в R2019b

Документация по Database Toolbox

Поддержка