Merge branch 'main' into ATSCALE-26548-review-model

Author: valentinemilov

sml-reference/dimension.md

@@ -29,7 +29,7 @@ SML supports the following types of dimensions:
 
 Sample `dimension` file:
 
-```
+```yaml
 unique_name: Store Dimension
 object_type: dimension
 label: Store Dimension
@@ -154,11 +154,14 @@ classDiagram
     Dimension *-- Hierarchy
     Dimension *-- LevelAttribute
     Dimension *-- CalculationGroup
+    Hierarchy *-- DefaultMember
     Hierarchy *-- Level
     LevelAttribute *-- CustomEmptyMember
+    LevelAttribute *-- SharedDegenerateColumns
     Level *-- SecondaryAttribute
     Level *-- MetricalAttribute
     Level *-- Alias
+    Level *-- ParallelPeriods
     CalculationGroup *-- CalculatedMembers
     SecondaryAttribute *-- CustomEmptyMember
     Alias *-- CustomEmptyMember
@@ -182,11 +185,12 @@ namespace Dimensions{
       Object to
       String role_play
       String type
-      Boolean m2m
     }
     class From{
       String dataset
-      Array~Column~ columns
+      Array~String~ join_columns
+      String hierarchy
+      String level
     }
     class To{
       String dimension
@@ -196,17 +200,22 @@ namespace Dimensions{
     class Hierarchy{
       String unique_name
       String label
+      String description
       String folder
       enum filter_empty
+      DefaultMember default_member
       Array~Level~ levels
     }
+    class DefaultMember{
+      String expression
+      Boolean apply_only_when_in_query
+    }
     class Level{
       String unique_name
-      String description
       Array~SecondaryAttribute~ secondary_attributes
       Array~Alias~ aliases
       Array~MetricalAttribute~ metrics
-      String default_member
+      Array~ParallelPeriods~ parallel_periods
       Boolean is_hidden
     }
     class Alias{
@@ -218,11 +227,11 @@ namespace Dimensions{
       String sort_column
       String folder
       Boolean is_hidden
+      String format
       Boolean exclude_from_dim_agg
+      Boolean is_aggregatable
       Boolean exclude_from_fact_agg
       Array~CustomEmptyMember~ custom_empty_member
-      Array~String~ allowed_calcs_for_dma
-      Object role
     }
     class MetricalAttribute{
       String unique_name
@@ -235,11 +244,16 @@ namespace Dimensions{
       String column
       Boolean is_hidden
       Boolean exclude_from_dim_agg
+      Boolean is_aggregatable
       Boolean exclude_from_fact_agg
       CustomEmptyMember custom_empty_member
       enum unrelated_dimensions_handling
       Array~String~ allowed_calcs_for_dma
     }
+    class ParallelPeriods{
+      String level
+      Array~String~ key_columns
+    }
     class LevelAttribute{
       String unique_name
       String label
@@ -252,9 +266,20 @@ namespace Dimensions{
       Boolean is_hidden
       Boolean is_unique_key
       Boolean exclude_from_dim_agg
+      Boolean is_aggregatable
       Boolean exclude_from_fact_agg
       String time_unit
       Array~String~ allowed_calcs_for_dma
+      CustomEmptyMember custom_empty_member
+      String folder
+      Array~SharedDegenerateColumns~ shared_degenerate_columns
+    }
+    class SharedDegenerateColumns {
+      String dataset
+      String name_column
+      String sort_column
+      Array~String~ key_columns
+      Boolean is_unique_key
     }
     class SecondaryAttribute{
       String unique_name
@@ -266,9 +291,12 @@ namespace Dimensions{
       String sort_column
       Array~String~ key_columns
       Boolean exclude_from_dim_agg
+      Boolean is_aggregatable
       Boolean exclude_from_fact_agg
       Array~String~ allowed_calcs_for_dma
-      Array~CustomEmptyMember~ custom_empty_member
+      CustomEmptyMember custom_empty_member
+      Boolean is_hidden
+      Boolean contains_unique_names
     }
     class CustomEmptyMember{
       Array~String~ key
@@ -288,6 +316,7 @@ namespace Dimensions{
       String format
       String expression
       Boolean use_input_metric_format
+      String template
     }
 }
 ```
@@ -325,14 +354,6 @@ need to be unique.
 
 A description of the dimension.
 
-## folder
-
-- **Type:** string
-- **Required:** N
-
-The name of the folder in which the calculation group appears in BI
-tools.
-
 ## type
 
 - **Type:** enum
@@ -345,6 +366,13 @@ Supported values:
 - `standard`: Can have any type of hierarchy.
 - `time`: Must have a time hierarchy.
 
+## is_degenerate
+
+- **Type:** boolean
+- **Required:** N
+
+Determines whether the dimension is degenerate. 
+
 ## hierarchies
 
 - **Type:** array
@@ -513,6 +541,13 @@ Defines the individual calculated members in the group.
 
 A description of the calculation group.
 
+## folder
+
+- **Type:** string
+- **Required:** N
+
+The name of the folder in which the calculation group is displayed in BI tools.
+
 # Calculated Members Properties
 
 ## unique_name
@@ -706,6 +741,13 @@ For levels in time dimensions only. Defines a custom parallel period for the lev
 
 You can define as many parallel periods for a level as needed.
 
+## is_hidden
+
+- **Type:** boolean
+- **Required:** N
+
+Determines whether the level is visible in BI tools. 
+
 # Secondary Attributes Properties
 
 ## unique_name
@@ -818,7 +860,7 @@ Excludes this attribute from system generated fact-based aggregates. This is use
 
 ## custom\_empty\_member
 
-- **Type:** array
+- **Type:** object
 - **Required:** N
 
 Defines a custom empty member for the attribute. This feature allows fact data with missing or invalid foreign key values to be isolated and independently aggregated from those with valid foreign key values. Because fact records with invalid foreign keys are aggregated separately from records referencing valid dimension members, analysts can easily spot data integrity problems and further investigate them. Use this feature to ensure that un-joinable values are included in query results and aggregated under a specially designated dimension member called the Custom Empty Member.
@@ -1176,7 +1218,7 @@ Supported properties:
 
 For example:
 
-```
+```yaml
 level_attributes:
 
   - unique_name: Order Degen Shared Level
@@ -1335,7 +1377,7 @@ A list of the empty member values to use for key fields.
 
 The empty member value to use for name fields.
 
-## sort
+## sort_name
 
 - **Type:** string
 - **Required:** N