传输保护#
JAX 可能会在类型转换和输入分片期间在主机和设备之间以及设备之间传输数据。 为了记录或禁止任何意外传输,用户可以配置 JAX 传输保护。
JAX 传输保护区分两种类型的传输
显式传输:
jax.device_put*()
和jax.device_get()
调用。隐式传输:其他传输(例如,打印
DeviceArray
)。
传输保护可以根据其保护级别采取行动
"allow"
: 默默允许所有传输(默认)。"log"
: 记录并允许隐式传输。 默默允许显式传输。"disallow"
: 禁止隐式传输。 默默允许显式传输。"log_explicit"
: 记录并允许所有传输。"disallow_explicit"
: 禁止所有传输。
JAX 在禁止传输时会抛出 RuntimeError
。
传输保护使用标准的 JAX 配置系统
一个
--jax_transfer_guard=GUARD_LEVEL
命令行标志和jax.config.update("jax_transfer_guard", GUARD_LEVEL)
会设置全局选项。一个
with jax.transfer_guard(GUARD_LEVEL): ...
上下文管理器会在上下文管理器的范围内设置线程本地选项。
请注意,与其他 JAX 配置选项类似,新生成的线程将使用全局选项,而不是生成线程的范围内的任何活动的线程本地选项。
传输保护也可以更具选择性地应用,基于传输方向。 标志和上下文管理器名称后缀为相应的传输方向(例如,--jax_transfer_guard_host_to_device
和 jax.config.transfer_guard_host_to_device
)
"host_to_device"
: 将 Python 值或 NumPy 数组转换为 JAX 设备上的缓冲区。"device_to_device"
: 将 JAX 设备上的缓冲区复制到另一个设备。"device_to_host"
: 获取 JAX 设备上的缓冲区。
无论传输保护级别如何,始终允许获取 CPU 设备上的缓冲区。
以下显示了使用传输保护的示例。
>>> jax.config.update("jax_transfer_guard", "allow") # This is default.
>>>
>>> x = jnp.array(1)
>>> y = jnp.array(2)
>>> z = jnp.array(3)
>>>
>>> print("x", x) # All transfers are allowed.
x 1
>>> with jax.transfer_guard("disallow"):
... print("x", x) # x has already been fetched into the host.
... print("y", jax.device_get(y)) # Explicit transfers are allowed.
... try:
... print("z", z) # Implicit transfers are disallowed.
... assert False, "This line is expected to be unreachable."
... except:
... print("z could not be fetched")
x 1
y 2
z could not be fetched