Product

How Sembric turns warehouse tables into answers agents can trust

Sembric runs one governed workflow: discover what you already have, classify it, certify exactly what agents may use, then enforce that on every call. Here is each step and the rules it enforces.

1 · Discover

Read the catalog, never the whole warehouse

An owner connects a BigQuery dataset, Snowflake schema, Trino catalog and schema, Databricks catalog and schema, PostgreSQL schema or MySQL database, and tests the customer identity each Sembric role uses before saving.

  • Discovery reads every catalog page before publishing the refreshed inventory, so a failure part-way leaves the previous catalog intact.
  • Assets that disappear are marked missing, lose their reviews and dependent certificates, and cannot be used until restored and rediscovered.
  • Readable display names can be set per workspace; the physical relation stays visible for traceability and remains the only query target.
  • Owners and engineers browse the catalog; analysts and viewers see only certified surfaces, because table and column names can be sensitive themselves.

2 · Classify and steward

Every asset has one accountable steward

Columns with common personal-data names start sensitive. That heuristic is a starting point, so review by the asset’s assigned data steward is mandatory before anything built on it can be certified.

  • An owner assigns a steward, or the first eligible reviewer claims an unassigned asset. Reassignment withdraws the review and dependent certificates atomically.
  • Engineers can mark a column sensitive; only an owner can clear the mark. Many columns can be marked in one reviewed change.
  • Nested or repeated fields keep their full type in the reviewed fingerprint, start sensitive when any nested name looks personal, and cannot be measures or dimensions.
  • Every preview, certification and query rechecks the stored definition against the current classification, so a newly sensitive column can never be released.

3 · Define

Two kinds of certified surface

Both carry a business definition, caveats, concepts, role grants and at least two distinct expected-answer cases. Every saved definition is versioned with a field-level history.

Aggregate

Data product

One measure — sum, count, count_distinct, avg, min or max — over approved dimensions. Sum, average, minimum and maximum need a numeric measure so their checks are verifiable.

A reviewed minimum group size is enforced in the source query with HAVING COUNT(*) >= n for previews, certification, the API and MCP. It withholds small groups but is not complementary suppression, so keep person-level dimensions coarse.

Projection

Governed view

Approved, non-sensitive columns with optional fixed row restrictions. Restrictions are equality or value lists, never open ranges, and are always conjoined with what the caller asks for.

Certification also proves that each granted source identity can actually read the approved projection — a row count alone cannot prove column access.

4 · Certify

Independent review, checked under every role

A builder requests review from a named, independent owner or engineer. The request closes itself when the surface is certified or its definition changes.

Data product

Net revenue by region

Certified
Measure
sum(net_amount)
Granted roles
analyst, viewer
Minimum group
5 records
Expires
in 23 days
Expected-answer checks run under each granted role
Check under roleExpectedResult
Analyst · Q1 total711,290.00pass
Analyst · North only849,000.00pass
Viewer · Q1 total412,880.00pass
Viewer · North only849,000.00pass

Reviewer is neither the owner nor the last editor · fingerprint unchanged through the final check

  • The reviewer differs from both the current owner and the last definition editor.
  • Each granted role runs two distinct checks; an expected answer can be overridden per role when source row policies differ.
  • COUNT checks need exact non-negative integers; SUM and AVG allow only machine-precision noise.
  • A failed or refused certification is recorded with its reason and visible to every builder.
  • Certificates last 30 days by default. In the final 7 days an independent reviewer can renew in place by re-running every check; expired certificates are never renewed.

5 · Serve

Bounded, typed queries — and nothing else

Agents and applications query certified surfaces through MCP or the REST API. Sembric builds the source query; callers supply only these inputs.

Query rules enforced for every API and MCP call
RuleWhat Sembric enforces
FieldsOnly declared dimensions or approved columns; a product query may group by at most three of up to 12 declared dimensions.
FiltersEquality, a value list of at most 50, or a range on numeric, date and time fields — always bound as typed parameters.
Time grainsday, week, month, quarter or year on declared date or timestamp dimensions; weeks start Monday and instants bucket in UTC.
Limits1 to 100 rows. A query matching more is refused with narrowing guidance instead of being truncated.
Result shapeProvider rows must have exactly the approved columns; an extra or missing field fails closed.
Response sizeSerialized rows are capped at 1 MB by default (configurable up to 4 MB) before release.
Fixed restrictionsA view’s equality or value-list restrictions are always conjoined with caller filters and cannot be replaced.

After a source query returns, Sembric rechecks membership, role, the calling session or key, and the certificate before releasing rows.

Context for agents

Ontology and lineage

Concepts declared on certified surfaces form a shared ontology. Owners and engineers connect them with typed relationships, and certification refuses a conflicting definition for an existing concept.

  • The API and MCP filter concepts and relationships to the surfaces visible to the caller; links disappear when a surface is withdrawn.
  • Column-level lineage traces each certified surface from its source columns — sensitive ones shown as withheld — through approved fields to concepts, roles and agents.
  • Cmd/Ctrl+K searches everything a member may see.

Workspace

Roles, collaboration and monitoring

Membership and role are re-read on every request, so changes take effect immediately for people and their agents.

Workspace roles
RoleCan
OwnerConnects sources and maps role identities, assigns stewards, invites and removes members, clears sensitive marks, revokes any key.
EngineerBrowses the catalog, rediscovers sources, marks columns sensitive, builds and certifies surfaces, monitors agents.
AnalystSees and queries the certified products and views granted to the analyst role.
ViewerSees and queries the certified products and views granted to the viewer role.
  • Notifications cover review requests, certification outcomes, withdrawals, renewals due and expiry — in-app, with optional email and webhook copies that carry only a title and a portal link.
  • The Agents page shows answered and refused calls, the busiest surfaces, recent refusals and each key’s last use.
  • Owners download workspace audit events as JSONL from the Activity page.

FAQ

Frequently asked questions

What is the difference between a data product and a governed view?

A data product is one aggregate measure — sum, count, distinct count, average, minimum or maximum — over approved dimensions. A governed view projects approved columns with optional fixed row restrictions. Both carry business context, role grants and expected-answer checks.

Who can certify a surface?

An owner or engineer who is neither the surface’s current owner nor its last definition editor. They run two distinct expected-answer checks under every granted role’s source identity before certifying.

How long does a certificate last?

Thirty days by default. In the last seven days an independent reviewer can renew it by re-running every check. An expired certificate is withdrawn, recorded and never renewed; the surface returns to draft.

How do aggregates protect people in small groups?

A product can set a reviewed minimum group size, enforced in the source query with HAVING COUNT(*) >= n. It withholds small groups but is not complementary suppression, so keep person-level dimensions coarse.

Put your first certified data product in front of an agent.

Tell us which warehouse you run and what your agents need to answer. We will help you connect a source, certify a first surface and query it over MCP.