（注意：如果您修改默认的外部数据包装器 oracle_fdw，则任何更改都将在转储/还原时丢失。 如果要选项持久化，请创建一个新的外部数据包装器。随软件提供的 SQL 脚本中包含可用的 CREATE FOREIGN DATA WRAPPER 语句。）

Oracle用户显然需要CREATE SESSION权限以及选择相关表或视图的权限。

对于EXPLAIN VERBOSE，用户还需要在V$SQL和V$SQL_PLAN上拥有SELECT权限。

oracle_fdw会缓存Oracle连接，因为为每个单独的查询创建Oracle会话的成本较高。当LightDB会话结束时，所有连接都会自动关闭。

函数oracle_close_connections() 可用于关闭所有缓存的Oracle连接。这对于长时间运行的会话非常有用，因为它们不会一直访问外部表，并且希望避免阻塞打开的Oracle连接所需的资源。

不能在修改Oracle数据的事务中调用此函数。

当您定义外部表时，Oracle表的列按其定义顺序映射到LightDB列。

oracle_fdw只会在LightDB查询中实际需要的情况下在Oracle查询中包含这些列。

LightDB表可以比Oracle表具有更多或更少的列。如果它有更多的列，并且这些列被使用，您将收到一个警告并返回NULL值。

如果要进行UPDATE或DELETE操作，请确保所有属于表主键的列的key选项都已设置。否则将导致错误。

必须使用oracle_fdw可以转换的数据类型来定义LightDB列（请参见下面的转换表）。只有在实际使用列时才强制执行此限制，因此您可以为无法转换的数据类型定义“虚拟”列，只要您不访问它们即可（此技巧仅适用于SELECT，而不是在修改外部数据时）。如果Oracle值超出LightDB列的大小（例如，varchar列的长度或最大整数值），则会收到运行时错误。

这些转换由oracle_fdw自动处理：

                Oracle type              | Possible LightDB types
                -------------------------+--------------------------------------------------
                CHAR                     | char, varchar, text
                NCHAR                    | char, varchar, text
                VARCHAR                  | char, varchar, text
                VARCHAR2                 | char, varchar, text, json, oracle.varchar2
                NVARCHAR2                | char, varchar, text
                CLOB                     | char, varchar, text, json
                LONG                     | char, varchar, text
                RAW                      | uuid, bytea
                BLOB                     | bytea
                BFILE                    | bytea (read-only)
                LONG RAW                 | bytea
                NUMBER                   | numeric, float4, float8, char, varchar, text
                NUMBER(n,m)     | numeric, float4, float8, int2, int4, int8,
                                         |    boolean, char, varchar, text
                FLOAT                    | numeric, float4, float8, char, varchar, text
                BINARY_FLOAT             | numeric, float4, float8, char, varchar, text
                BINARY_DOUBLE            | numeric, float4, float8, char, varchar, text
                DATE                     | date, timestamp, timestamptz, char, varchar, text, oracle.date
                TIMESTAMP                | date, timestamp, timestamptz, char, varchar, text
                TIMESTAMP WITH TIME ZONE | date, timestamp, timestamptz, char, varchar, text
                TIMESTAMP WITH           | date, timestamp, timestamptz, char, varchar, text
                   LOCAL TIME ZONE       |
                INTERVAL YEAR TO MONTH   | interval, char, varchar, text
                INTERVAL DAY TO SECOND   | interval, char, varchar, text
                XMLTYPE                  | xml, char, varchar, text
            

如果将NUMBER转换为布尔值，则0表示false，其他所有值表示true。

插入或更新XMLTYPE只适用于不超过VARCHAR2数据类型最大长度（4000或32767，取决于MAX_STRING_SIZE参数）的值。

目前不支持NCLOB，因为Oracle无法自动将其转换为客户端编码。

如果需要超出上述转换的转换，请在Oracle或LightDB中定义适当的视图。

LightDB将使用WHERE子句的所有适用部分作为扫描的过滤器。每当这样的条件可以安全地转换为Oracle SQL时， Oracle_fdw构造的Oracle查询将包含与这些过滤条件相对应的WHERE子句。这个功能也被称为WHERE子句的“下推”， 可以大大减少从Oracle检索的行数，可能使Oracle的优化器选择访问所需表的良好计划。

同样地，ORDER BY子句将在可能的情况下下推到Oracle。请注意，不会将按字符字符串排序的ORDER BY条件下推， 因为LightDB和Oracle中的排序顺序不能保证相同。

为了利用这一点，请尽量使用简单的条件来为外部表进行选择。选择与Oracle类型相对应的LightDB列数据类型， 否则条件无法转换。

表达式now()，transaction_timestamp()， current_timestamp，current_date和localtimestamp 会被正确转换。

EXPLAIN的输出将显示所使用的Oracle查询，因此您可以看到哪些条件被翻译为Oracle以及如何翻译。

从 24.1 版本开始，涉及到隐式转换为numeric类型的过滤条件可以下推，下面是一些例子：

lightdb@test_o=# explain (costs false) select * from t1 where val1 > 1;
                                                                       QUERY PLAN
                                                                        
---------------------------------------------------------------------------------
------------------------------------------------------------------------
 Foreign Scan on t1
   Oracle query: SELECT /*1057989d07288e060655a4377d7d36ef*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (cast(r1."VAL1" as number) > 1)
(2 rows)

lightdb@test_o=# explain (costs false) select * from t1 where val1::number > 1;
                                                                       QUERY PLAN
                                                                        
---------------------------------------------------------------------------------
------------------------------------------------------------------------
 Foreign Scan on t1
   Oracle query: SELECT /*1057989d07288e060655a4377d7d36ef*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (cast(r1."VAL1" as number) > 1)
(2 rows)
              
                

lightdb@test_o=# explain (costs false) select * from t1 where nvl(val1,' ') = 'abc' order by id;
                                                                                 
     QUERY PLAN                                                                  
                     
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
---------------------
 Foreign Scan on t1
   Oracle query: SELECT /*49625285d521d9e84167b4358a1b57b0*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (nvl(r1."VAL1", ' ') = 'abc') ORDER BY r1
."ID" ASC NULLS LAST
(2 rows)

lightdb@test_o=# explain (costs false) select * from t1 where trim(val1) = 'abc' order by id;
                                                                                 
          QUERY PLAN                                                             
                               
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
-------------------------------
 Foreign Scan on t1
   Oracle query: SELECT /*ad50eef72115ae7525aaaf08663b014c*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (TRIM(BOTH ' ' FROM r1."VAL1") = 'abc') O
RDER BY r1."ID" ASC NULLS LAST
(2 rows)

lightdb@test_o=# explain (costs false) select * from t1 where trim(LEADING val1) = 'abc' order by id;
                                                                                 
      QUERY PLAN                                                                 
                       
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
-----------------------
 Foreign Scan on t1
   Oracle query: SELECT /*e2c065886aa1e3ccb9cc00faa85f9f95*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (ltrim(r1."VAL1", ' ') = 'abc') ORDER BY 
r1."ID" ASC NULLS LAST
(2 rows)

lightdb@test_o=# explain (costs false) select * from t1 where trim(TRAILING val1) = 'abc' order by id;
                                                                                 
      QUERY PLAN                                                                 
                       
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
-----------------------
 Foreign Scan on t1
   Oracle query: SELECT /*4fc7fba86ff56a97069e1102f988519f*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (rtrim(r1."VAL1", ' ') = 'abc') ORDER BY 
r1."ID" ASC NULLS LAST
(2 rows)

lightdb@test_o=# explain (costs false) select * from t1 where nvl(trim(val1),' ') = 'abc' order by id;
                                                                                 
               QUERY PLAN                                                        
                                         
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
-----------------------------------------
 Foreign Scan on t1
   Oracle query: SELECT /*77db51933cdfa1dd6edc39f35a00f952*/ r1."ID", r1."VAL1", 
r1."VAL2", r1."VAL3" FROM "T1" r1 WHERE (nvl(TRIM(BOTH ' ' FROM r1."VAL1"), ' ') 
= 'abc') ORDER BY r1."ID" ASC NULLS LAST
(2 rows)

                    

oracle_fdw可以将连接下推到Oracle服务器，也就是两个外部表之间的连接将导致在Oracle端执行连接的单个查询。

只有 inner/left/right/full/semi join 支持下推。 下面是一些示例：

lightdb@test_o=# SELECT oracle_execute(
lightdb@test_o(#           'oracle',
lightdb@test_o(#           E'CREATE TABLE t1(id number(10,0) primary key, val1 varchar(10), val2 char(10), val3 varchar2(10))'
lightdb@test_o(#        );
 oracle_execute 
----------------
 
(1 row)

lightdb@test_o=# 
lightdb@test_o=# SELECT oracle_execute(
lightdb@test_o(#           'oracle',
lightdb@test_o(#           E'CREATE TABLE t2(id number(10,0) primary key, start_date number(10,0), val1 varchar(10), val2 char(10))'
lightdb@test_o(#        );
 oracle_execute 
----------------
 
(1 row)

lightdb@test_o=# CREATE foreign TABLE t1 (
lightdb@test_o(#     id number(10) OPTIONS (key 'yes') NOT NULL,
lightdb@test_o(#     val1 varchar(10),
lightdb@test_o(#     val2 char(10),
lightdb@test_o(#     val3 text
lightdb@test_o(# ) SERVER oracle OPTIONS (table 'T1', force_pushdown_where_op 'true');
 'yes') NOT NULL,
    start_date number(10),
    val1 varchar(10),
    val2 char(10)
) SERVER oracle OPTIONS (table 'T2', force_pushdown_where_op 'true');CREATE FOREIGN TABLE
lightdb@test_o=# 
lightdb@test_o=# CREATE foreign TABLE t2 (
lightdb@test_o(#     id number(10) OPTIONS (key 'yes') NOT NULL,
lightdb@test_o(#     start_date number(10),
lightdb@test_o(#     val1 varchar(10),
lightdb@test_o(#     val2 char(10)
lightdb@test_o(# ) SERVER oracle OPTIONS (table 'T2', force_pushdown_where_op 'true');
CREATE FOREIGN TABLE
lightdb@test_o=# insert into t1 values(1, '1234', '1234','1234');
;

insert into t2 values(1, '20240118', 'abc', '2');
insert into t2 values(2, '20240118', 'qwe', '2');
insert into t2 values(3, '20240119', 'abc', '2');
insert into t2 values(4, '20240119', 'qwe', '3');
insert into t2 values(5, '20240121', 'zxc', '2');
insert into t2 values(6, '20240119', '', '3');INSERT 0 1
lightdb@test_o=# insert into t1 values(2, '2234', '2234','2234');
INSERT 0 1
lightdb@test_o=# insert into t1 values(3, '2', '2','2');
INSERT 0 1
lightdb@test_o=# insert into t1 values(4, '3', '3','3');
INSERT 0 1
lightdb@test_o=# insert into t1 values(5, '4', '3','3');
INSERT 0 1
lightdb@test_o=# insert into t1 values(6, '5', '3','3');
INSERT 0 1
lightdb@test_o=# 
lightdb@test_o=# insert into t2 values(1, '20240118', 'abc', '2');
INSERT 0 1
lightdb@test_o=# insert into t2 values(2, '20240118', 'qwe', '2');
INSERT 0 1
lightdb@test_o=# insert into t2 values(3, '20240119', 'abc', '2');
INSERT 0 1
lightdb@test_o=# insert into t2 values(4, '20240119', 'qwe', '3');
INSERT 0 1
lightdb@test_o=# insert into t2 values(5, '20240121', 'zxc', '2');
INSERT 0 1
lightdb@test_o=# insert into t2 values(6, '20240119', '', '3');
INSERT 0 1
lightdb@test_o=# create table t1_copy(
lightdb@test_o(#     id number(10) NOT NULL,
lightdb@test_o(#     val1 varchar(10),
lightdb@test_o(#     val2 char(10),
lightdb@test_o(#     val3 text
lightdb@test_o(# );
CREATE TABLE
lightdb@test_o=# explain (costs false) insert into t1_copy select * from t1 where exists (select * from t2 where t1.id=t2.id);
                                                                                       QUE
RY PLAN                                                                                   
     
------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------
-----
 Insert on t1_copy
   ->  Foreign Scan
         Oracle query: SELECT /*0354f41de5ae3cfec39f466b95199ae0*/ r3."ID", r3."VAL1", r3.
"VAL2", r3."VAL3" FROM "T1" r3 WHERE EXISTS (SELECT 1 FROM "T2" r4 WHERE (r3."ID" = r4."ID
") )
(3 rows)

lightdb@test_o=# explain (costs false) insert into t1_copy select t1.* from t1 join t2 on t1.id = t2.id;
                                                                             QUERY PLAN   
                                                                           
------------------------------------------------------------------------------------------
---------------------------------------------------------------------------
 Insert on t1_copy
   ->  Foreign Scan
         Oracle query: SELECT /*8198ab105b0cf1a88507da8440560abf*/ r3."ID", r3."VAL1", r3.
"VAL2", r3."VAL3" FROM ("T1" r3 INNER JOIN "T2" r4 ON (r3."ID" = r4."ID"))
(3 rows)

lightdb@test_o=# explain (costs false) insert into t1_copy select t1.* from t1 left join t2 on t1.id = t2.id;
                                                                             QUERY PLAN   
                                                                          
------------------------------------------------------------------------------------------
--------------------------------------------------------------------------
 Insert on t1_copy
   ->  Foreign Scan
         Oracle query: SELECT /*9590092cd58c52862a9f87d57d5cc7b0*/ r3."ID", r3."VAL1", r3.
"VAL2", r3."VAL3" FROM ("T1" r3 LEFT JOIN "T2" r4 ON (r3."ID" = r4."ID"))
(3 rows)

lightdb@test_o=# explain (costs false) insert into t1_copy select t1.* from t1 right join t2 on t1.id = t2.id;
                                                                             QUERY PLAN   
                                                                          
------------------------------------------------------------------------------------------
--------------------------------------------------------------------------
 Insert on t1_copy
   ->  Foreign Scan
         Oracle query: SELECT /*5b0638eb17c55e93456a02170c07ed6f*/ r3."ID", r3."VAL1", r3.
"VAL2", r3."VAL3" FROM ("T2" r4 LEFT JOIN "T1" r3 ON (r3."ID" = r4."ID"))
(3 rows)

lightdb@test_o=# explain (costs false) insert into t1_copy select t1.* from t1 full join t2 on t1.id = t2.id;
                                                                             QUERY PLAN   
                                                                          
------------------------------------------------------------------------------------------
--------------------------------------------------------------------------
 Insert on t1_copy
   ->  Foreign Scan
         Oracle query: SELECT /*0175371a65b00ef9b62ca21e1910774f*/ r3."ID", r3."VAL1", r3.
"VAL2", r3."VAL3" FROM ("T1" r3 FULL JOIN "T2" r4 ON (r3."ID" = r4."ID"))
(3 rows)

                

在下推连接时，有一些限制：

很重要的是，使用ANALYZE收集了两个外部表的表统计信息，LightDB才能确定最佳的连接策略。

oracle_fdw支持对外部表进行INSERT、UPDATE和DELETE操作。默认情况下（包括从早期的LightDB版本升级的数据库中）允许此操作， 并且可以通过设置readonly表选项来禁用。

对于UPDATE和DELETE操作，与Oracle表的主键列对应的列必须设置key列选项。 这些列用于标识外部表中的一行，因此请确保在属于主键的所有列上设置了该选项。

如果在INSERT操作中省略了外部表列，那么该列将设置为在LightDB外部表上定义的DEFAULT子句的值（如果没有DEFAULT子句，则为NULL）。 不使用相应的Oracle列上的DEFAULT子句。如果LightDB外部表不包括Oracle表的所有列，则Oracle DEFAULT子句将用于未包含在外部表定义中的列。

INSERT、UPDATE和DELETE操作中的RETURNING子句被支持，但对于具有Oracle数据类型LONG和LONG RAW的列除外 （Oracle不支持在RETURNING子句中使用这些数据类型）。

支持外部表上的触发器。使用AFTER和FOR EACH ROW定义的触发器要求外部表没有具有Oracle数据类型LONG或LONG RAW的列。 这是因为这样的触发器利用了上面提到的RETURNING子句。

虽然修改外部数据是可行的，但在许多行受到影响时，性能并不是特别好，这是由于（由于外部数据包装器的工作方式） 每一行都必须单独处理。

事务将被转发到Oracle，因此BEGIN、COMMIT、ROLLBACK和SAVEPOINT按预期工作。不支持涉及Oracle的预处理语句。 有关详细信息，请参见内部部分。

由于oracle_fdw默认使用序列化事务，因此修改数据语句可能导致序列化失败：

                ORA-08177: can't serialize access for this transaction
            

如果并发事务修改了表，并且在长时间运行的事务中更有可能发生此类情况。这些错误可以通过它们的SQLSTATE（40001）进行识别。 使用oracle_fdw的应用程序应该重试以此错误失败的事务。

可以使用不同的事务隔离级别，有关讨论，请参见Foreign server options。

LightDB的EXPLAIN命令将显示实际发送给Oracle的查询语句。使用EXPLAIN VERBOSE命令将显示Oracle的执行计划（不适用于Oracle服务器9i或更早版本，请参阅Problems）。

您可以使用ANALYZE命令收集外部表的统计信息。这一功能由oracle_fdw支持。

如果没有统计信息，LightDB无法估计对外部表的查询结果行数，这可能导致选择错误的执行计划。

与普通表不同，LightDB不会自动通过autovacuum守护进程来收集外部表的统计信息，因此在创建外部表之后，以及远程表发生重大变化时，运行ANALYZE命令收集外部表的统计信息尤为重要。

请注意，对Oracle外部表进行分析将导致完整的顺序表扫描。您可以使用表选项sample_percent，仅使用Oracle表的部分抽样数据以加快速度。

支持使用IMPORT FOREIGN SCHEMA命令批量导入Oracle模式中所有表的表定义。

除了IMPORT FOREIGN SCHEMA的文档之外，还请考虑以下内容：

请注意，IMPORT FOREIGN SCHEMA 与 Oracle server 8i 不兼容；详见问题部分以获取更多细节。

存储在 Oracle 数据库中的字符，如果无法转换为 LightDB 数据库编码，Oracle 将默默地替换为 替换字符， 通常是普通或反向问号。您将不会收到警告或错误消息。

如果您使用 Oracle 不知道的 LightDB 数据库编码（目前有 EUC_CN、EUC_KR、LATIN10、MULE_INTERNAL、WIN874 和 SQL_ASCII）， 则无法正确地转换非 ASCII 字符。在这种情况下，您将收到警告，并且字符将被替换为上述替换字符。

您可以设置外部数据包装器的 nls_lang 选项以强制使用某个 Oracle 编码， 但是生成的字符很可能是不正确的，并会导致 LightDB 错误消息。如果您知道自己在做什么，则仅对 SQL_ASCII 编码有用。 请参见选项部分。

在 Oracle 11.2 或更高版本中，使用 oracle_fdw 向新创建的 Oracle 表插入第一行会导致序列化错误。

这是因为 Oracle 具有一个名为延迟 段创建 的功能，它推迟为新表分配存储空间，直到插入第一行。 这会导致可串行化事务出现序列化故障（请参见 Oracle 知识库中的文档 1285464.1）。

这不是一个严重的问题；您可以通过忽略第一个错误或使用 SEGMENT CREATION IMMEDIATE 创建表来解决它。

一种更加严重的问题是，当索引页面与修改可串行化事务同时发生并发插入时，有时可能会导致序列化错误（请参见 Oracle 文档 160593.1）。

Oracle 声称这不是一个 bug，建议的解决方案是重试遇到序列化错误的事务。

这是过去影响 oracle_fdw 的 Oracle Bug 列表。

Bug 2728408 可能会导致 ORA-8177 cannot serialize access for this transaction， 即使没有尝试修改远程数据。

它可能会发生在 Oracle server 8.1.7.4（安装 one-off patch 2728408）或 Oracle server 9.2（安装 Patch Set 9.2.0.4 或更高版本）。