diff --git a/docs/programming_guide/source_zh_cn/cache.md b/docs/programming_guide/source_zh_cn/cache.md index 6d9015a3ae8ae65d9bc77861f9167c73c15c47d5..a96c315b3d8b0d44e70a1d810954dee45fe7aaa5 100644 --- a/docs/programming_guide/source_zh_cn/cache.md +++ b/docs/programming_guide/source_zh_cn/cache.md @@ -69,7 +69,7 @@ `cache_admin`支持以下命令和参数: - `--start`:启动缓存服务器,支持通过以下参数进行配置: - `--workers`或`-w`:设置缓存服务器的工作线程数量,默认情况下工作线程数量为机器CPU个数的一半。 - - `--spilldir`或`-s`:设置若缓存数据的大小超过内存空间,则溢出至磁盘的数据文件路径,默认为`/tmp/mindspore/cache`。 + - `--spilldir`或`-s`:设置若缓存数据的大小超过内存空间,则溢出至磁盘的数据文件路径,默认为空(表示不启用数据溢出功能)。 - `--hostname`或`-h`:缓存服务器的ip地址,默认为127.0.0.1。 - `--port`或`-p`:缓存服务器的端口号,默认为50052。 - `--loglevel`或`-l`:设置日志等级,默认为1(WARNING级别)。若设置为0(INFO级别),会输出过多日志,导致性能劣化。 @@ -83,7 +83,8 @@ 用户可通过`ps -ef|grep cache_server`命令来检查服务器是否已启动以及查询服务器参数。 - > 设置cache_server初始化参数时,要先确认系统可用内存和待加载数据集大小,cache_server初始化容量或待加载数据集空间占耗超过系统可用内存时,都有可能导致机器宕机/重启、cache_server自动关闭、训练流程执行失败等问题。 + > - 设置cache_server初始化参数时,要先确认系统可用内存和待加载数据集大小,cache_server初始化容量或待加载数据集空间占耗超过系统可用内存时,都有可能导致机器宕机/重启、cache_server自动关闭、训练流程执行失败等问题。 + > - 若要启用数据溢出功能,则用户在启动缓存服务器时必须使用`-s`参数对溢出路径进行设置,否则该功能默认关闭。 3. 创建缓存会话。 @@ -135,7 +136,7 @@ > - 在实际使用中,通常应当首先使用`cache_admin -g`命令从缓存服务器处获得一个缓存会话id并作为`session_id`的参数,防止发生缓存会话不存在而报错的情况。 > - 设置`size=0`代表不限制缓存所使用的内存空间,但不超过系统总内存的80%。注意,设置`size`为0可能会存在机器“out of memory”的风险,因此建议用户根据机器本身的空闲内存大小,给`size`参数设置一个合理的取值。 - > - 若设置`spilling=True`,则当内存空间不足时,多余数据将写入磁盘中。因此,用户需确保所设置的磁盘路径具有写入权限以及足够的磁盘空间,以存储溢出至磁盘的缓存数据。 + > - 若设置`spilling=True`,则当内存空间不足时,多余数据将写入磁盘中。因此,用户需确保所设置的磁盘路径具有写入权限以及足够的磁盘空间,以存储溢出至磁盘的缓存数据。注意,若启动服务器时未指定溢出路径,则在调用API时设置`spilling=True`将会导致报错。 > - 若设置`spilling=False`,则缓存服务器在耗尽所设置的内存空间后将不再写入新的数据。 > - 当使用不支持随机访问的数据集(如`TFRecordDataset`)进行数据加载并启用缓存服务时,需要保证整个数据集均存放于本地。在该场景下,若本地内存空间不足以存放所有数据,则必须启用溢出,将数据溢出至磁盘。 > - `num_connections`和`prefetch_size`为内部性能调优参数,一般情况下,用户无需设置这两个参数。 diff --git a/tutorials/training/source_zh_cn/quick_start/quick_video.md b/tutorials/training/source_zh_cn/quick_start/quick_video.md index d4aa156c89f6e47c5539d062d4744265a6f9fd51..0dc24306d8eb8aad4759b7672310b627bf8f2956 100644 --- a/tutorials/training/source_zh_cn/quick_start/quick_video.md +++ b/tutorials/training/source_zh_cn/quick_start/quick_video.md @@ -556,7 +556,7 @@