DATABASE LINK函数

描述：通过DBLink名称主动关闭当前session下该DBLink的连接，不允许关闭存在活跃事务的dblink。

示例：

gaussdb=# SELECT close_database_link('xxx');
 close_database_link 
---------------------
 t
(1 row)

gaussdb=# BEGIN;
BEGIN
gaussdb=# SELECT * FROM t1@dblink;
c1 | c2 | c3 
----+----+----
1 | | 
(1 row)
gaussdb=# INSERT INTO t1@dblink VALUES (2,0,0);
INSERT 0 1
gaussdb=# SELECT * FROM t1@dblink;
c1 | c2 | c3 
----+----+----
1 | | 
2 | 0 | 0
(2 rows)
gaussdb=# SELECT close_database_link('dblink');
ERROR: Dblink dblink is in use.
CONTEXT: referenced column: close_database_link
gaussdb=# END;
ROLLBACK

描述：该函数只能获取连接Oracle库的DBLink对应的信息。通过DBLink名称获取gs_ora_fdw版本、GaussDB版本、Oracle数据库客户端版本以及Oracle数据库服务端版本信息。当参数为NULL时，如果查询用户是管理员用户还会返回ORACLE_HOME、ORACLE_SID、TNS_ADMIN、TWO_TASK、 LDAP_ADMIN等信息，非管理员用户不显示。

示例：

--管理员用户。
gaussdb=# SELECT gs_ora_diag('xxx');
                                     gs_ora_diag                                      
--------------------------------------------------------------------------------------
 gs_ora_fdw 1.0.0, GaussDB 9.2.4, Oracle client 19.24.0.0.0, Oracle server 19.0.0.0.0
(1 row)
gaussdb=# SELECT gs_ora_diag();
                                                                                         gs_ora_diag                                                                                          
----------------------------------------------------------------------------------------------------------------------------------------------------
 gs_ora_fdw 1.0.0, GaussDB 9.2.4, Oracle client 19.24.0.0.0, ORACLE_HOME=/xxx/instantclient_19_24, TNS_ADMIN=/xxx/instantclient_19_24/network/admin
(1 row)

--普通用户。
gaussdb=# SELECT gs_ora_diag('xxx');
                                     gs_ora_diag                                      
--------------------------------------------------------------------------------------
 gs_ora_fdw 1.0.0, GaussDB 9.2.4, Oracle client 19.24.0.0.0, Oracle server 19.0.0.0.0
(1 row)

gaussdb=# SELECT gs_ora_diag();
                        gs_ora_diag                         
------------------------------------------------------------
 gs_ora_fdw 1.0.0, GaussDB 9.2.4, Oracle client 19.24.0.0.0
(1 row)

描述：通过DBLink的OID，获取该DBLink通过OCI使用的内存大小，单位为字节。

gaussdb=# SELECT gs_ora_get_handle_alloc(xxx);
  gs_ora_get_handle_alloc 
--------------------------
                   151224
(1 row)

描述：获取每个节点的环境句柄，所有DBLink通过OCI使用的内存大小计算总和，单位为字节。

gaussdb=# SELECT gs_ora_get_handle_alloc_all();
  gs_ora_get_handle_alloc_all 
------------------------------
                       429000
(1 row)

描述：通过DBLink的OID，获取该DBLink在当前session下的连接状态。

示例：

gaussdb=# SELECT gs_ora_connection_status(xxx);
  gs_ora_connection_status
-----------------------------
  CONNECTED
(1 row)

描述：外部数据封装器oracle_fdw的处理函数，函数功能为返回一个fdw_handler结构体，其中包含指向回调函数的指针。

入参：无

返回值类型：fdw_handler

描述：外部数据封装器gs_ora_fdw的检查函数，用来检查提供给gs_ora_fdw的通用选项。如果选项或选项值无效或缺失，则报错。

返回值类型：void

描述：通过DBLink的OID，获取该DBLink是否被使用。

示例：

gaussdb=# SELECT is_dblink_in_use(xxx);
  is_dblink_in_use
-----------------------------
  f
(1 row)

描述：判断当前事务中是否已使用OID对应的DATABASE LINK发送了DML语句且未提交。

示例：

gaussdb=# SELECT dblink_has_updatasent(xxx);
  dblink_has_updatasent
-----------------------------
  f
(1 row)

描述：通过DBLink的OID，获取该DBLink是否正在事务中。

示例：

gaussdb=# SELECT is_dblink_in_transaction(xxx);
  is_dblink_in_transaction
-----------------------------
  f
(1 row)