---
title: PushKvCache
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/llmdatadistdev/llmcrv1_42_15.html
sourcePath: /source/zh/canncommercial/900/others/llmdatadistdev/llmcrv1_42_15.html
indexId: e027a88a423465eefd6195feca40cef3a2b263035974d976787c8e1469fd1e5d70
---
# PushKvCache

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | x |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | x |
| Atlas 推理系列产品 | x |
| Atlas 训练系列产品 | x |


说明：针对 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，仅支持Atlas 800I A2 推理服务器、A200I A2 Box 异构组件。


#### 函数功能

推送Cache到远端节点，仅当角色为Prompt时可调用。


#### 函数原型

```
Status PushKvCache(const Cache &src_cache,
                   const CacheIndex &dst_cache_index,
                   uint32_t src_batch_index = 0U,
                   int64_t size = -1,
                   const KvCacheExtParam &ext_param = {});
```


#### 参数说明

| 参数名称 | 输入/输出 | 取值说明 |
| --- | --- | --- |
| src\_cache | 输入 | 本地源Cache。 |
| dst\_cache\_index | 输入 | 远端目的Cache的索引。 |
| src\_batch\_index | 输入 | 本地源batch的下标。 |
| size | 输入 | 当前只支持默认值\-1。 |
| ext\_param | 输入 | 当前支持ext\_param中src\_layer\_range的second与first的差值和dst\_layer\_range的second与first的差值一致。src\_layer\_range和dst\_layer\_range的first和second默认值都是\-1，表示全部的层。取值范围都是[0, 最大可用层索引]，且first小于等于second。 最大可用层索引值的计算公式如下。 (CacheDesc::num\_tensors / KvCacheExtParam::tensor\_num\_per\_layer) \- 1 当前支持tensor\_num\_per\_layer取值范围是[1, 当前cache的tensor总数]，默认值为2。当src\_layer\_range或dst\_layer\_range取值为非默认值时， tensor\_num\_per\_layer可以保持默认值，也可以输入其他值，输入其他值时，tensor\_num\_per\_layer的取值还需要被当前cache的tensor总数整除。 |


#### 调用示例

```
CacheDesc kv_desc{};
kv_desc.data_type = llm_datadist::DT_INT32;
kv_desc.shape = {4, 16};
kv_desc.num_tensors = 4;
Cache cache{};
llm_datadist.AllocateCache(kv_desc, cache);
CacheIndex dst_cache_key{0, 1, 3};
KvCacheExtParam ext_param{};
ext_param.src_layer_range =  std::pair<int32_t, int32_t>(3, 3);
ext_param.dst_layer_range =  std::pair<int32_t, int32_t>(3, 3);
ext_param.tensor_num_per_layer = 1;
Status ret = llm_datadist.PushKvCache(cache, dst_cache_key, 3, -1, ext_param);
```


#### 返回值

- LLM_SUCCESS：成功
- LLM_PARAM_INVALID：参数错误
- LLM_NOT_YET_LINK：与远端cluster没有建链
- LLM_TIMEOUT：推送超时
- LLM_KV_CACHE_NOT_EXIST：本地或远端KV Cache不存在
- 其他：失败


#### 约束说明

该接口调用之前，需要先调用Initialize接口完成初始化。src_cache必须是AllocateCache接口申请出的Cache。