---
title: ASCEND_REMAIN_CACHE_SIZE_RATIO
description: "启用算子编译缓存功能时，当编译缓存空间大小达到ASCEND_MAX_OP_CACHE_SIZE而需要删除旧的kernel文件时，系统需要保留缓存的空间大小比例，默认为50，单位为百分比。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/maintenref/envvar/envref_07_0022.html
sourcePath: /source/zh/canncommercial/900/maintenref/envvar/envref_07_0022.html
indexId: 1dca1efb3b65d0b560c5c05fc296c5260b1935af1e217e1b9f7ed3d0e6457ec767
---
# ASCEND_REMAIN_CACHE_SIZE_RATIO

#### 功能描述

启用算子编译缓存功能时，当编译缓存空间大小达到ASCEND_MAX_OP_CACHE_SIZE而需要删除旧的kernel文件时，系统需要保留缓存的空间大小比例，默认为50，单位为百分比。


#### 配置示例

```
export ASCEND_REMAIN_CACHE_SIZE_RATIO=50
```


#### 使用约束

系统读取保留缓存空间大小比例配置的优先级如下：

算子编译磁盘缓存的目录下的“op_cache.ini”配置文件 > ASCEND_REMAIN_CACHE_SIZE_RATIO环境变量 > 默认值

即若开发者同时配置了op_cache.ini文件和环境变量，则优先读取op_cache.ini文件中的配置项，若op_cache.ini文件和环境变量都未设置，则读取系统默认值：默认保留缓存空间的50%。

关于“op_cache.ini”配置文件的说明可参见op_cache.ini文件说明。


#### op_cache.ini文件说明

业务开启算子编译缓存功能后，会在指定的算子编译磁盘缓存的目录下自动生成op_cache.ini文件，开发者可通过该配置文件进行缓存磁盘空间大小的配置。若op_cache.ini文件不存在，可在该路径下手动创建。

不同场景下指定算子编译磁盘缓存目录的方法不同，例如：

- 基于AscendCL接口开发AI应用场景下，可在“  aclCompileOpt(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/aclcppdevg_03_1371.html)
”接口中通过编译选项ACL_OP_COMPILER_CACHE_DIR设置。
- Ascend Graph构图场景下，可通过配置参数“  ge.op_compiler_cache_dir(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/ascendgraphapi/atlasgeapi_07_0150.html#ZH-CN_TOPIC_0000002562261167__section7719145610561)
”设置。
- ATC模型转换场景下，可通过参数“  --op_compiler_cache_dir(https://www.hiascend.comdocument/detail/zh/canncommercial/900/devaids/atctool/atlasatcparam_16_0085.html)
”设置。
- PyTorch框架场景下，可通过环境变量“ACL_OP_COMPILER_CACHE_DIR”设置，关于“ACL_OP_COMPILER_CACHE_DIR”的介绍可参见《Ascend Extension for PyTorch 环境变量参考(https://www.hiascend.com/document/detail/zh/Pytorch/600/apiref/Envvariables/Envir_001.html)》。
- TensorFlow框架场景下，可通过配置参数“op_compiler_cache_dir”设置。
  TF Adapter配置参数“op_compiler_cache_dir”的详细说明可参见：
  - 《TF Adapter接口 (1.x)(https://www.hiascend.com/document/detail/zh/TensorFlowCommercial/900/migration/tfmigr1/tfmigr1_tfadapi_0001.html)》中的“session配置 > session配置参数说明”。
  - 《TF Adapter接口 (2.x)(https://www.hiascend.com/document/detail/zh/TensorFlowCommercial/900/migration/tfmigr2/tfmigr2_tfadapi_0001.html)》中的“npu.global_options > 配置参数说明。


以上列举场景仅为示例，若无法覆盖您所使用的场景，请查看对应场景的用户手册。


在“op_cache.ini”文件中，添加如下信息：

```
#配置文件格式，必须包含，自动生成的文件中默认包括如下信息，手动创建时，需要填写
[op_compiler_cache]
#限制某个AI处理器下缓存文件的磁盘空间的大小，整数，单位为MB
max_op_cache_size=500
#当磁盘空间不足时，设置需要保留的缓存文件比例，取值范围：[1,100]，单位为百分比；例如80表示磁盘空间不足时，会保留80%的缓存空间中的文件，其余删除
remain_cache_size_ratio=80
```


#### 支持的型号

Atlas 训练系列产品

Atlas 推理系列产品

Atlas A2 训练系列产品 / Atlas A2 推理系列产品

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

Atlas 350 加速卡

Atlas 200I/500 A2 推理产品