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'

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.

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

свернуть все

`opts` - Опции подключения JDBC
`JDBCConnectionOptions` объект

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

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

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

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

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

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

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

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

свернуть все

`status` - Состояние соединения
логичный

Состояние соединения, возвращенное как логическое 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` - Состояние соединения
логичный

`message` - Сообщение об ошибке
вектор символов

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

Приложение

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

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

См. также

Объекты

Функции

Темы

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

Поддержка

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

testConnection

Синтаксис

Описание

Примеры

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

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

opts - Опции подключения JDBC JDBCConnectionOptions объект

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

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

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

status - Состояние соединения логичный

message - Сообщение об ошибке вектор символов

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

Приложение

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

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

См. также

Объекты

Функции

Темы

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

Поддержка

`opts` - Опции подключения JDBC
`JDBCConnectionOptions` объект

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

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

`status` - Состояние соединения
логичный

`message` - Сообщение об ошибке
вектор символов

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