PolarDB：oracle_fdw（Oracle外部表格）

使用方法

1. 安裝外掛程式。

   CREATE EXTENSION oracle_fdw;

2. 建立外部Oracle資料庫伺服器。

   配置Oracle資料庫的串連資訊，建立PolarDB PostgreSQL版（相容Oracle）到Oracle的映射。樣本如下：

   CREATE SERVER oradb
   FOREIGN DATA WRAPPER oracle_fdw
   OPTIONS (dbserver '//host:port/dbname');

   建立外部Oracle資料庫伺服器參數說明如下：

   參數	說明	是否必填
   dbserver	Oracle資料庫的串連串，包含IP地址、連接埠號碼、資料庫名。	是
   isolation_level	交易隔離等級，預設為SERIALIZABLE。 可選的參數類型如下： serializable：序列化。 read_committed：讀已提交。 read_only：唯讀。	否
   nchar	是否在Oracle端開啟字元轉換。 說明 修改可能會影響效能。	否

3. 建立使用者映射。

   將PolarDB PostgreSQL版（相容Oracle）的使用者pguser與對應Oracle資料庫的使用者orauser進行映射。需要配置Oracle資料庫使用者的使用者名稱、密碼。樣本如下：

   CREATE USER MAPPING
   FOR pguser SERVER oradb
   OPTIONS (user 'orauser', password 'orapwd');

   建立使用者映射參數說明如下：

   參數	說明	是否必填
   user	Oracle資料庫使用者的使用者名稱。	是
   password	Oracle資料庫使用者的密碼。	是

   說明

   如果您不想在PolarDB PostgreSQL版（相容Oracle）中儲存Oracle使用者的憑證，可以設定user為空白字串，並提供外部授權。

4. 建立外部表格映射。

   在PolarDB PostgreSQL版（相容Oracle）中建立一個外部表格，映射到Oracle資料庫的一個已有的表上。樣本如下：

   CREATE FOREIGN TABLE oratab (
       id        integer OPTIONS (key 'true') NOT NULL,
       text      character varying(30),
       floating  double precision NOT NULL
   ) SERVER oradb OPTIONS (
       table 'ORATAB',
       schema 'ORAUSER',
       max_long '32767',
       readonly 'false',
       sample_percent, '100',
       prefetch, '200'
   );

   建立外部表格參數說明如下：

   參數	說明	是否必填
   table	Oracle資料庫中的被映射表名，一般是大寫。	是
   dblink	被映射表的資料庫連結，必須與Oracle系統目錄中的完全一致。	否
   schema	Oracle使用者名稱，需要大寫，用於訪問不屬於當前串連使用者的表。	否
   max_long	限制Oracle表中 LONG、LONG RAW、XMLTYPE類型列的最大長度。	否
   sample_percent	PostgreSQL用於計算因統計資訊而隨機播放的Oracle表資料的比例（預設100）。	否
   prefetch	掃描外表時PostgreSQL與Oracle之間一次性傳輸的資料行數。	否
   key	當前列是否包含在主鍵約束中。	否
   strip_zeros	資料傳遞時，是否去除字串後的ASCII 0字元（在Oracle中合法，在PostgreSQL中非法）。	否

   說明

   • 外部表格的結構定義需要與Oracle資料庫上的被映射表的結構完全一致。

   • oracle_fdw對PolarDB PostgreSQL版（相容Oracle）到Oracle的資料類型映射，請參見類型映射表格。

5. 使用方法。

   您可以使用操作PolarDB PostgreSQL版（相容Oracle）普通表相同的方式來操作外部表格，從而操縱遠程Oracle資料庫中的表。

6. 卸載外掛程式。

   DROP EXTENSION oracle_fdw;

類型映射表格

在oracle_fdw外掛程式中，PolarDB PostgreSQL版（相容Oracle）與Oracle兩種資料庫的資料類型映射如下：

相關參考

更多oracle_fdw進階使用方法，請參見oracle_fdw的官方文檔 。