Exponenta 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'

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 в виде 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.

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

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

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

Смотрите также

Объекты

Функции

Темы

Введенный в R2019b

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

Поддержка