51.15. pg_database #

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

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

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

Тип столбца

Описание

oid oid

Идентификатор строки

datname name

Имя базы данных

datdba oid (ссылается на pg_authid.oid)

Владелец базы данных, обычно пользователь, создавший её

encoding int4

Кодировка символов для этой базы данных (pg_encoding_to_char() может преобразовать этот номер в имя кодировки)

datlocprovider char

Провайдер локали для этой базы данных: b = builtin, c = libc, i = icu

datistemplate bool

Если true, базу данных сможет клонировать любой пользователь с правами CREATEDB; в противном случае клонировать эту базу смогут только суперпользователи и её владелец.

datallowconn bool

Если false, никто не сможет подключаться к этой базе данных. Это позволяет защитить базу данных template0 от модификаций.

dathasloginevt bool

Указывает, что для этой базы данных заданы событийные триггеры входа в систему. Этот флаг используется, чтобы избежать дополнительных операций поиска в таблице pg_event_trigger при запуске каждого обслуживающего процесса. Этот флаг используется внутри Postgres Pro и не должен изменяться вручную или считываться в целях мониторинга.

datconnlimit int4

Задаёт максимально допустимое число одновременных подключений к этой базе данных. С -1 ограничения нет, с -2 к базе данных нельзя подключаться.

datfrozenxid xid

Все идентификаторы транзакций, предшествующие данному, в этой базе данных заменены постоянным («замороженным») идентификатором транзакции. Это нужно для определения, когда требуется очищать базу данных для предотвращения зацикливания идентификаторов или для сокращения объёма pg_xact. Это значение вычисляется как минимум значений pg_class.relfrozenxid для всех таблиц.

datminmxid xid

Идентификаторы мультитранзакций, предшествующие данному, в этой базе данных заменены другим идентификатором транзакции. Это нужно для определения, когда требуется очищать базу данных для предотвращения зацикливания идентификаторов мультитранзакций или для сокращения объёма pg_multixact. Это значение вычисляется как минимум значений pg_class.relminmxid для всех таблиц.

dattablespace oid (ссылается на pg_tablespace.oid)

Табличное пространство по умолчанию для данной базы данных. Если таблица базы находится в этом пространстве, для неё значение pg_class.reltablespace будет нулевым; в частности, в нём окажутся все частные системные каталоги этой базы.

datcollate text

LC_COLLATE для этой базы данных

datctype text

LC_CTYPE для этой базы данных

datlocale text

Имя локали провайдера правил сортировки для этой базы данных. Если провайдер — libc, datlocale имеет значение NULL и вместо него используются datcollate и datctype.

daticurules text

Правила сортировки ICU для этой базы данных

datcollversion text

Определяемая провайдером версия правила сортировки. Она записывается при создании базы данных и проверяется при использовании для обнаружения изменений в его определении, чреватых повреждением данных.

datacl aclitem[]

Права доступа; за подробностями обратитесь к Разделу 5.8.


51.15. pg_database #

The catalog pg_database stores information about the available databases. Databases are created with the CREATE DATABASE command. Consult Chapter 21 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

Column Type

Description

oid oid

Row identifier

datname name

Database name

datdba oid (references pg_authid.oid)

Owner of the database, usually the user who created it

encoding int4

Character encoding for this database (pg_encoding_to_char() can translate this number to the encoding name)

datlocprovider char

Locale provider for this database: b = builtin, c = libc, i = icu

datistemplate bool

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.

datallowconn bool

If false then no one can connect to this database. This is used to protect the template0 database from being altered.

dathasloginevt bool

Indicates that there are login event triggers defined for this database. This flag is used to avoid extra lookups on the pg_event_trigger table during each backend startup. This flag is used internally by Postgres Pro and should not be manually altered or read for monitoring purposes.

datconnlimit int4

Sets maximum number of concurrent connections that can be made to this database. -1 means no limit, -2 indicates the database is invalid.

datfrozenxid xid

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.

datminmxid xid

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.

dattablespace oid (references pg_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.

datcollate text

LC_COLLATE for this database

datctype text

LC_CTYPE for this database

datlocale text

Collation provider locale name for this database. If the provider is libc, datlocale is NULL; datcollate and datctype are used instead.

daticurules text

ICU collation rules for this database

datcollversion text

Provider-specific version of the collation. This is recorded when the database is created and then checked when it is used, to detect changes in the collation definition that could lead to data corruption.

datacl aclitem[]

Access privileges; see Section 5.8 for details