DataProcessing
The data structure used to specify the data to be used for inference in a batch transform job and to associate the data that is relevant to the prediction results in the output. The input filter provided allows you to exclude input data that is not needed for inference in a batch transform job. The output filter provided allows you to include input data relevant to interpreting the predictions in the output from the job. For more information, see Associate Prediction Results with their Corresponding Input Records.
Contents
- InputFilter
-
A JSONPath expression used to select a portion of the input data to pass to the algorithm. Use the
InputFilter
parameter to exclude fields, such as an ID column, from the input. If you want SageMaker to pass the entire input dataset to the algorithm, accept the default value$
.Examples:
"$"
,"$[1:]"
,"$.features"
Type: String
Length Constraints: Minimum length of 0. Maximum length of 63.
Required: No
- JoinSource
-
Specifies the source of the data to join with the transformed data. The valid values are
None
andInput
. The default value isNone
, which specifies not to join the input with the transformed data. If you want the batch transform job to join the original input data with the transformed data, setJoinSource
toInput
. You can specifyOutputFilter
as an additional filter to select a portion of the joined dataset and store it in the output file.For JSON or JSONLines objects, such as a JSON array, SageMaker adds the transformed data to the input JSON object in an attribute called
SageMakerOutput
. The joined result for JSON must be a key-value pair object. If the input is not a key-value pair object, SageMaker creates a new JSON file. In the new JSON file, and the input data is stored under theSageMakerInput
key and the results are stored inSageMakerOutput
.For CSV data, SageMaker takes each row as a JSON array and joins the transformed data with the input by appending each transformed row to the end of the input. The joined data has the original input data followed by the transformed data and the output is a CSV file.
For information on how joining in applied, see Workflow for Associating Inferences with Input Records.
Type: String
Valid Values:
Input | None
Required: No
- OutputFilter
-
A JSONPath expression used to select a portion of the joined dataset to save in the output file for a batch transform job. If you want SageMaker to store the entire input dataset in the output file, leave the default value,
$
. If you specify indexes that aren't within the dimension size of the joined dataset, you get an error.Examples:
"$"
,"$[0,5:]"
,"$['id','SageMakerOutput']"
Type: String
Length Constraints: Minimum length of 0. Maximum length of 63.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: