Skip to main content

Module table_semantics

Module table_semantics 

Source
Expand description

information_schema.table_semantics: the queryable view over the table semantic layer. One row per table that is part of it, so a consumer can discover the observability concept a table stands for with a single SQL query instead of parsing every tableโ€™s create_options.

The few signal-agnostic keys are promoted to their own columns (signal_type / source / source_version / pipeline / metadata_quality); the remaining signal-specific keys are folded into a semantic_options JSON string, keyed by the option name with the greptime.semantic. prefix stripped.

entity_declarations reports the entities the table contributes to the graph, including the ones the conventions derive with no option set โ€” so a table with no semantic option still gets a row. It shows the outcome, not the reasoning: a declaration dropped for naming a missing column is simply absent, and only the log says why.

Structsยง

DeclarationEntry ๐Ÿ”’
The JSON form of one declaration in the entity_declarations column.
InformationSchemaSemanticTablesBuilder ๐Ÿ”’
InformationSchemaTableSemantics ๐Ÿ”’
SemanticRow ๐Ÿ”’
The semantic projection of a single table: the signal-agnostic keys promoted to columns, plus a JSON tail for the rest. Borrows from the tableโ€™s options.

Constantsยง

ENTITY_DECLARATIONS
INIT_CAPACITY ๐Ÿ”’
METADATA_QUALITY
PIPELINE
SEMANTIC_OPTIONS
SIGNAL_TYPE
SOURCE
SOURCE_VERSION
TABLE_CATALOG
TABLE_ID
TABLE_NAME
TABLE_SCHEMA

Functionsยง

entity_declarations_json ๐Ÿ”’
optional_value ๐Ÿ”’