feat: add support for native totals

Properly support the native totals in executions and in tables.

JIRA: CQ-633
risk: low

Author: no23reason

gooddata-sdk/gooddata_sdk/compute/model/execution.py

@@ -33,7 +33,7 @@ class TotalDefinition:
     """total's local identifier"""
 
     aggregation: str
-    """aggregation function; case insensitive; one of SUM, MIN, MAX, MED, AVG"""
+    """aggregation function; case insensitive; one of SUM, MIN, MAX, MED, AVG, NAT"""
 
     metric_local_id: str
     """local identifier of the measure to calculate total for"""
@@ -175,13 +175,20 @@ def _create_totals(self) -> Optional[list[models.Total]]:
                 models.Total(
                     local_identifier=total.local_id,
                     metric=total.metric_local_id,
-                    function=total.aggregation.upper(),
+                    function=ExecutionDefinition._convert_total_aggregation(total.aggregation),
                     total_dimensions=total_dims,
                 )
             )
 
         return totals
 
+    @staticmethod
+    def _convert_total_aggregation(aggregation: str) -> str:
+        # native total is represented as NAT in visualization objects, but needs to be NATIVE in execution
+        if aggregation.upper() == "NAT":
+            return "NATIVE"
+        return aggregation.upper()
+
     def _create_result_spec(self) -> models.ResultSpec:
         dimensions = self._create_dimensions()
         totals = self._create_totals()

gooddata-sdk/gooddata_sdk/table.py

@@ -38,7 +38,7 @@
 logger = logging.getLogger(__name__)
 
 _MEASURE_GROUP_IDENTIFIER = "measureGroup"
-_TOTAL_ORDER = ["SUM", "MAX", "MIN", "AVG", "MED"]
+_TOTAL_ORDER = ["SUM", "MAX", "MIN", "AVG", "MED", "NAT"]
 
 _TABLE_ROW_BATCH_SIZE = 512
 """