semantic-link-labs 0.8.9__py3-none-any.whl → 0.8.11__py3-none-any.whl

sempy_labs/_refresh_semantic_model.py

@@ -1,10 +1,10 @@
 import sempy.fabric as fabric
 import time
 from sempy_labs._helper_functions import (
-    resolve_dataset_id,
     resolve_workspace_name_and_id,
     _get_partition_map,
     _process_and_display_chart,
+    resolve_dataset_name_and_id,
 )
 from typing import Any, List, Optional, Union
 from sempy._utils._log import log
@@ -14,18 +14,19 @@ import pandas as pd
 import warnings
 import ipywidgets as widgets
 import json
+from uuid import UUID
 
 
 @log
 def refresh_semantic_model(
-    dataset: str,
+    dataset: str | UUID,
     tables: Optional[Union[str, List[str]]] = None,
     partitions: Optional[Union[str, List[str]]] = None,
     refresh_type: str = "full",
     retry_count: int = 0,
     apply_refresh_policy: bool = True,
     max_parallelism: int = 10,
-    workspace: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
     visualize: bool = False,
     commit_mode: str = "transactional",
 ) -> pd.DataFrame | None:
@@ -34,8 +35,8 @@ def refresh_semantic_model(
 
     Parameters
     ----------
-    dataset : str
-        Name of the semantic model.
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
     tables : str, List[str], default=None
         A string or a list of tables to refresh.
     partitions: str, List[str], default=None
@@ -50,8 +51,8 @@ def refresh_semantic_model(
         Determines the maximum number of threads that can run the processing commands in parallel.
         This value aligns with the MaxParallelism property that can be set in the TMSL Sequence command or by using other methods.
         Defaults to 10.
-    workspace : str, default=None
-        The Fabric workspace name.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     visualize : bool, default=False
@@ -65,7 +66,8 @@ def refresh_semantic_model(
         If 'visualize' is set to True, returns a pandas dataframe showing the SSAS trace output used to generate the visualization.
     """
 
-    workspace = fabric.resolve_workspace_name(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(dataset, workspace_id)
 
     if isinstance(tables, str):
         tables = [tables]
@@ -118,11 +120,11 @@ def refresh_semantic_model(
         def extract_failure_error():
             error_messages = []
             combined_messages = ""
-            final_message = f"{icons.red_dot} The refresh of the '{dataset}' semantic model within the '{workspace}' workspace has failed."
+            final_message = f"{icons.red_dot} The refresh of the '{dataset_name}' semantic model within the '{workspace_name}' workspace has failed."
             for _, r in fabric.get_refresh_execution_details(
                 refresh_request_id=request_id,
-                dataset=dataset,
-                workspace=workspace,
+                dataset=dataset_id,
+                workspace=workspace_id,
             ).messages.iterrows():
                 error_messages.append(f"{r['Type']}: {r['Message']}")
 
@@ -135,8 +137,8 @@ def refresh_semantic_model(
         # Function to perform dataset refresh
         def refresh_dataset():
             return fabric.refresh_dataset(
-                dataset=dataset,
-                workspace=workspace,
+                dataset=dataset_id,
+                workspace=workspace_id,
                 refresh_type=refresh_type,
                 retry_count=retry_count,
                 apply_refresh_policy=apply_refresh_policy,
@@ -147,7 +149,9 @@ def refresh_semantic_model(
 
         def check_refresh_status(request_id):
             request_details = fabric.get_refresh_execution_details(
-                dataset=dataset, refresh_request_id=request_id, workspace=workspace
+                dataset=dataset_id,
+                refresh_request_id=request_id,
+                workspace=workspace_id,
             )
             return request_details.status
 
@@ -169,7 +173,8 @@ def refresh_semantic_model(
                     right_on="PartitionID",
                     how="left",
                 )
-                _process_and_display_chart(df, title=title, widget=widget)
+                if not df.empty:
+                    _process_and_display_chart(df, title=title, widget=widget)
                 if stop:
                     df.drop(["Object Name", "PartitionID"], axis=1, inplace=True)
                     df.rename(columns={"TableName": "Table Name"}, inplace=True)
@@ -180,7 +185,7 @@ def refresh_semantic_model(
         if not visualize:
             request_id = refresh_dataset()
         print(
-            f"{icons.in_progress} Refresh of the '{dataset}' semantic model within the '{workspace}' workspace is in progress..."
+            f"{icons.in_progress} Refresh of the '{dataset_name}' semantic model within the '{workspace_name}' workspace is in progress..."
         )
 
         # Monitor refresh progress and handle tracing if visualize is enabled
@@ -189,7 +194,7 @@ def refresh_semantic_model(
             widget = widgets.Output()
 
             with fabric.create_trace_connection(
-                dataset=dataset, workspace=workspace
+                dataset=dataset_id, workspace=workspace_id
             ) as trace_connection:
                 with trace_connection.create_trace(icons.refresh_event_schema) as trace:
                     trace.start()
@@ -204,7 +209,7 @@ def refresh_semantic_model(
                             raise ValueError(extract_failure_error())
                         elif status == "Cancelled":
                             print(
-                                f"{icons.yellow_dot} The refresh of the '{dataset}' semantic model within the '{workspace}' workspace has been cancelled."
+                                f"{icons.yellow_dot} The refresh of the '{dataset_name}' semantic model within the '{workspace_name}' workspace has been cancelled."
                             )
                             return
 
@@ -231,7 +236,7 @@ def refresh_semantic_model(
                     )
 
                     print(
-                        f"{icons.green_dot} Refresh '{refresh_type}' of the '{dataset}' semantic model within the '{workspace}' workspace is complete."
+                        f"{icons.green_dot} Refresh '{refresh_type}' of the '{dataset_name}' semantic model within the '{workspace_name}' workspace is complete."
                     )
                     return final_df
 
@@ -245,14 +250,14 @@ def refresh_semantic_model(
                     raise ValueError(extract_failure_error())
                 elif status == "Cancelled":
                     print(
-                        f"{icons.yellow_dot} The refresh of the '{dataset}' semantic model within the '{workspace}' workspace has been cancelled."
+                        f"{icons.yellow_dot} The refresh of the '{dataset_name}' semantic model within the '{workspace_name}' workspace has been cancelled."
                     )
                     return
 
                 time.sleep(3)
 
             print(
-                f"{icons.green_dot} Refresh '{refresh_type}' of the '{dataset}' semantic model within the '{workspace}' workspace is complete."
+                f"{icons.green_dot} Refresh '{refresh_type}' of the '{dataset_name}' semantic model within the '{workspace_name}' workspace is complete."
             )
 
     final_output = refresh_and_trace_dataset(
@@ -272,39 +277,40 @@ def refresh_semantic_model(
 
 @log
 def cancel_dataset_refresh(
-    dataset: str, request_id: Optional[str] = None, workspace: Optional[str] = None
+    dataset: str | UUID,
+    request_id: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
 ):
     """
     Cancels the refresh of a semantic model which was executed via the `Enhanced Refresh API <https://learn.microsoft.com/power-bi/connect-data/asynchronous-refresh>`_
 
     Parameters
     ----------
-    dataset : str
-        Name of the semantic model.
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
     request_id : str, default=None
         The request id of a semantic model refresh.
         Defaults to finding the latest active refresh of the semantic model.
-    workspace : str, default=None
-        The Fabric workspace name.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(dataset, workspace_id)
 
-    rr = fabric.list_refresh_requests(dataset=dataset, workspace=workspace)
+    rr = fabric.list_refresh_requests(dataset=dataset_id, workspace=workspace_id)
     rr_filt = rr[rr["Status"] == "Unknown"]
 
     if request_id is None:
         if len(rr_filt) == 0:
             raise ValueError(
-                f"{icons.red_dot} There are no active Enhanced API refreshes of the '{dataset}' semantic model within the '{workspace}' workspace."
+                f"{icons.red_dot} There are no active Enhanced API refreshes of the '{dataset_name}' semantic model within the '{workspace_name}' workspace."
             )
 
         request_id = rr_filt["Request Id"].iloc[0]
 
-    dataset_id = resolve_dataset_id(dataset=dataset, workspace=workspace)
-
     client = fabric.PowerBIRestClient()
 
     response = client.delete(
@@ -314,12 +320,14 @@ def cancel_dataset_refresh(
     if response.status_code != 200:
         raise FabricHTTPException(response)
     print(
-        f"{icons.green_dot} The '{request_id}' refresh request for the '{dataset}' semantic model within the '{workspace}' workspace has been cancelled."
+        f"{icons.green_dot} The '{request_id}' refresh request for the '{dataset_name}' semantic model within the '{workspace_name}' workspace has been cancelled."
     )
 
 
 def get_semantic_model_refresh_history(
-    dataset: str, request_id: Optional[str] = None, workspace: Optional[str] = None
+    dataset: str | UUID,
+    request_id: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
 ) -> pd.DataFrame:
     """
     Obtains the semantic model refresh history (refreshes executed via the Enhanced Refresh API).
@@ -328,13 +336,13 @@ def get_semantic_model_refresh_history(
 
     Parameters
     ----------
-    dataset : str
-        Name of the semantic model.
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
     request_id : str, default=None
         The request id of a semantic model refresh.
         Defaults to None which resolves to showing all refresh requests for the given semantic model.
-    workspace : str, default=None
-        The Fabric workspace name.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
 
@@ -344,8 +352,8 @@ def get_semantic_model_refresh_history(
         A pandas dataframe showing the semantic model refresh history.
     """
 
-    workspace_name = fabric.resolve_workspace_name(workspace)
-    workspace_id = fabric.resolve_workspace_id(workspace_name)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(dataset, workspace_id)
     df = pd.DataFrame(
         columns=[
             "Request Id",
@@ -357,9 +365,6 @@ def get_semantic_model_refresh_history(
         ]
     )
 
-    dataset_id = fabric.resolve_item_id(
-        item_name=dataset, workspace=workspace_id, type="SemanticModel"
-    )
     client = fabric.PowerBIRestClient()
     response = client.get(
         f"/v1.0/myorg/groups/{workspace_id}/datasets/{dataset_id}/refreshes"

sempy_labs/_spark.py

@@ -6,9 +6,10 @@ from sempy_labs._helper_functions import (
     resolve_workspace_name_and_id,
 )
 from sempy.fabric.exceptions import FabricHTTPException
+from uuid import UUID
 
 
-def list_custom_pools(workspace: Optional[str] = None) -> pd.DataFrame:
+def list_custom_pools(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Lists all `custom pools <https://learn.microsoft.com/fabric/data-engineering/create-custom-spark-pools>`_ within a workspace.
 
@@ -16,7 +17,7 @@ def list_custom_pools(workspace: Optional[str] = None) -> pd.DataFrame:
 
     Parameters
     ----------
-    workspace : str, default=None
+    workspace : str | uuid.UUID, default=None
         The name of the Fabric workspace.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
@@ -27,7 +28,7 @@ def list_custom_pools(workspace: Optional[str] = None) -> pd.DataFrame:
         A pandas dataframe showing all the custom pools within the Fabric workspace.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     df = pd.DataFrame(
         columns=[
@@ -95,7 +96,7 @@ def create_custom_pool(
     node_family: str = "MemoryOptimized",
     auto_scale_enabled: bool = True,
     dynamic_executor_allocation_enabled: bool = True,
-    workspace: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
 ):
     """
     Creates a `custom pool <https://learn.microsoft.com/fabric/data-engineering/create-custom-spark-pools>`_ within a workspace.
@@ -122,13 +123,13 @@ def create_custom_pool(
         The status of `auto scale <https://learn.microsoft.com/rest/api/fabric/spark/custom-pools/create-workspace-custom-pool?tabs=HTTP#autoscaleproperties>`_.
     dynamic_executor_allocation_enabled : bool, default=True
         The status of the `dynamic executor allocation <https://learn.microsoft.com/en-us/rest/api/fabric/spark/custom-pools/create-workspace-custom-pool?tabs=HTTP#dynamicexecutorallocationproperties>`_.
-    workspace : str, default=None
-        The name of the Fabric workspace.
+    workspace : str | uuid.UUID, default=None
+        The name or ID of the Fabric workspace.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     request_body = {
         "name": pool_name,
@@ -154,7 +155,7 @@ def create_custom_pool(
     if response.status_code != 201:
         raise FabricHTTPException(response)
     print(
-        f"{icons.green_dot} The '{pool_name}' spark pool has been created within the '{workspace}' workspace."
+        f"{icons.green_dot} The '{pool_name}' spark pool has been created within the '{workspace_name}' workspace."
     )
 
 
@@ -168,7 +169,7 @@ def update_custom_pool(
     node_family: Optional[str] = None,
     auto_scale_enabled: Optional[bool] = None,
     dynamic_executor_allocation_enabled: Optional[bool] = None,
-    workspace: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
 ):
     """
     Updates the properties of a `custom pool <https://learn.microsoft.com/fabric/data-engineering/create-custom-spark-pools>`_ within a workspace.
@@ -203,20 +204,20 @@ def update_custom_pool(
     dynamic_executor_allocation_enabled : bool, default=None
         The status of the `dynamic executor allocation <https://learn.microsoft.com/en-us/rest/api/fabric/spark/custom-pools/create-workspace-custom-pool?tabs=HTTP#dynamicexecutorallocationproperties>`_.
         Defaults to None which keeps the existing property setting.
-    workspace : str, default=None
-        The name of the Fabric workspace.
+    workspace : str | uuid.UUID, default=None
+        The name or ID of the Fabric workspace.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     df = list_custom_pools(workspace=workspace)
     df_pool = df[df["Custom Pool Name"] == pool_name]
 
     if len(df_pool) == 0:
         raise ValueError(
-            f"{icons.red_dot} The '{pool_name}' custom pool does not exist within the '{workspace}'. Please choose a valid custom pool."
+            f"{icons.red_dot} The '{pool_name}' custom pool does not exist within the '{workspace_name}'. Please choose a valid custom pool."
         )
 
     if node_family is None:
@@ -262,11 +263,11 @@ def update_custom_pool(
     if response.status_code != 200:
         raise FabricHTTPException(response)
     print(
-        f"{icons.green_dot} The '{pool_name}' spark pool within the '{workspace}' workspace has been updated."
+        f"{icons.green_dot} The '{pool_name}' spark pool within the '{workspace_name}' workspace has been updated."
     )
 
 
-def delete_custom_pool(pool_name: str, workspace: Optional[str] = None):
+def delete_custom_pool(pool_name: str, workspace: Optional[str | UUID] = None):
     """
     Deletes a `custom pool <https://learn.microsoft.com/fabric/data-engineering/create-custom-spark-pools>`_ within a workspace.
 
@@ -276,35 +277,35 @@ def delete_custom_pool(pool_name: str, workspace: Optional[str] = None):
     ----------
     pool_name : str
         The custom pool name.
-    workspace : str, default=None
-        The name of the Fabric workspace.
+    workspace : str | uuid.UUID, default=None
+        The name or ID of the Fabric workspace.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
-    dfL = list_custom_pools(workspace=workspace)
+    dfL = list_custom_pools(workspace=workspace_id)
     dfL_filt = dfL[dfL["Custom Pool Name"] == pool_name]
 
     if len(dfL_filt) == 0:
         raise ValueError(
-            f"{icons.red_dot} The '{pool_name}' custom pool does not exist within the '{workspace}' workspace."
+            f"{icons.red_dot} The '{pool_name}' custom pool does not exist within the '{workspace_name}' workspace."
         )
-    poolId = dfL_filt["Custom Pool ID"].iloc[0]
+    pool_id = dfL_filt["Custom Pool ID"].iloc[0]
 
     client = fabric.FabricRestClient()
-    response = client.delete(f"/v1/workspaces/{workspace_id}/spark/pools/{poolId}")
+    response = client.delete(f"/v1/workspaces/{workspace_id}/spark/pools/{pool_id}")
 
     if response.status_code != 200:
         raise FabricHTTPException(response)
     print(
-        f"{icons.green_dot} The '{pool_name}' spark pool has been deleted from the '{workspace}' workspace."
+        f"{icons.green_dot} The '{pool_name}' spark pool has been deleted from the '{workspace_name}' workspace."
     )
 
 
 def get_spark_settings(
-    workspace: Optional[str] = None, return_dataframe: bool = True
+    workspace: Optional[str | UUID] = None, return_dataframe: bool = True
 ) -> pd.DataFrame | dict:
     """
     Shows the spark settings for a workspace.
@@ -313,8 +314,8 @@ def get_spark_settings(
 
     Parameters
     ----------
-    workspace : str, default=None
-        The name of the Fabric workspace.
+    workspace : str | uuid.UUID, default=None
+        The name or ID of the Fabric workspace.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     return_dataframe : bool, default=True
@@ -326,7 +327,7 @@ def get_spark_settings(
         A pandas dataframe showing the spark settings for a workspace.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     df = pd.DataFrame(
         columns=[
@@ -393,7 +394,7 @@ def update_spark_settings(
     max_executors: Optional[int] = None,
     environment_name: Optional[str] = None,
     runtime_version: Optional[str] = None,
-    workspace: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
 ):
     """
     Updates the spark settings for a workspace.
@@ -426,13 +427,13 @@ def update_spark_settings(
     runtime_version : str, default=None
         The `runtime version <https://learn.microsoft.com/rest/api/fabric/spark/workspace-settings/update-spark-settings?tabs=HTTP#environmentproperties>`_.
         Defaults to None which keeps the existing property setting.
-    workspace : str, default=None
-        The name of the Fabric workspace.
+    workspace : str | uuid.UUID, default=None
+        The name or ID of the Fabric workspace.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     request_body = get_spark_settings(workspace=workspace, return_dataframe=False)
 
@@ -463,5 +464,5 @@ def update_spark_settings(
     if response.status_code != 200:
         raise FabricHTTPException(response)
     print(
-        f"{icons.green_dot} The spark settings within the '{workspace}' workspace have been updated accordingly."
+        f"{icons.green_dot} The spark settings within the '{workspace_name}' workspace have been updated accordingly."
     )

sempy_labs/_sql.py

@@ -3,10 +3,14 @@ import pandas as pd
 from typing import Optional, Union, List
 from sempy._utils._log import log
 import struct
-import uuid
 from itertools import chain, repeat
 from sempy.fabric.exceptions import FabricHTTPException
-from sempy_labs._helper_functions import resolve_warehouse_id, resolve_lakehouse_id
+from sempy_labs._helper_functions import (
+    resolve_warehouse_id,
+    resolve_lakehouse_id,
+    resolve_workspace_name_and_id,
+)
+from uuid import UUID
 
 
 def _bytes2mswin_bstr(value: bytes) -> bytes:
@@ -32,21 +36,20 @@ class ConnectBase:
     def __init__(
         self,
         name: str,
-        workspace: Optional[Union[str, uuid.UUID]] = None,
+        workspace: Optional[Union[str, UUID]] = None,
         timeout: Optional[int] = None,
         endpoint_type: str = "warehouse",
     ):
         from sempy.fabric._token_provider import SynapseTokenProvider
         import pyodbc
 
-        workspace = fabric.resolve_workspace_name(workspace)
-        workspace_id = fabric.resolve_workspace_id(workspace)
+        (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
 
         # Resolve the appropriate ID (warehouse or lakehouse)
         if endpoint_type == "warehouse":
-            resource_id = resolve_warehouse_id(warehouse=name, workspace=workspace)
+            resource_id = resolve_warehouse_id(warehouse=name, workspace=workspace_id)
         else:
-            resource_id = resolve_lakehouse_id(lakehouse=name, workspace=workspace)
+            resource_id = resolve_lakehouse_id(lakehouse=name, workspace=workspace_id)
 
         # Get the TDS endpoint
         client = fabric.FabricRestClient()
@@ -139,7 +142,7 @@ class ConnectWarehouse(ConnectBase):
     def __init__(
         self,
         warehouse: str,
-        workspace: Optional[Union[str, uuid.UUID]] = None,
+        workspace: Optional[Union[str, UUID]] = None,
         timeout: Optional[int] = None,
     ):
         super().__init__(
@@ -154,7 +157,7 @@ class ConnectLakehouse(ConnectBase):
     def __init__(
         self,
         lakehouse: str,
-        workspace: Optional[Union[str, uuid.UUID]] = None,
+        workspace: Optional[Union[str, UUID]] = None,
         timeout: Optional[int] = None,
     ):
         super().__init__(

sempy_labs/_translations.py

@@ -3,29 +3,32 @@ import pandas as pd
 from typing import List, Optional, Union
 from sempy._utils._log import log
 import sempy_labs._icons as icons
-from sempy_labs._helper_functions import get_language_codes
+from sempy_labs._helper_functions import (
+    get_language_codes,
+)
+from uuid import UUID
 
 
 @log
 def translate_semantic_model(
-    dataset: str,
+    dataset: str | UUID,
     languages: Union[str, List[str]],
     exclude_characters: Optional[str] = None,
-    workspace: Optional[str] = None,
+    workspace: Optional[str | UUID] = None,
 ) -> pd.DataFrame:
     """
     Translates names, descriptions, display folders for all objects in a semantic model.
 
     Parameters
     ----------
-    dataset : str
-        Name of the semantic model.
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
     languages : str, List[str]
         The language code(s) in which to translate the semantic model.
     exclude_characters : str
         A string specifying characters which will be replaced by a space in the translation text when sent to the translation service.
-    workspace : str, default=None
-        The Fabric workspace name.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.