v1.7.0: Consolidated reference tables and local mode validation

[vondravl]

Summary

This release consolidates visualization and metric reference tables into unified schemas and adds is_valid computation for local mode exports.

Breaking Changes

• visualizations_references replaces visualizations_metrics and visualizations_attributes

  • Two-dimensional classification: object_type (metric/fact/attribute/label) + source (measure/attribute/filter)
  • Enables queries like "Is this attribute used as a filter or dimension?"
  • CSV renamed to gooddata_visualizations_references.csv

• metrics_references replaces metrics_relationships and metrics_ldm_references

  • Single table with reference_type column (metric/attribute/label/fact)
  • Views v_metrics_relationships and v_metrics_relationships_root now filter by reference_type = 'metric'

New Features

• is_valid computation for local mode

  • Metrics/visualizations now default to NULL when areRelationsValid is absent
  • Post-export updates compute validity based on reference analysis
  • Checks all reference types (metrics, attributes, facts, labels)

• Date instance support in LDM export

  • Processes ldm.dateInstances in addition to ldm.datasets
  • Date granularities stored as attributes in ldm_columns
  • Enables validation of {label/date.granularity} references

• {label/...} extraction from MAQL

  • Extracted with reference_type='label'
  • Validated against ldm_columns (type='attribute') since MAQL {label/id} uses attribute ID

Validation Logic

Entity	Reference Type	Validated Against
Metric	{metric/X}	metrics table
Metric	{attr/X}	ldm_columns (type='attribute')
Metric	{label/X}	ldm_columns (type='attribute')
Metric	{fact/X}	ldm_columns (type='fact')
Visualization	metric	metrics table
Visualization	fact	ldm_columns (type='fact')
Visualization	attribute	ldm_columns (type='attribute')
Visualization	label	ldm_labels table

Test plan

• All 172 existing tests pass
• New test_metrics_references.py with 24 tests covering:
  • Reference extraction for all types (metric, attribute, label, fact)
  • Self-reference exclusion
  • MAQL comment filtering
  • is_valid computation for local mode
  • Integration tests with full export pipeline

🤖 Generated with Claude Code