## 一、`PK` 字段是什么

Backoffice 中 `Administration` 区域的 `Metadata` 部分显示的 `PK`，是 `Primary Key` 的缩写，也就是 SAP Commerce Cloud 持久化层为每一个 `Item` 分配的**内部技术主键**。

例如：

```text
8796355887147
```

它不是购物车编号、订单编号、用户可见编号，也不是匿名购物车的 `GUID`。它表示：

> 当前 SAP Commerce 数据库中，这一条 `Cart` 持久化对象的内部唯一身份。

SAP Commerce 的所有持久化业务对象最终都属于 `Item` 类型体系。模型层对象继承 `AbstractItemModel.getPk()`，因此 `CartModel`、`ProductModel`、`CustomerModel`、`OrderModel`、`AddressModel` 等对象都会拥有一个 `PK`。SAP 官方文档也说明，`PK` 属性由 Commerce 持久化引擎在创建数据项时添加。([SAP Help Portal][1])

可以把它类比为普通关系型数据库中的自增主键：

```text
Cart 表中的一行数据
        ↓
PK = 8796355887147
```

但 SAP Commerce 的 `PK` 比普通的自增整数稍微复杂，因为它并非纯粹的业务流水号，其中还包含与类型有关的信息。

---

## 二、你看到的 `8796355887147` 具体表示什么

SAP Commerce 在 Java 层使用下面这个类表示主键：

```java
de.hybris.platform.core.PK
```

Backoffice 将该对象转换成十进制字符串，所以你看到的是：

```text
8796355887147
```

它本质上可以存储为一个 Java `long` 值。`PK` 类提供了以下方法：

```java
PK.parse(...)
PK.fromLong(...)
getLongValue()
getHex()
getTypeCode()
getCounter()
isCounterBased()
```

也就是说，这个十进制字符串可以重新解析为一个 `PK` 对象，而不是一个普通的业务字符串。([SAP Help Portal][2])

将这个数值转成十六进制，大致为：

```text
8796355887147
    ↓
0x8000FAB002B
```

当前 SAP Commerce 默认采用的是 `counter-based PK`。官方说明，`counter-based PK` 是默认方案，而旧的 `UUID-based PK` 已被弃用。生成 `counter-based PK` 时，平台会使用 `NumberSeries` 取得序列值。([SAP Help Portal][3])

对于这个例子，使用 `PK` API 解析时，可以检查：

```java
PK pk = PK.parse("8796355887147");

pk.isCounterBased();
pk.getTypeCode();
pk.getCounter();
```

这个 `PK` 的类型部分应当对应：

```text
typeCode = 43
```

而 SAP Commerce 核心类型定义中，`Cart` 的部署定义正是：

```xml
<itemtype code="Cart"
          extends="AbstractOrder"
          autocreate="true"
          generate="true">
    <deployment table="Carts" typecode="43"/>
</itemtype>
```

因此，你看到的数值与一个 `Cart` 类型对象是吻合的。SAP 官方文档明确指出，`deployment` 中定义的 `typecode` 会成为 `PK` 的组成部分；标准 `Cart` 类型的 `typecode` 是 `43`。([SAP Help Portal][4])

不过要注意：

> 不应该依靠手工位运算来编写业务逻辑，应该调用 `PK.getTypeCode()`、`PK.isCounterBased()` 等官方 API。

PK 的内部编码属于平台持久化实现细节，将来存在调整的可能。

---

## 三、`PK` 有什么作用

### 1. 唯一识别数据库中的一个对象

最核心的作用是区分不同的持久化对象。

例如，两个购物车即使在某些业务字段上相同：

```text
Cart A:
    user = anonymous
    currency = USD
    site = electronics

Cart B:
    user = anonymous
    currency = USD
    site = electronics
```

它们仍然拥有不同的 `PK`：

```text
Cart A PK = 8796355887147
Cart B PK = 8796355952683
```

在模型层，`AbstractItemModel.equals()` 和 `hashCode()` 的实现也以 `PK` 为基础。换句话说，两个已经持久化的 `ItemModel` 是否代表同一个数据库对象，最终主要由 `PK` 判断。([SAP Help Portal][5])

---

### 2. 作为数据库关系中的引用值

SAP Commerce 类型系统中的关系最终需要在数据库中保存。

例如：

```text
Cart
 ├─ user        → User
 ├─ currency    → Currency
 ├─ deliveryAddress → Address
 └─ entries     → CartEntry
```

这些对象之间的关联在底层通常通过相关对象的 `PK` 建立。

例如，一个购物车条目需要知道自己属于哪个购物车。从模型层看是：

```java
cartEntry.getOrder()
```

在持久化层，相关引用最终会对应购物车的 `PK`。

因此，`PK` 不仅用于定位当前对象，也被大量用于：

```text
一对一关系
一对多关系
多对多关系
外键式引用
缓存键
事件中的对象标识
```

SAP 官方 API 中大量查询、缓存、索引和事件接口都直接接受 `PK`。([SAP Help Portal][6])

---

### 3. 通过 `ModelService` 直接加载对象

如果已经知道一个对象的 `PK`，可以使用 `ModelService` 直接加载对应模型：

```java
PK pk = PK.parse("8796355887147");

CartModel cart = modelService.get(pk);
```

`ModelService.get(PK)` 会根据 `PK` 中包含的类型信息解析目标模型类型，然后返回相应的模型对象。([SAP Help Portal][7])

例如：

```java
PK pk = PK.parse("8796355887147");

CartModel cart = modelService.get(pk);

System.out.println(cart.getCode());
System.out.println(cart.getGuid());
System.out.println(cart.getUser());
System.out.println(cart.getEntries());
```

这对于后台排查非常有用，例如：

```text
已知日志中的 Cart PK
        ↓
通过 ModelService 加载 CartModel
        ↓
检查 user、entries、site、store、guid
```

---

### 4. 用于 `FlexibleSearch` 精确查询

在 `HAC → Console → FlexibleSearch` 中，可以直接通过这个 `PK` 查询购物车：

```sql
SELECT
    {c.pk},
    {c.code},
    {c.guid},
    {c.user},
    {c.site},
    {c.creationtime},
    {c.modifiedtime}
FROM
    {Cart AS c}
WHERE
    {c.pk} = 8796355887147
```

也可以只查询模型：

```sql
SELECT {c.pk}
FROM {Cart AS c}
WHERE {c.pk} = 8796355887147
```

SAP 官方文档将通过主键查询作为 `FlexibleSearch` 的基础用法之一，因为已知 `PK` 时，平台可以非常直接地定位记录。([SAP Help Portal][3])

如果查询不到，常见原因包括：

```text
对象已经被删除；
查询的是另一个环境；
查询的是另一个 tenant；
数据库已经重新初始化；
数据迁移后重新生成了 PK；
当前用户的 FlexibleSearch restriction 限制了结果。
```

---

## 四、`PK` 与 `code`、`GUID` 有什么区别

对于购物车，经常会同时看到三个容易混淆的字段：

| 字段     | 主要含义        | 典型使用位置                 |
| ------ | ----------- | ---------------------- |
| `PK`   | 平台内部技术主键    | 数据库、模型层、缓存、关系、后台排查     |
| `code` | 购物车业务或服务层标识 | Cart Service、业务逻辑、日志   |
| `GUID` | 匿名购物车查找标识   | Storefront、OCC、匿名购物车恢复 |

### `PK`

示例：

```text
8796355887147
```

特点是：

```text
平台自动生成；
用于持久化；
通常不可修改；
与当前数据库环境绑定；
不适合作为跨环境业务标识。
```

---

### `code`

示例可能是：

```text
00001025
```

或者由自定义购物车编号生成器产生。

它通常更接近服务层或业务层使用的购物车标识，但它仍然不一定适合直接暴露给匿名用户。

---

### `GUID`

示例：

```text
4ba587d9-b428-4921-97b3-da4cdd53f462
```

SAP 官方对 `AbstractOrder.guid` 的说明是：

> 用于查找匿名购物车的 `GUID`。

因此，在 Composable Storefront 或 OCC 匿名购物车场景中，你通常看到的是 `GUID`，而不是数据库 `PK`。([SAP Help Portal][8])

可以理解为：

```text
浏览器 / OCC
    使用 GUID 找匿名购物车
             ↓
Commerce Service Layer
    找到 CartModel
             ↓
Persistence Layer
    通过 PK 识别真正的数据库对象
```

---

## 五、为什么 Backoffice 要把 `PK` 放在 `Metadata` 区域

`PK` 不是普通业务人员维护的购物车属性，而是平台技术元数据，因此 Backoffice 将它放在：

```text
Administration
    └─ Metadata
         ├─ PK
         ├─ Creation Time
         ├─ Modified Time
         ├─ Item Type
         └─ Owner
```

Backoffice 的 Editor Area 用来展示业务对象的属性、元数据和管理信息。`PK` 来自所有持久化模型共同继承的 `ItemModel` 元数据，而不是 `Cart` 自己定义的普通可编辑业务字段。([SAP Help Portal][9])

它主要服务于：

```text
技术支持人员；
开发人员；
系统管理员；
数据迁移人员；
问题排查人员；
SAP Commerce 持久化框架。
```

正常情况下不需要也不能在 Backoffice 中修改它。

---

## 六、不能通过 `PK` 推断购物车创建时间

这是一个很容易踩坑的地方。

旧的 `UUID-based PK` 可以携带时间成分，但现在默认使用的是 `counter-based PK`。官方说明：

```text
UUID-based PK：
    getCreationTime() 返回创建时间

counter-based PK：
    getCreationTime() 返回的实际上是 counter 值
```

因此，不要把下面的结果当作真实时间戳：

```java
pk.getCreationTime()
```

对于当前默认的 `counter-based PK`，要查看购物车真实创建时间，应读取：

```java
cart.getCreationtime()
```

或者查询：

```sql
SELECT {c.creationtime}
FROM {Cart AS c}
WHERE {c.pk} = 8796355887147
```

SAP 官方 `PK` API 明确说明，`getCreationTime()` 对 `counter-based PK` 返回的是计数器值，而不是实际创建日期。([SAP Help Portal][2])

---

## 七、可以在 HAC 中这样检查这个 `PK`

在 `HAC → Console → Scripting Languages → Groovy` 中，可以执行类似代码：

```groovy
import de.hybris.platform.core.PK

def pkValue = "8796355887147"
def pk = PK.parse(pkValue)

println "Decimal PK    : ${pk.longValue}"
println "Hex PK        : ${pk.hex}"
println "Type Code     : ${pk.typeCode}"
println "Counter Based : ${pk.counterBased}"
println "Counter       : ${pk.counter}"

def modelService = spring.getBean("modelService")
def item = modelService.get(pk)

println "Item Type     : ${item.itemtype}"
println "Model Class   : ${item.class.name}"

if (item.metaClass.hasProperty(item, "code")) {
    println "Code          : ${item.code}"
}

if (item.metaClass.hasProperty(item, "guid")) {
    println "GUID          : ${item.guid}"
}

println "Creation Time : ${item.creationtime}"
println "Modified Time : ${item.modifiedtime}"
```

对你这个购物车，预期关键结果类似：

```text
Decimal PK    : 8796355887147
Hex PK        : 8000fab002b
Type Code     : 43
Counter Based : true
Item Type     : Cart
```

具体的 `code`、`GUID`、用户、站点和时间，只能在你的 Commerce 环境中查询得到，单独凭这个数字无法在外部还原完整购物车内容。

---

## 八、不要把 `PK` 当成跨环境稳定标识

假设同一个购物车数据经过以下过程：

```text
开发环境导出
    ↓
测试环境导入
    ↓
生产环境重新创建
```

三个环境中的业务内容可能相同，但 `PK` 通常不同：

```text
DEV  PK  = 8796355887147
TEST PK  = 8796422996011
PROD PK  = 8796557213739
```

因此不建议在外部系统中长期保存 Commerce `PK` 作为业务集成键。

跨系统或跨环境集成更适合使用：

```text
Cart code
Order code
Product code
Customer UID
GUID
外部系统 ID
组合唯一属性
```

SAP 官方关于数据导入导出的文档也指出，在重新导入等场景中，需要使用 `code` 或其他唯一属性引用对象，而不能假定原有 `PK` 始终有效。([SAP Help Portal][10])

---

## 总结

你看到的：

```text
PK = 8796355887147
```

表示的是：

> SAP Commerce 持久化层中，这个 `Cart` 对象的内部技术主键。

它的主要作用包括：

1. 唯一识别当前数据库中的购物车对象。
2. 作为数据库关系和对象引用的基础。
3. 支持 `ModelService` 按主键加载模型。
4. 支持 `FlexibleSearch` 精确查询。
5. 作为缓存、事件、索引和持久化操作中的对象标识。
6. 在日志和 Backoffice 中辅助开发与故障排查。

该值中的类型信息与标准 `Cart` 的 `typecode = 43` 相符，但它不是购物车 `code`，也不是匿名购物车 `GUID`。在 Composable Storefront 匿名购物车场景中，前端通常使用 `GUID`；进入 SAP Commerce 持久化层后，系统最终依靠 `PK` 识别具体的 `CartModel`。

[1]: https://help.sap.com/docs/SAP_COMMERCE/3fb5dcdfe37f40edbac7098ed40442c0/a24c18f60d7c42fda6e33c65009b1920.html?utm_source=chatgpt.com "ImpEx"
[2]: https://help.sap.com/doc/9fef7037b3304324b8891e84f19f2bf3/2205/en-US/de/hybris/platform/core/PK.html?utm_source=chatgpt.com "PK (hybris Commerce Suite 2205)"
[3]: https://help.sap.com/docs/SAP_COMMERCE/d0224eca81e249cb821f2cdf45a82ace/8c2d4abd866910149207b2f33deaf652.html?utm_source=chatgpt.com "Primary Keys | SAP Help Portal"
[4]: https://help.sap.com/docs/SAP_COMMERCE/129a68efcdaf43dc94243b57f9aba5ad/8ecae959b9bd46b8b426fa8dbde5cac4.html?utm_source=chatgpt.com "Define Data Types - SAP Commerce"
[5]: https://help.sap.com/doc/9fef7037b3304324b8891e84f19f2bf3/2011/en-US/de/hybris/platform/servicelayer/model/AbstractItemModel.html?utm_source=chatgpt.com "AbstractItemModel (hybris Commerce Suite 2011)"
[6]: https://help.sap.com/doc/789b8a6e1434444da824c2493c6faaa0/2211.4/en-US/de/hybris/platform/core/class-use/PK.html?utm_source=chatgpt.com "Uses of Class de.hybris.platform.core.PK"
[7]: https://help.sap.com/doc/9fef7037b3304324b8891e84f19f2bf3/2205/en-US/de/hybris/platform/servicelayer/model/ModelService.html?utm_source=chatgpt.com "ModelService (hybris Commerce Suite 2205)"
[8]: https://help.sap.com/doc/21aab51c2b0e4b1aa720882eec30938c/2205/en-US/de/hybris/platform/core/model/order/AbstractOrderModel.html?utm_source=chatgpt.com "AbstractOrderModel (hybris Commerce Suite 2105.10)"
[9]: https://help.sap.com/docs/SAP_COMMERCE/5c9ea0c629214e42b727bf08800d8dfa/8bb7ed5b8669101487f2a7bc6b015366.html?utm_source=chatgpt.com "Editor Area Widget"
[10]: https://help.sap.com/docs/SAP_COMMERCE/d0224eca81e249cb821f2cdf45a82ace/31ffc3dd858d47209614a97fd084d12d.html?utm_source=chatgpt.com "Modifying Export Headers"


Backoffice 中 Administration 区域的 Metadata 部分显示的 PK，是 Primary Key 的缩写，也就是 SAP Commerce Cloud 持久化层为每一个 Item 分配的内部技术主键。

什么是 Commerce Cloud Back-Office 的 pk 字段

紫薇堂堂主

编程语言

SAP Commerce Cloud中PK字段是持久化层为每个Item分配的内部技术主键，用于唯一标识数据库对象。PK不同于业务编号或GUID，包含类型信息，支持对象加载、关系引用和精确查询。了解PK的作用有助于开发调试，但不建议作为跨环境业务标识。

关系型数据库

数据迁移

代码解释

数据库

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

什么是 Commerce Cloud Back-Office 的 pk 字段-腾讯云开发者社区-腾讯云

什么是 Commerce Cloud Back-Office 的 pk 字段

什么是 Commerce Cloud Back-Office 的 pk 字段

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐