無料スクリプト配布のPHP.TO   PHPの実用的なtips PHPマニュアル MySQLマニュアル Apacheマニュアル PostgreSQLマニュアル マニュアル検索    

F.14. file_fdw

file_fdw モジュールは、サーバのファイルシステムにあるデータファイルにアクセスするのに使用できる外部データラッパ file_fdw を提供します。 データファイルは COPY FROM で読むことのできるフォーマットでなければなりません。 詳細は COPY を参照してください。 そのようなデータへのアクセスは現時点では読み取り専用です。

このラッパーで作成された外部テーブルには以下のオプションを設定することができます。

filename

読み込むファイルを指定します。必須です。絶対パスでなければなりません。

format

ファイルフォーマットを指定するもので、 COPY FORMAT オプションと同じです。

header

ファイルがヘッダ行を持つか指定するもので、 COPY HEADER オプションと同じです。

delimiter

ファイルのデリミタ文字を指定するもので、 COPY DELIMITER オプションと同じです。

quote

ファイルの引用符文字を指定するもので、 COPY QUOTE オプションと同じです。

escape

ファイルのエスケープ文字を指定するもので、 COPY ESCAPE オプションと同じです。

null

ファイルのnull文字列を指定するもので、 COPY NULL オプションと同じです。

encoding

ファイルのエンコーディングを指定するもので、 COPY ENCODING オプションと同じです。

COPY ではOIDSやHEADERといったオプションを対応する値なしで指定できるのに対して、外部データラッパの構文では全ての場合において値を指定する必要がある点に注意して下さい。通常値なしで指定される COPY オプションを有効にするには、代わりにTRUEを渡すことができます。

このラッパーを使って作られた外部テーブルのカラムは、以下のオプションを持つことができます。

force_not_null

これはbooleanオプションです。真の場合は、このカラムの値はヌル値文字列(これはファイルレベルの null オプションです)と比較されません。これは、 COPY FORCE_NOT_NULL オプションに列名を指定するのと同じ効果があります。

COPY OIDS FORCE_QUOTE の各オプションは file_fdw では現在サポートされていません。

これらのオプションは外部テーブルまたはその列にのみ指定可能で、 file_fdw 外部データラッパやそれを使用するサーバ、ユーザマッピングのオプションには指定できません。

どのファイルから読み込むかを決定できるのはスーパーユーザーのみでなければならない、というセキュリティ上の理由から、テーブルレベルのオプションを変更するにはスーパーユーザ権限が必要です。 原則としては非スーパーユーザはその他のオプションを変更することを許されてもよいのですが、現時点ではサポートされていません。

file_fdw を使用する外部テーブルでは、 EXPLAIN は読み込むファイルの名前を表示します。 COSTS OFF が指定されない場合は(バイト単位の)ファイルサイズも表示されます。

例 F-1. PostgreSQL CSV ログ用の外部テーブル作成

file_fdw の明確な用途の一つはPostgreSQLの活動ログをテーブルとして検索できるようにすることです。これを実現するには、ここでは pglog.csv と呼ぶCSVファイルにログを記録している必要があります。まず、 file_fdw をエクステンションとしてインストールします。

CREATE EXTENSION file_fdw;

続いて外部サーバを作成します。

CREATE SERVER pglog FOREIGN DATA WRAPPER file_fdw;

これで外部テーブルを作成する準備ができました。 CREATE FOREIGN TABLE コマンドを使って、テーブルのカラム、CSVファイル名とそのフォーマットを定義する必要があるでしょう。

CREATE FOREIGN TABLE pglog (
  log_time timestamp(3) with time zone,
  user_name text,
  database_name text,
  process_id integer,
  connection_from text,
  session_id text,
  session_line_num bigint,
  command_tag text,
  session_start_time timestamp with time zone,
  virtual_transaction_id text,
  transaction_id bigint,
  error_severity text,
  sql_state_code text,
  message text,
  detail text,
  hint text,
  internal_query text,
  internal_query_pos integer,
  context text,
  query text,
  query_pos integer,
  location text,
  application_name text
) SERVER pglog
OPTIONS ( filename '/home/josh/9.1/data/pg_log/pglog.csv', format 'csv' );

これで全てです—もうあなたはログに直接検索を実行することができます。実運用においては、もちろん何らかの方法でログを切り替える必要があるでしょう。


powered by SEO.CUG.NET