Компания Postgres Professional

52.7. `pg_attribute`
Пред.	Наверх	Глава 52. Системные каталоги	Начало	След.

52.7. `pg_attribute` #

В каталоге pg_attribute хранится информация о столбцах таблицы. Для каждого столбца каждой таблицы в pg_attribute существует ровно одна строка. (Также в этом каталоге будут записи для индексов и на самом деле для всех объектов, присутствующих в pg_class.)

Термин «атрибут» равнозначен «столбцу» и употребляется по историческим причинам.

Таблица 52.7. Столбцы pg_attribute

Тип столбца Описание
`attrelid` `oid` (ссылается на `pg_class`.`oid`) Таблица, к которой принадлежит столбец
`attname` `name` Имя столбца
`atttypid` `oid` (ссылается на `pg_type`.`oid`) Тип данных этого столбца (ноль для удалённого столбца)
`attlen` `int2` Копия `pg_type.typlen` из записи типа столбца
`attnum` `int2` Порядковый номер столбца. Обычные столбцы нумеруются по возрастанию, начиная с 1. Системные столбцы, такие как `ctid`, имеют (обычно) отрицательные номера.
`atttypmod` `int4` В поле `atttypmod` записывается дополнительное число, связанное с определённым типом данных, указываемое при создании таблицы (например, максимальный размер столбца `varchar`). Это значение передаётся функциям ввода и преобразования длины конкретного типа. Для типов, которым не нужен `atttypmod`, это обычно -1.
`attndims` `int2` Число размерностей, если столбец имеет тип массива; ноль в противном случае. (В настоящее время число размерностей массива не контролируется, поэтому любое ненулевое значение по сути означает «это массив».)
`attbyval` `bool` Копия `pg_type.typbyval` из записи типа столбца
`attalign` `char` Копия `pg_type.typalign` из записи типа столбца
`attstorage` `char` Обычно копия `pg_type.typstorage` из записи типа столбца. Для типов, поддерживающих TOAST, можно изменять это значение после создания столбца и таким образом управлять политикой хранения.
`attcompression` `char` Текущий метод сжатия столбца. Обычно задано значение `'\0'`, то есть действует метод, установленный по умолчанию (см. default_toast_compression). В других случаях: если указано значение `'p'`, используется алгоритм сжатия `pglz`, если указано `'l'` — алгоритм LZ4. Это значение игнорируется, если `attstorage` не поддерживает сжатие.
`attnotnull` `bool` Представляет ограничение NOT NULL (возможно, нерабочее).
`atthasdef` `bool` Столбец имеет значение по умолчанию или генерирующее выражение, в этом случае в каталоге `pg_attrdef` будет соответствующая запись, собственно задающая это выражение. (Определить, является ли это выражение генерирующим или оно вычисляет значение по умолчанию, можно по атрибуту `attgenerated`.)
`atthasmissing` `bool` Столбец имеет значение, которое используется, когда он полностью отсутствует в строке. Это имеет место, когда столбец добавляется с неизменчивым значением `DEFAULT` после создания строки. Фактическое значение хранится в `attmissingval`.
`attidentity` `char` Пустой символ (`''`) указывает, что это не столбец идентификации. Символ `a` указывает, что значение генерируется всегда, а `d` — что значение генерируется по умолчанию.
`attgenerated` `char` Если нулевой байт (`''`), это не генерируемый столбец. В противном случае `s` означает, что генерируемое значение хранится (stored), a `v`, что оно является виртуальным (virtual). Хранимый генерируемый столбец физически хранится, как обычный столбец. Виртуальный генерируемый столбец физически хранится, как значение `NULL`, а фактическое значение вычисляется в момент выполнения.
`attisdropped` `bool` Столбец был удалён и теперь не является рабочим. Удалённый столбец может по-прежнему физически присутствовать в таблице, но анализатор запросов его игнорирует, так что обратиться к нему из SQL нельзя.
`attislocal` `bool` Столбец определён локально в данном отношении. Заметьте, что столбец может быть определён локально и при этом наследоваться.
`attinhcount` `int2` Число прямых предков этого столбца. Столбец с ненулевым числом предков нельзя удалить или переименовать.
`attcollation` `oid` (ссылается на `pg_collation`.`oid`) Заданное для столбца правило сортировки, либо ноль, если тип столбца не сортируемый.
`attstattarget` `int2` Столбец `attstattarget` управляет детализацией статистики, собираемой по этому столбцу командой `ANALYZE`. Нулевое значение указывает, что статистика не собирается. При значении NULL используется системное ограничение статистики по умолчанию. Точное значение положительных величин определяется типом данных. Для скалярных типов данных, `attstattarget` задаёт и целевое число собираемых «самых частых значений», и целевое число создаваемых групп гистограммы.
`attacl` `aclitem[]` Права доступа к столбцу, если они были заданы непосредственно для этого столбца
`attoptions` `text[]` Параметры уровня атрибута, в виде строк «ключ=значение»
`attfdwoptions` `text[]` Параметры уровня атрибута для обёрток сторонних данных, в виде строк «ключ=значение»
`attmissingval` `anyarray` В данном столбце размещается массив с одним элементом. Значение в этом элементе используется, когда столбец полностью отсутствует в строке, что имеет место, когда столбец добавляется с неизменчивым значением `DEFAULT` после создания строки. Это значение используется, только когда `atthasmissing` равен true. Если значение отсутствует, столбец будет содержать NULL.

Тип столбца

Описание

attrelid oid (ссылается на pg_class.oid)

Таблица, к которой принадлежит столбец

attname name

Имя столбца

atttypid oid (ссылается на pg_type.oid)

Тип данных этого столбца (ноль для удалённого столбца)

attlen int2

Копия pg_type.typlen из записи типа столбца

attnum int2

Порядковый номер столбца. Обычные столбцы нумеруются по возрастанию, начиная с 1. Системные столбцы, такие как ctid, имеют (обычно) отрицательные номера.

atttypmod int4

В поле atttypmod записывается дополнительное число, связанное с определённым типом данных, указываемое при создании таблицы (например, максимальный размер столбца varchar). Это значение передаётся функциям ввода и преобразования длины конкретного типа. Для типов, которым не нужен atttypmod, это обычно -1.

attndims int2

Число размерностей, если столбец имеет тип массива; ноль в противном случае. (В настоящее время число размерностей массива не контролируется, поэтому любое ненулевое значение по сути означает «это массив».)

attbyval bool

Копия pg_type.typbyval из записи типа столбца

attalign char

Копия pg_type.typalign из записи типа столбца

attstorage char

Обычно копия pg_type.typstorage из записи типа столбца. Для типов, поддерживающих TOAST, можно изменять это значение после создания столбца и таким образом управлять политикой хранения.

attcompression char

Текущий метод сжатия столбца. Обычно задано значение '\0', то есть действует метод, установленный по умолчанию (см. default_toast_compression). В других случаях: если указано значение 'p', используется алгоритм сжатия pglz, если указано 'l' — алгоритм LZ4. Это значение игнорируется, если attstorage не поддерживает сжатие.

attnotnull bool

Представляет ограничение NOT NULL (возможно, нерабочее).

atthasdef bool

Столбец имеет значение по умолчанию или генерирующее выражение, в этом случае в каталоге pg_attrdef будет соответствующая запись, собственно задающая это выражение. (Определить, является ли это выражение генерирующим или оно вычисляет значение по умолчанию, можно по атрибуту attgenerated.)

atthasmissing bool

Столбец имеет значение, которое используется, когда он полностью отсутствует в строке. Это имеет место, когда столбец добавляется с неизменчивым значением DEFAULT после создания строки. Фактическое значение хранится в attmissingval.

attidentity char

Пустой символ ('') указывает, что это не столбец идентификации. Символ a указывает, что значение генерируется всегда, а d — что значение генерируется по умолчанию.

attgenerated char

Если нулевой байт (''), это не генерируемый столбец. В противном случае s означает, что генерируемое значение хранится (stored), a v, что оно является виртуальным (virtual). Хранимый генерируемый столбец физически хранится, как обычный столбец. Виртуальный генерируемый столбец физически хранится, как значение NULL, а фактическое значение вычисляется в момент выполнения.

attisdropped bool

Столбец был удалён и теперь не является рабочим. Удалённый столбец может по-прежнему физически присутствовать в таблице, но анализатор запросов его игнорирует, так что обратиться к нему из SQL нельзя.

attislocal bool

Столбец определён локально в данном отношении. Заметьте, что столбец может быть определён локально и при этом наследоваться.

attinhcount int2

Число прямых предков этого столбца. Столбец с ненулевым числом предков нельзя удалить или переименовать.

attcollation oid (ссылается на pg_collation.oid)

Заданное для столбца правило сортировки, либо ноль, если тип столбца не сортируемый.

attstattarget int2

Столбец attstattarget управляет детализацией статистики, собираемой по этому столбцу командой ANALYZE. Нулевое значение указывает, что статистика не собирается. При значении NULL используется системное ограничение статистики по умолчанию. Точное значение положительных величин определяется типом данных. Для скалярных типов данных, attstattarget задаёт и целевое число собираемых «самых частых значений», и целевое число создаваемых групп гистограммы.

attacl aclitem[]

Права доступа к столбцу, если они были заданы непосредственно для этого столбца

attoptions text[]

Параметры уровня атрибута, в виде строк «ключ=значение»

attfdwoptions text[]

Параметры уровня атрибута для обёрток сторонних данных, в виде строк «ключ=значение»

attmissingval anyarray

В данном столбце размещается массив с одним элементом. Значение в этом элементе используется, когда столбец полностью отсутствует в строке, что имеет место, когда столбец добавляется с неизменчивым значением DEFAULT после создания строки. Это значение используется, только когда atthasmissing равен true. Если значение отсутствует, столбец будет содержать NULL.

В записи удалённого столбца в pg_attribute поле atttypid сбрасывается в ноль, но attlen и другие поля, копируемые из pg_type, сохраняют актуальные значения. Это нужно, чтобы справиться с ситуацией, когда после удаления столбца удаляется и его тип данных, так что записи в pg_type больше не будет. В таких случаях для интерпретации содержимого строки таблицы могут использоваться attlen и другие поля.

Пред.	Наверх	След.
52.6. `pg_attrdef`	Начало	52.8. `pg_authid`

52.7. `pg_attribute`
Prev	Up	Chapter 52. System Catalogs	Home	Next

52.7. `pg_attribute` #

The catalog pg_attribute stores information about table columns. There will be exactly one pg_attribute row for every column in every table in the database. (There will also be attribute entries for indexes, and indeed all objects that have pg_class entries.)

The term attribute is equivalent to column and is used for historical reasons.

Table 52.7. pg_attribute Columns

Column Type Description
`attrelid` `oid` (references `pg_class`.`oid`) The table this column belongs to
`attname` `name` The column name
`atttypid` `oid` (references `pg_type`.`oid`) The data type of this column (zero for a dropped column)
`attlen` `int2` A copy of `pg_type.typlen` of this column's type
`attnum` `int2` The number of the column. Ordinary columns are numbered from 1 up. System columns, such as `ctid`, have (arbitrary) negative numbers.
`atttypmod` `int4` `atttypmod` records type-specific data supplied at table creation time (for example, the maximum length of a `varchar` column). It is passed to type-specific input functions and length coercion functions. The value will generally be -1 for types that do not need `atttypmod`.
`attndims` `int2` Number of dimensions, if the column is an array type; otherwise 0. (Presently, the number of dimensions of an array is not enforced, so any nonzero value effectively means “it's an array”.)
`attbyval` `bool` A copy of `pg_type.typbyval` of this column's type
`attalign` `char` A copy of `pg_type.typalign` of this column's type
`attstorage` `char` Normally a copy of `pg_type.typstorage` of this column's type. For TOAST-able data types, this can be altered after column creation to control storage policy.
`attcompression` `char` The current compression method of the column. Typically this is `'\0'` to specify use of the current default setting (see default_toast_compression). Otherwise, `'p'` selects pglz compression, while `'l'` selects LZ4 compression. However, this field is ignored whenever `attstorage` does not allow compression.
`attnotnull` `bool` This column has a (possibly invalid) not-null constraint.
`atthasdef` `bool` This column has a default expression or generation expression, in which case there will be a corresponding entry in the `pg_attrdef` catalog that actually defines the expression. (Check `attgenerated` to determine whether this is a default or a generation expression.)
`atthasmissing` `bool` This column has a value which is used where the column is entirely missing from the row, as happens when a column is added with a non-volatile `DEFAULT` value after the row is created. The actual value used is stored in the `attmissingval` column.
`attidentity` `char` If a zero byte (`''`), then not an identity column. Otherwise, `a` = generated always, `d` = generated by default.
`attgenerated` `char` If a zero byte (`''`), then not a generated column. Otherwise, `s` = stored, `v` = virtual. A stored generated column is physically stored like a normal column. A virtual generated column is physically stored as a null value, with the actual value being computed at run time.
`attisdropped` `bool` This column has been dropped and is no longer valid. A dropped column is still physically present in the table, but is ignored by the parser and so cannot be accessed via SQL.
`attislocal` `bool` This column is defined locally in the relation. Note that a column can be locally defined and inherited simultaneously.
`attinhcount` `int2` The number of direct ancestors this column has. A column with a nonzero number of ancestors cannot be dropped nor renamed.
`attcollation` `oid` (references `pg_collation`.`oid`) The defined collation of the column, or zero if the column is not of a collatable data type
`attstattarget` `int2` `attstattarget` controls the level of detail of statistics accumulated for this column by `ANALYZE`. A zero value indicates that no statistics should be collected. A null value says to use the system default statistics target. The exact meaning of positive values is data type-dependent. For scalar data types, `attstattarget` is both the target number of “most common values” to collect, and the target number of histogram bins to create.
`attacl` `aclitem[]` Column-level access privileges, if any have been granted specifically on this column
`attoptions` `text[]` Attribute-level options, as “keyword=value” strings
`attfdwoptions` `text[]` Attribute-level foreign data wrapper options, as “keyword=value” strings
`attmissingval` `anyarray` This column has a one element array containing the value used when the column is entirely missing from the row, as happens when the column is added with a non-volatile `DEFAULT` value after the row is created. The value is only used when `atthasmissing` is true. If there is no value the column is null.

Column Type

Description

attrelid oid (references pg_class.oid)

The table this column belongs to

attname name

The column name

atttypid oid (references pg_type.oid)

The data type of this column (zero for a dropped column)

attlen int2

A copy of pg_type.typlen of this column's type

attnum int2

The number of the column. Ordinary columns are numbered from 1 up. System columns, such as ctid, have (arbitrary) negative numbers.

atttypmod int4

atttypmod records type-specific data supplied at table creation time (for example, the maximum length of a varchar column). It is passed to type-specific input functions and length coercion functions. The value will generally be -1 for types that do not need atttypmod.

attndims int2

Number of dimensions, if the column is an array type; otherwise 0. (Presently, the number of dimensions of an array is not enforced, so any nonzero value effectively means “it's an array”.)

attbyval bool

A copy of pg_type.typbyval of this column's type

attalign char

A copy of pg_type.typalign of this column's type

attstorage char

Normally a copy of pg_type.typstorage of this column's type. For TOAST-able data types, this can be altered after column creation to control storage policy.

attcompression char

The current compression method of the column. Typically this is '\0' to specify use of the current default setting (see default_toast_compression). Otherwise, 'p' selects pglz compression, while 'l' selects LZ4 compression. However, this field is ignored whenever attstorage does not allow compression.

attnotnull bool

This column has a (possibly invalid) not-null constraint.

atthasdef bool

This column has a default expression or generation expression, in which case there will be a corresponding entry in the pg_attrdef catalog that actually defines the expression. (Check attgenerated to determine whether this is a default or a generation expression.)

atthasmissing bool

This column has a value which is used where the column is entirely missing from the row, as happens when a column is added with a non-volatile DEFAULT value after the row is created. The actual value used is stored in the attmissingval column.

attidentity char

If a zero byte (''), then not an identity column. Otherwise, a = generated always, d = generated by default.

attgenerated char

If a zero byte (''), then not a generated column. Otherwise, s = stored, v = virtual. A stored generated column is physically stored like a normal column. A virtual generated column is physically stored as a null value, with the actual value being computed at run time.

attisdropped bool

This column has been dropped and is no longer valid. A dropped column is still physically present in the table, but is ignored by the parser and so cannot be accessed via SQL.

attislocal bool

This column is defined locally in the relation. Note that a column can be locally defined and inherited simultaneously.

attinhcount int2

The number of direct ancestors this column has. A column with a nonzero number of ancestors cannot be dropped nor renamed.

attcollation oid (references pg_collation.oid)

The defined collation of the column, or zero if the column is not of a collatable data type

attstattarget int2

attstattarget controls the level of detail of statistics accumulated for this column by ANALYZE. A zero value indicates that no statistics should be collected. A null value says to use the system default statistics target. The exact meaning of positive values is data type-dependent. For scalar data types, attstattarget is both the target number of “most common values” to collect, and the target number of histogram bins to create.

attacl aclitem[]

Column-level access privileges, if any have been granted specifically on this column

attoptions text[]

Attribute-level options, as “keyword=value” strings

attfdwoptions text[]

Attribute-level foreign data wrapper options, as “keyword=value” strings

attmissingval anyarray

This column has a one element array containing the value used when the column is entirely missing from the row, as happens when the column is added with a non-volatile DEFAULT value after the row is created. The value is only used when atthasmissing is true. If there is no value the column is null.

In a dropped column's pg_attribute entry, atttypid is reset to zero, but attlen and the other fields copied from pg_type are still valid. This arrangement is needed to cope with the situation where the dropped column's data type was later dropped, and so there is no pg_type row anymore. attlen and the other fields can be used to interpret the contents of a row of the table.

Prev	Up	Next
52.6. `pg_attrdef`	Home	52.8. `pg_authid`

52.7. pg_attribute #

52.7. pg_attribute #

52.7. `pg_attribute` #

52.7. `pg_attribute` #