exponenta event banner

testConnection

Тестирование подключения базы данных собственного интерфейса PostgreSQL

Описание

пример

status = testConnection(opts,username,password) проверяет подключение базы данных собственного интерфейса PostgreSQL, указанное SQLConnectionOptions объект opts, имя пользователя и пароль.

пример

[status,message] = testConnection(opts,username,password) также возвращает сообщение об ошибке, связанное с тестированием подключения к базе данных.

Примеры

свернуть все

Создание, настройка, тестирование и сохранение источника данных собственного интерфейса PostgreSQL для базы данных PostgreSQL.

Создайте источник данных собственного интерфейса PostgreSQL для подключения базы данных собственного интерфейса PostgreSQL.

vendor = "PostgreSQL";
opts = databaseConnectionOptions("native",vendor)
opts = 
  SQLConnectionOptions with properties:

              DataSourceName: ""
                      Vendor: "PostgreSQL"

                DatabaseName: ""
                      Server: "localhost"
                  PortNumber: 5432

opts является SQLConnectionOptions объект со следующими свойствами:

  • DataSourceName - Наименование источника данных

  • Vendor - Имя поставщика базы данных

  • DatabaseName - Имя базы данных

  • Server - Имя сервера базы данных

  • PortNumber - Номер порта

Настройка источника данных путем установки параметров подключения к базе данных для источника данных PostgreSQLDataSource, имя базы данных toystore_doc, сервер базы данных dbtb00, и номер порта 5432.

opts = setoptions(opts, ...
    'DataSourceName',"PostgreSQLDataSource", ...
    'DatabaseName',"toystore_doc",'Server',"dbtb00", ...
    'PortNumber',5432)
opts = 
  SQLConnectionOptions with properties:

              DataSourceName: "PostgreSQLDataSource"
                      Vendor: "PostgreSQL"

                DatabaseName: "toystore_doc"
                      Server: "dbtb00"
                  PortNumber: 5432

setoptions функция устанавливает DataSourceName, DatabaseName, Server, и PortNumber свойства в SQLConnectionOptions объект.

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

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

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

saveAsDataSource(opts)

Можно подключиться к новому источнику данных с помощью postgresql или приложение «Обозреватель баз данных».

Создание и настройка источника данных собственного интерфейса PostgreSQL для базы данных PostgreSQL. Проверьте подключение базы данных к источнику данных собственного интерфейса PostgreSQL и получите сообщение об ошибке.

Создайте собственный источник данных интерфейса PostgreSQL для подключения к базе данных PostgreSQL.

vendor = "PostgreSQL";
opts = databaseConnectionOptions("native",vendor)
opts = 
  SQLConnectionOptions with properties:

              DataSourceName: ""
                      Vendor: "PostgreSQL"

                DatabaseName: ""
                      Server: "localhost"
                  PortNumber: 5432

opts является SQLConnectionOptions объект со следующими свойствами:

  • DataSourceName - Наименование источника данных

  • Vendor - Имя поставщика базы данных

  • DatabaseName - Имя базы данных

  • Server - Имя сервера базы данных

  • PortNumber - Номер порта

Настройка источника данных путем установки параметров подключения к базе данных для источника данных PostgreSQLDataSource, имя базы данных toystore_doc, сервер базы данных dbtb00, и номер порта 5432.

opts = setoptions(opts, ...
    'DataSourceName',"PostgreSQLDataSource", ...
    'DatabaseName',"toystore_doc",'Server',"dbtb00", ...
    'PortNumber',5432)
opts = 
  SQLConnectionOptions with properties:

              DataSourceName: "PostgreSQLDataSource"
                      Vendor: "PostgreSQL"

                DatabaseName: "toystore_doc"
                      Server: "dbtb00"
                  PortNumber: 5432

setoptions функция устанавливает DataSourceName, DatabaseName, Server, и PortNumber свойства в SQLConnectionOptions объект.

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

username = "wronguser";
password = "wrongpassword";
[status,message] = testConnection(opts,username,password)
status = logical
   0

message =
    'Driver Error: FATAL:  password authentication failed for user "wronguser"
    FATAL:  password authentication failed for user "wronguser"
    '

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

свернуть все

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

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

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

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

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

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

свернуть все

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

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

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