PostgreSQL 9.6.24 Documentation
Prev | Up |  | Next

# dblink_error_message

## Name

dblink_error_message -- gets last error message on the named connection

## Synopsis

    dblink_error_message(text connname) returns text

## Description

`dblink_error_message` fetches the most recent remote error message for a given connection.

## Arguments

`connname`

  Name of the connection to use.

## Return Value

Returns last error message, or `OK` if there has been no error in this connection.

## Notes

When asynchronous queries are initiated by `dblink_send_query`, the error message associated with the connection might not get updated until the server's response message is consumed. This typically means that `dblink_is_busy` or `dblink_get_result` should be called prior to `dblink_error_message`, so that any error generated by the asynchronous query will be visible.

## Examples

    SELECT dblink_error_message('dtest1');

Prev | Home | Next
dblink_get_connections | Up | dblink_send_query