2026-07-13|17:54:49
DuckDBWARNING0.05ERROR0.1CRITICAL0.15
col_vals_regex()
1.00
0.00
col_vals_gt()
0.85
0.15
col_vals_gt()
0.84
0.16
Actions class.
## Returns
`dict | None`
A dictionary containing the metadata for the current step. If called outside of an action (i.e., when no action is being executed), this function will return `None`.
## Description Of The Metadata Fields
The metadata dictionary contains the following fields for a given validation step:
- `step`: The step number.
- `column`: The column name.
- `value`: The value being compared (only available in certain validation steps).
- `type`: The assertion type (e.g., `"col_vals_gt"`, etc.).
- `time`: The time the validation step was executed (in ISO format).
- `level`: The severity level (`"warning"`, `"error"`, or `"critical"`).
- `level_num`: The severity level as a numeric value (`30`, `40`, or `50`).
- `autobrief`: A localized and brief statement of the expectation for the step.
- `failure_text`: Localized text that explains how the validation step failed.
## Examples
When creating a custom action, you can access the metadata for the current step using the [get_action_metadata()](get_action_metadata.md#pointblank.get_action_metadata) function. Here's an example of a custom action that logs the metadata for the current step:
``` python
import pointblank as pb
def log_issue():
metadata = pb.get_action_metadata()
print(f"Type: {metadata['type']}, Step: {metadata['step']}")
validation = (
pb.Validate(
data=pb.load_dataset(dataset="game_revenue", tbl_type="duckdb"),
thresholds=pb.Thresholds(warning=0.05, error=0.10, critical=0.15),
actions=pb.Actions(warning=log_issue),
)
.col_vals_regex(columns="player_id", pattern=r"[A-Z]{12}[0-9]{3}")
.col_vals_gt(columns="item_revenue", value=0.05)
.col_vals_gt(
columns="session_duration",
value=15,
)
.interrogate()
)
validation
```
Type: col_vals_gt, Step: 2
Type: col_vals_gt, Step: 3
| Pointblank Validation | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2026-07-13|17:54:49
DuckDBWARNING0.05ERROR0.1CRITICAL0.15
|
|||||||||||||
| STEP | COLUMNS | VALUES | TBL | EVAL | UNITS | PASS | FAIL | W | E | C | EXT | ||
| #4CA64C | 1 |
col_vals_regex()
|
|
✓ | 2000 | 2000 1.00 |
0 0.00 |
○ | ○ | ○ | -- | ||
| #EBBC14 | 2 |
col_vals_gt()
|
|
✓ | 2000 | 1701 0.85 |
299 0.15 |
● | ● | ○ | -- | ||
| #FF3300 | 3 |
col_vals_gt()
|
|
✓ | 2000 | 1675 0.84 |
325 0.16 |
● | ● | ● | -- | ||
| 2026-07-13 17:54:49 UTC< 1 s2026-07-13 17:54:49 UTC | |||||||||||||