feat(schema-compiler): custom granularity support

[KSDaemon]

This PR brings custom granularity support into the Cube.

Now it is possible to define any number of custom granularities for time dimension. Custom granularity maybe specified in two forms:

• Interval + offset. You can look at this as a supercharged date_trunc version. This way you can define only intervals that are divisible by a year with no remainder (like for example2 months).
• Interval + origin point. This is the most flexible variant. You can choose any arbitrary interval (e.g. 2 months 3 weeks 4 days 12 hours) and set the origin pivot point for calculating intervals. Origin maybe specified in date or timestamp if needed.

A few examples:

.....
dimensions:
  - name: createdAt
    sql: created_at
    type: time
    granularities:
      - name: six_months
        interval: 6 months # no offset specified, meaning the start of the year
      - name: three_months_offset
        interval: 3 months
        offset: 2 weeks # the pivot point in this case will be 15 Jan
      - name: fiscal_year_1st_april
        interval: 1 year
        origin: >  # Note that as date includes dashes, you need to escape it with quotes or use `>` variant
          2024-04-01
      - name: timestamp_origin_example
        interval: 24 days
        origin: "2024-02-15 10:15:25"

What's else inside?

• Custom granularity support in YAML cube definitions
• Custom granularity cube scheme validation
• Custom granularity interval generation for rolling windows
• Custom granularity support in BaseQuery
• Custom granularity support for PostgeSQL
• Custom granularity support for MySQL
• Custom granularity support for BigQuery
• Custom granularity support for Databricks
• Custom granularity support for MS SQL Server
• Custom granularity support for Snowflake
• Custom granularity support for ClickHouse
• Custom granularity support for DuckDB

This PR probably closes #177 and partially #8488

Check List

• Tests have been run in packages where changes made if available
• Linter has been run for changed code
• Tests for the changes have been added if not covered yet
• Docs have been added / updated if required

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

8 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
examples-angular-dashboard	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-react-d3	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-react-dashboard	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-react-data-table	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-react-highcharts	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-react-material-ui	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-react-pivot-table	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm
examples-vue-query-builder	⬜️ Ignored (Inspect)	Visit Preview		Sep 12, 2024 3:16pm