Input: 단일 데이터셋 입력 명세
transforms.api.Input은 변환이 읽는 데이터셋 입력을 선언합니다. FoundryInputParam의 구체 클래스이며 1.53.0부터 이 기본 클래스를 상속합니다. 여러 입력을 하나의 명세로 다루려면 InputSet을 사용합니다.
transforms.api.Input(
alias=None, branch=None, description=None,
stop_propagating=None, stop_requiring=None,
checks=None, failure_strategy=None, transaction_limit=None,
)
| 인자 | 형식 | 기본값과 동작 |
|---|---|---|
alias | str | None이면 바인딩되지 않은 입력. 값은 데이터셋 RID 또는 Compass 절대 경로 |
branch | str | None이면 빌드 시점에 결정. 지정하면 해당 이름의 브랜치로 입력 해석 |
description | str | 선택적 입력 설명, 기본값 None |
stop_propagating | Markings | 전파를 중단할 보안 표지 명세, 기본값 None |
stop_requiring | OrgMarkings | 출력에 더 이상 요구하지 않을 상속 조직 명세, 기본값 None |
checks | Check 또는 list<Check> | 입력에 연결할 검사, 기본값 None |
failure_strategy | str | 입력 갱신 실패 시 continue 또는 fail. 생략하면 fail |
transaction_limit | int | 증분 입력에서 읽을 최대 트랜잭션 수, 기본값 None |
보안 표지와 조직 제거 설정은 입력에 지정하며, 적용할 보호 브랜치와 승인 권한을 충족해야 합니다. 두 설정은 역할(Role)을 바꾸는 기능이 아닙니다. 검사는 입력 데이터에 대한 전제 조건을 확인합니다.
인스턴스와 결과
| 메서드 또는 속성 | 계약 |
|---|---|
instance(context, json_value) | 정적 메서드. ParamContext와 JobSpec의 역직렬화된 원시 값을 받아 compute에 주입할 인스턴스 생성 |
lightweight_instance(_context, json_value) | 정적 메서드. 확정된 JSON 값에서 경량 입력 유형 생성 |
input_results(instance, **kwargs) | instance에서 생성한 객체를 받아 입력 RID별 TransformsInputResult 맵 생성. TransformJobResult에 병합 |
json_value | JobSpec에 넣을 JSON 값. None이면 바인딩되지 않은 상태 |
schema | 매개변수 유형의 유효한 JSON 스키마 반환 |
매개변수가 하나라도 바인딩되지 않은 변환은 JobSpec을 게시하지 않습니다. ParamContext는 인스턴스를 만드는 데 필요한 입출력 명세와 빌드 정보를 제공합니다.