企业官网建设流程全解析

1. AMDP 开发环境搭建与 AI 辅助工具接入

SAP AMDP（ABAP Managed Database Procedures）是 ABAP 层管理 HANA 数据库存储过程的一套机制，允许开发者在 ADT（ABAP Development Tools）里用 SQLScript 编写数据库过程，由 ABAP 类统一管理生命周期。它适合谁？适合已经在做 SAP HANA 项目、需要在数据库层直接跑应用逻辑的 ABAP 开发者，尤其是那些发现 CDS View 表达力不够、又不想脱离 ABAP 传输体系去单独维护 HANA 存储过程的人。

我试过在纯 SAP GUI 里翻 AMDP 源码，只能只读浏览，改不了。真正写代码必须用 ADT（Eclipse 插件）。而 ADT 本身没有 AI 补全，写 SQLScript 时经常要来回查函数名、查$ABAP.type()的写法。所以这篇除了讲 AMDP 语法实例，还会给出一套本地 AI 辅助开发工具的配置骨架——用统一的 Key/API 通道把代码补全接进你的编辑器，让写 AMDP 时少翻文档。

核心检索词先明确：AMDP 语法实例、AMDP 数据库存储过程、SAP HANA SQLScript。下面从环境准备开始，一步步给出可复制的配置和可运行的 AMDP 代码。

1.1 前置条件清单

在动手之前，确认这几项：

• SAP NetWeaver 7.40 SP08 以上，底层是 HANA 数据库（HDB）。
• 安装好 ADT，版本建议 3.20 以上，能连到你的 ABAP 项目。
• 有一个可传输的开发包（Package），比如ZAMDP_DEMO。
• 本地装了 VS Code 或 Cursor 之类的编辑器，用来接 AI 补全。

AMDP 类只能在 ADT 里开发，SAP GUI 里用SE24打开只能看，不能编辑。这一点先记住，后面排障会用到。

1.2 为什么要在本地接 AI 辅助

写 AMDP 的痛点很集中：SQLScript 的函数名和 ABAP 不一样，DECLARE的类型引用要用"$ABAP.type( ... )"这种字符串写法，游标循环的语法也和普通 ABAP 不同。每次写都要查，效率低。把 AI 补全接进编辑器后，你可以在写DECLARE CURSOR或record_count()时直接得到提示，减少上下文切换。

接入方式是用一个统一的 API 通道，把模型能力接到编辑器的补全插件里。下面给出配置骨架。

2. TaoToken 前置准备与统一 Key 通道

TaoToken 在这里的角色是一个统一的模型 API 通道：你申请一个 Key，就能在本地编辑器、命令行工具里调用模型做代码补全和问答，不用为每个工具单独配一套凭证。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api 。

2.1 申请 Key 与确认模型 ID

登录后进控制台创建 API Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。创建完复制那串 Key，只显示一次。模型 ID 在文档里能查到，常用的编码模型直接填对应 ID 即可，文档地址 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

三个要素记牢，后面所有配置都围绕它们：

• Base URL：https://taotoken.net/api
• API Key：你创建的那串
• Model ID：文档里对应的模型标识

2.2 验证 Key 是否可用

在正式写配置前，先用一条命令确认 Key 通。打开终端：

curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 你的KEY" \ -d '{ "model": "你的模型ID", "messages": [{"role": "user", "content": "用一句话说明AMDP是什么"}] }'

返回里如果choices数组有内容，说明通道正常。如果返回 401，先检查 Key 有没有复制全、有没有多余空格。这一步过了再往下配编辑器，能省很多排查时间。

3. 可复制配置骨架：settings.json 与 config.toml

这一节给两份可直接复制的配置。VS Code 系（含 Cursor）用settings.json，命令行编码工具用config.toml。两份都遵循同一套 Base URL + Key + Model ID 三件套。

3.1 VS Code / Cursor 的 settings.json

如果你用的是支持 OpenAI 兼容接口的补全插件，在用户设置里加这段。路径：Ctrl+Shift+P→ 输入Open Settings (JSON)→ 在打开的settings.json里追加：

{ "aiAssistant.provider": "openai-compatible", "aiAssistant.baseUrl": "https://taotoken.net/api", "aiAssistant.apiKey": "你的KEY", "aiAssistant.model": "你的模型ID", "aiAssistant.completion.enable": true, "aiAssistant.completion.languageOverrides": { "abap": true, "sql": true } }

注意baseUrl结尾不要带/v1，插件一般会自己拼。languageOverrides里把abap和sql打开，写 AMDP 时补全才会触发。

3.2 命令行工具的 config.toml

如果你用命令行编码助手，配置放在~/.config/你的工具/config.toml（Windows 在%USERPROFILE%\.config\下）：

[provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key = "你的KEY" model = "你的模型ID" [completion] enabled = true max_tokens = 2048 temperature = 0.2 [context] include_extensions = ["abap", "sql", "cds"]

temperature设低一点，代码补全要的是稳定不是发散。include_extensions把.abap、.sql、.cds都纳入上下文，写 AMDP 时模型能看到你项目里的相关文件。

3.3 配置生效验证

改完配置重启编辑器。新建一个.abap文件，敲DECLARE CURSOR，看有没有补全弹出。如果没有，先看插件日志里请求有没有发出去，再对照第 5 节的报错排查。

4. AMDP 语法实例与调用验证

配置就绪后，进入正题。AMDP 的本质是一个实现了标记接口if_amdp_marker_hdb的 ABAP 类，方法上用特定关键字修饰，方法体里写 SQLScript。

4.1 定义 AMDP 类骨架

在 ADT 里新建 ABAP 类ZCL_AMDP_DEMO，定义部分：

CLASS zcl_amdp_demo DEFINITION PUBLIC FINAL CREATE PUBLIC. PUBLIC SECTION. INTERFACES if_amdp_marker_hdb. CLASS-METHODS get_flydatas FOR TABLE FUNCTION ztest_tablef. PROTECTED SECTION. PRIVATE SECTION. ENDCLASS.

if_amdp_marker_hdb是标记接口，实现它才表明这是 AMDP 类。FOR TABLE FUNCTION说明这个方法对应一个 CDS 表函数。

4.2 实现方法体：变量声明与游标循环

实现部分，方法用BY DATABASE FUNCTION FOR HDB LANGUAGE SQLSCRIPT修饰：

CLASS zcl_amdp_demo IMPLEMENTATION. METHOD get_flydatas BY DATABASE FUNCTION FOR HDB LANGUAGE SQLSCRIPT OPTIONS READ-ONLY USING spfli. DECLARE lv_index INT; DECLARE lt_return TABLE ( MANDT "$ABAP.TYPE( MANDT )", CARRID "$ABAP.TYPE( s_carr_id )", CONNID "$ABAP.TYPE( s_conn_id )" ); DECLARE CURSOR lt_spfli FOR ( SELECT * FROM spfli ); lv_index := 1; FOR ls_spfli AS lt_spfli DO lt_return.mandt [:lv_index] := :ls_spfli.mandt; lt_return.carrid[:lv_index] := :ls_spfli.carrid; lt_return.connid[:lv_index] := :ls_spfli.connid; lv_index := :lv_index + 1; END FOR; RETURN SELECT mandt, carrid, connid FROM :lt_return; ENDMETHOD. ENDCLASS.

几个关键点：变量用DECLARE，类型引用用"$ABAP.type( ... )"字符串形式；赋值用:=；游标用DECLARE CURSOR ... FOR ( SELECT ... )；循环用FOR ... DO ... END FOR；内表按角标赋值lt_return.mandt[:lv_index]。

4.3 条件判断与常用函数

条件判断和普通 ABAP 类似：

IF lv_index = 1 THEN -- 处理第一行 ELSEIF lv_index = 2 THEN -- 处理第二行 ELSE -- 其他 END IF;

常用函数记几个：record_count( :lt_table )算行数，MOD( :lv_line, 2 )取余，CURRENT_DATE/CURRENT_TIME取当前日期时间，DAYS_BETWEEN( d1, d2 )算天数差，HOUR()/MINUTE()/SECOND()从时间取值。

4.4 定义 CDS 表函数并调用

新建 CDS 表函数ZTEST_TABLEF：

@EndUserText.label: 'TEST TABLE FUNCTION' define table function ZTEST_TABLEF returns { key mandt : abap.clnt; key carrid : s_carr_id; key connid : s_conn_id; } implemented by method zcl_amdp_demo=>get_flydatas;

然后在 ADT 里用Data Preview打开这个表函数，或者写一段 ABAP 调用：

SELECT * FROM ztest_tablef INTO TABLE @DATA(lt_result). cl_demo_output=>display( lt_result ).

跑通后能看到SPFLI表里的航班数据被游标处理后返回。这一步成功，说明 AMDP 从定义到调用整条链路通了。

5. 常见报错排查

写 AMDP 和配 AI 通道时，报错集中在几个地方。下面按真实报错对照排查。

5.1 401 Unauthorized

请求返回 401，说明 Key 没被接受。检查三处：Key 有没有复制完整、Authorization头是不是Bearer 你的KEY格式、Base URL 有没有写错。如果 Key 里带了换行或空格，也会 401。重新在控制台复制一次，粘贴时注意别带首尾空白。

5.2 local proxy failed

编辑器插件报local proxy failed，通常是本地代理端口没起来，或者baseUrl填成了带/v1的地址导致拼接重复。把baseUrl改回https://taotoken.net/api，重启插件。如果还不行，看插件日志里实际请求的 URL 是什么，多半是路径拼错了。

5.3 reading choices 报错

返回体解析时报reading choices相关错误，一般是响应结构和你用的插件预期不一致。先确认请求里model字段填的是文档里存在的模型 ID，不是随便写的名字。模型 ID 错了，返回体里没有choices，插件解析就崩。对照文档核对模型 ID。

5.4 OAuth 相关报错

如果插件走的是 OAuth 流程而不是 API Key，报 OAuth 错误说明认证方式选错了。在插件设置里把认证方式切成 API Key，填 Base URL + Key + Model ID 三件套。OAuth 那套不适用于这种直连 API 的场景。

5.5 AMDP 侧常见错误

METHOD ... is not an AMDP method：检查类有没有实现if_amdp_marker_hdb，方法有没有加BY DATABASE ...修饰。

Table SPFLI is not used：USING后面没声明用到的表。AMDP 方法里访问的表必须在USING里列出。

Syntax error in SQLScript：多半是$ABAP.type()的引号写错，或者变量引用忘了加冒号:lv_var。SQLScript 里引用 ABAP 变量要加冒号。

6. 继续深入的方向

AMDP 的BY DATABASE PROCEDURE和BY DATABASE FUNCTION两种模式用途不同：前者标记为存储过程，可以写更复杂的逻辑；后者标记为表函数，主要给 CDS 消费。方法嵌套调用时，被调用的 AMDP 方法也要在USING里声明，方法名大写。

如果你要把这套 AI 辅助长期用在日常编码里，可以考虑 Coding Plan，地址 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，适合需要持续补全和 Agent 辅助的场景。只想先验证模型对话效果，用模型对话入口 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 试几句。Key 管理和接入文档分别在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 和 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

最后给个实操建议：AMDP 调试时，先在 ADT 里用Data Preview单独跑表函数，确认 SQLScript 逻辑对了，再接到 ABAP 程序里调用。这样出错时能快速定位是 SQLScript 的问题还是 ABAP 调用的问题。写游标循环时，lv_index的初始化和自增别漏，漏了会死循环或者只处理一行。