mindspore.mint.distributed.destroy_process_group

mindspore.mint.distributed.destroy_process_group(group=None)[源代码]

销毁指定通信group。如果指定的通信group为 None 或 "hccl_world_group", 则销毁全局通信域并释放分布式资源，例如 hccl 服务。

说明

当前接口不支持GPU、CPU版本的MindSpore调用。
此方法应该在 mindspore.mint.distributed.init_process_group() 方法之后使用。
当前仅支持PyNative模式，不支持Graph模式。

参数：

group (str，可选) - 通信组名称，通常由 mindspore.mint.distributed.new_group() 方法创建。默认值： None ，即Ascend平台表示为 "hccl_world_group" 。

异常：

TypeError - 在参数 group 不是字符串时抛出。
RuntimeError - HCCL 服务不可用时，或者使用了MindSpore的GPU或CPU版本。

支持平台：

Ascend

样例：

说明

运行以下样例之前，需要配置好通信环境变量。

针对Ascend设备，推荐使用msrun启动方式，无第三方以及配置文件依赖。详见 msrun启动。

>>> import mindspore as ms
>>> from mindspore.mint.distributed import init_process_group, destroy_process_group
>>> ms.set_device(device_target="Ascend")
>>> init_process_group()
>>> destroy_process_group()