34.16. columns · PostgreSQL 中文文檔 9.3

# 34.16\. `columns` 視圖`columns`包含有關數據庫中所有表字段（或者視圖字段）的信息。不包括系統字段（比如`oid`等）。只有那些當前用戶有權訪問的字段才會顯示出來（要么是所有者，要么是有些權限）。 **Table 34-14\. `columns` 字段** | 名字 | 數據類型 | 描述 | | --- | --- | --- | | `table_catalog` | `sql_identifier` | 包含表的數據庫的名字（總是當前數據庫） | | `table_schema` | `sql_identifier` | 包含表的模式的名字 | | `table_name` | `sql_identifier` | 表的名字 | | `column_name` | `sql_identifier` | 字段的名字 | | `ordinal_position` | `cardinal_number` | 字段在表中的位置序號（從 1 開始） | | `column_default` | `character_data` | 字段的缺省表達式 | | `is_nullable` | `yes_or_no` | 如果字段可能為空，則為`YES`，如果知道它不能為空，則為`NO`。非空約束是我們得知字段不能為空的一個手段，但是還可能有其它的。 | | `data_type` | `character_data` | 如果它是一個內置類型，那么為字段的數據類型，如果它是某種數組，則為`ARRAY`（在這種情況下，參閱視圖`element_types`），否則就是`USER-DEFINED`（這時，類型定義在`udt_name`和相關的字段上）。如果字段基于域，這個字段引用底層域類型（而域是在`domain_name`和相關字段里定義的）。 | | `character_maximum_length` | `cardinal_number` | 如果`data_type`標識一個字符或者位串類型，那么就是聲明的最大長度；如果是其它類型或者沒有定義最大長度，就是空。 | | `character_octet_length` | `cardinal_number` | 如果`data_type`標識一個字符類型，就是以字節記的最大可能長度；所有其它類型都是空。最大字節長度取決于聲明的字節最大長度（見上文）和服務器編碼。 | | `numeric_precision` | `cardinal_number` | 如果`data_type`標識一個數值類型，這個字段包含（聲明的或隱含的）這個字段的數據類型的精度。精度表示有效小數位的長度。它可以用十進制或者二進制來表示，這一點在`numeric_precision_radix` 字段里聲明。對于其它數據類型，這個字段是空。 | | `numeric_precision_radix` | `cardinal_number` | 如果`data_type`標識一個數值類型，這個字段標識字段 `numeric_precision`和`numeric_scale` 里的數據是多少進制的。值要么是 2 要么是 10。對于所有其它數據類型，這個字段是空。 | | `numeric_scale` | `cardinal_number` | 如果`data_type`標識一個精確的數值類型，那么這個字段包含（聲明的或者隱含的）這個字段上這個類型的數值范圍。數值范圍表明小數點右邊的有效小數位的數目。它可以用十進制（10為基）或者二進制（二為基）來表示，正如字段`numeric_precision_radix` 聲明的那樣。對于所有其它數據類型，這個字段是空。 | | `datetime_precision` | `cardinal_number` | 如果`data_type`標識一個日期，時間，時間戳，或者間隔類型，該字段（公開地或隱含地）包含該字段類型的小數秒精度，就是說，小數位數保持到小數點后面。對于所有其它的數據類型，該字段是null。 | | `interval_type` | `character_data` | 如果`data_type`標識一個間隔類型，這個字段包含這個字段時間間隔聲明，例如，`YEAR TO MONTH`, `DAY TO SECOND`等等。如果沒有指定字段限制（也就是，間隔接受所有字段），或對于所有其他數據類型，這個字段是null。 | | `interval_precision` | `cardinal_number` | 用于一個PostgreSQL不可用的特性（參閱`datetime_precision`獲取間隔類型字段的小數秒精度） | | `character_set_catalog` | `sql_identifier` | 用于PostgreSQL里一個不可用的特性 | | `character_set_schema` | `sql_identifier` | 用于PostgreSQL里一個不可用的特性 | | `character_set_name` | `sql_identifier` | 用于PostgreSQL里一個不可用的特性 | | `collation_catalog` | `sql_identifier` | 包含該字段的排序規則的數據庫的名字（總是當前數據庫），缺省或者字段的數據類型不可排序時為null。 | | `collation_schema` | `sql_identifier` | 包含該字段的排序規則的模式的名字，缺省或者字段的數據類型不可排序時為null。 | | `collation_name` | `sql_identifier` | 字段的排序規則的名字，缺省或者字段的數據類型不可排序時為null。 | | `domain_catalog` | `sql_identifier` | 如果字段是域類型，就是該域定義所在的數據庫的名字（總是當前數據庫），否則為null。 | | `domain_schema` | `sql_identifier` | 如果字段是域類型，就是域定義所在的模式的名字，否則為null。 | | `domain_name` | `sql_identifier` | 如果字段是域類型，就是該域的名字，否則為null。 | | `udt_catalog` | `sql_identifier` | 這個字段數據類型（如果適用，就是底層域類型）定義所在的數據庫的名字（總是當前數據庫）。 | | `udt_schema` | `sql_identifier` | 這個字段數據類型（如果適用，就是底層域類型）定義所在的模式名字。 | | `udt_name` | `sql_identifier` | 這個字段數據類型（如果適用，就是底層域類型）的名字。 | | `scope_catalog` | `sql_identifier` | 用于PostgreSQL里一個不可用的特性 | | `scope_schema` | `sql_identifier` | 用于PostgreSQL里一個不可用的特性 | | `scope_name` | `sql_identifier` | 用于PostgreSQL里一個不可用的特性 | | `maximum_cardinality` | `cardinal_number` | 總是空，因為在PostgreSQL里數組總是有無限的最大維數 | | `dtd_identifier` | `sql_identifier` | 一個該字段的數據類型描述符的標識符，在屬于這個表中的所有的數據類型描述符中唯一。這個字段主要用于和其它這樣的標識符實例連接。（這個標識符的確切格式沒有定義并且不保證在將來的版本中保持一樣。） | | `is_self_referencing` | `yes_or_no` | 用于PostgreSQL里一個不可用的特性 | | `is_identity` | `yes_or_no` | 用于PostgreSQL里一個不可用的特性 | | `identity_generation` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `identity_start` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `identity_increment` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `identity_maximum` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `identity_minimum` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `identity_cycle` | `yes_or_no` | 用于PostgreSQL里一個不可用的特性 | | `is_generated` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `generation_expression` | `character_data` | 用于PostgreSQL里一個不可用的特性 | | `is_updatable` | `yes_or_no` | 如果字段為可更新則為`YES`，否則為`NO` （基表中的字段總是可以更新的，而試圖中的字段則不一定） | 因為數據類型在SQL里可以用多種方法定義，并且PostgreSQL包含額外的定義數據類型的方法，因此他們在信息模式里的表現形式可能不太一樣。字段`data_type` 會被用于標識該字段底層的內置數據類型。在PostgreSQL里，這意味著類型將定義在系統表模式`pg_catalog`里。如果應用可以很好地處理那些重要的內置類型（比如，對數值類型格式化成不同的東西，或者使用在精度字段里的數據），那么這個字段是有用的。字段`udt_name`, `udt_schema`, 和 `udt_catalog` 總是標識該字段的底層數據類型，即使字段是基于域的也一樣。（因為PostgreSQL 把內置類型看作和用戶定義類型一樣，所以，內置類型也在這里出現。這是對SQL標準的一個擴展。）如果一個應用想根據數據類型的不同而區別處理數據，那么應該使用這些字段，因為在這種情況下它不會在意這個字段是否真正基于域的。如果這個字段基于一個域，那么該域的標識保存在字段`domain_name`, `domain_schema`, 和`domain_catalog`里。如果你想把字段和他們相關的數據類型湊成對兒，并且把域當作不同的類型處理，你可以這么寫`coalesce(domain_name,udt_name)`等等。