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 функционируйте или приложение 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

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

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

свернуть все

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

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

Введенный в R2020b