Inspect Governance Rules

Type: Function

Inspect the deployed rule layer for one governed table. Use this when an agent needs to understand which usage, validation, and transfer rules exist before asking for an authorization decision or explaining a result.

Input Parameters

Parameter	Type	Required	Description
table_name	string	Yes	Fully qualified table name (DB.SCHEMA.TABLE).
columns	array	No	Optional list of columns used to scope column-governance facts.

Output Schema

Field	Type	Description
table_name	string	Evaluated table name.
effective_columns	array	Column-level sensitivity, PII, masking, and provenance facts.
data_meaning	object	Business context and source instruction metadata.
usage_rules	array	Deployed permitted-use, prohibited-use, and AI-governance rules.
validation_rules	array	Deployed pre-query validation rules.
transfer_rules	array	Deployed destination and consumer-context transfer rules.

SQL Example

SELECT METATATE_APP.CORE.INSPECT_GOVERNANCE_RULES(
  OBJECT_CONSTRUCT(
    'table_name', 'ANALYTICS_DB.CORE.CUSTOMERS',
    'columns', ARRAY_CONSTRUCT('EMAIL')
  )
);

Agent Workflow

Call this tool when authorize-use returns UNKNOWN, when validate-query-context reports ambiguous findings, or when an agent needs to explain available controls before proposing a compliant query.