如何在SageMaker SDK中插值ParameterString构建ProcessingInput路径？

在SageMaker Pipeline中，ParameterString是特殊的管道参数对象，不能直接用Python的f-string或str.format()进行插值——这两种方式会把参数对象转成普通字符串表示，而非保留管道能识别的参数引用。以下两种方法可以正确实现参数与字符串的组合：

方法一：使用SageMaker的Join函数（推荐） #

SageMaker Workflow提供了Join函数，专门用于在管道定义阶段拼接字符串和参数，能确保管道运行时正确解析参数值。

import sagemaker
from sagemaker.processing import ProcessingInput
from sagemaker.sklearn.processing import SKLearnProcessor
from sagemaker.workflow.parameters import ParameterString
from sagemaker.workflow.functions import Join

date_parameter = ParameterString(name="date")
# 拼接成完整S3路径
s3_source_path = Join(on="", values=["s3://my-bucket/date=", date_parameter])

p_input = ProcessingInput(
    source=s3_source_path,
    destination="/opt/ml/processing/input"
)

如果路径有多个分段，也可以用on="/"来拼接不同部分，比如：

s3_source_path = Join(on="/", values=["s3://my-bucket", f"date={date_parameter}", "raw-data"])

方法二：直接字符串拼接 #

ParameterString对象支持与普通字符串直接用+运算符拼接，这种方式同样能被SageMaker管道识别并在运行时替换参数值。

import sagemaker
from sagemaker.processing import ProcessingInput
from sagemaker.sklearn.processing import SKLearnProcessor
from sagemaker.workflow.parameters import ParameterString

date_parameter = ParameterString(name="date")
# 直接拼接字符串与参数
s3_source_path = "s3://my-bucket/date=" + date_parameter

p_input = ProcessingInput(
    source=s3_source_path,
    destination="/opt/ml/processing/input"
)

为什么f-string/str.format()不行？ #

当使用f-string时，Python会立即把date_parameter转换成它的对象字符串（类似<sagemaker.workflow.parameters.ParameterString object at 0x12345678>），而不是保留管道需要的参数引用，导致运行时无法替换为实际传入的日期值。

内容的提问来源于stack exchange，提问作者RubenLaguna