CLI: record matching

Use mr-data match to match text or records against a versioned dataset using a profile. A profile defines the matching behavior; a job tracks the work; results carry the evidence to review. Availability depends on the hosted deployment and your workspace access.

Inspect before submitting

mr-data match --help
mr-data match profiles --json
mr-data match profile PROFILE_ID --json

Read the returned profile and revision before constructing a request. Writes take a UTF-8 JSON request document through --request FILE. The CLI validates each operation against the matching contract; do not reuse a query body as a job, profile or publication body.

mr-data match estimate --request request.json --json
mr-data match query TABLE_ID --request request.json --idempotency-key REQUEST_KEY --json

Replace identifiers and REQUEST_KEY with your own values. Preserve the idempotency key for an identical submission after an interrupted response. Changed requests require a new key. An estimate is not an execution result.

Follow and review a job

mr-data match jobs --json
mr-data match job JOB_ID --json
mr-data match watch JOB_ID --timeout 120 --json
mr-data match results JOB_ID --limit 20 --json

Follow server-issued cursors with --cursor. Inspect coverage, assessments and execution evidence before using matches as facts. A completed job does not establish that every source record matched correctly. Keep ambiguous matches separate from accepted ones.

Operations

Group	Commands
Profiles	profile-create, profiles, profile, profile-version, profile-activate, profile-alias, profile-delete
Quality and indexing	validate, evaluate, index-create, index, index-delete
Execution	query, estimate, execution, execution-delete
Jobs	job-create, jobs, job, results, cancel, resume, retry-failed, watch, wait
Delivery and review	publish, publication-cancel, export, review
Media	media-create, media, media-seal, media-download, media-delete

--if-match ETAG supplies a profile revision precondition. --alias selects default, shadow or rollback. --revision reads an immutable revision. Export format is jsonl, parquet or json; --kind selects edges, summaries, assessments, execution_manifest, coverage or evaluation. Evaluation exports require an actual retained --evaluation-id.

Read structured failures and retry instructions. Do not blindly repeat publication, cancellation, profile changes or deletion after an ambiguous response: first inspect the corresponding resource. For row search without a matching profile, use CLI search.