semantic-link-labs 0.10.1__py3-none-any.whl → 0.11.0__py3-none-any.whl

sempy_labs/admin/__init__.py

@@ -6,6 +6,7 @@ from sempy_labs.admin._workspaces import (
     add_user_to_workspace,
     delete_user_from_workspace,
     restore_deleted_workspace,
+    list_orphaned_workspaces,
 )
 from sempy_labs.admin._artifacts import (
     list_unused_artifacts,
@@ -139,6 +140,7 @@ __all__ = [
     "add_user_to_workspace",
     "delete_user_from_workspace",
     "restore_deleted_workspace",
+    "list_orphaned_workspaces",
     "list_capacity_users",
     "list_user_subscriptions",
     "list_report_subscriptions",

sempy_labs/admin/_activities.py

@@ -107,6 +107,8 @@ def list_activity_events(
 
     responses = _base_api(request=url, client="fabric_sp", uses_pagination=True)
 
+    dfs = []
+
     for r in responses:
         if return_dataframe:
             for i in r.get("activityEventEntities", []):
@@ -150,17 +152,16 @@ def list_activity_events(
                     "Consumption Method": i.get("ConsumptionMethod"),
                     "Artifact Kind": i.get("ArtifactKind"),
                 }
-                df = pd.concat(
-                    [df, pd.DataFrame(new_data, index=[0])],
-                    ignore_index=True,
-                )
+                dfs.append(pd.DataFrame(new_data, index=[0]))
         else:
             response_json["activityEventEntities"].extend(
                 r.get("activityEventEntities")
             )
 
     if return_dataframe:
-        _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        if dfs:
+            df = pd.concat(dfs, ignore_index=True)
+            _update_dataframe_datatypes(dataframe=df, column_map=columns)
         return df
     else:
         return response_json

sempy_labs/admin/_apps.py

@@ -9,8 +9,10 @@ from sempy_labs._helper_functions import (
 )
 from uuid import UUID
 import sempy_labs._icons as icons
+from sempy._utils._log import log
 
 
+@log
 def list_apps(
     top: Optional[int] = 1000,
     skip: Optional[int] = None,
@@ -56,26 +58,25 @@ def list_apps(
     url = _build_url(url, params)
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "App Name": v.get("name"),
-                "App Id": v.get("id"),
-                "Description": v.get("description"),
-                "Published By": v.get("publishedBy"),
-                "Last Update": v.get("lastUpdate"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "App Name": v.get("name"),
+            "App Id": v.get("id"),
+            "Description": v.get("description"),
+            "Published By": v.get("publishedBy"),
+            "Last Update": v.get("lastUpdate"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def _resolve_app_id(app: str | UUID) -> str:
     if _is_valid_uuid(app):
         return app
@@ -87,6 +88,7 @@ def _resolve_app_id(app: str | UUID) -> str:
         return df_filt["App Id"].iloc[0]
 
 
+@log
 def list_app_users(app: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified app.
@@ -122,22 +124,20 @@ def list_app_users(app: str | UUID) -> pd.DataFrame:
     url = f"/v1.0/myorg/admin/apps/{app_id}/users"
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "User Name": v.get("displayName"),
-                "Email Address": v.get("emailAddress"),
-                "App User Access Right": v.get("appUserAccessRight"),
-                "Identifier": v.get("identifier"),
-                "Graph Id": v.get("graphId"),
-                "Principal Type": v.get("principalType"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "User Name": v.get("displayName"),
+            "Email Address": v.get("emailAddress"),
+            "App User Access Right": v.get("appUserAccessRight"),
+            "Identifier": v.get("identifier"),
+            "Graph Id": v.get("graphId"),
+            "Principal Type": v.get("principalType"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df

sempy_labs/admin/_artifacts.py

@@ -9,8 +9,10 @@ from sempy_labs.admin._basic_functions import (
     _create_dataframe,
     _update_dataframe_datatypes,
 )
+from sempy._utils._log import log
 
 
+@log
 def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Returns a list of datasets, reports, and dashboards that have not been used within 30 days for the specified workspace.
@@ -25,7 +27,7 @@ def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFram
         A pandas dataframe showing a list of datasets, reports, and dashboards that have not been used within 30 days for the specified workspace.
     """
 
-    (workspace_name, workspace_id) = _resolve_workspace_name_and_id(workspace)
+    (_, workspace_id) = _resolve_workspace_name_and_id(workspace)
 
     columns = {
         "Artifact Name": "string",
@@ -44,6 +46,7 @@ def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFram
         uses_pagination=True,
     )
 
+    dfs = []
     for r in responses:
         for i in r.get("unusedArtifactEntities", []):
             new_data = {
@@ -55,8 +58,10 @@ def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFram
                 "Last Accessed Date Time": i.get("lastAccessedDateTime"),
             }
 
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+            dfs.append(pd.DataFrame(new_data, index=[0]))
 
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df

sempy_labs/admin/_basic_functions.py

@@ -249,6 +249,7 @@ def unassign_workspaces_from_capacity(
     )
 
 
+@log
 def list_modified_workspaces(
     modified_since: Optional[str] = None,
     exclude_inactive_workspaces: Optional[bool] = False,
@@ -298,6 +299,7 @@ def list_modified_workspaces(
     return df
 
 
+@log
 def list_workspace_access_details(
     workspace: Optional[Union[str, UUID]] = None,
 ) -> pd.DataFrame:
@@ -350,6 +352,7 @@ def list_workspace_access_details(
     return df
 
 
+@log
 def _resolve_workspace_name(workspace_id: Optional[UUID] = None) -> str:
     from sempy_labs._helper_functions import _get_fabric_context_setting
     from sempy.fabric.exceptions import FabricHTTPException
@@ -372,6 +375,7 @@ def _resolve_workspace_name(workspace_id: Optional[UUID] = None) -> str:
     return workspace_name
 
 
+@log
 def _resolve_workspace_name_and_id(
     workspace: str | UUID,
 ) -> Tuple[str, UUID]:
@@ -397,6 +401,7 @@ def _resolve_workspace_name_and_id(
     return workspace_name, workspace_id
 
 
+@log
 def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified workspace.

sempy_labs/admin/_capacities.py

@@ -13,6 +13,7 @@ from sempy_labs._helper_functions import (
 )
 
 
+@log
 def patch_capacity(capacity: str | UUID, tenant_key_id: UUID):
     """
     Changes specific capacity information. Currently, this API call only supports changing the capacity's encryption key.
@@ -44,6 +45,7 @@ def patch_capacity(capacity: str | UUID, tenant_key_id: UUID):
     )
 
 
+@log
 def _resolve_capacity_name_and_id(
     capacity: str | UUID,
 ) -> Tuple[str, UUID]:
@@ -58,6 +60,7 @@ def _resolve_capacity_name_and_id(
     return capacity_name, capacity_id
 
 
+@log
 def _resolve_capacity_id(
     capacity: str | UUID,
 ) -> UUID:
@@ -76,6 +79,7 @@ def _resolve_capacity_id(
     return capacity_id
 
 
+@log
 def _list_capacities_meta() -> pd.DataFrame:
     """
     Shows the a list of capacities and their properties. This function is the admin version.
@@ -102,6 +106,7 @@ def _list_capacities_meta() -> pd.DataFrame:
         request="/v1.0/myorg/admin/capacities", client="fabric_sp", uses_pagination=True
     )
 
+    dfs = []
     for r in responses:
         for i in r.get("value", []):
             new_data = {
@@ -112,11 +117,15 @@ def _list_capacities_meta() -> pd.DataFrame:
                 "State": i.get("state"),
                 "Admins": [i.get("admins", [])],
             }
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+            dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     return df
 
 
+@log
 def get_capacity_assignment_status(
     workspace: Optional[str | UUID] = None,
 ) -> pd.DataFrame:
@@ -178,6 +187,7 @@ def get_capacity_assignment_status(
     return df
 
 
+@log
 def get_capacity_state(capacity: Optional[str | UUID] = None):
     """
     Gets the state of a capacity.
@@ -248,6 +258,7 @@ def list_capacities(
         request="/v1.0/myorg/admin/capacities", client="fabric_sp", uses_pagination=True
     )
 
+    dfs = []
     for r in responses:
         for i in r.get("value", []):
             new_data = {
@@ -258,7 +269,10 @@ def list_capacities(
                 "State": i.get("state"),
                 "Admins": [i.get("admins", [])],
             }
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+            dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     if capacity is not None:
         if _is_valid_uuid(capacity):
@@ -269,6 +283,7 @@ def list_capacities(
     return df
 
 
+@log
 def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified workspace.
@@ -288,7 +303,7 @@ def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
         A pandas dataframe showing a list of users that have access to the specified workspace.
     """
 
-    (capacity_name, capacity_id) = _resolve_capacity_name_and_id(capacity)
+    (_, capacity_id) = _resolve_capacity_name_and_id(capacity)
 
     columns = {
         "User Name": "string",
@@ -307,25 +322,23 @@ def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
         request=f"/v1.0/myorg/admin/capacities/{capacity_id}/users", client="fabric_sp"
     )
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "User Name": v.get("displayName"),
-                "Email Address": v.get("emailAddress"),
-                "Capacity User Access Right": v.get("capacityUserAccessRight"),
-                "Identifier": v.get("identifier"),
-                "Graph Id": v.get("graphId"),
-                "Principal Type": v.get("principalType"),
-                "User Type": v.get("userType"),
-                "Profile": v.get("profile"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
+        new_data = {
+            "User Name": v.get("displayName"),
+            "Email Address": v.get("emailAddress"),
+            "Capacity User Access Right": v.get("capacityUserAccessRight"),
+            "Identifier": v.get("identifier"),
+            "Graph Id": v.get("graphId"),
+            "Principal Type": v.get("principalType"),
+            "User Type": v.get("userType"),
+            "Profile": v.get("profile"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
 
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
@@ -419,11 +432,10 @@ def get_refreshables(
 
     url = _build_url(url, params)
 
-    responses = _base_api(request=url, client="fabric_sp")
+    response = _base_api(request=url, client="fabric_sp")
 
-    refreshables = []
-
-    for i in responses.json().get("value", []):
+    dfs = []
+    for i in response.json().get("value", []):
         last_refresh = i.get("lastRefresh", {})
         refresh_schedule = i.get("refreshSchedule", {})
         new_data = {
@@ -461,11 +473,10 @@ def get_refreshables(
             "Refresh Schedule Notify Option": refresh_schedule.get("notifyOption"),
             "Configured By": i.get("configuredBy"),
         }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
 
-        refreshables.append(new_data)
-
-    if len(refreshables) > 0:
-        df = pd.DataFrame(refreshables)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
         _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df

sempy_labs/admin/_datasets.py

@@ -9,8 +9,10 @@ from sempy_labs._helper_functions import (
 )
 from uuid import UUID
 import sempy_labs._icons as icons
+from sempy._utils._log import log
 
 
+@log
 def list_datasets(
     top: Optional[int] = None,
     filter: Optional[str] = None,
@@ -77,46 +79,45 @@ def list_datasets(
     url = _build_url(url, params)
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "Dataset Id": v.get("id"),
-                "Dataset Name": v.get("name"),
-                "Web URL": v.get("webUrl"),
-                "Add Rows API Enabled": v.get("addRowsAPIEnabled"),
-                "Configured By": v.get("configuredBy"),
-                "Is Refreshable": v.get("isRefreshable"),
-                "Is Effective Identity Required": v.get("isEffectiveIdentityRequired"),
-                "Is Effective Identity Roles Required": v.get(
-                    "isEffectiveIdentityRolesRequired"
-                ),
-                "Target Storage Mode": v.get("targetStorageMode"),
-                "Created Date": pd.to_datetime(v.get("createdDate")),
-                "Content Provider Type": v.get("contentProviderType"),
-                "Create Report Embed URL": v.get("createReportEmbedURL"),
-                "QnA Embed URL": v.get("qnaEmbedURL"),
-                "Upstream Datasets": v.get("upstreamDatasets", []),
-                "Users": v.get("users", []),
-                "Is In Place Sharing Enabled": v.get("isInPlaceSharingEnabled"),
-                "Workspace Id": v.get("workspaceId"),
-                "Auto Sync Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
-                    "autoSyncReadOnlyReplicas"
-                ),
-                "Max Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
-                    "maxReadOnlyReplicas"
-                ),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "Dataset Id": v.get("id"),
+            "Dataset Name": v.get("name"),
+            "Web URL": v.get("webUrl"),
+            "Add Rows API Enabled": v.get("addRowsAPIEnabled"),
+            "Configured By": v.get("configuredBy"),
+            "Is Refreshable": v.get("isRefreshable"),
+            "Is Effective Identity Required": v.get("isEffectiveIdentityRequired"),
+            "Is Effective Identity Roles Required": v.get(
+                "isEffectiveIdentityRolesRequired"
+            ),
+            "Target Storage Mode": v.get("targetStorageMode"),
+            "Created Date": pd.to_datetime(v.get("createdDate")),
+            "Content Provider Type": v.get("contentProviderType"),
+            "Create Report Embed URL": v.get("createReportEmbedURL"),
+            "QnA Embed URL": v.get("qnaEmbedURL"),
+            "Upstream Datasets": v.get("upstreamDatasets", []),
+            "Users": v.get("users", []),
+            "Is In Place Sharing Enabled": v.get("isInPlaceSharingEnabled"),
+            "Workspace Id": v.get("workspaceId"),
+            "Auto Sync Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
+                "autoSyncReadOnlyReplicas"
+            ),
+            "Max Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
+                "maxReadOnlyReplicas"
+            ),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def _resolve_dataset_id(dataset: str | UUID) -> str:
     if _is_valid_uuid(dataset):
         return dataset
@@ -128,6 +129,7 @@ def _resolve_dataset_id(dataset: str | UUID) -> str:
         return df_filt["Dataset Id"].iloc[0]
 
 
+@log
 def list_dataset_users(dataset: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified dataset.
@@ -163,22 +165,20 @@ def list_dataset_users(dataset: str | UUID) -> pd.DataFrame:
     url = f"/v1.0/myorg/admin/datasets/{dataset_id}/users"
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "User Name": v.get("displayName"),
-                "Email Address": v.get("emailAddress"),
-                "Dataset User Access Right": v.get("datasetUserAccessRight"),
-                "Identifier": v.get("identifier"),
-                "Graph Id": v.get("graphId"),
-                "Principal Type": v.get("principalType"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "User Name": v.get("displayName"),
+            "Email Address": v.get("emailAddress"),
+            "Dataset User Access Right": v.get("datasetUserAccessRight"),
+            "Identifier": v.get("identifier"),
+            "Graph Id": v.get("graphId"),
+            "Principal Type": v.get("principalType"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df

sempy_labs/admin/_domains.py

@@ -8,8 +8,10 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
     _is_valid_uuid,
 )
+from sempy._utils._log import log
 
 
+@log
 def resolve_domain_id(domain: Optional[str | UUID] = None, **kwargs) -> UUID:
     """
     Obtains the domain Id for a given domain name.
@@ -45,6 +47,7 @@ def resolve_domain_id(domain: Optional[str | UUID] = None, **kwargs) -> UUID:
     return dfL_filt["Domain ID"].iloc[0]
 
 
+@log
 def resolve_domain_name(domain: Optional[str | UUID], **kwargs) -> UUID:
     """
     Obtains the domain name for a given domain ID.
@@ -80,6 +83,7 @@ def resolve_domain_name(domain: Optional[str | UUID], **kwargs) -> UUID:
     return dfL_filt["Domain Name"].iloc[0]
 
 
+@log
 def list_domains(non_empty_only: bool = False) -> pd.DataFrame:
     """
     Shows a list of domains.
@@ -115,6 +119,7 @@ def list_domains(non_empty_only: bool = False) -> pd.DataFrame:
 
     response = _base_api(request=url, client="fabric_sp")
 
+    dfs = []
     for v in response.json().get("domains", []):
         new_data = {
             "Domain ID": v.get("id"),
@@ -123,11 +128,15 @@ def list_domains(non_empty_only: bool = False) -> pd.DataFrame:
             "Parent Domain ID": v.get("parentDomainId"),
             "Contributors Scope": v.get("contributorsScope"),
         }
-        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     return df
 
 
+@log
 def list_domain_workspaces(domain: Optional[str] = None, **kwargs) -> pd.DataFrame:
     """
     Shows a list of workspaces within the domain.
@@ -178,6 +187,7 @@ def list_domain_workspaces(domain: Optional[str] = None, **kwargs) -> pd.DataFra
     return df
 
 
+@log
 def create_domain(
     domain_name: str,
     description: Optional[str] = None,
@@ -222,6 +232,7 @@ def create_domain(
     print(f"{icons.green_dot} The '{domain_name}' domain has been created.")
 
 
+@log
 def delete_domain(domain: Optional[str | UUID], **kwargs):
     """
     Deletes a domain.
@@ -249,6 +260,7 @@ def delete_domain(domain: Optional[str | UUID], **kwargs):
     print(f"{icons.green_dot} The '{domain}' domain has been deleted.")
 
 
+@log
 def update_domain(
     domain: Optional[str | UUID] = None,
     description: Optional[str] = None,
@@ -301,6 +313,7 @@ def update_domain(
     print(f"{icons.green_dot} The '{domain_name}' domain has been updated.")
 
 
+@log
 def assign_domain_workspaces_by_capacities(
     domain: str | UUID,
     capacity_names: str | List[str],
@@ -369,6 +382,7 @@ def assign_domain_workspaces_by_capacities(
     )
 
 
+@log
 def assign_domain_workspaces(domain: str | UUID, workspace_names: str | List[str]):
     """
     Assigns workspaces to the specified domain by workspace.
@@ -420,6 +434,7 @@ def assign_domain_workspaces(domain: str | UUID, workspace_names: str | List[str
     )
 
 
+@log
 def unassign_all_domain_workspaces(domain: str | UUID):
     """
     Unassigns all workspaces from the specified domain.
@@ -446,6 +461,7 @@ def unassign_all_domain_workspaces(domain: str | UUID):
     )
 
 
+@log
 def unassign_domain_workspaces(
     domain: str | UUID,
     workspace_names: str | List[str],

sempy_labs/admin/_external_data_share.py

@@ -7,8 +7,10 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
     _update_dataframe_datatypes,
 )
+from sempy._utils._log import log
 
 
+@log
 def list_external_data_shares() -> pd.DataFrame:
     """
     Lists external data shares in the tenant. This function is for admins.
@@ -39,6 +41,7 @@ def list_external_data_shares() -> pd.DataFrame:
 
     response = _base_api(request="/v1/admin/items/externalDataShares")
 
+    dfs = []
     for i in response.json().get("value", []):
         cp = i.get("creatorPrincipal", {})
         new_data = {
@@ -56,13 +59,16 @@ def list_external_data_shares() -> pd.DataFrame:
             "Invitation URL": i.get("invitationUrl"),
         }
 
-        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+        dfs.append(pd.DataFrame(new_data, index=[0]))
 
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def revoke_external_data_share(
     external_data_share_id: UUID, item_id: UUID, workspace: str | UUID
 ):