Connection String Options - PostgreSQL ODBC Driver

ODBC Driver for PostgreSQL

Connection String Options - PostgreSQL ODBC Driver

PostgreSQL Connection Options

The following table describes the options that you can include in the connection string for PostgreSQL:

Option Description

Server

Serves to supply the server name for login.

Port

Used to specify the port number for the connection. 5432 by default.

User ID

Used to supply a unique User ID for login.

Password

Used to supply a password for login.

Database

Used to set the name of the database

Schema

Used to change the search path of the connection to the specified schema, or get the first value from the search path.

Charset

Used to set the character set that ODBC driver for PostgreSQL uses to read and write character data.

UseUnicode

Informs server that all data between client and server sides will be passed in Utf8 coding. Setting this option converts all fields of the String type into WideString that allows to work correctly with symbols of almost all languages simultaneously. On the other hand, it causes a delay in working. If the Use Unicode property is enabled, the Charset property will be ignored. The default value is False.

ConnectionTimeout

Used to specify the time in seconds before an attempt to make a connection is considered unsuccessful.

IPVersion

Used to specify the version of the Internet Protocol. Ipv4 and Ipv6 are available. The IPBoth option value allows to check for available protocol versions and use the first available automatically.

Protocol

Used to set the version of protocol for communication with PostgreSQL server.

MinFetchRows

Respectively, if the SQL_ATTR_ROW_ARRAY_SIZE attribute value is less than MinFetchRows, then the number of rows queried from the server will equal MinFetchRows. Otherwise - it will be equal to SQL_ATTR_ROW_ARRAY_SIZE.

In order to make the driver to query from the server exactly the same number of rows as specified in the SQL_ATTR_ROW_ARRAY_SIZE attribute, it is enough to set the MinFetchRows parameter to 0. However, in this case, you should take into account, that the SQL_ATTR_ROW_ARRAY_SIZE value is 1 by default, and therefore performance decreases dramatically at this value.

Advanced Settings

Option Description

Allow NULL strings

To retrieve metadata, not all parameters according to MSDN can accept a null value. If NULL, the driver should return an error. But some 3rd-party tools pass NULL to the parameters. These options should be enabled for compatibility with such tools.

Empty strings as NULL

String Types

Sets the string value types returned by the driver as Default, Ansi or Unicode.

  • Default - the driver defines the string types.
  • Ansi - all string types will be returned as SQL_CHAR, SQL_VARCHAR and SLQ_LONGVARCHAR.
  • Unicode - all string types will be returned as SQL_WCHAR, SQL_WVARCHAR and SLQ_WLONGVARCHAR.

The option value should be changed if any third-party tool supports only Ansi string types or Unicode ones.

RegionalNumberSettings

Enables using local regional settings when converting numbers to string.

RegionalDateTimeSettings

Enables using local regional settings when converting dates and times to string.

PostgreSQL ODBC Connection String sample

DRIVER={Devart ODBC Driver for PostgreSQL};Data Source=localhost;User ID=postgres;Password=postgres;Database=postgres;Schema=public

See also:

© 2015-2018 Devart. All Rights Reserved. Request Support ODBC Forum Provide Feedback