Collection Engine¶
pghf.execute_check_run(p_run_key text DEFAULT NULL, p_check_run_id uuid DEFAULT NULL, INOUT p_run_id uuid DEFAULT NULL, p_target_version int DEFAULT NULL, p_amcheck_tables text[] DEFAULT NULL, p_pg_visibility_tables text[] DEFAULT NULL)¶
The generic dispatch engine. Runs every member of a named suite, in order, committing after each one. It has zero built-in knowledge of any particular check or suite — it's driven entirely by suite membership and each check's registered backing function. Deliberately not SECURITY DEFINER (see The Access Model): checks run as whoever actually calls this procedure. Must be invoked as a standalone CALL statement.
| Parameter | Type | Mandatory | Default | Description |
|---|---|---|---|---|
p_run_key |
text |
One of p_run_key/p_check_run_id required |
empty | Suite to run, by name. |
p_check_run_id |
uuid |
One of p_run_key/p_check_run_id required |
empty | Suite to run, by internal identifier. |
p_run_id |
uuid (input/output) |
No | empty = a new one is generated | Pass an existing value to reuse a specific run ID; otherwise a fresh one is generated and handed back to you. |
p_target_version |
int |
No | empty | Recorded as run configuration; read by the pg_upgrade-readiness checks. |
p_amcheck_tables |
text[] |
No | empty | Recorded as run configuration, for checks that verify specific tables with the amcheck extension. |
p_pg_visibility_tables |
text[] |
No | empty | Recorded as run configuration, for checks that inspect specific tables with the pg_visibility extension. |
Returns: the run ID, via the input/output parameter. This is a procedure. Inserts one run record and one raw-result record per suite member, and stamps a finish time on completion.
Continue to Thresholds.