> 本文面向有一定ABAP基础、首次接触ADBC直连开发的顾问和开发者。以问题为导向，从配置环境到查询写入，再到常见踩坑，带你从零掌握SAP直连Oracle数据库的完整技术栈。

---

## 一、开场：为什么需要直连数据库？

在SAP项目中，我们经常需要和外围系统打交道——WMS仓库系统、SCM供应链系统、MES制造执行系统……数据在不同系统间流转，方式五花八门：

- **RFC/IDoc/Proxy**：SAP原生的标准接口方式，规范但配置复杂

- **ESB/中间件**：通过企业服务总线中转，解耦但多了一层依赖

- **文件交换**：CSV、Excel、XML文件互传，简单但实时性差

- **直连数据库**：直接读写对方数据库表，简单粗暴但高效

**ADBC（ABAP Database Connectivity）** 就是SAP提供的一套直连外部数据库的API。它的思路和Java的JDBC、Python的cx_Oracle很像——建立连接、执行SQL、处理结果。

### 什么时候该用ADBC？

✅ **适合的场景**：

- 外围系统只开放数据库访问权限，没有接口服务

- 大数据量同步，性能要求高

- 实时性要求不高的批量数据交换

- 对方系统是"黑盒"，只能通过表级操作集成

❌ **不适合的场景**：

- 需要事务一致性保证的关键业务

- 对方系统有成熟的API/服务接口

- 数据结构复杂、业务逻辑多的场景

- 对安全性要求极高（直连数据库权限较大）

本文我们聚焦 **Oracle数据库**，从最基础的配置讲起，一步步写出能跑的代码。

---

## 二、问题一：连不上怎么办？—— 环境配置三步走

很多人第一次用ADBC，代码写得没问题，但就是连不上。90%的情况都是环境配置的锅。这一节我们把配置环节拆成三步，每一步都讲清楚。

### 2.1 DBCO事务：配置连接信息

SAP里所有外部数据库连接的配置都存在 **DBCON** 表里，维护事务码是 **DBCO**。

打开DBCO后，点击"新建"，你会看到几个关键字段：

| 字段 | 说明 | 示例 |

|------|------|------|

| 连接名 | 自定义的连接标识，代码里用这个名字获取连接 | `ADBC-SCM-001` |

| 数据库类型 | 选Oracle | `ORA` 或 `ORACLE` |

| 用户名 | 对方数据库的用户名 | `scm_user` |

| 密码 | 对方数据库的密码 | `********` |

| 连接串 | Oracle TNS连接串 | `//192.168.1.100:1521/ORCL` |

> ⚠️ **踩坑提醒**：连接名是**大小写敏感**的！代码里写的 `'ADBC-SCM-001'` 和配置的 `'adbc-scm-001'` 是两个不同的连接。这个坑我见过不止一次。

连接串的格式，Oracle一般有两种写法：

```

//host:port/service_name （推荐，简单直接）

//192.168.1.100:1521/ORCL

或者完整的TNS描述：

(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=ORCL)))

```

配置完保存，DBCON表里就多了一条记录。但这只是第一步，能不能连上还得看驱动装没装。

### 2.2 Basis侧：Oracle驱动安装

ADBC本质上是通过SAP应用服务器上的数据库客户端驱动来连接外部数据库的。**没有驱动，一切免谈。**

这一步通常是Basis同事负责的，但作为开发你得知道原理，出了问题才能和Basis有效沟通。

#### Windows环境

需要安装 **Oracle Instant Client**（或完整的Oracle Client），确保以下文件在系统PATH中：

- `oci.dll` — Oracle调用接口核心库

- `oraociei12.dll`（或对应版本）— 数据访问组件

- `orannzsbb12.dll` — 安全组件

检查方式：在SAP应用服务器上打开命令行，输入 `where oci.dll`，能找到路径说明装好了。

#### Unix/Linux环境

需要确保 `libclntsh.so` 在库路径中（`LD_LIBRARY_PATH` 环境变量）。

SAP应用服务器启动时会加载这些库，所以**装完驱动后需要重启SAP实例**才能生效。

#### 版本兼容性

| Oracle数据库版本 | 推荐Instant Client版本 |

|------------------|----------------------|

| 11g | 11.2.x |

| 12c | 12.1.x / 12.2.x |

| 19c | 19.x |

| 21c | 21.x |

一般来说，客户端版本**等于或略低于**数据库版本比较稳妥。跨大版本可能会有兼容性问题。

### 2.3 连通性测试

配置完了，怎么验证能不能连上？推荐三种方式：

#### 方式一：DBACOCKPIT（推荐）

事务码 **DBACOCKPIT** 是SAP的DBA控制台，功能很全：

1. 打开DBACOCKPIT，找到你配置的连接

2. 可以直接 **Ping** 测试网络连通性

3. 可以查看数据库版本、字符集等信息

4. 可以直接执行SQL语句测试（比如 `SELECT SYSDATE FROM DUAL`）

这个工具能帮你快速定位问题——Ping不通是网络问题，Ping得通但SQL执行报错可能是权限或驱动问题。

#### 方式二：标准演示程序 ADBC_DEMO

SAP系统自带了一个ADBC演示程序 **ADBC_DEMO**（事务码 SE38 执行），非常适合初学者学习和快速验证环境。

这个程序的主要功能：

- **连接测试**：选择已配置的DBCO连接名，一键测试连通性

- **SQL执行器**：可以直接输入任意SQL语句执行并查看结果

- **演示模式**：内置了多个示例，展示查询、参数绑定、批量操作等用法

- **错误演示**：甚至有故意写错的SQL，展示异常信息长什么样

使用方法很简单：

1. SE38 输入 `ADBC_DEMO`，执行

2. 在 **Connection** 字段选择你的DBCO连接名

3. 切换不同的演示标签页（Query、Parameter、Update 等）

4. 点击 Execute 看效果

> 💡 **学习建议**：如果你是第一次接触ADBC，强烈建议先跑一遍 ADBC_DEMO 的所有示例。它的代码结构清晰、注释完整，比看文档直观多了。遇到看不懂的地方，直接SE38进去看源码，比自己瞎琢磨效率高得多。

#### 方式三：小程序测试

写一段最简单的ABAP代码测试连接：

```abap

REPORT ztest_adbc_conn.

DATA: lo_conn TYPE REF TO cl_sql_connection,

lo_stmt TYPE REF TO cl_sql_statement,

lo_result TYPE REF TO cl_sql_result_set,

lv_date TYPE string.

TRY.

lo_conn = cl_sql_connection=>get_connection( 'ADBC-SCM-001' ).

lo_stmt = lo_conn->create_statement( ).

lo_result = lo_stmt->execute_query( 'SELECT TO_CHAR(SYSDATE, ''YYYY-MM-DD HH24:MI:SS'') FROM DUAL' ).

lo_result->next( ).

lo_result->get_value( EXPORTING column = 1

IMPORTING value = lv_date ).

lo_result->close( ).

WRITE: / '连接成功！当前数据库时间：', lv_date.

lo_conn->close( ).

CATCH cx_sql_exception INTO DATA(lx_err).

WRITE: / '连接失败：', lx_err->get_text( ).

ENDTRY.

```

如果这段代码能正常输出数据库时间，恭喜你，环境通了！

---

## 三、问题二：要查数据怎么办？—— ADBC查询Oracle

环境通了，接下来就是最常用的操作——查数据。ADBC的查询流程非常经典，如果你用过JDBC会觉得很熟悉。

### 3.1 基本查询流程

ADBC查询的核心是三个类：

- **CL_SQL_CONNECTION** — 数据库连接对象

- **CL_SQL_STATEMENT** — SQL语句对象

- **CL_SQL_RESULT_SET** — 查询结果集

完整的查询流程如下：

```abap

" 1. 定义变量

DATA: lv_dbcon TYPE dbcon_name,

lo_conn TYPE REF TO cl_sql_connection,

lo_stmt TYPE REF TO cl_sql_statement,

lo_result TYPE REF TO cl_sql_result_set,

lv_sql TYPE string,

lt_data TYPE TABLE OF zs_external_rec,

ls_data TYPE zs_external_rec.

" 2. 获取连接

lv_dbcon = 'ADBC-SCM-001'.

TRY.

lo_conn = cl_sql_connection=>get_connection( lv_dbcon ).

CATCH cx_sql_exception INTO DATA(lx_conn).

MESSAGE '数据库连接失败：' && lx_conn->get_text( ) TYPE 'E'.

ENDTRY.

" 3. 创建语句对象 + 构建SQL

TRY.

lo_stmt = lo_conn->create_statement( ).

lv_sql = | SELECT matnr, maktx, erdat, lfdat | &&

| FROM qm_kanban | &&

| WHERE erdat >= '20240101' | &&

| ORDER BY erdat |.

" 4. 执行查询

lo_result = lo_stmt->execute_query( lv_sql ).

" 5. 将结果集绑定到内表

lo_result->set_param_table( REF #( lt_data ) ).

lo_result->next_package( ).

lo_result->close( ).

WRITE: / '查询成功，共', lines( lt_data ), '条数据'.

CATCH cx_sql_exception INTO DATA(lx_sql).

MESSAGE 'SQL执行失败：' && lx_sql->get_text( ) TYPE 'E'.

ENDTRY.

" 6. 关闭连接

IF lo_conn IS BOUND.

lo_conn->close( ).

ENDIF.

```

这段代码的几个关键点：

1. **`set_param_table`**：把结果集直接映射到内表，内表的字段顺序和类型要和SELECT的列对应

2. **`next_package`**：一次性读取所有结果（也可以分批读，后面讲）

3. **`close`**：结果集和连接用完一定要关，否则会泄漏

4. **TRY/CATCH**：所有ADBC操作都要捕获 `cx_sql_exception`，出了问题能拿到具体错误信息

### 3.2 参数化查询

上面的例子里，日期条件是直接拼在SQL字符串里的。这在实际项目中是**绝对不推荐**的，原因有二：

1. **SQL注入风险**：如果条件来自用户输入，可能被注入恶意SQL

2. **性能问题**：每次SQL文本都不一样，数据库无法复用执行计划

正确的做法是用 **参数化查询**，用 `?` 做占位符：

```abap

DATA: lv_start_date TYPE char8.

lv_start_date = '20240101'.

lv_sql = | SELECT matnr, maktx, erdat | &&

| FROM qm_kanban | &&

| WHERE erdat >= ? | &&

| ORDER BY erdat |.

" 绑定参数（按?出现的顺序依次绑定）

lo_stmt->set_param( REF #( lv_start_date ) ).

lo_result = lo_stmt->execute_query( lv_sql ).

```

> ⚠️ 注意：`set_param` 的调用顺序必须和SQL中 `?` 的顺序一一对应。有几个 `?` 就要调用几次 `set_param`，多了少了都会报错。

如果参数很多，可以用 `set_param_table` 一次性绑定一个内表参数（不过这个用得相对少一些）。

### 3.3 Oracle SQL的那些"不一样"

如果你平时写惯了Open SQL（ABAP的SQL），写Oracle原生SQL时会遇到一些语法差异。这里列几个最常见的：

#### NVL 空值替换

Oracle的 `NVL(expr, default)` 相当于ABAP的 `COALESCE`，也等于Open SQL的 `COALESCE`：

```sql

-- 如果nloc为空，返回toid的值

NVL(b.nloc, a.toid) AS location

```

#### TO_CHAR 日期格式化（新手最容易踩的坑）

这是ADBC开发中**最容易翻车**的一个点，必须单独拿出来讲透。

**问题现象**：你写了一条查询SQL，里面有个Oracle的DATE类型字段，你在ABAP里用 `TYPE char8` 或 `TYPE string` 来接，结果要么报错，要么拿到的是乱码/格式不对的值。

**根本原因**：Oracle的 `DATE` 类型是一个包含年月日时分秒的二进制结构，它**不是字符串**。ADBC在传输时，如果ABAP端的接收变量是字符类型（char/string），而数据库端是DATE类型，类型不匹配就会出问题。

**正确做法（推荐）：在SQL里用TO_CHAR转成字符串**

这是SCM系统接口中采用的方式，也是最稳妥的方案——在查询时就把日期字段转成你想要的字符串格式，ABAP端直接用字符类型接收：

```sql

SELECT

matnr,

maktx,

TO_CHAR(initdate, 'yyyymmdd') AS create_date, " 日期 → CHAR8

TO_CHAR(printdate, 'yyyymmdd') AS print_date,

TO_CHAR(di_updatetime, 'yyyymmdd hh24:mi:ss') AS update_time " 带时分秒

FROM qm_kanban

```

ABAP端对应的内表字段就用 `char8` 或 `char19` 来接，干干净净。

注意Oracle的格式符：`hh24` 是24小时制，`mi` 是分钟（不是mm，mm是月份）。这个细节写错了格式就不对。

#### (+) 外连接语法

老版本Oracle用 `(+)` 表示外连接，这是Oracle特有的语法：

```sql

-- 左外连接：a表所有记录，b表匹配不上的字段为空

SELECT a.toid, b.nloc

FROM temp_locnewandold a,

qm_kanban b

WHERE a.toid = b.oloc(+)

```

当然，现在也支持标准的 `LEFT JOIN` 语法了，但很多老系统里还能看到 `(+)` 的写法。

#### || 字符串拼接

Oracle用 `||` 拼接字符串，而不是Open SQL里的 `&&` 或 `CONCAT`：

```sql

SELECT matnr || '_' || maktx AS full_desc

FROM qm_kanban

```

#### ROWNUM 分页

Oracle没有 `LIMIT`，分页用 `ROWNUM`：

```sql

-- 取前100条

SELECT * FROM qm_kanban WHERE ROWNUM <= 100

-- 分页：第101-200条（需要嵌套）

SELECT * FROM (

SELECT t.*, ROWNUM rn FROM (

SELECT * FROM qm_kanban ORDER BY erdat DESC

) t WHERE ROWNUM <= 200

) WHERE rn > 100

```

#### SYSDATE 和 DUAL表

Oracle获取当前时间用 `SYSDATE`，测试SQL经常用 `DUAL` 这个虚拟表：

```sql

SELECT SYSDATE FROM DUAL;

SELECT 1 + 1 FROM DUAL;

SELECT USER FROM DUAL;

```

### 3.4 大数据量查询

如果查询结果有几万、几十万条，一次性全部读到内表里可能会撑爆内存。这时候需要**分批读取**。

ADBC的 `next_package` 方法支持指定包大小：

```abap

DATA: lv_package_size TYPE i VALUE 5000,

lv_total TYPE i VALUE 0.

lo_result = lo_stmt->execute_query( lv_sql ).

lo_result->set_param_table( REF #( lt_data ) ).

DO.

lo_result->next_package( EXPORTING up_to = lv_package_size

IMPORTING rows = DATA(lv_rows) ).

IF lv_rows = 0.

EXIT.

ENDIF.

" 处理这一批数据

lv_total = lv_total + lv_rows.

" ... 业务逻辑处理 ...

" 清空内表，准备下一批

CLEAR lt_data.

ENDDO.

lo_result->close( ).

```

#### 增量同步思路

实际项目中，从外部系统拉数据很少全量拉，一般都是**增量同步**。常见的做法：

1. **批次号方式**：对方表有个自增的批次号字段（比如 `di_batchno`），每次记录上次处理到的批次号，下次只拉比这个大的

2. **时间戳方式**：用创建时间/修改时间做增量条件

3. **状态标记方式**：对方表有个处理状态字段，处理完更新状态

批次号的存储可以用 **STVARV** 变量（SAP标准的变量维护表，事务码STVARV），也可以自建一张日志表。

```abap

" 从STVARV获取上次处理的批次号

DATA: lv_last_batch TYPE numc10.

" 假设已经从STVARV读到了lv_last_batch

lv_sql = | SELECT matnr, maktx, di_batchno | &&

| FROM qm_kanban | &&

| WHERE di_batchno > ? | &&

| ORDER BY di_batchno |.

lo_stmt->set_param( REF #( lv_last_batch ) ).

" ... 处理完后，把最大批次号写回STVARV ...

```

---

## 四、问题三：要写数据怎么办？—— ADBC写入Oracle

查询是从外部数据库读数据到SAP，写入则反过来——把SAP的数据写到外部数据库里。

### 4.1 INSERT写入

写入用的是 `execute_update` 方法（注意不是execute_query），它返回受影响的行数：

```abap

DATA: lv_rows TYPE i.

lv_sql = | INSERT INTO di_t_invmaterialdoc ( | &&

| matnr, maktx, erdat, menge, meins | &&

| ) VALUES ( | &&

| ?, ?, ?, ?, ? | &&

| ) |.

" 按顺序绑定参数

lo_stmt->set_param( REF #( ls_data-matnr ) ).

lo_stmt->set_param( REF #( ls_data-maktx ) ).

lo_stmt->set_param( REF #( ls_data-erdat ) ).

lo_stmt->set_param( REF #( ls_data-menge ) ).

lo_stmt->set_param( REF #( ls_data-meins ) ).

" 执行写入

TRY.

lv_rows = lo_stmt->execute_update( lv_sql ).

WRITE: / '成功插入', lv_rows, '行'.

CATCH cx_sql_exception INTO DATA(lx_ins).

MESSAGE '插入失败：' && lx_ins->get_text( ) TYPE 'E'.

ENDTRY.

```

和查询一样，写入也强烈推荐**参数化查询**，尤其是当数据来自用户输入或业务单据时。

### 4.2 事务控制

这是ADBC写入最容易踩坑的地方之一。

**外部数据库的事务和SAP的事务是两回事！**

你在SAP里写 `COMMIT WORK`，只会提交SAP数据库的事务，**不会**提交外部数据库的事务。外部数据库的事务必须手动控制：

```abap

TRY.

lo_conn = cl_sql_connection=>get_connection( 'ADBC-SCM-001' ).

lo_stmt = lo_conn->create_statement( ).

" 执行第一条INSERT

lv_sql = 'INSERT INTO table1 (col1) VALUES (?)'.

lo_stmt->set_param( REF #( lv_val1 ) ).

lo_stmt->execute_update( lv_sql ).

" 执行第二条INSERT

lv_sql = 'INSERT INTO table2 (col2) VALUES (?)'.

lo_stmt->set_param( REF #( lv_val2 ) ).

lo_stmt->execute_update( lv_sql ).

" 两条都成功，提交事务

lo_conn->commit( ).

WRITE: / '写入成功，已提交'.

CATCH cx_sql_exception INTO DATA(lx_err).

" 任何一步出错，回滚事务

IF lo_conn IS BOUND.

lo_conn->rollback( ).

ENDIF.

MESSAGE '写入失败，已回滚：' && lx_err->get_text( ) TYPE 'E'.

ENDTRY.

" 关闭连接

IF lo_conn IS BOUND.

lo_conn->close( ).

ENDIF.

```

几个关键原则：

1. **成功要COMMIT**：不COMMIT的话，数据不会真正写入数据库，其他会话也看不到

2. **失败要ROLLBACK**：异常时一定要回滚，否则会持有锁，影响其他操作

3. **最后要CLOSE**：连接用完关闭，防止泄漏

4. **TRY/CATCH要包住**：所有数据库操作都在TRY块里，CATCH里统一回滚和报错

> ⚠️ **特别注意**：如果你的程序在循环里批量写入，不要每条都COMMIT，那样性能很差。建议每1000条左右COMMIT一次，或者全部成功后一次性COMMIT（看数据量和业务要求）。

### 4.3 UPDATE与DELETE

UPDATE和DELETE的写法和INSERT类似，都是用 `execute_update`：

```abap

" UPDATE示例

lv_sql = | UPDATE di_t_invmaterialdoc | &&

| SET maktx = ? | &&

| WHERE matnr = ? |.

lo_stmt->set_param( REF #( lv_new_maktx ) ).

lo_stmt->set_param( REF #( lv_matnr ) ).

lv_rows = lo_stmt->execute_update( lv_sql ).

IF lv_rows = 0.

WRITE: / '没有找到匹配的记录'.

ELSE.

WRITE: / '更新了', lv_rows, '条记录'.

ENDIF.

```

```abap

" DELETE示例

lv_sql = | DELETE FROM di_t_invmaterialdoc | &&

| WHERE matnr = ? |.

lo_stmt->set_param( REF #( lv_matnr ) ).

lv_rows = lo_stmt->execute_update( lv_sql ).

WRITE: / '删除了', lv_rows, '条记录'.

```

> 💡 **小技巧**：执行完UPDATE/DELETE后，判断 `lv_rows = 0` 可以知道有没有匹配到数据。有时候业务上"更新0条"可能是异常情况，需要特殊处理。

---

## 五、问题四：报错了怎么办？—— 常见异常与踩坑汇总

ADBC开发中，报错是家常便饭。这里把最常见的错误和解决方案整理一下，遇到了可以直接对照。

### 5.1 连接类错误

#### 错误：驱动未找到

**现象**：`cx_sql_exception`，错误信息包含 "Driver not loaded" 或 "OCI_INVALID_HANDLE"

**原因**：SAP应用服务器上没有安装Oracle客户端驱动，或者驱动不在PATH/LD_LIBRARY_PATH中

**解决**：

1. 找Basis确认Oracle Instant Client是否安装

2. 检查环境变量配置

3. 装完驱动后重启SAP实例

#### 错误：用户名密码错误

**现象**：ORA-01017: invalid username/password; logon denied

**原因**：DBCO里配置的用户名或密码不对

**解决**：用DBCO事务重新维护正确的用户名密码

#### 错误：TNS连接串问题

**现象**：ORA-12154: TNS:could not resolve the connect identifier specified 或 ORA-12514

**原因**：连接串格式不对，或者数据库地址/端口/服务名错误

**解决**：

1. 检查连接串格式，推荐用 `//host:port/service_name`

2. 确认数据库IP、端口、服务名正确

3. 在SAP应用服务器上用tnsping命令测试

#### 错误：网络不通

**现象**：连接超时，或者ORA-12541: TNS:no listener

**原因**：网络不通，或者数据库监听器没启动

**解决**：

1. 在SAP应用服务器上ping数据库IP

2. telnet测试端口是否通

3. 找DBA确认数据库和监听器状态

### 5.2 SQL执行类错误

#### 错误：表或视图不存在

**现象**：ORA-00942: table or view does not exist

**原因**：

1. 表名写错了（注意大小写！Oracle默认大写，除非建表时用了双引号）

2. 连接的用户没有这张表的权限

3. 表在其他schema下，需要加前缀（比如 `scm_user.qm_kanban`）

**解决**：

1. 检查表名拼写和大小写

2. 确认用户权限

3. 必要时加上schema前缀

#### 错误：列名无效

**现象**：ORA-00904: "XXX": invalid identifier

**原因**：字段名写错了，或者这张表根本没有这个字段

**解决**：对照目标表的字段定义，检查拼写

#### 错误：数据类型不匹配

**现象**：ORA-01722: invalid number 或 ORA-01861: literal does not match format string

**原因**：

1. 把字符串插到NUMBER类型的字段里

2. 日期格式不对

3. 参数绑定的数据类型和目标列不匹配

**解决**：

1. 检查字段类型，确保插入的数据类型匹配

2. 日期用 `TO_DATE(?, 'yyyymmdd')` 显式转换

#### 错误：绑定变量数量不匹配

**现象**：报错说参数数量不对，或者索引越界

**原因**：SQL里有N个 `?`，但 `set_param` 调用次数不是N次

**解决**：数清楚SQL里有几个 `?`，确保 `set_param` 调用次数一致，顺序对应

### 5.3 事务与锁

#### 长事务导致锁表

**现象**：程序跑了一半卡住，或者其他会话操作这张表超时

**原因**：程序里开了事务但一直没COMMIT也没ROLLBACK，持有行锁或表锁

**解决**：

1. 确保所有异常路径都有ROLLBACK

2. 不要在事务中间做耗时的业务处理

3. 批量操作时定期COMMIT

#### 忘记COMMIT

**现象**：程序显示执行成功，但数据库里查不到数据

**原因**：执行了INSERT/UPDATE但没有调用 `lo_conn->commit( )`

**解决**：写入操作成功后一定要COMMIT

#### 连接泄漏

**现象**：运行一段时间后报 "maximum number of connections exceeded"

**原因**：程序里获取了连接但没有close，连接越积越多

**解决**：

1. 养成习惯：TRY块最后CLOSE，CATCH块里也要CLOSE

2. 可以封装工具类，自动管理连接生命周期

### 5.4 其他坑

#### 连接名大小写

这个前面提过，但值得再强调一次：**DBCON的连接名是大小写敏感的**。代码里写的和DBCO配置的必须完全一致，包括大小写。

#### Oracle保留字

如果你的字段名刚好是Oracle的保留字（比如 `USER`、`DATE`、`LEVEL`、`COMMENT`），查询时会报错。解决办法是用双引号括起来，但更推荐的是改字段名避开保留字。

#### NULL值处理

Oracle的NULL和ABAP的INITIAL不是一回事。从Oracle读出来的NULL值，在ABAP里会变成初始值（字符是空串，数字是0），但有时候你需要区分"真的是空"还是"值就是0"。

写入的时候也要注意：如果字段允许NULL，ABAP的初始值传过去是NULL还是空串？这个要看具体类型和绑定方式，建议统一处理逻辑。

#### 日期格式（高频踩坑）

Oracle的日期格式和SAP不一样，这绝对是排名前三的坑点。详细的分析在前面"Oracle SQL的那些不一样"里讲过了，这里再强调几个核心原则：

1. **查询时：日期字段不要直接用字符串接**

- Oracle DATE ≠ 字符串，直接用ABAP的char/string接会出问题

- 推荐方式：`TO_CHAR(date_col, 'yyyymmdd')` 转成字符串再接（SCM项目的做法）

- 替代方式：ABAP端用 `d` 类型接收，让ADBC自动转换（WMS项目的做法），但要注意时分秒会丢失

2. **写入时：用TO_DATE显式转换**

- 不要依赖数据库的默认日期格式，不同环境配置可能不一样

- 正确写法：`INSERT INTO table (date_col) VALUES (TO_DATE(?, 'yyyymmdd'))`

- 参数传 `char8` 类型的日期字符串就行

3. **日期比较：统一格式再比**

- WHERE条件里的日期比较，两边都用同一种格式

- 比如：`WHERE create_date >= TO_DATE(?, 'yyyymmdd')`

一句话总结：**日期字段的转换，能在SQL里做就在SQL里做，不要把问题留给ABAP端。**

---

## 六、进阶：写得更优雅一点

掌握了基本的增删改查，你已经能应付大部分场景了。但如果想让代码更健壮、更好维护，可以看看下面这些进阶内容。

### 6.1 工具类封装

每个程序都写一遍连接获取、异常处理、关闭连接，重复又容易漏。不如封装成工具类：

```abap

CLASS zcl_adbc_helper DEFINITION PUBLIC.

PUBLIC SECTION.

METHODS:

get_connection IMPORTING iv_con_name TYPE dbcon_name

RETURNING VALUE(ro_conn) TYPE REF TO cl_sql_connection

RAISING cx_sql_exception,

safe_close IMPORTING io_conn TYPE REF TO cl_sql_connection.

ENDCLASS.

```

思路就是把重复的逻辑抽出来，比如：

- 连接名校验（是否配置、是否激活）

- 统一的异常日志记录

- 安全的连接关闭（判断是否BOUND）

- 统一的事务提交/回滚模式

### 6.2 性能优化

#### 批量操作

如果要插入大量数据，一条一条INSERT性能很差。可以考虑：

- 每N条COMMIT一次（比如1000条），减少事务开销

- 如果Oracle版本支持，用数组绑定（array bind）批量插入

- 考虑用SQL*Loader等工具（但这就不是ADBC的范畴了）

#### 合理使用索引

查询条件要尽量走索引，这个和普通SQL优化是一样的。ADBC只是执行通道，SQL本身的性能还是要靠SQL优化。

#### 连接复用

如果一个程序里要执行多次SQL，不要每次都get_connection再close，复用同一个连接对象就行。

### 6.3 安全实践

#### SQL注入防护

**永远不要**把用户输入直接拼到SQL字符串里。一律用参数化查询（`?` + `set_param`）。

#### 权限最小化

给SAP用的数据库账号，权限要尽量小：

- 只给需要的表的SELECT/INSERT/UPDATE权限

- 不要给DROP、ALTER等DDL权限

- 不要用DBA账号

#### 敏感信息处理

- 密码存在DBCON表里是加密的，这个没问题

- 不要在代码里硬编码密码

- 日志里不要打印敏感数据（比如身份证号、密码等）

---

## 七、结语

ADBC这套技术，说难也不难——核心就是"连接→执行→处理结果"三步走，和各种语言的数据库API思路一致。说简单也不简单——环境配置、SQL差异、事务控制、异常处理，每一步都有坑。

总结一下本文的核心要点：

1. **配置三步**：DBCO配连接信息 → Basis装Oracle驱动 → DBACOCKPIT测试连通性

2. **查询三步**：get_connection → execute_query → set_param_table + next_package

3. **写入三步**：execute_update → commit → close（异常时rollback）

4. **安全第一**：参数化查询防注入，最小权限原则

5. **资源管理**：连接和结果集用完一定要关

ADBC是SAP开发者工具箱里一件很实用的武器。用好了，很多外围系统集成的问题都能迎刃而解。但也要记住：**直连数据库是一把双刃剑**，简单高效的同时，也意味着更强的耦合和更大的安全责任。用在合适的场景，它就是利器；用在不合适的场景，它就是坑。

希望这篇文章能帮你少踩一些坑，更快上手ADBC开发。