查询实施类型

ABAP RESTful 应用程序编程模型 › 学习 › 查询 › 查询实施类型

托管查询

查询的缺省案例是被管理实施类型。在这种情况下,RAP 运行时引擎管理对数据库的数据访问。考虑由 OData 查询选项($orderby、$top、$skip…)生成的查询功能,以及从附加访问控制派生的可能权限。该框架为查询创建一个 SQL 语句,该语句基于 CDS 源代码中的定义、查询功能和权限执行。对于托管查询的运行时,应用程序开发人员不必进行任何实施。在设计时期间,应用程序开发任务仅限于定义数据模型和相关访问控制。

下图说明了查询的运行时。

托管查询 - 运行时

示例

具有查询选项 $filter 的 OData 请求到达 OData 服务。转换为 ABAP 可使用对象后,RAP 运行时引擎会触发要执行的查询。然后,查询框架创建 SQL 语句以从数据库中选择所需数据。在这种情况下,查询框架使用 where 子句扩展 SQL 语句,以仅选择与过滤条件匹配的数据集。在这种情况下,涉及访问控制,查询框架还会评估涉及的权限。

有关详细运行时图,请参阅查询运行时。

非托管查询

当查询框架的标准 SQL 下推不足或根本不可用时,将使用查询的非托管实施类型。

非托管查询的用例是

  • OData 请求的数据源不是数据库表,而是 OData 客户端代理访问的另一个 OData 服务,

  • 通过应用程序特定处理优化性能,

  • 将 AMDP 与 SQL 脚本实施中的某些查询下推参数结合使用,

  • 将呼叫转接到分析引擎,或

  • 增强属性或行级别的查询结果数据,例如,拆分中间总和的行或压缩过滤结果时。

非托管查询与协议无关。这意味着,与托管查询一样,可将其重用于多个场景。

下图说明了非托管查询的运行时。

非托管查询 - 运行时

非托管查询的数据模型可以在 CDS 自定义实体中定义。自定义实体定义查询返回的数据的结构。此操作使用 CDS 数据定义 (DDLS) 中的 CDS 语法完成。CDS 自定义实体没有从数据库选择数据的 SQL 视图。相反,自定义实体指定实施查询的 ABAP 类。实体注释 @ObjectModel.query.implementedBy: 'ABAP:...' 用于引用 CDS 自定义实体的数据定义中的查询实施类。在执行非托管查询时评估此注释,从而调用查询实施类以执行查询。对于 CDS 自定义实体上的每个查询请求,都会重新实例化实施类。从不会缓存类实例。

由于没有为自定义实体生成 SQL 部件且查询在 ABAP 中实施,因此自定义实体无法在 ABAP SQL 或数据定义中的 SQL 连接中使用。

有关 CDS 自定义实体语法的详细信息,请参阅 CDS DDL - DEFINE CUSTOM ENTITY(ABAP 关键字文档)

CDS 自定义实体可以具有参数、元素和关联。与在 CDS 视图中一样,它列出了数据模型中使用的元素。对于每个元素,必须指定数据类型,因为它无法从基础数据库表示中检索。

自定义实体可以是使用 root 和 composition 关系的业务对象中的实体,例如根、父实体或子实体。自定义实体也可以用作关联定义中的目标,并将关联定义为源。

无法在 ABAP SQL SELECT 执行中使用自定义实体,因为它们没有数据库表示。特别是,无法在源 CDS 实体的元素列表中使用关联自定义实体的元素。

非托管查询在 ABAP 类中实施。查询实施类实施预定义的 ABAP 接口 (IF_RAP_QUERY_PROVIDER),以确保启用所需的基本 OData 支持。接口 具有 select 方法,用于导入请求数据的接口实例和响应数据的接口实例。

需要在查询实施类中手动实施访问控制,以确保仅返回用户有权访问的记录。您不能将访问控制对象用于自定义实体。

与托管查询相反,应用程序开发人员必须注意查询实施类中每个受支持的查询选项,包括查询实施类中也实施的可能权限。

示例

有关如何使用 CDS 自定义实体并在查询实施类中使用接口 IF_RAP_QUERY_PROVIDER 实施非托管查询的示例在实施非托管查询中提供。

有关接口 IF_RAP_QUERY_PROVIDER 的详细信息,请参阅非托管查询 API。

备注

自定义实体无法在 CDS 映射视图中投影。

有关详细运行时图,请参阅查询运行时。

来源:SAP Help Portal · 2025 FPS02 (Oct 2026) · 中文为 SAP 官方机器翻译

← 查询 · 查询运行时 →