Skip to content

REST Spec: add labels field to LoadTableResult#15750

Draft
laskoviymishka wants to merge 1 commit intoapache:mainfrom
laskoviymishka:labels-in-load-table-response
Draft

REST Spec: add labels field to LoadTableResult#15750
laskoviymishka wants to merge 1 commit intoapache:mainfrom
laskoviymishka:labels-in-load-table-response

Conversation

@laskoviymishka
Copy link

Add optional labels field to LoadTableResult for catalog-specific metadata enrichment. Labels are ephemeral API-level annotations — not table state. They do not modify table metadata files or create commits.

Catalogs MAY populate labels to provide operational context (ownership, classification, cost attribution, semantic hints). Engines MAY use labels or ignore them entirely. Labels are backward compatible — older clients ignore unknown fields.

New schemas: Labels, ColumnLabels (column labels keyed by field-id for stability across schema evolution).

Proof-of-concept for the IRC Labels proposal: #15521.

Add optional labels field to LoadTableResult for catalog-specific metadata
enrichment. Labels are ephemeral API-level annotations — not table state.
They do not modify table metadata files or create commits.

Catalogs MAY populate labels to provide operational context (ownership,
classification, cost attribution, semantic hints). Engines MAY use labels
or ignore them entirely. Labels are backward compatible — older clients
ignore unknown fields.

New schemas: Labels, ColumnLabels (column labels keyed by field-id for
stability across schema evolution).
@laskoviymishka laskoviymishka force-pushed the labels-in-load-table-response branch from acdb80a to a80fc1a Compare March 24, 2026 09:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant