character_sets

34.7. character_sets

The view character_sets identifies the character sets available in the current database. Since PostgreSQL does not support multiple character sets within one database, this view only shows one, which is the database encoding.

Take note of how the following terms are used in the SQL standard:

character repertoire

An abstract collection of characters, for example UNICODE, UCS, or LATIN1. Not exposed as an SQL object, but visible in this view.

character encoding form

An encoding of some character repertoire. Most older character repertoires only use one encoding form, and so there are no separate names for them (e.g., LATIN1 is an encoding form applicable to the LATIN1 repertoire). But for example Unicode has the encoding forms UTF8, UTF16, etc. (not all supported by PostgreSQL). Encoding forms are not exposed as an SQL object, but are visible in this view.

character set

A named SQL object that identifies a character repertoire, a character encoding, and a default collation. A predefined character set would typically have the same name as an encoding form, but users could define other names. For example, the character set UTF8 would typically identify the character repertoire UCS, encoding form UTF8, and some default collation.

You can think of an "encoding" in PostgreSQL either as a character set or a character encoding form. They will have the same name, and there can only be one in one database.

Table 34-5. character_sets Columns

NameData TypeDescription
character_set_catalogsql_identifierCharacter sets are currently not implemented as schema objects, so this column is null.
character_set_schemasql_identifierCharacter sets are currently not implemented as schema objects, so this column is null.
character_set_namesql_identifierName of the character set, currently implemented as showing the name of the database encoding
character_repertoiresql_identifierCharacter repertoire, showing UCS if the encoding is UTF8, else just the encoding name
form_of_usesql_identifierCharacter encoding form, same as the database encoding
default_collate_catalogsql_identifierName of the database containing the default collation (always the current database, if any collation is identified)
default_collate_schemasql_identifierName of the schema containing the default collation
default_collate_namesql_identifier Name of the default collation. The default collation is identified as the collation that matches the COLLATE and CTYPE settings of the current database. If there is no such collation, then this column and the associated schema and catalog columns are null.