SDK 概述及其在 DSPM 中的作用
说实话，我见过不少团队在对接数据安全平台时，第一反应就是“用 API 吧”。但真正做起来，往往会发现 REST API 在某些场景下根本跑不通。这时候你才意识到——SDK 才是那把对口的钥匙。
这一章我们聊聊 SDK 的定位，它和 REST API 到底差在哪，以及什么时候该用它。
SDK 的定位：不只是一个库
我习惯把 SDK 理解成一个“嵌入式安全探针”。它不是远程调一个接口，而是把 DSPM 的核心能力——比如数据分类、敏感信息扫描、资产指纹采集——直接注入到你的应用进程里。
举个例子。你有一个 Java 写的微服务，需要实时检测用户上传文件里是否包含身份证号。如果用 REST API，你得把文件先发到远程 DSPM 平台，等它返回结果，再决定是否拦截。延迟、带宽、隐私都是问题。而换成 SDK，你直接在本地调用一个 detectSensitiveData(file) 方法，毫秒级出结果。
为什么会这样？因为 SDK 把 DSPM 的“脑子”装到了你的应用里。它和你的代码运行在同一个 JVM 里，共享同一份内存和数据上下文。
SDK vs REST API：一张表说明白
很多同学问我：“老师，到底选 SDK 还是 API？”我的回答是——看场景。下面这张表比较了六个关键维度，你一看就懂了。
| 对比维度 | SDK | REST API |
|---|---|---|
| 部署位置 | 嵌入应用进程内部 | 独立服务，远程调用 |
| 执行模式 | 本地同步，函数级调用 | 网络请求，异步响应 |
| 延迟 | 毫秒级（无网络开销） | 几十到几百毫秒（含网络） |
| 数据是否出域 | 数据不出进程 | 数据需通过网络传输 |
| 维护成本 | 需更新 SDK 版本、关注兼容性 | 只需保证网络连通，版本由服务端控制 |
| 灵活性 | 可定制规则、集成复杂业务逻辑 | 仅支持预设的端点接口 |
适用场景：什么时候非 SDK 不可？
不是所有场景都需要 SDK。但下面三种情况，我建议你直接放弃 REST API，拥抱 SDK。
1. 实时数据扫描——毫秒级拦截
比如 IM 消息的敏感词过滤、文件上传时的内容审计。这些场景对延迟敏感，一旦超过 50ms，用户体验就会明显下降。REST API 至少要经过序列化、传输、服务端处理、反序列化，哪怕用内网专线，也很难做到稳定 5ms 以内。SDK 把检测逻辑塞进应用进程里，零拷贝。
我记得有一次做企业网盘审批系统，用户上传一个 10MB 的 Excel，如果用 REST API 传输加上扫描，平均 800ms。换成 SDK 后，在本地解析文件 + 扫描，稳定在 120ms。老板当场拍板：“以后都走 SDK。”
2. 数据主权合规——数据不能出域
这个不用多说。GDPR、《数据安全法》、《个人信息保护法》都对数据跨境和出域有严格要求。如果你的应用部署在客户内网，或者处理的是用户隐私数据，把数据通过 REST API 发到云端 DSPM 平台，本身就是违规行为。
3. 离线或弱网环境——没有网络也能用
有些业务场景，比如工业边缘计算、车载系统、医疗设备终端，网络不一定总在。你总不能为了查一段数据，先保证 4G 稳定吧？SDK 可以把 DSPM 的检测模型打包下发给终端设备，离线依然能运行。扫描结果暂存本地，等网络恢复时再同步到 DSPM 平台。
看看这个流程图，你就明白 SDK 在整个 DSPM 数据采集链里扮演什么角色了。
SDK 的典型集成模式
讲完场景，我再说说实际开发中 SDK 是怎么集成进来的。说白了就两种模式：
- 同步阻塞模式：主调线程直接调用 SDK 方法，等到检测结果回来再继续。适合对实时性要求极高、数据量不大的场景，比如逐条判断消息是否违规。
- 异步回调/观察者模式：SDK 内部维护一个扫描队列，调用后立即返回 Future 或回调。适合批量扫描、大文件处理，避免阻塞主业务流程。
我呢，在项目里一般会封装一个统一的 SDK 适配层，把初始化、回收、结果上报统一管理。这样即使后续更换 DSPM 厂商，改动也很小。
thread-safety 说明，或者在沙箱环境压测一下。
SDK 与 DSPM 平台的协作流程
最后梳理一下完整的协作链路。你可以用下面这段伪代码感受一下：
// 1. 初始化 SDK（加载模型、连接配置）
DspmSdk.init("config.json");
// 2. 针对每个数据资产（文件、表、消息）
DataAsset asset = ...;
ScanResult result = DspmSdk.classify(asset);
// 3. 处理结果（标记敏感等级、记录审计）
if (result.containsSensitive()) {
alert();
logToLocalCache(result);
}
// 4. 批量同步到 DSPM 平台（定时或触发）
DspmSdk.syncResults("https://dspm.company.com/api/v1/assets");注意最后一步 syncResults 是可选的——如果你的业务不允许任何数据外传，甚至可以把同步关闭，只在运维窗口离线导出。SDK 的本地缓存机制给了你很大的灵活性。