表9.57「セッション情報関数」に、セッションおよびシステムの情報を抽出する関数を示します。

本節で列挙されている関数のほかに、同様にシステム情報を提供する統計システムに関連した数多くの関数があります。 27.2.2. 統計情報の表示にさらに情報があります。

session_userは、通常、現在のデータベース接続を開始したユーザです。しかし、スーパユーザはこの設定をSET SESSION AUTHORIZATIONを使用して変更することができます。 current_userは、権限の検査に適用されるユーザ識別子です。 通常はセッションユーザと同じですが、SET ROLEを使用して変更可能です。 SECURITY DEFINER属性を持つ関数の実行中にも変わります。 Unix用語で言うと、セッションユーザは「実ユーザ」で、現在のユーザは「実効ユーザ」です。

current_schema関数は、検索パスの最初にあるスキーマ名（もしくは、検索パスが空の場合はNULL値）を返します。 これは、対象スキーマを指定せずに作成される、すべてのテーブルまたは他の名前付きオブジェクトに使用されるスキーマです。 また、current_schemas(boolean) は、検索パスに存在する全てのスキーマ名の配列を返します。 booleanオプションにより、pg_catalogのような暗黙的に含まれているシステムスキーマを、結果の検索パスに含めるかどうかを指定します。

SET search_path TO schema [, schema, ...]

pg_listening_channelsは、現在のセッションで待ち受け中のチャンネル名のセットを返します。 詳細はLISTENを参照して下さい。

inet_client_addrは現在のクライアントのIPアドレスを返し、inet_client_portはそのポート番号を返します。 inet_server_addrは、現在の接続を受け付けたサーバのIPアドレスを返し、inet_server_portはそのポート番号を返します。 これら全ての関数は接続がUnixドメインソケット経由の場合NULLを返します。

pg_my_temp_schemaは、現在のセッションの一時スキーマのOIDを返します。（一時テーブルをまだ１つも作成しておらず）存在しなければゼロを返します。 pg_is_other_temp_schemaは、指定したOIDが他のセッションの一時スキーマのOIDであれば、真を返します。 （例えば、他のセッションの一時テーブルをカタログ表示から除外したい場合などで有用です。）

pg_postmaster_start_timeはサーバが起動した時のtimestamp with time zoneを返します。

pg_conf_load_timeはサーバの設定ファイルが最後に読み込まれた時のtimestamp with time zoneを返します。 （現在のセッションがその時点で稼働していた場合、これはセッション自体が設定ファイルを読み込んだ時刻となります。 このためこの読み取った結果は多少他のセッションと異なります。 この他の場合は、postmasterプロセスが設定ファイルを再読み込みした時刻となります。）

version関数はPostgreSQLサーバのバージョンを記述した文字列を返します。 この情報はserver_versionでも取得できますし、機械読み取り可能なバージョンはserver_version_numで取得できます。 ソフトウェア開発者はテキスト版の結果を解析するのではなく、server_version_num（バージョン8.2以降で利用可能）あるいは PQserverVersion を利用すべきです。

表9.58「アクセス権限照会関数」に列挙した関数を使用して、ユーザはオブジェクトのアクセス権限をプログラムから問い合わせることができます。 権限についての詳細は、5.6. 権限を参照してください。

has_table_privilegeはユーザが特定の方法でテーブルにアクセス可能かどうかを検査します。 ユーザは名前、OID(pg_authid.oid)、もしくは擬似的なPUBLICロールを意味するpublicで指定できます。省略された場合はcurrent_userが使われます。 テーブルは名前もしくはOIDで指定可能です。 （従って、実際にはhas_table_privilegeの６つの変形があり、引数の数と型で区別されます。） 名前を指定する場合、必要であればスキーマ修飾できます。 対象とするアクセス権限の種類はテキスト文字列で指定され、それは、SELECT、INSERT、UPDATE、DELETE、TRUNCATE、REFERENCES、またはTRIGGERのどれかである必要があります。 オプションとして、権限がGRANTオプションにより付与されているかどうかの権限の検査するため、WITH GRANT OPTIONを付加することができます。 更に、複数の権限の種類をコンマで区切って列挙可能です。この場合、結果は列挙された権限の１つでも存在すれば真となります。 （権限文字列の大文字小文字は重要ではありません。余分な空白は権限名と権限名の間にはあっても良いですが、権限名の途中にはあってはいけません。） 例を示します。

SELECT has_table_privilege('myschema.mytable', 'select');
SELECT has_table_privilege('joe', 'mytable', 'INSERT, SELECT WITH GRANT OPTION');

has_sequence_privilegeはユーザが特定の方法でシーケンスにアクセス可能かどうかを検査します。 取り得る引数はhas_table_privilegeに対するものと類似しています。 対象とする権限の種類はUSAGE、SELECTまたはUPDATEのいずれかである必要があります。

has_any_column_privilegeはユーザが特定の方法でテーブルのどれか１つの列にアクセス可能かどうかを検査します。 取り得る引数はhas_table_privilegeに対するものと類似していますが、対象とする権限の種類がSELECT、INSERT、UPDATE、またはREFERENCESの組み合わせである必要がある点を除きます。 テーブル単位でこれらの権限を所有することは、テーブルのそれぞれの列に対し暗黙的にそれらの権限を与えることになるため、has_table_privilegeが真を返す場合は、同一の引数に対してhas_any_column_privilegeは常に真を返すということに注意して下さい。 しかし、少なくとも一つの列に対し権限の列単位の許可がある場合にもhas_any_column_privilegeは成功します。

has_column_privilegeはユーザが特定の方法でテーブルのある列にもアクセス可能かどうかを検査します。 取り得る引数はhas_table_privilegeと類似していますが、名前または属性番号のいずれかで列の指定が追加されます。 対象とするアクセス権限の種類はSELECT、INSERT、UPDATE、またはREFERENCESの組み合わせでなければなりません。 テーブル単位のこれらの権限を所有することは、テーブルのそれぞれの列に対し暗黙的にそれら権限を与えることに注意してください。

has_database_privilege関数は、ユーザが特定の方法でデータベースにアクセス可能かどうかを検査します。 取り得る引数は、has_table_privilegeに類似しています。 対象とするアクセス権限の種類はCREATE、CONNECT、TEMPORARY、またはTEMP（TEMPORARYと同じ）の組み合わせである必要があります。

has_function_privilege関数は、ユーザが特定の方法で関数にアクセス可能かどうかを検査します。 取り得る引数はhas_table_privilegeと同じです。 関数をOIDではなくテキスト文字列で指定する場合、regprocedure データ型（8.18. オブジェクト識別子データ型を参照）と同じ入力が可能です。 対象とするアクセス権限の種類はEXECUTEである必要があります。 以下に例を示します。

SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');

has_foreign_data_wrapper_privilege関数は、ユーザが特定の方法で外部データラッパーにアクセス可能かどうかを検査します。 取り得る引数はhas_table_privilegeと同じです。 対象とするアクセス権限の種類はUSAGEである必要があります。

has_language_privilege関数は、ユーザが特定の方法で手続き言語にアクセス可能かどうかを検査します。 取り得る引数は、has_table_privilegeに類似しています。 対象とするアクセス権限の種類はUSAGEである必要があります。

has_schema_privilege関数は、ユーザが特定の方法でスキーマにアクセス可能かどうかを検査します。 取り得る引数は、has_table_privilegeに類似しています。 対象とするアクセス権限の種類は、CREATEもしくはUSAGEの組み合わせである必要があります。

has_server_privilegeはユーザが特定の方法で外部サーバにアクセスできるかどうかを検査します。 取り得る引数はhas_table_privilegeに類似しています。 対象とするアクセス権限の種類はUSAGEである必要があります。

has_tablespace_privilege関数は、ユーザが特定の方法でテーブル空間にアクセス可能かどうかを検査します。 取り得る引数は、has_table_privilegeに類似しています。 対象とするアクセス権限の種類は、CREATEである必要があります。

pg_has_roleは、ユーザが特定の方法でロールにアクセスできるかどうかを検査します。 取り得る引数については、publicがユーザ名として使用不可であることを除き、has_table_privilegeと類似しています。 対象とするアクセス権限の種類は、 MEMBER、USAGEの組み合わせである必要があります。 MEMBERは、ロールの直接または間接メンバ資格（つまり、SET ROLEを行う権限）を表します。一方、USAGEは、そのロール権限がSET ROLEをしなくてもすぐに利用できることを表します。

row_security_activeはcurrent_userと現在の環境において、指定のテーブルで行単位セキュリティが有効かどうかを検査します。 テーブルは名前またはOIDで指定できます。

表9.59「スキーマ可視性照会関数」に、特定のオブジェクトが、現行スキーマの検索パスにおいて可視かどうかを判別する関数を示します。 例えば、あるテーブルを含むスキーマが検索パス内に存在し、検索パス内の前方に同じ名前のテーブルがない場合、そのテーブルは可視であると言います。 つまり、これは、テーブルが明示的なスキーマ修飾なしで名前によって参照可能であるということです。 全ての可視テーブルの名前を列挙するには以下のようにします。

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

それぞれの関数はデータベースオブジェクトの１つの型に対して可視性の検査を行います。 pg_table_is_visibleがビュー、マテリアライズドビュー、インデックス、シーケンス、外部テーブルに対しても使用できること、pg_type_is_visibleがドメインに対しても使用できることに注意してください。 関数および演算子では、パスの前方に同じ名前かつ同じ引数のデータ型を持つオブジェクトが存在しなければ、検索パス内のオブジェクトは可視です。 演算子クラスでは、名前と関連するインデックスアクセスメソッドが考慮されます。

これらの関数は全て、検査するオブジェクトを識別するために、オブジェクトのOIDを必要とします。 オブジェクトを名前でテストする場合、OID別名型（regclass、regtype、regprocedure、regoperator、regconfig、またはregdictionary）を使用すると便利です。 例えば、以下のようにします。

SELECT pg_type_is_visible('myschema.widget'::regtype);

ただし、このようなやり方でスキーマ修飾されていない型名をテストしても、あまり意味がないことに注意してください。名前が認識されれば、それは必ず可視ということになります。

表9.60「システムカタログ情報関数」に、システムカタログから情報を抽出する関数を列挙します。

関数format_typeは、自身の型OIDと場合により型修飾子によって特定されるデータ型のSQL名を返します。 特定の修飾子が既知でなければ型修飾子にNULLを渡します。

関数pg_get_keywordsは、サーバが認識したSQLキーワードを記述するレコードの集合を返します。 word列にはキーワードが含まれます。 catcode列は種類コードで、Uは未予約(unreserved)、Cは列名(column)、Tは型名(type)または関数名、Rは予約語(reserved)です。 catdesc列は種類を記述する文字列を含み、現地語化されている場合もあります。

pg_get_constraintdef、pg_get_indexdef、pg_get_ruledef、およびpg_get_triggerdefはそれぞれ、制約、インデックス、ルール、もしくはトリガに対する作成コマンドを再構築します。 （これはコマンドの元々のテキストではなく、逆コンパイルにより再構築されたテキストであることに注意してください。） pg_get_exprは、列のデフォルト値のような個々の式の内部形式を逆コンパイルします。 システムカタログの内容を試験するときに便利です。 式がVarを含んでいるかもしれない場合、２番目のパラメータとして参照する関連（リレーション）のOIDを指定します。Varがないと期待されるならゼロで充分です。 pg_get_viewdef はビューを定義するSELECT問い合わせを再構築します。 これらの関数のほとんどは２つの異形があり、そのうちの１つはオプションとして結果を「見やすく表示」します。 見やすく表示された書式はより読みやすい半面、デフォルトの書式の方が今後のバージョンのPostgreSQLでも同様に解釈することができそうです。ダンプを目的とする場合は、見やすく表示する出力を使用しないでください。 見やすい表示用のパラメータにfalseを渡すことで、このパラメータをまったく持たない種類の結果と同一の結果を生成します。

pg_get_functiondefは、関数の完全なCREATE OR REPLACE FUNCTION文を返します。 pg_get_function_argumentsは、CREATE FUNCTIONの中に出現しなければならない形式で、引数リストを返します。 pg_get_function_resultは同様、その関数の適切なRETURNS句を返します。 pg_get_function_identity_argumentsは、例えばALTER FUNCTIONの中に出現しなければならない形式で、関数を特定するのに必要な引数リストを返します。 この形式はデフォルト値を省略します。

pg_get_serial_sequenceは、列に関連したシーケンスの名前を返します。もし、列に関連したシーケンスが存在しなければ、NULLを返します。 最初の入力パラメータはテーブル名です。スキーマを付けることもできます。２番目のパラメータは列名です。 最初のパラメータは普通スキーマとテーブルですので、二重引用符付の識別子としては解釈されません。つまり、デフォルトで小文字に変換されます。一方２番目のパラメータは単なる列名であり、二重引用符付として解釈され、その大文字小文字は保持されます。 この関数は、シーケンス関数に渡すことができるよう適切な書式で値を返します（9.16. シーケンス操作関数を参照）。 この関連付けはALTER SEQUENCE OWNED BYにより変更、削除することができます。 （この関数はおそらくpg_get_owned_sequenceと呼ばれるべきでした。現在の名前は、通常はserialやbigserial列で使われることからきています。）

pg_get_userbyidはそのOIDで与えられたロールの名前を抽出します。

pg_options_to_tableは、pg_class.reloptionsまたはpg_attribute.attoptionsが渡されたときに、格納オプションの名前と値のペア(option_name/option_value)の集合を返します。

pg_tablespace_databasesによりテーブル空間を調べることができます。 これは、そのテーブル空間内に格納されたオブジェクトを持つデータベースのOIDの集合を返します。 この関数が何らかの行を返した場合、このテーブル空間は空ではなく、削除することができません。 テーブル空間内に格納された特定のオブジェクトを表示するためには、pg_tablespace_databasesで識別されたデータベースに接続し、そのpg_classカタログに問い合わせを行う必要があります。

pg_typeofは、渡される値のデータ型のOIDを返します。 これはトラブル解決作業、または動的にSQL問い合わせを生成するのに便利です。 この関数は、OID型の別名であるregtypeを返すものとして宣言されます（8.18. オブジェクト識別子データ型を参照）。つまり、比較が目的ならOIDと同一ですが、型名として表示されます。 以下に例をあげます。

SELECT pg_typeof(33);

 pg_typeof 
-----------
 integer
(1 row)

SELECT typlen FROM pg_type WHERE oid = pg_typeof(33);
 typlen 
--------
      4
(1 row)

collation for式は、それに渡された値の照合順序を返します。 例を示します。

SELECT collation for (description) FROM pg_description LIMIT 1;
 pg_collation_for 
------------------
 "default"
(1 row)

SELECT collation for ('foo' COLLATE "de_DE");
 pg_collation_for 
------------------
 "de_DE"
(1 row)

値には引用符が付けられ、またはスキーマ修飾されることがあります。 もし引数の式から何も照合順序が得られなかった場合、NULLが返されます。 もし引数が照合順序をサポートしないデータ型だった場合、エラーとなります。

to_regclass、to_regproc、to_regprocedure、to_regoper、to_regoperator、to_regtype、to_regnamespace、to_regrole関数はリレーション、関数、演算子、型、スキーマ、ロールの名前をそれぞれregclass、regproc、regprocedure、regoper、regoperator、regtype、regnamespace、regrole型のオブジェクトに変換します。 数値OIDを受け付けず、名前が見つからない(もしくは、to_regprocとto_regoperでは、与えられた名前が複数のオブジェクトに一致する)場合にはエラーを発生するのではなくnullを返すという点で、これらの関数はテキストからのキャストとは異なります。

表9.61「オブジェクト情報とアドレスの関数」にデータベースオブジェクトの識別とアドレスに関連する関数を示します。

pg_describe_objectはカタログOID、オブジェクトOID、もしくはサブオブジェクトOID（0のこともある）で指定されたデータベースオブジェクトのテキストによる説明を返します。 この説明はサーバの設定に依存しますが、人が読んでわかる、そして翻訳も可能になることを目的としたのもです。 これはpg_dependカタログに格納されたオブジェクトの識別判断の際に有用です。

pg_identify_objectはカタログOID、オブジェクトOID、そしてサブオブジェクトID（0のこともある）により指定されるデータベースオブジェクトを一意に特定するために十分な情報を含む行を返します。 この情報は機械による読み取りを目的としており、決して翻訳されません。 typeはデータベースオブジェクトの型を識別するものです。 schemaはオブジェクトが所属するスキーマの名前ですが、スキーマに所属しないオブジェクト型の場合はNULLになります。 nameは（必要なら引用符で括った）オブジェクトの名前ですが、（適切ならスキーマ名と合わせて）オブジェクトの一意識別子として使用できる場合にのみ指定し、それ以外の場合はNULLにします。 identityは完全なオブジェクトの識別で、オブジェクトの型に依存した正確なフォーマットを持っています。 フォーマット内の各部分はスキーマ修飾されており、必要に応じて引用符で括られます。

pg_identify_object_as_addressはカタログOID、オブジェクトOID、そしてサブオブジェクトID（0のこともある）により指定されるデータベースオブジェクトを一意に特定するために充分な情報を含む行を返します。 返される情報は現在のサーバに依存しません。 つまり、他のサーバで全く同じ名前を付けられたオブジェクトを識別するために使うことができます。 typeはデータベースオブジェクトの型を識別するものです。 nameとargsは文字列の配列で、それらが組み合わされてオブジェクトへの参照を構成します。 これらの3つの列は、オブジェクトの内部アドレスを取得するためにpg_get_object_addressに渡すことができます。 この関数はpg_get_object_addressの逆関数です。

pg_get_object_addressは、型、オブジェクト名および引数の配列で指定されたデータベースオブジェクトを一意に特定するために十分な情報を含む行を返します。 返される値は、pg_dependなどのシステムカタログで使用されるもので、pg_identify_objectやpg_describe_objectなど他のシステム関数に渡すことができます。 catalog_idはオブジェクトを含むシステムカタログのOIDです。 object_idはオブジェクト自体のOIDです。 object_sub_idはオブジェクトのサブID、なければ0です。 この関数はpg_identify_object_as_addressの逆関数です。

表9.62「コメント情報関数」に示される関数は、COMMENTコマンドによって以前に保存されたコメントを抽出します。 指定されたパラメータに対するコメントが存在しない場合、NULL値が返されます。

col_description()関数は、テーブルのOIDとその列番号で指定されるテーブルの列のコメントを返します。 （obj_description()関数は、テーブル列自体がOIDを所有していませんので、テーブル列に対して使用することはできません。）

obj_description()関数の２つのパラメータを取る形式はそのOIDと保有しているシステムカタログの名前で指定されたデータベースオブジェクトのコメントを返します。 例えば、obj_description(123456,'pg_class')はOID 123456を持つテーブルのコメントを抽出します。 obj_description()関数の単一パラメータ形式はオブジェクトのOIDのみ必要とします。 異なったシステムカタログに渡ってOIDが一意である保証はないことから廃止予定です。従って、間違ったコメントが返ることがあります。

shobj_descriptionは、共有オブジェクトのコメント取得のために使用されることを除いて、obj_descriptionと同じように使用されます。 一部のシステムカタログは、各クラスタ内のデータベース全体に対して大域的です。これらのコメントも同様に大域的に格納されます。

表9.63「トランザクションIDとスナップショット」で示される関数はサーバトランザクション情報をエクスポートできる形式で提供します。 これら関数の主な使用目的は２つのスナップショット間でどちらのトランザクションがコミットされたのかを特定するためです。

内部トランザクションID型（xid）は32ビット幅なので40億トランザクション毎にラップします。 とは言っても、これらの関数は「epoch」カウンタにより拡張された64ビット形式をエクスポートするため、インストレーションの生涯にわたってラップしないでしょう。 これらの関数で使用されるデータ型、txid_snapshotはある特定の時間におけるトランザクションIDの可視性に関する情報を格納します。 構成要素は表9.64「スナップショット構成要素」に記載されています。

txid_snapshotのテキスト表現はxmin:xmax:xip_listです。 例えば、10:20:10,14,15はxmin=10, xmax=20, xip_list=10, 14, 15を意味します。

表9.65「コミットされたトランザクションの情報」に示す関数は、コミット済みのトランザクションに関する情報を提供します。 これらの関数は主に、トランザクションがいつコミットされたかについての情報を提供します。 これらは、設定オプションtrack_commit_timestampが有効な時にのみ、しかもそれが有効にされた後にコミットされたトランザクションについてのみ有意なデータを提供します。