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

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

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

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

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

saveAsDataSource(opts)

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

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

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

Проверьте подключение к базе данных с использованием неправильных имени пользователя и пароля. The 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