Param: 변환 매개변수의 공통 계약

transforms.api.Param은 변환의 compute 함수가 받는 매개변수의 기본 클래스입니다. 대표적인 구체 클래스에는 Input과 InputSet이 있습니다. 입력 명세를 빌드 작업 명세(JobSpec)에 담는 단계와, 빌드에서 compute 함수에 객체를 주입하는 단계를 연결합니다.

transforms.api.Param(description=None)

description은 선택적 문자열이며 기본값은 None입니다. 매개변수의 JSON 스키마에 설명을 추가합니다.

instance(context, json_value)

정적 메서드로 JobSpec 매개변수의 역직렬화된 원시 JSON 값과 생성 맥락을 받아 인스턴스를 만듭니다. 반환값이 변환의 compute 함수에 주입됩니다.

이 메서드는 라이브러리 1.53.0에 추가되었습니다.

json_value

JobSpec에 넣을 JSON 값을 반환하는 속성입니다. 반환값이 None이면 이 매개변수는 바인딩되지 않은 상태입니다. 변환의 매개변수 중 하나라도 바인딩되지 않았으면 변환 전체도 바인딩되지 않은 것으로 간주하며 JobSpec을 게시하지 않습니다.

schema

매개변수 유형의 JSON 스키마를 반환하는 속성입니다. 유효한 JSON 스키마를 반환해야 합니다. 매개변수 값을 직렬화하는 json_value와 그 값의 구조를 설명하는 schema를 구분합니다.

값 기반 입력의 선언과 compute에서의 사용은 매개변수 명세를 참고합니다.