51.15. pg_database

В каталоге pg_database хранится информация о доступных базах данных. Базы данных создаются командой CREATE DATABASE. Подробнее о предназначении некоторых свойств баз можно узнать в Главе 22.

В отличие от большинства системных каталогов, pg_database разделяется всеми базами данных кластера: есть только один экземпляр pg_database в кластере, а не отдельные в каждой базе данных.

Таблица 51.15. Столбцы pg_database

NameТипСсылкиОписание
oidoid Идентификатор строки
datnamename Имя базы данных
datdbaoidpg_authid.oidВладелец базы данных, обычно пользователь, создавший её
encodingint4 Кодировка символов для этой базы данных (pg_encoding_to_char() может преобразовать этот номер в имя кодировки)
datcollatename LC_COLLATE для этой базы данных
datctypename LC_CTYPE для этой базы данных
datistemplatebool Если true, базу данных сможет клонировать любой пользователь с правами CREATEDB; в противном случае клонировать эту базу смогут только суперпользователи и её владелец.
datallowconnbool Если false, никто не сможет подключаться к этой базе данных. Это позволяет защитить базу данных template0 от модификаций.
datconnlimitint4 Задаёт максимально допустимое число одновременных подключений к этой базе данных. С -1 ограничения нет, с -2 к базе данных нельзя подключаться.
datlastsysoidoid Последний системный OID в базе данных; в частности, полезен для pg_dump
datfrozenxidxid Все идентификаторы транзакций, предшествующие данному, в этой базе данных заменены постоянным («замороженным») идентификатором транзакции. Это нужно для определения, когда требуется очищать базу данных для предотвращения зацикливания идентификаторов или для сокращения объёма pg_xact. Это значение вычисляется как минимум значений pg_class.relfrozenxid для всех таблиц.
datminmxidxid Идентификаторы мультитранзакций, предшествующие данному, в этой базе данных заменены другим идентификатором транзакции. Это нужно для определения, когда требуется очищать базу данных для предотвращения зацикливания идентификаторов мультитранзакций или для сокращения объёма pg_multixact. Это значение вычисляется как минимум значений pg_class.relminmxid для всех таблиц.
dattablespaceoidpg_tablespace.oidТабличное пространство по умолчанию для данной базы данных. Если таблица базы находится в этом пространстве, для неё значение pg_class.reltablespace будет нулевым; в частности, в нём окажутся все частные системные каталоги этой базы.
dataclaclitem[] Права доступа; за подробностями обратитесь к Разделу 5.7.

51.15. pg_database

The catalog pg_database stores information about the available databases. Databases are created with the CREATE DATABASE command. Consult Chapter 22 for details about the meaning of some of the parameters.

Unlike most system catalogs, pg_database is shared across all databases of a cluster: there is only one copy of pg_database per cluster, not one per database.

Table 51.15. pg_database Columns

NameTypeReferencesDescription
oidoid Row identifier
datnamename Database name
datdbaoidpg_authid.oidOwner of the database, usually the user who created it
encodingint4 Character encoding for this database (pg_encoding_to_char() can translate this number to the encoding name)
datcollatename LC_COLLATE for this database
datctypename LC_CTYPE for this database
datistemplatebool  If true, then this database can be cloned by any user with CREATEDB privileges; if false, then only superusers or the owner of the database can clone it.
datallowconnbool  If false then no one can connect to this database. This is used to protect the template0 database from being altered.
datconnlimitint4  Sets maximum number of concurrent connections that can be made to this database. -1 means no limit, -2 indicates the database is invalid.
datlastsysoidoid  Last system OID in the database; useful particularly to pg_dump
datfrozenxidxid  All transaction IDs before this one have been replaced with a permanent (frozen) transaction ID in this database. This is used to track whether the database needs to be vacuumed in order to prevent transaction ID wraparound or to allow pg_xact to be shrunk. It is the minimum of the per-table pg_class.relfrozenxid values.
datminmxidxid  All multixact IDs before this one have been replaced with a transaction ID in this database. This is used to track whether the database needs to be vacuumed in order to prevent multixact ID wraparound or to allow pg_multixact to be shrunk. It is the minimum of the per-table pg_class.relminmxid values.
dattablespaceoidpg_tablespace.oid The default tablespace for the database. Within this database, all tables for which pg_class.reltablespace is zero will be stored in this tablespace; in particular, all the non-shared system catalogs will be there.
dataclaclitem[]  Access privileges; see Section 5.7 for details

FAQ