# F.14\. file_fdw `file_fdw`模塊提供了外部數據封裝器`file_fdw`， 可以用來在服務器的文件系統中訪問數據文件。數據文件必須是`COPY FROM` 可讀的格式；參閱[COPY](#calibre_link-777)獲取細節。訪問這樣的數據文件當前只是可讀的。 使用這個封裝器創建的外部表可以有下列選項： `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` 這是一個布爾選項。如果為真，則聲明字段的值不應該匹配空字符串（也就是， 文件級別`null`選項）。這與列出`COPY`的 `FORCE_NOT_NULL`選項里的字段有相同的效果。 `file_fdw`目前不支持`COPY`的`OIDS`和 `FORCE_QUOTE`選項。 這些選項只能為外部表或它的字段聲明，不是在`file_fdw`外部數據封裝器的選項里， 也不是在使用該封裝器的服務器或用戶映射的選項里。 修改表級別的選項需要超級用戶權限，因為安全原因：只有超級用戶能夠決定讀哪個文件。 原則上非超級用戶可以被允許改變其他選項，但是目前還不支持。 對于一個使用`file_fdw`的外部表，`EXPLAIN`顯示要讀取的文件名。 除非指定了`COSTS OFF`，否則也顯示文件大小（字節計）。 **Example F-1\. 為PostgreSQL CSV日志創建一個外部表** `file_fdw`明顯的用處之一就是使PostgreSQL活動日志可以作為一個表查詢。 要做到這點，首先必須登錄到一個CSV文件，這里我們稱為`pglog.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' ); ``` 就這樣，現在可以查詢日志目錄。當然，在生產中需要定義一些處理日志回旋的方法。