current_catalog → name

current_database () → name

現在のデータベースの名前を返します。 （データベースはSQL標準では「カタログ」と呼ばれています。ですから標準での記述はcurrent_catalogとなります。）

current_query () → text

クライアントから送信された現在実行中問い合わせのテキスト（複数の文を含むことあります）を返します。

current_role → name

current_userと同じです。

current_schema → name

current_schema () → name

サーチパスの先頭にあるスキーマの名前を返します。（サーチパスが空ならNULL値を返します。） これはターゲットスキーマを指定せずに作成されるすべてのテーブルあるいは名前付きのオブジェクトで使われるスキーマです。

current_schemas ( include_implicit boolean ) → name[]

現在有効な検索パス中にあるすべてのスキーマの名前を優先順に配列で返します。 （現在のsearch_path設定にある項目で、存在する検索可能なスキーマに関連しないものは無視されます。） 論理値引数が真ならpg_catalogのような暗黙的に検索されるシステムスキーマは結果に含まれます。

current_user → name

現在の実行コンテキストのユーザ名を返します。

inet_client_addr () → inet

現在のクライアントのIPアドレスを返します。UNIXドメインソケット経由の接続ならNULLが返ります。

inet_client_port () → integer

現在のクライアントのIPポート番号を返します。UNIXドメインソケット経由の接続ならNULLが返ります。

inet_server_addr () → inet

サーバが受け付けている現在の接続のIPアドレスを返します。UNIXドメインソケット経由の接続ならNULLが返ります。

inet_server_port () → integer

サーバが受け付けている現在の接続のIPポート番号を返します。UNIXドメインソケット経由の接続ならNULLが返ります。

pg_backend_pid () → integer

現在のセッションに結びついているサーバプロセスのプロセスIDを返します。

pg_blocking_pids ( integer ) → integer[]

指定したサーバプロセスIDによるロック取得をブロックしているプロセスIDを配列で返します。そのようなサーバプロセスが存在しないかあるいはブロックしていない場合は空の配列が返ります。

あるサーバプロセスが別のサーバプロセスをブロックするのは、ブロックされるプロセスのロック要求と競合するロックを保持している場合（ハードブロック）、あるいは、ブロックされるプロセスのロック要求と競合するロックを待っていて、かつロック待ちキュー内でより前方にいる場合（ソフトブロック）です。 パラレルクエリを使っている場合、実際のロックを子ワーカープロセスが保持または待っている場合であっても、この結果には必ずクライアントから可視のプロセスID（つまり、pg_backend_pidの結果）が示されます。 そのような仕様なので、この結果には重複するPIDが含まれることもあります。 また、プリペアドのトランザクションが競合するロックを保持している場合、この関数の結果ではプロセスIDがゼロとして示されることにも注意して下さい。

頻繁にこの関数を呼び出すとデータベースの性能に影響があるかも知れません。ロックマネージャの共有状態への短期的な排他ロックの取得が必要だからです。

pg_conf_load_time () → timestamp with time zone

サーバ設定ファイルが最後に読み込まれた時の時刻を返します。 現在のセッションがそのときに活動中だった場合、これはそのセッション自身が設定ファイルを再読み込みした時刻になります。（ですからその結果はセッションによって少し異なるかもしれません。） それ以外の場合は、postmasterプロセスが設定ファイルを再読み込みした時刻になります。

pg_current_logfile ( [ text ] ) → text

ログ収集機構が現在使用しているログファイルのパス名を返します。 パスにはlog_directoryディレクトリとログファイルの名前が含まれます。 ログ収集が無効ならば戻り値はNULLになります。 複数のログファイルがそれぞれ異なる形式で存在する場合、引数なしのpg_current_logfileは、順序リスト（stderr、csvlog、jsonlog）の最初に出てくる形式のファイルのパスを返します。 これらの形式のログファイルがないときはNULLが返されます。 特定のファイル形式を要求するには、オプションパラメータの値としてcsvlog、jsonlog、またはstderrをオプション引数の値として渡してください。 指定のログ形式がlog_destinationで設定されていない場合は、戻り値がNULLとなります。 結果はcurrent_logfilesファイルの内容を反映します。

pg_my_temp_schema () → oid

現在のセッションの一時スキーマのOIDを返します。（一時テーブルをまだ１つも作成しておらず）存在しなければゼロを返します。

pg_is_other_temp_schema ( oid ) → boolean

指定したOIDが他のセッションの一時スキーマのOIDであれば、真を返します。 （例えば、他のセッションの一時テーブルをカタログ表示から除外したい場合などで有用です。）

pg_jit_available () → boolean

JITコンパイラ拡張が利用可能で(第32章参照)、jit設定パラメータがonなら真を返します。

pg_listening_channels () → setof text

今のセッションにおいて現在待ち受け中の非同期通知チャンネル名の集合を返します。

pg_notification_queue_usage () → double precision

非同期通知キューの最大サイズのうち、処理待ちの通知によって占められている現在の割合（0から1まで）を返します。 詳細はLISTENとNOTIFYをご覧ください。

pg_postmaster_start_time () → timestamp with time zone

サーバの起動時刻を返します。

pg_safe_snapshot_blocking_pids ( integer ) → integer[]

指定のサーバプロセスIDによる安全なスナップショットの取得をブロックしているセッションのサーバプロセスIDの配列を返します。そのようなサーバプロセスがないか、ブロックされていない場合は空の配列が返ります。

SERIALIZABLEトランザクションを実行しているセッションは、SERIALIZABLE READ ONLY DEFERRABLEトランザクションが述語ロックの取得をすべて回避しても安全であると決定するまで、後者がスナップショットを取得するのをブロックします。 シリアライザブルトランザクションおよび遅延可能トランザクションについてのさらなる情報については13.2.3を参照してください。

この関数を頻繁に呼び出すと、短時間に述語ロックマネージャの共有状態にアクセスする必要があるため、データベースのパフォーマンスに若干の影響が出るかもしれません。

pg_trigger_depth () → integer

PostgreSQLのトリガの現在の入れ子の深さを返します。(直接的であれ間接的であれ、トリガ内部から呼ばれていなければ0を返します)。

session_user → name

セッションのユーザ名を返します。

system_user → text

認証方式と、データベースロールが割り当てられる前にユーザが認証サイクル中に提示したID(存在する場合)を戻します。 ユーザが認証されている場合はauth_method:identityとして表示します。ユーザが認証されていない場合（たとえばTrust認証が使用されている場合）はNULLとして表示します。

user → name

current_userと等価です。

version () → text

PostgreSQLサーバのバージョンを説明する文字列を返します。 情報はserver_versionからも得られます。 機械読み取り可能なバージョンはserver_version_numを使ってください。 ソフトウェア開発者は文字列バージョンを解析するのではなく、server_version_num (8.2以降で利用可能)かPQserverVersionを使うべきです。

has_any_column_privilege ( [ user name or oid, ] table text or oid, privilege text ) → boolean

ユーザがテーブルのどれか１つの列に対して権限を所有しているか？ テーブル全体あるいは列レベルの権限が少なくとも１つの列に与えられていれば成功します。 可能な権限型はSELECT、INSERT、UPDATE、REFERENCESです。

has_column_privilege ( [ user name or oid, ] table text or oid, column text or smallint, privilege text ) → boolean

ユーザがテーブルの指定された（１つの）列に対して権限を所有しているか？ テーブル全体あるいはその列に対して列レベルの権限が与えられていれば成功します。 名前かアトリビュート番号(pg_attribute.attnum)で列を指定できます。 可能な権限型はSELECT、INSERT、UPDATE、REFERENCESです。

has_database_privilege ( [ user name or oid, ] database text or oid, privilege text ) → boolean

ユーザはデータベースに対する権限があるか？ 可能な権限型はCREATE、CONNECT、TEMPORARY、TEMP (TEMPORARYと同じです)です。

has_foreign_data_wrapper_privilege ( [ user name or oid, ] fdw text or oid, privilege text ) → boolean

現在のユーザは外部データラッパーに対する権限があるか？ 可能な権限型はUSAGEだけです。

has_function_privilege ( [ user name or oid, ] function text or oid, privilege text ) → boolean

ユーザは関数に対する権限があるか？ 可能な権限型はEXECUTEだけです。

関数をOIDではなく名前で指定する場合、regprocedureデータ型（8.19を参照）と同じ入力が可能です。 例を示します。

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

has_language_privilege ( [ user name or oid, ] language text or oid, privilege text ) → boolean

ユーザは言語に対する権限があるか？ 可能な権限型はUSAGEだけです。

has_parameter_privilege ( [ user name or oid, ] parameter text, privilege text ) → boolean

ユーザーに構成パラメータに対する権限があるか? パラメータ名では大文字と小文字が区別されません。 使用可能な権限タイプはSETおよびALTER SYSTEMです。

has_schema_privilege ( [ user name or oid, ] schema text or oid, privilege text ) → boolean

ユーザはスキーマに対する権限があるか？ 可能な権限型はCREATEとUSAGEです。

has_sequence_privilege ( [ user name or oid, ] sequence text or oid, privilege text ) → boolean

ユーザはシーケンスに対する権限があるか？ 可能な権限型はUSAGE、SELECT、UPDATEです。

has_server_privilege ( [ user name or oid, ] server text or oid, privilege text ) → boolean

ユーザは外部サーバに対する権限があるか？ 可能な権限型はUSAGEだけです。

has_table_privilege ( [ user name or oid, ] table text or oid, privilege text ) → boolean

ユーザはテーブルに対する権限があるか？ 可能な権限型はSELECT、INSERT、UPDATE、DELETE、TRUNCATE、REFERENCES、TRIGGERです。

has_tablespace_privilege ( [ user name or oid, ] tablespace text or oid, privilege text ) → boolean

ユーザはテーブル空間に対する権限があるか？ 可能な権限型はCREATEです。

has_type_privilege ( [ user name or oid, ] type text or oid, privilege text ) → boolean

ユーザにデータ型に対する権限があるか？ 可能な権限型はUSAGEだけです。 OIDではなく名前で型を指定する際は、可能な入力はregtypeデータ型に対するのと同じものです（8.19参照）。

pg_has_role ( [ user name or oid, ] role text or oid, privilege text ) → boolean

ユーザにロールに対する権限があるか？ 可能な権限型はMEMBER、USAGEとSETです。 特定の権限が与えられているかどうかにかかわらず、MEMBERは直接あるいは間接的にそのロールのメンバであることを示します。（すなわち、SET ROLEを実行する権限です） SETがSET ROLEコマンドを用いてロールに変更を加えることができるかどうかを示すのに対し、USAGEは、そのロールの権限がSET ROLEを実行することなく、直ちに利用可能であることを示します。 この関数はuserをpublicに設定する特別なケースを許可しません。 PUBLIC仮想ロールは実在するロールのメンバには決してなれないからです。

row_security_active ( table text or oid ) → boolean

現在のユーザと環境のコンテキストにおいて、指定のテーブルに対して行単位セキュリティは有効か？

aclitem = aclitem → boolean

aclitemは等しいか？ （aclitem型には通常の比較演算子の組がありません。等値だけです。 同じようにaclitemの配列は等値比較だけが可能です。）

'calvin=r*w/hobbes'::aclitem = 'calvin=r*w*/hobbes'::aclitem → f

aclitem[] @> aclitem → boolean

配列は指定した権限を含んでいるか？ （これはaclitemを与えられる側と与える側にマッチする配列のエントリを含んでいて、少なくとも指定した権限の集合を持つ場合に真となります。）

'{calvin=r*w/hobbes,hobbes=r*w*/postgres}'::aclitem[] @> 'calvin=r*/hobbes'::aclitem → t

aclitem[] ~ aclitem → boolean

これは@>の廃止予定の別名です。

'{calvin=r*w/hobbes,hobbes=r*w*/postgres}'::aclitem[] ~ 'calvin=r*/hobbes'::aclitem → t

acldefault ( type "char", ownerId oid ) → aclitem[]

ownerIdのOIDを持つロールに所属するtype型のオブジェクトのデフォルト権限を持つaclitem配列を作成します。 これはオブジェクトのACL権限がnullであるときに想定されるアクセス権限を示します。 （デフォルトアクセス権限については5.7で述べています。） typeパラメータは以下のどれかでなければなりません。 'c'でCOLUMN、'r'でTABLEおよびテーブルに見えるオブジェクト、's'でSEQUENCE、'd'でDATABASE、'f'でFUNCTIONあるいはPROCEDURE、'l'でLANGUAGE、'L'でLARGE OBJECT、'n'でSCHEMA、'p'でPARAMETER、't'でTABLESPACE、'F'でFOREIGN DATA WRAPPER、'S'でFOREIGN SERVER、'T'でTYPEあるいはDOMAINを表します。

aclexplode ( aclitem[] ) → setof record ( grantor oid, grantee oid, privilege_type text, is_grantable boolean )

行の集合としてaclitem配列を返します。 アクセス権を与えられる側が仮想ロールPUBLICなら、grantee列でgranteeはゼロで表現されます。 各々の与えられた権限はSELECT、INSERTなどで表現されます。(完全なリストは表 5.1を参照してください）。 各々の権限は別々の行に分解され、privilege_type列には一つのキーワードだけが現れることに注意してください。

makeaclitem ( grantee oid, grantor oid, privileges text, is_grantable boolean ) → aclitem

与えられた属性でaclitemを作成します。 privilegesは、結果中に設定されるSELECT、INSERTなどのカンマで区切られた権限名のリストです。 （権限文字列の大文字小文字の区別は無視されます。権限文字の間に余分な空白が合っても構いませんが、権限文字列中に空白があってはいけません。）

pg_collation_is_visible ( collation oid ) → boolean

照合順序が検索パスにおいて可視か？

pg_conversion_is_visible ( conversion oid ) → boolean

変換が検索パスにおいて可視か？

pg_function_is_visible ( function oid ) → boolean

関数が検索パスにおいて可視か？ （これはプロシージャと集約にも使えます。）

pg_opclass_is_visible ( opclass oid ) → boolean

演算子クラスが検索パスにおいて可視か？

pg_operator_is_visible ( operator oid ) → boolean

演算子が検索パスにおいて可視か？

pg_opfamily_is_visible ( opclass oid ) → boolean

演算子族が検索パスにおいて可視か？

pg_statistics_obj_is_visible ( stat oid ) → boolean

統計情報オブジェクトが検索パスにおいて可視か？

pg_table_is_visible ( table oid ) → boolean

テーブルが検索パスにおいて可視か？ （これはビュー、マテリアライズドビュー、インデックス、シーケンス、外部テーブルを含むべての形式のリレーションで使用できます。）

pg_ts_config_is_visible ( config oid ) → boolean

テキスト検索設定が検索パスにおいて可視か？

pg_ts_dict_is_visible ( dict oid ) → boolean

テキスト検索辞書が検索パスにおいて可視か？

pg_ts_parser_is_visible ( parser oid ) → boolean

テキスト検索パーサが検索パスにおいて可視か？

pg_ts_template_is_visible ( template oid ) → boolean

テキスト検索テンプレートが検索パスにおいて可視か？

pg_type_is_visible ( type oid ) → boolean

型（またはドメイン）が検索パスにおいて可視か？

format_type ( type oid, typemod integer ) → text

型OIDと型修飾子で決まるデータ型のSQL名を返します。 型修飾子が不明な場合はNULLを型修飾子に渡してください。

pg_char_to_encoding ( encoding name ) → integer

指定されたエンコード名を、一部のシステムカタログテーブルで使用されている内部識別子を表す整数に変換します。 不明なエンコード名が指定された場合は-1を返します。

pg_encoding_to_char ( encoding integer ) → name

システムカタログテーブル内のエンコーディングの内部識別子として使用されている整数を、読み取り可能な文字列に変換します。 無効なエンコーディング番号が指定されている場合は、空の文字列を返します。

pg_get_catalog_foreign_keys () → setof record ( fktable regclass, fkcols text[], pktable regclass, pkcols text[], is_array boolean, is_opt boolean )

PostgreSQLシステムカタログ中に存在する外部キー関係を記述するレコードの集合を返します。 fktable列は参照するカタログの名前を示し、fkcols列は参照する列の名前を示します。 同様に、pktableは参照されるカタログの名前を示し、pkcolsは参照される列の名前を示します。 is_arrayが真なら、最後の参照列は配列で、各要素は参照カタログにマッチします。 is_optが真なら、参照される列は有効な参照の代わりにゼロを含んでも構いません。

pg_get_constraintdef ( constraint oid [, pretty boolean ] ) → text

制約を作成したコマンドを再構築します。 （これは逆コンパイルで構成したもので、元のコマンドのテキストではありません。）

pg_get_expr ( expr pg_node_tree, relation oid [, pretty boolean ] ) → text

列のデフォルト値のような、システムカタログに格納された内部表現式を逆コンパイルします。 式に変数が含まれている場合は2番目の引数として参照されているリレーションのOIDを指定してください。変数が含まれていない場合は、ゼロを渡しておけば十分です。

pg_get_functiondef ( func oid ) → text

関数あるいはプロシージャの作成コマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。） 結果は完全なCREATE OR REPLACE FUNCTIONあるいはCREATE OR REPLACE PROCEDURE文です。

pg_get_function_arguments ( func oid ) → text

CREATE FUNCTION中に現れる形で関数あるいはプロシージャの引数のリストを再構築します。 （デフォルト値を含みます。）

pg_get_function_identity_arguments ( func oid ) → text

ALTER FUNCTIONのようなコマンド中に現れる形で関数あるいはプロシージャの引数のリストを再構築します。 この形式ではデフォルト値は省略します。

pg_get_function_result ( func oid ) → text

CREATE FUNCTION中に現れる形で関数のRETURNS句を再構築します。 プロシージャに対してNULLを返します。

pg_get_indexdef ( index oid [, column integer, pretty boolean ] ) → text

インデックスを作成するコマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。） columnが渡されていてゼロでないなら、その列の定義だけが再構築されます。

pg_get_keywords () → setof record ( word text, catcode "char", barelabel boolean, catdesc text, baredesc text )

サーバが認識するSQLキーワードを記述するレコードの集合を返します。 word列にはキーワードが含まれます。 catcode列にはカテゴリコードが含まれます。Uは非予約キーワード、Cは列名になり得るキーワード、Tは型あるいは関数名になり得るキーワード、Rは完全な予約キーワードです。 barelabel列は、キーワードが「bare」列ラベルとしてSELECTリスト中で使えるならtrueで、ASの後にのみ使えるのならfalseです。 catdesc列にはキーワードカテゴリを記述する、ローカライズ化されることもある文字列が含まれます。 baredesc列にはキーワードの列ラベル状態を記述する、ローカライズ化されることもある文字列が含まれます。

pg_get_partkeydef ( table oid ) → text

パーティション化テーブルのパーティションキーの定義を、CREATE TABLEのPARTITION BY句の形式で再構成します。(これは逆コンパイルされた再構成であり、コマンドのオリジナルテキストではありません。 )

pg_get_ruledef ( rule oid [, pretty boolean ] ) → text

ルールを作成するコマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。）

pg_get_serial_sequence ( table text, column text ) → text

列に関連するシーケンスの名前を返します。 列に関連するシーケンスが存在しなければ、NULLを返します。 列がIDENTITY列の場合、関連するシーケンスはIDENTITY列に対して内部的に作成されたシーケンスとなります。 SERIAL型（serial、smallserial、bigserial）の一つを使って作られた列については、そのSERIAL列の定義に対して作られたシーケンスとなります。 後者の場合、この関連付けはALTER SEQUENCE OWNED BYで修正または削除することができます。 （この関数はおそらくpg_get_owned_sequenceと呼ばれるべきだったのでしょうが、現在の名前はそれが主にserial列またはbigserial列と一緒に使われていたという事実によります。） 最初の入力パラメータはテーブル名で、スキーマを付けることもできます。 ２番目のパラメータは列名です。 最初のパラメータは普通はスキーマとテーブルですので、二重引用符付の識別子としては解釈されません。 つまり、デフォルトで小文字に変換されます。 一方２番目のパラメータは単なる列名であり、二重引用符付として解釈され、その大文字小文字は保持されます。 この関数は、シーケンス関数（9.17を参照）に渡すことができるよう適切な書式で値を返します。

典型的な使用法はIDENTITY列またはSERIAL列のシーケンスの現在値を読み取ることです。例を示します。

SELECT currval(pg_get_serial_sequence('sometable', 'id'));

pg_get_statisticsobjdef ( statobj oid ) → text

拡張統計情報オブジェクトを作成するコマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。）

pg_get_triggerdef ( trigger oid [, pretty boolean ] ) → text

トリガを作成するコマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。）

pg_get_userbyid ( role oid ) → name

OIDで指定されるロール名を返します。

pg_get_viewdef ( view oid [, pretty boolean ] ) → text

ビューあるいはマテリアライズドビューの背後にあるSELECTコマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。）

pg_get_viewdef ( view oid, wrap_column integer ) → text

ビューあるいはマテリアライズドビューの背後にあるSELECTコマンドを再構築します。 （これは逆コンパイルによる再構築で、元のコマンドのテキストではありません。） この関数形式では整形するオプションは常に有効で、列数よりも短く保つように長い行は折り返されます。

pg_get_viewdef ( view text [, pretty boolean ] ) → text

ビューあるいはマテリアライズドビューの背後にあるSELECTコマンドを再構築します。ビューのOIDではなく、テキスト形式の名前を使います。 （これは廃止予定です。OIDのバージョンを使ってください。）

pg_index_column_has_property ( index regclass, column integer, property text ) → boolean

インデックス列が名前付きのプロパティを持つかどうかを検査します。 共通のインデックス列プロパティは表 9.73に列挙されています。 （拡張アクセスメソッドはインデックスに対して追加のプロパティ名を持てることに注意してください。） プロパティ名が不明あるいは特定のオブジェクトに適用されない場合、OIDあるいは列番号が有効なオブジェクトを特定しない場合はNULLが返ります。

pg_index_has_property ( index regclass, property text ) → boolean

インデックスが名前付きのプロパティを持つかどうかを検査します。 共通のインデックスプロパティは表 9.74に列挙されています。 （拡張アクセスメソッドはインデックスに対して追加のプロパティ名を持てることに注意してください。） プロパティ名が不明あるいは特定のオブジェクトに適用されない場合、OIDが有効なオブジェクトを特定しない場合はNULLが返ります。

pg_indexam_has_property ( am oid, property text ) → boolean

インデックスアクセスメソッドが名前付きのプロパティを持つかどうかを検査します。 アクセスメソッドプロパティは表 9.75に列挙されています。 プロパティ名が不明あるいは特定のオブジェクトに適用されない場合、OIDが有効なオブジェクトを特定しない場合はNULLが返ります。

pg_options_to_table ( options_array text[] ) → setof record ( option_name text, option_value text )

pg_class.reloptionsあるいはpg_attribute.attoptionsの値で表現されるストレージオプションの集合を返します。

pg_settings_get_flags ( guc text ) → text[]

指定されたGUCに関連付けられたフラグの配列を返します。 存在しない場合はNULLを返します。 GUCが存在しても表示するフラグがない場合、結果は空の配列になります。 表 9.76にリストされている最も有用なフラグのみが公開されます。

pg_tablespace_databases ( tablespace oid ) → setof oid

指定したテーブル空間に格納されるオブジェクトを持つデータベースのOIDの集合を返します。 この関数が何らかの行を返すならば、そのテーブル空間は空ではなく、削除できません。 特定のオブジェクトがそのテーブル空間にあるかどうかを確認するには、pg_tablespace_databasesで識別されるデータベースに接続してpg_classカタログを検索する必要があります。

pg_tablespace_location ( tablespace oid ) → text

テーブル空間が配置されているファイルシステムのパスを返します。

pg_typeof ( "any" ) → regtype

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

以下に例をあげます。

SELECT pg_typeof(33);
 pg_typeof
-----------
 integer

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

COLLATION FOR ( "any" ) → text

渡された値の照合順序の名前を返します。 値は必要ならば引用符付きでスキーマ修飾されます。 引数式から照合順序が生じなければ、NULLが返ります。 引数が照合可能なデータ型でなければ、エラーが生じます。

例を挙げます。

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

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

to_regclass ( text ) → regclass

テキスト形式のリレーション名をOIDに変換します。 同様の結果はその文字列をregclass型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

to_regcollation ( text ) → regcollation

テキスト形式の照合順名をOIDに変換します。 同様の結果はその文字列をregcollation型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

to_regnamespace ( text ) → regnamespace

テキスト形式のスキーマ名をOIDに変換します。 同様の結果はその文字列をregnamespace型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

to_regoper ( text ) → regoper

テキスト形式の演算子名をOIDに変換します。 同様の結果はその文字列をregoper型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない、あるいは曖昧な場合にエラーを起こすのではなく、NULLを返します。

to_regoperator ( text ) → regoperator

テキスト形式の演算子名（パラメータ型付き）をOIDに変換します。 同様の結果はその文字列をregoperator型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

to_regproc ( text ) → regproc

テキスト形式の関数名またはプロシージャ名をOIDに変換します。 同様の結果はその文字列をregproc型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない、あるいは曖昧な場合にエラーを起こすのではなく、NULLを返します。

to_regprocedure ( text ) → regprocedure

テキスト形式の関数名またはプロシージャ名（引数型付き）をOIDに変換します。 同様の結果はその文字列をregprocedure型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

to_regrole ( text ) → regrole

テキスト形式のロール名をOIDに変換します。 同様の結果はその文字列をregrole型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

to_regtype ( text ) → regtype

テキスト形式の型名をOIDに変換します。 同様の結果はその文字列をregtype型にキャストすることによっても得られます。（8.19参照。） しかしこの関数は名前が見つからない場合にエラーを起こすのではなく、NULLを返します。

pg_describe_object ( classid oid, objid oid, objsubid integer ) → text

カタログOID、オブジェクトOID、もしくはサブオブジェクトOID（たとえばテーブル中の列番号。オブジェクト全体を参照している場合は0）で指定されたデータベースオブジェクトのテキストによる説明を返します。 この説明はサーバの設定に依存しますが、人が読んでわかる、そして翻訳も可能になることを目的としたのもです。 これはpg_dependカタログに格納されたオブジェクトの識別判断の際に有用です。 この関数は、未定義オブジェクトに対してNULL値を返します。

pg_identify_object ( classid oid, objid oid, objsubid integer ) → record ( type text, schema text, name text, identity text )

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

pg_identify_object_as_address ( classid oid, objid oid, objsubid integer ) → record ( type text, object_names text[], object_args text[] )

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

pg_get_object_address ( type text, object_names text[], object_args text[] ) → record ( classid oid, objid oid, objsubid integer )

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

col_description ( table oid, column integer ) → text

テーブルのOIDと列番号で指定されたテーブル列のコメントを返します。 （obj_descriptionはテーブル列には使えません。列は自身のOIDを持たないからです。）

obj_description ( object oid, catalog name ) → text

OIDとそれを含むシステム型で指定されるデータベースオブジェクトのコメントを返します。 たとえばobj_description(123456, 'pg_class')はOID 123456のテーブルのコメントを返します。

obj_description ( object oid ) → text

OIDだけで指定されるデータベースオブジェクトのコメントを返します。 これは廃止予定です。異なるシステムカタログに渡ってOIDが一意であるという保証はないからです。ですから、間違ったコメントが返されるかも知れません。

shobj_description ( object oid, catalog name ) → text

OIDとそれを含むシステム型で指定されるデータベース共有オブジェクトのコメントを返します。 これは共有オブジェクト（すなわちデータベース、ロール、テーブル空間）のコメントを取り出すために使うのを除くとobj_descriptionと同じです。 システムカタログによってはクラスタ内ですべてのデータベースに対して広域的で、その中のオブジェクトの説明も広域的に格納されています。

pg_input_is_valid ( string text, type text ) → boolean

指定された文字列が指定されたデータ型に対して有効な入力かどうかをテストし、真または偽を返します。

この関数は、データ型の入力関数が無効な入力を「ソフト」エラーとして報告するように更新されている場合にのみ、機能します。 そうでない場合、無効な入力は、文字列が直接その型にキャストされたかのように、トランザクションを中断します。

pg_input_is_valid('42', 'integer') → t

pg_input_is_valid('42000000000', 'integer') → f

pg_input_is_valid('1234.567', 'numeric(7,4)') → f

pg_input_error_info ( string text, type text ) → record ( message text, detail text, hint text, sql_error_code text )

指定された文字列が指定されたデータタイプに対して有効な入力かどうかをテストします。 有効でない場合は、スローされたであろうエラーの詳細を結果します。 入力が有効な場合、結果はNULLになります。 入力はpg_input_is_validと同じです。

この関数は、データ型の入力関数が無効な入力を「ソフト」エラーとして報告するように更新されている場合にのみ、機能します。 そうでない場合、無効な入力は、文字列が直接その型にキャストされたかのように、トランザクションを中断します。

select * from pg_input_error_info('42000000000', 'integer') →

                       message                        | detail | hint | sql_error_code
------------------------------------------------------+--------+------+----------------
 value "42000000000" is out of range for type integer |        |      | 22003

select message, detail from pg_input_error_info('1234.567', 'numeric(7,4)') →

        message         |                                      detail
------------------------+----------------------------------​-------------------------------------------------
 numeric field overflow | A field with precision 7, scale 4 must round to an absolute value less than 10^3.

pg_current_xact_id () → xid8

現在のトランザクションのIDを返します。 現在トランザクションにIDがない場合(データベースの更新を実行していないため)、新しいIDが割り当てられます。 詳細は74.1を参照してください。 サブトランザクションで実行された場合、トップ-レベルトランザクションIDが返却されます。 詳細は74.3を参照してください。

pg_current_xact_id_if_assigned () → xid8

現在のトランザクションIDを返します。もしまだ割り当てられていなければNULLを返します。 （トランザクションが読み取り専用なら、無駄なXIDの消費を避けるためにこの関数を使うのが最良です。） サブトランザクションで実行された場合、トップ-レベルトランザクションIDが返却されます。

pg_xact_status ( xid8 ) → text

最近のトランザクションのコミット状態について報告します。 トランザクションが最近のもので、システムがそのトランザクションのコミット状態を保持している場合は、トランザクションの状態はin progress、committedあるいはabortedとして報告されます。 トランザクションが古く、その参照がシステムに残っておらず、コミット状態の情報が破棄されている場合は、この関数はNULLを返します。 COMMITの進行中にアプリケーションとデータベースが切断されたときに、アプリケーションはトランザクションがコミットされたか中断されたかを知るためにこれを使うことができます。 プリペアドのトランザクションはin progressとして報告されること、そして指定のIDがプリペアドのトランザクションかどうかを確認する必要がある場合は、アプリケーションはpg_prepared_xactsを調べなければならないことに注意してください。

pg_current_snapshot () → pg_snapshot

どのトランザクションIDがin-progressなのかを表示するデータ構造である現在のsnapshotを返します。 スナップショットにはトップレベルのトランザクションIDだけが含まれます。 サブトランザクションIDは表示されません。詳細は74.3をご覧ください。

pg_snapshot_xip ( pg_snapshot ) → setof xid8

スナップショットに含まれるin-progressのトランザクションIDの集合を返します。

pg_snapshot_xmax ( pg_snapshot ) → xid8

スナップショットのxmaxを返します。

pg_snapshot_xmin ( pg_snapshot ) → xid8

スナップショットのxminを返します。

pg_visible_in_snapshot ( xid8, pg_snapshot ) → boolean

このスナップショットによると与えられたトランザクションIDが可視か（すなわちスナップショットが取得される前に完了していたか）？ この関数は副トランザクションID（subxid）に対しては正しい答えを返さないことに注意してください。 詳細は74.3を参照してください。

txid_current () → bigint

pg_current_xact_id()参照。

txid_current_if_assigned () → bigint

pg_current_xact_id_if_assigned()参照。

txid_current_snapshot () → txid_snapshot

pg_current_snapshot()参照。

txid_snapshot_xip ( txid_snapshot ) → setof bigint

pg_snapshot_xip()参照。

txid_snapshot_xmax ( txid_snapshot ) → bigint

pg_snapshot_xmax()参照。

txid_snapshot_xmin ( txid_snapshot ) → bigint

pg_snapshot_xmin()参照。

txid_visible_in_snapshot ( bigint, txid_snapshot ) → boolean

pg_visible_in_snapshot()参照。

txid_status ( bigint ) → text

pg_xact_status()参照。

pg_xact_commit_timestamp ( xid ) → timestamp with time zone

トランザクションのコミットタイムスタンプを返します。

pg_xact_commit_timestamp_origin ( xid ) → record ( timestamp timestamp with time zone, roident oid)

トランザクションのコミットタイムスタンプとレプリケーション原点を返します。

pg_last_committed_xact () → record ( xid xid, timestamp timestamp with time zone, roident oid )

直近にコミットしたトランザクションのトランザクションID、コミットタイムスタンプ、レプリケーション原点を返します。

age ( xid ) → integer

指定されたトランザクションIDと現在のトランザクションカウンタの間のトランザクション数を返します。

mxid_age ( xid ) → integer

指定されたマルチトランザクションIDと現在のマルチトランザクションカウンタの間のマルチトランザクションIDの数を返します。

pg_control_checkpoint () → record

表 9.85に示すように現在のチェックポイントの状態に関する情報を返します。

pg_control_system () → record

表 9.86に示すように現在の制御ファイルの状態に関する情報を返します。

pg_control_init () → record

表 9.87に示すようにクラスタの初期化状態に関する情報を返します。

pg_control_recovery () → record

表 9.88に示すようにリカバリ状態に関する情報を返します。