CheckpointResult
- class great_expectations.checkpoint.types.checkpoint_result.CheckpointResult(run_id: RunIdentifier, run_results: dict[ValidationResultIdentifier, dict[str, ExpectationSuiteValidationResult | dict | str]], checkpoint_config: CheckpointConfig, validation_result_url: Optional[str] = None, success: Optional[bool] = None)#
-
Object returned by Checkpoint.run.
The run_results property forms the backbone of this type and defines the basic contract for what a checkpoint's run method returns. It is a dictionary where the top-level keys are the ValidationResultIdentifiers of the validation results generated in the run. Each value is a dictionary having at minimum, a "validation_result" key containing an ExpectationSuiteValidationResult and an "actions_results" key containing a dictionary where the top-level keys are names of actions performed after that particular validation, with values containing any relevant outputs of that action (at minimum and in many cases, this would just be a dictionary with the action's class_name).
The run_results dictionary can contain other keys that are relevant for a specific checkpoint implementation. For example, the run_results dictionary from a WarningAndFailureExpectationSuiteCheckpoint might have an extra key named "expectation_suite_severity_level" to indicate if the suite is at either a "warning" or "failure" level.
Example run_results Dict:
{
ValidationResultIdentifier: {
"validation_result": ExpectationSuiteValidationResult,
"actions_results": {
"my_action_name_that_stores_validation_results": {
"class": "StoreValidationResultAction"
}
}
}
}- Parameters:
-
-
run_id – An instance of the RunIdentifier class.
-
run_results – A Dict with ValidationResultIdentifier keys and Dict values, which contains at minimum a validation_result key and an action_results key.
-
checkpoint_config – The CheckpointConfig instance used to create this CheckpointResult.
-
success – An optional boolean describing the success of all run_results in this CheckpointResult.
-
- list_expectation_suite_names() List[str] #
-
Return the list of expecation suite names for a checkpoint.
- Parameters:
-
None –
- Returns:
-
The list of expectation suite names.
- Return type:
-
self._expectation_suite_names
- list_validation_result_identifiers() List[ValidationResultIdentifier] #
-
Obtain a list of all the ValidationResultIdentifiers used in this CheckpointResult.
Args:
- Returns:
-
List of zero or more ValidationResultIdentifier instances.
- list_validation_results(group_by: Literal['validation_result_identifier', 'expectation_suite_name', 'data_asset_name'] | None = None) list[ExpectationSuiteValidationResult] | dict #
-
Obtain the ExpectationValidationResults belonging to this CheckpointResult.
- Parameters:
-
group_by – Specify how the ExpectationValidationResults should be grouped. Valid options are "validation_result_identifier", "expectation_suite_name", "data_asset_name", or the default None. Providing an invalid group_by value will cause this method to silently fail, and return None.
- Returns:
-
A list of ExpectationSuiteValidationResult, when group_by=None A dict of ValidationResultIdentifier keys and ExpectationValidationResults
values, when group_by="validation_result_identifier"
- A dict of str keys and ExpectationValidationResults values, when
-
group_by="expectation_suite_name" or group_by="data_asset_name"
None, when group_by is something other than the options described above
- to_json_dict() Dict[str, JSONValues] #
-
Returns a JSON-serializable dict representation of this CheckpointResult.
- Returns:
-
A JSON-serializable dict representation of this CheckpointResult.