file_fdw 模組提供了外部資料包裝器 file_fdw，可用於存取伺服器檔案系統中的資料檔案，或在伺服器上執行程式並讀取其輸出。資料檔案或程式輸出必須為 COPY FROM 可以讀取的格式；詳情請參閱 COPY。目前對資料檔案的存取為唯讀。
使用此包裝器建立的外部資料表可以有以下選項
filename指定要讀取的檔案。相對路徑相對於資料目錄。必須指定 filename 或 program，但不能同時指定兩者。
program指定要執行的指令。此指令的標準輸出將被讀取，就像使用了 COPY FROM PROGRAM 一樣。必須指定 program 或 filename，但不能同時指定兩者。
format指定資料格式，與 COPY 的 FORMAT 選項相同。
header指定資料是否具有標頭行，與 COPY 的 HEADER 選項相同。
delimiter指定資料分隔符號，與 COPY 的 DELIMITER 選項相同。
quote指定資料引號字元，與 COPY 的 QUOTE 選項相同。
escape指定資料跳脫字元，與 COPY 的 ESCAPE 選項相同。
null指定資料空字串，與 COPY 的 NULL 選項相同。
encoding指定資料編碼，與 COPY 的 ENCODING 選項相同。
請注意，雖然 COPY 允許在沒有相應值的情況下指定 HEADER 等選項，但外部資料表選項語法要求在所有情況下都必須存在一個值。若要啟用通常在沒有值的情況下編寫的 COPY 選項，您可以傳遞值 TRUE，因為所有此類選項都是布林值。
使用此包裝器建立的外部資料表的欄位可以有以下選項
force_not_null這是一個布林選項。如果為 true，則指定欄位的值不應與空字串（即資料表層級的 null 選項）進行比對。這與在 COPY 的 FORCE_NOT_NULL 選項中列出欄位具有相同的效果。
force_null這是一個布林選項。如果為 true，則指定與空字串相符的欄位值會以 NULL 傳回，即使該值被引號括住。如果沒有此選項，只有未用引號括住且與空字串相符的值才會以 NULL 傳回。這與在 COPY 的 FORCE_NULL 選項中列出欄位具有相同的效果。
COPY 的 FORCE_QUOTE 選項目前不受 file_fdw 支援。
這些選項只能為外部資料表或其欄位指定，不能在 file_fdw 外部資料包裝器的選項中指定，也不能在使用該包裝器的伺服器或使用者對應的選項中指定。
變更資料表層級的選項需要成為超級使用者，或具有角色 pg_read_server_files（使用檔案名稱）或角色 pg_execute_server_program（使用程式）的權限，出於安全考量：只有某些使用者應該能夠控制讀取哪個檔案或執行哪個程式。原則上，可以允許一般使用者變更其他選項，但目前不支援。
指定 program 選項時，請記住選項字串由 shell 執行。如果您需要將來自不受信任來源的任何引數傳遞給指令，則必須小心地剝離或跳脫任何可能對 shell 具有特殊意義的字元。出於安全考量，最好使用固定的指令字串，或至少避免在其中傳遞任何使用者輸入。
對於使用 file_fdw 的外部資料表，EXPLAIN 會顯示要讀取的檔案或要執行的程式的名稱。對於檔案，除非指定了 COSTS OFF，否則檔案大小（以位元組為單位）也會顯示。
範例 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, backend_type text, leader_pid integer, query_id bigint ) SERVER pglog OPTIONS ( filename 'log/pglog.csv', format 'csv' );
就這樣 — 現在您可以直接查詢您的日誌。 在生產環境中，當然，您需要定義一些處理日誌輪換的方法。
範例 F.2. 建立一個在欄位上具有選項的外部資料表
若要設定欄位的 force_null 選項，請使用 OPTIONS 關鍵字。
CREATE FOREIGN TABLE films ( code char(5) NOT NULL, title text NOT NULL, rating text OPTIONS (force_null 'true') ) SERVER film_server OPTIONS ( filename 'films/db.csv', format 'csv' );
如果您在文件中發現任何不正確、與您使用特定功能的經驗不符或需要進一步澄清的內容，請使用此表格回報文件問題。