dennis zhuang f25ab67af1 feat: table semantic layer identity (Phase 1) (#8210) ...

* feat: table semantic layer identity (Phase 1)

Attach a thin layer of semantic metadata to ingested tables via the existing
`table_options` slot, so machine consumers (LLM agents, alert/dashboard builders,
MCP servers, ETL) can align a table with the observability concept it stands for
without guessing from column names. See docs/rfcs/2026-05-28-table-semantic-layer.md.

Phase 1 (identity) only:
- New `table::requests::semantic` module: the `greptime.semantic.*` vocabulary
  (signal/source/source_version/pipeline + trace/metric/log/resource-scope keys,
  defined now, populated by later phases), value constants, the internal
  `greptime.internal.semantic.per_table_index` transport key (reserved for Phase 2,
  deliberately outside the public namespace), and `is_semantic_option_key`.
- `validate_table_option` accepts the `greptime.semantic.*` prefix, so the keys are
  valid both on the auto-create path and on explicit `CREATE TABLE ... WITH (...)`.
- `fill_table_options_for_create` copies every semantic ctx extension into the new
  table's options (prefix passthrough alongside the fixed allowlist).
- Frontend stamps identity on the context at each ingest entry: OTLP metrics
  (metric/opentelemetry), traces (+pipeline, has_events/has_links/conventions for
  the v1 model), logs (log/opentelemetry), and Prometheus remote write
  (metric/prometheus, metadata_quality=inferred). OTLP metric metadata_quality is
  left for Phase 2 (declared).
- Trace identity is stamped only on the main span table; the derived
  `_services` / `_operations` lookup tables keep the unstamped context and carry no
  semantic identity (cross-table relationships are out of scope).

Semantic options appear in SHOW CREATE TABLE (like table_data_model /
otlp_metric_compat) and in information_schema, so an LLM inspecting a table sees its
semantics directly.

Tests: unit (validation prefix + internal-key rejection, ctx passthrough) and
integration assertions that the common keys land for OTLP metrics (metric-engine
logical table), traces, logs, and Prometheus remote write; SHOW CREATE goldens
updated.

Signed-off-by: Dennis Zhuang <killme2008@gmail.com>

* fix: prom batcher not cover and white list for semantic keys/values

Signed-off-by: Dennis Zhuang <killme2008@gmail.com>

* fix: typo

Signed-off-by: Dennis Zhuang <killme2008@gmail.com>

---------

Signed-off-by: Dennis Zhuang <killme2008@gmail.com>

2026-06-02 01:56:29 +00:00

..

grpc.rs

feat: global switch for creating tables automatically (#8203)

2026-05-31 23:51:14 +00:00

http.rs

feat: table semantic layer identity (Phase 1) (#8210)

2026-06-02 01:56:29 +00:00

jsonbench.rs

test: add jsonbench tests (#8165)

2026-05-27 08:34:06 +00:00

main.rs

test: cover standalone user provider config (#8067)

2026-05-08 08:56:22 +00:00

mysql.rs

fix: mysql prepare correctly returns error instead of panic (#7963)

2026-04-15 01:59:16 +00:00

region_migration.rs

refactor: SQL and gRPC server handlers (#7637)

2026-01-30 07:19:45 +00:00

repartition_expr_version.rs

refactor: rename partition rule version to partition expr version (#7696)

2026-02-10 10:12:47 +00:00

repartition.rs

feat(meta-srv): support repartition for unpartitioned tables (#8186)

2026-05-28 03:31:55 +00:00

sql.rs

fix(server): describe EXPLAIN statements so bind parameters work (#8035)

2026-04-26 14:01:35 +00:00