datasystem.hetero_client.HeteroClient.async_mget_h2d

datasystem.hetero_client.HeteroClient.async_mget_h2d#

datasystem.hetero_client.HeteroClient.async_mget_h2d(keys, data_blob_list, sub_timeout_ms)#

异步接口,从 host 中获取数据并写入 device 中。

async_mget_h2d 和 mset_d2h/async_mset_d2h 需配套使用。

若 mset_d2h/async_mset_d2h 时将多个内存地址拼接写入了 host 的内存,则在 async_mget_h2d 中自动将 host 内存中的数据拆分成多个内存地址写入 Device。

若 host 的 key 不再使用,可调用 delete 接口删除。

参数:
  • keys (list) - host 的 key 列表。约束:传入的object key的数量不能超过1万。

  • data_blob_list (list) - datasystem.hetero_client.DeviceBlobList 列表。

  • sub_timeout_ms (int) - 超时时间,当在指定时间内无法获取完成,则抛出异常。

返回:
  • Future (Future) - 可通过该Future对象查询异步请求执行结果。

异常:
  • TypeError - 输入参数存在非法值。

  • RuntimeError - 给定列表的对象 key 都未执行成功。