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

Создайте, сконфигурируйте, протестируйте и сохраните источник данных 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.

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

свернуть все

`opts` — Опции связи JDBC
`JDBCConnectionOptions` объект

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

`username` — Имя пользователя
вектор символов | строковый скаляр

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

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

`password` — Пароль
вектор символов | строковый скаляр

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

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

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

свернуть все

`status` — Состояние Connection
логический

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

`message` — Сообщение об ошибке
символьный вектор

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

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

Приложение

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

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

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

`testConnection` функция будет удалена

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

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

Обновите код

Используйте testConnection функция с SQLConnectionOptions возразите, чтобы протестировать заданные опции связи JDBC.

В предшествующих релизах вы сконфигурировали источник данных JDBC с помощью JDBCConnectionOptions объект. Например:

opts = configureJDBCDataSource('Vendor','Microsoft SQL Server');
opts = setConnectionOptions(opts, ...
    'DataSourceName','SQLServerDataSource', ...
    'Server','dbtb04','PortNumber',54317, ...
    'JDBCDriverLocation','C:\Drivers\sqljdbc4.jar', ...
    'AuthType','Windows');
username = "";
password = "";
status = testConnection(opts,username,password);
saveAsJDBCDataSource(opts)

Теперь можно установить опции связи JDBC и сохранить источник данных с помощью SQLConnectionOptions объект вместо этого.

vendor = "Microsoft SQL Server";
opts = databaseConnectionOptions("jdbc",vendor);
opts = setoptions(opts, ...
    'DataSourceName',"SQLServerDataSource", ...
    'JDBCDriverLocation',"C:\Drivers\sqljdbc4.jar", ...
    'DatabaseName',"toystore_doc",'Server',"dbtb04", ...
    'PortNumber',54317,'AuthType',"Windows");
username = "";
password = "";
status = testConnection(opts,username,password);
saveAsDataSource(opts)

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

Объекты

JDBCConnectionOptions

Функции

addConnectionOptions | configureJDBCDataSource | deleteJDBCDataSource | rmConnectionOptions | saveAsJDBCDataSource | setConnectionOptions | testConnection

Темы

Введенный в R2019b

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

testConnection

Синтаксис

Описание

Примеры

Создайте источник данных JDBC

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

`opts` — Опции связи JDBC
`JDBCConnectionOptions` объект

`username` — Имя пользователя
вектор символов | строковый скаляр

`password` — Пароль
вектор символов | строковый скаляр

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

`status` — Состояние Connection
логический

`message` — Сообщение об ошибке
символьный вектор

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

Приложение

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

`testConnection` функция будет удалена

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

Объекты

Функции

Темы

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

Поддержка

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

testConnection

Синтаксис

Описание

Примеры

Создайте источник данных JDBC

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

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

username — Имя пользователя вектор символов | строковый скаляр

password — Пароль вектор символов | строковый скаляр

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

status — Состояние Connection логический

message — Сообщение об ошибке символьный вектор

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

Приложение

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

testConnection функция будет удалена

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

Объекты

Функции

Темы

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

Поддержка

`opts` — Опции связи JDBC
`JDBCConnectionOptions` объект

`username` — Имя пользователя
вектор символов | строковый скаляр

`password` — Пароль
вектор символов | строковый скаляр

`status` — Состояние Connection
логический

`message` — Сообщение об ошибке
символьный вектор

`testConnection` функция будет удалена