semantic-link-labs 0.9.4__py3-none-any.whl → 0.9.6__py3-none-any.whl

sempy_labs/_workspaces.py

@@ -18,6 +18,8 @@ def delete_user_from_workspace(
 
     This is a wrapper function for the following API: `Groups - Delete User In Group <https://learn.microsoft.com/rest/api/power-bi/groups/delete-user-in-group>`_.
 
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
     Parameters
     ----------
     email_address : str
@@ -33,6 +35,7 @@ def delete_user_from_workspace(
     _base_api(
         request=f"/v1.0/myorg/groups/{workspace_id}/users/{email_address}",
         method="delete",
+        client="fabric_sp",
     )
     print(
         f"{icons.green_dot} The '{email_address}' user has been removed from accessing the '{workspace_name}' workspace."
@@ -50,6 +53,8 @@ def update_workspace_user(
 
     This is a wrapper function for the following API: `Groups - Update Group User <https://learn.microsoft.com/rest/api/power-bi/groups/update-group-user>`_.
 
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
     Parameters
     ----------
     email_address : str
@@ -90,6 +95,7 @@ def update_workspace_user(
         request=f"/v1.0/myorg/groups/{workspace_id}/users",
         method="put",
         payload=payload,
+        client="fabric_sp",
     )
     print(
         f"{icons.green_dot} The '{email_address}' user has been updated to a '{role_name}' within the '{workspace_name}' workspace."
@@ -102,6 +108,8 @@ def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame
 
     This is a wrapper function for the following API: `Workspaces - List Workspace Role Assignments <https://learn.microsoft.com/rest/api/fabric/core/workspaces/list-workspace-role-assignments>`_.
 
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
     Parameters
     ----------
     workspace : str | uuid.UUID, default=None
@@ -127,7 +135,9 @@ def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame
     df = _create_dataframe(columns=columns)
 
     responses = _base_api(
-        request=f"v1/workspaces/{workspace_id}/roleAssignments", uses_pagination=True
+        request=f"v1/workspaces/{workspace_id}/roleAssignments",
+        uses_pagination=True,
+        client="fabric_sp",
     )
 
     for r in responses:
@@ -204,7 +214,9 @@ def add_user_to_workspace(
 
 
 def assign_workspace_to_capacity(
-    capacity_name: str, workspace: Optional[str | UUID] = None
+    capacity: str | UUID,
+    workspace: Optional[str | UUID] = None,
+    **kwargs,
 ):
     """
     Assigns a workspace to a capacity.
@@ -213,16 +225,22 @@ def assign_workspace_to_capacity(
 
     Parameters
     ----------
-    capacity_name : str
-        The name of the capacity.
+    capacity : str | uuid.UUID
+        The name or ID of the capacity.
     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.
     """
 
+    if "capacity_name" in kwargs:
+        capacity = kwargs["capacity_name"]
+        print(
+            f"{icons.warning} The 'capacity_name' parameter is deprecated. Please use 'capacity' instead."
+        )
+
     (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
-    capacity_id = resolve_capacity_id(capacity_name=capacity_name)
+    capacity_id = resolve_capacity_id(capacity=capacity)
 
     payload = {"capacityId": capacity_id}
 
@@ -233,7 +251,7 @@ def assign_workspace_to_capacity(
         status_codes=[200, 202],
     )
     print(
-        f"{icons.green_dot} The '{workspace_name}' workspace has been assigned to the '{capacity_name}' capacity."
+        f"{icons.green_dot} The '{workspace_name}' workspace has been assigned to the '{capacity}' capacity."
     )
 
 
@@ -243,6 +261,8 @@ def unassign_workspace_from_capacity(workspace: Optional[str | UUID] = None):
 
     This is a wrapper function for the following API: `Workspaces - Unassign From Capacity <https://learn.microsoft.com/rest/api/fabric/core/workspaces/unassign-from-capacity>`_.
 
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
     Parameters
     ----------
     workspace : str | uuid.UUID, default=None
@@ -257,6 +277,7 @@ def unassign_workspace_from_capacity(workspace: Optional[str | UUID] = None):
         request=f"/v1/workspaces/{workspace_id}/unassignFromCapacity",
         method="post",
         status_codes=[200, 202],
+        client="fabric_sp",
     )
     print(
         f"{icons.green_dot} The '{workspace_name}' workspace has been unassigned from its capacity."
@@ -271,6 +292,8 @@ def list_workspace_role_assignments(
 
     This is a wrapper function for the following API: `Workspaces - List Workspace Role Assignments <https://learn.microsoft.com/rest/api/fabric/core/workspaces/list-workspace-role-assignments>`_.
 
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
     Parameters
     ----------
     workspace : str | uuid.UUID, default=None
@@ -295,7 +318,9 @@ def list_workspace_role_assignments(
     df = _create_dataframe(columns=columns)
 
     responses = _base_api(
-        request=f"v1/workspaces/{workspace_id}/roleAssignments", uses_pagination=True
+        request=f"v1/workspaces/{workspace_id}/roleAssignments",
+        uses_pagination=True,
+        client="fabric_sp",
     )
 
     for r in responses:
@@ -310,3 +335,26 @@ def list_workspace_role_assignments(
             df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
 
     return df
+
+
+def delete_workspace(workspace: Optional[str | UUID] = None):
+    """
+    Deletes a workspace.
+
+    This is a wrapper function for the following API: `Workspaces - Delete Workspace <https://learn.microsoft.com/rest/api/fabric/core/workspaces/delete-workspace>`_.
+
+    Parameters
+    ----------
+    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_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+
+    _base_api(
+        request=f"v1/workspaces/{workspace_id}", method="delete", client="fabric_sp"
+    )
+
+    print(f"{icons.green_dot} The '{workspace_name}' workspace has been deleted.")

sempy_labs/admin/__init__.py

@@ -1,3 +1,15 @@
+from sempy_labs.admin._users import (
+    list_access_entities,
+    list_user_subscriptions,
+)
+from sempy_labs.admin._workspaces import (
+    add_user_to_workspace,
+    delete_user_from_workspace,
+    restore_deleted_workspace,
+)
+from sempy_labs.admin._artifacts import (
+    list_unused_artifacts,
+)
 from sempy_labs.admin._shared import (
     list_widely_shared_artifacts,
 )
@@ -12,6 +24,7 @@ from sempy_labs.admin._apps import (
 from sempy_labs.admin._reports import (
     list_reports,
     list_report_users,
+    list_report_subscriptions,
 )
 from sempy_labs.admin._activities import (
     list_activity_events,
@@ -24,6 +37,7 @@ from sempy_labs.admin._capacities import (
     list_capacities,
     get_capacity_assignment_status,
     get_capacity_state,
+    list_capacity_users,
 )
 from sempy_labs.admin._tenant import (
     list_tenant_settings,
@@ -41,7 +55,6 @@ from sempy_labs.admin._basic_functions import (
     list_workspaces,
     list_workspace_access_details,
     list_modified_workspaces,
-    list_access_entities,
     list_workspace_users,
 )
 from sempy_labs.admin._domains import (
@@ -113,4 +126,11 @@ __all__ = [
     "list_capacity_tenant_settings_overrides",
     "list_capacities_delegated_tenant_settings",
     "list_domain_tenant_settings_overrides",
+    "list_unused_artifacts",
+    "add_user_to_workspace",
+    "delete_user_from_workspace",
+    "restore_deleted_workspace",
+    "list_capacity_users",
+    "list_user_subscriptions",
+    "list_report_subscriptions",
 ]

sempy_labs/admin/_apps.py

@@ -40,7 +40,7 @@ def list_apps(
         "App Id": "string",
         "Description": "string",
         "Published By": "string",
-        "Last Update": "datetime",
+        "Last Update": "datetime_coerce",
     }
 
     df = _create_dataframe(columns=columns)

sempy_labs/admin/_artifacts.py

@@ -0,0 +1,62 @@
+import pandas as pd
+from sempy_labs._helper_functions import (
+    _base_api,
+)
+from uuid import UUID
+from typing import Optional
+from sempy_labs.admin._basic_functions import (
+    _resolve_workspace_name_and_id,
+    _create_dataframe,
+    _update_dataframe_datatypes,
+)
+
+
+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.
+
+    This is a wrapper function for the following API: `Admin - Groups GetUnusedArtifactsAsAdmin <https://learn.microsoft.com/rest/api/power-bi/admin/groups-get-unused-artifacts-as-admin>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Returns
+    -------
+    pandas.DataFrame
+        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)
+
+    columns = {
+        "Artifact Name": "string",
+        "Artifact Id": "string",
+        "Artifact Type": "string",
+        "Artifact Size in MB": "int",
+        "Created Date Time": "datetime",
+        "Last Accessed Date Time": "datetime",
+    }
+
+    df = _create_dataframe(columns=columns)
+
+    responses = _base_api(
+        request=f"/v1.0/myorg/admin/groups/{workspace_id}/unused",
+        client="fabric_sp",
+        uses_pagination=True,
+    )
+
+    for r in responses:
+        for i in r.get("unusedArtifactEntities", []):
+            new_data = {
+                "Artifact Name": i.get("artifactId"),
+                "Artifact Id": i.get("displayName"),
+                "Artifact Type": i.get("artifactType"),
+                "Artifact Size in MB": i.get("artifactSizeInMB"),
+                "Created Date Time": i.get("createdDateTime"),
+                "Last Accessed Date Time": i.get("lastAccessedDateTime"),
+            }
+
+            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df

sempy_labs/admin/_basic_functions.py

@@ -298,58 +298,6 @@ def list_modified_workspaces(
     return df
 
 
-def list_access_entities(
-    user_email_address: str,
-) -> pd.DataFrame:
-    """
-    Shows a list of permission details for Fabric and Power BI items the specified user can access.
-
-    This is a wrapper function for the following API: `Users - List Access Entities <https://learn.microsoft.com/rest/api/fabric/admin/users/list-access-entities>`_.
-
-    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
-
-    Parameters
-    ----------
-    user_email_address : str
-        The user's email address.
-
-    Returns
-    -------
-    pandas.DataFrame
-        A pandas dataframe showing a list of permission details for Fabric and Power BI items the specified user can access.
-    """
-
-    columns = {
-        "Item Id": "string",
-        "Item Name": "string",
-        "Item Type": "string",
-        "Permissions": "string",
-        "Additional Permissions": "string",
-    }
-    df = _create_dataframe(columns=columns)
-
-    responses = _base_api(
-        request=f"/v1/admin/users/{user_email_address}/access",
-        client="fabric_sp",
-        uses_pagination=True,
-    )
-
-    for r in responses:
-        for v in r.get("accessEntities", []):
-            new_data = {
-                "Item Id": v.get("id"),
-                "Item Name": v.get("displayName"),
-                "Item Type": v.get("itemAccessDetails", {}).get("type"),
-                "Permissions": v.get("itemAccessDetails", {}).get("permissions"),
-                "Additional Permissions": v.get("itemAccessDetails", {}).get(
-                    "additionalPermissions"
-                ),
-            }
-            df = pd.concat([df, pd.DataFrame([new_data])], ignore_index=True)
-
-    return df
-
-
 def list_workspace_access_details(
     workspace: Optional[Union[str, UUID]] = None,
 ) -> pd.DataFrame:
@@ -406,9 +354,10 @@ def _resolve_workspace_name_and_id(
     workspace: str | UUID,
 ) -> Tuple[str, UUID]:
 
+    from sempy_labs._helper_functions import resolve_workspace_name_and_id
+
     if workspace is None:
-        workspace_id = fabric.get_workspace_id()
-        workspace_name = fabric.resolve_workspace_name(workspace_id)
+        (workspace_name, workspace_id) = resolve_workspace_name_and_id()
     else:
         dfW = list_workspaces(workspace=workspace)
         if not dfW.empty:

sempy_labs/admin/_capacities.py

@@ -248,3 +248,64 @@ def list_capacities(
             df = df[df["Capacity Name"] == capacity]
 
     return df
+
+
+def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
+    """
+    Shows a list of users that have access to the specified workspace.
+
+    This is a wrapper function for the following API: `Admin - Capacities GetCapacityUsersAsAdmin <https://learn.microsoft.com/rest/api/power-bi/admin/capacities-get-capacity-users-as-admin>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    capacity : str | uuid.UUID
+        The name or ID of the capacity.
+
+    Returns
+    -------
+    pandas.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)
+
+    columns = {
+        "User Name": "string",
+        "Email Address": "string",
+        "Capacity User Access Right": "string",
+        "Identifier": "string",
+        "Graph Id": "string",
+        "Principal Type": "string",
+        "User Type": "string",
+        "Profile": "string",
+    }
+
+    df = _create_dataframe(columns=columns)
+
+    response = _base_api(
+        request=f"/v1.0/myorg/admin/capacities/{capacity_id}/users", client="fabric_sp"
+    )
+
+    rows = []
+    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()))
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df

sempy_labs/admin/_reports.py

@@ -163,3 +163,77 @@ def list_report_users(report: str | UUID) -> pd.DataFrame:
     _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
+
+
+def list_report_subscriptions(report: str | UUID) -> pd.DataFrame:
+    """
+    Shows a list of report subscriptions along with subscriber details. This is a preview API call.
+
+    This is a wrapper function for the following API: `Admin - Reports GetReportSubscriptionsAsAdmin <https://learn.microsoft.com/rest/api/power-bi/admin/reports-get-report-subscriptions-as-admin>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    report : str | uuid.UUID
+        The name or ID of the report.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of report subscriptions along with subscriber details. This is a preview API call.
+    """
+
+    report_id = _resolve_report_id(report)
+
+    columns = {
+        "Subscription Id": "string",
+        "Title": "string",
+        "Artifact Id": "string",
+        "Artifact Name": "string",
+        "Sub Artifact Name": "string",
+        "Artifact Type": "string",
+        "Is Enabled": "bool",
+        "Frequency": "string",
+        "Start Date": "datetime",
+        "End Date": "string",
+        "Link To Content": "bool",
+        "Preview Image": "bool",
+        "Attachment Format": "string",
+        "Users": "string",
+    }
+
+    df = _create_dataframe(columns=columns)
+
+    response = _base_api(
+        request=f"/v1.0/myorg/admin/reports/{report_id}/subscriptions",
+        client="fabric_sp",
+    )
+
+    rows = []
+    for v in response.json().get("value", []):
+        rows.append(
+            {
+                "Subscription Id": v.get("id"),
+                "Title": v.get("title"),
+                "Artifact Id": v.get("artifactId"),
+                "Artifact Name": v.get("artifactDisplayName"),
+                "Sub Artifact Name": v.get("subArtifactDisplayName"),
+                "Artifact Type": v.get("artifactType"),
+                "Is Enabled": v.get("isEnabled"),
+                "Frequency": v.get("frequency"),
+                "Start Date": v.get("startDate"),
+                "End Date": v.get("endDate"),
+                "Link To Content": v.get("linkToContent"),
+                "Preview Image": v.get("previewImage"),
+                "Attachment Format": v.get("attachmentFormat"),
+                "Users": str(v.get("users")),
+            }
+        )
+
+    if rows:
+        df = pd.DataFrame(rows, columns=list(columns.keys()))
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df

sempy_labs/admin/_scanner.py

@@ -1,4 +1,3 @@
-import sempy.fabric as fabric
 from typing import Optional, List
 from uuid import UUID
 from sempy.fabric.exceptions import FabricHTTPException
@@ -10,6 +9,7 @@ from sempy_labs._helper_functions import (
     _base_api,
     _is_valid_uuid,
     _build_url,
+    resolve_workspace_name,
 )
 
 
@@ -54,7 +54,7 @@ def scan_workspaces(
     """
 
     if workspace is None:
-        workspace = fabric.resolve_workspace_name()
+        workspace = resolve_workspace_name()
 
     if isinstance(workspace, str):
         workspace = [workspace]

sempy_labs/admin/_shared.py

@@ -50,11 +50,13 @@ def list_widely_shared_artifacts(
     )
 
     responses = _base_api(
-        request=f"/v1.0/myorg/admin/widelySharedArtifacts/{api}", client="fabric_sp"
+        request=f"/v1.0/myorg/admin/widelySharedArtifacts/{api}",
+        client="fabric_sp",
+        uses_pagination=True,
     )
 
     for r in responses:
-        for v in r.get("value", []):
+        for v in r.get("ArtifactAccessEntities", []):
             sharer = v.get("sharer", {})
             new_data = {
                 "Artifact Id": v.get("artifactId"),

sempy_labs/admin/_users.py

@@ -0,0 +1,133 @@
+from sempy_labs._helper_functions import (
+    _base_api,
+    _create_dataframe,
+    _update_dataframe_datatypes,
+)
+from uuid import UUID
+import pandas as pd
+
+
+def list_access_entities(
+    user_email_address: str,
+) -> pd.DataFrame:
+    """
+    Shows a list of permission details for Fabric and Power BI items the specified user can access.
+
+    This is a wrapper function for the following API: `Users - List Access Entities <https://learn.microsoft.com/rest/api/fabric/admin/users/list-access-entities>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    user_email_address : str
+        The user's email address.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of permission details for Fabric and Power BI items the specified user can access.
+    """
+
+    columns = {
+        "Item Id": "string",
+        "Item Name": "string",
+        "Item Type": "string",
+        "Permissions": "string",
+        "Additional Permissions": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    responses = _base_api(
+        request=f"/v1/admin/users/{user_email_address}/access",
+        client="fabric_sp",
+        uses_pagination=True,
+    )
+
+    for r in responses:
+        for v in r.get("accessEntities", []):
+            new_data = {
+                "Item Id": v.get("id"),
+                "Item Name": v.get("displayName"),
+                "Item Type": v.get("itemAccessDetails", {}).get("type"),
+                "Permissions": v.get("itemAccessDetails", {}).get("permissions"),
+                "Additional Permissions": v.get("itemAccessDetails", {}).get(
+                    "additionalPermissions"
+                ),
+            }
+            df = pd.concat([df, pd.DataFrame([new_data])], ignore_index=True)
+
+    return df
+
+
+def list_user_subscriptions(user: str | UUID) -> pd.DataFrame:
+    """
+    Shows a list of subscriptions for the specified user. This is a preview API call.
+
+    This is a wrapper function for the following API: `Admin - Users GetUserSubscriptionsAsAdmin <https://learn.microsoft.com/rest/api/power-bi/admin/users-get-user-subscriptions-as-admin>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    user : str | uuid.UUID
+        The graph ID or user principal name (UPN) of the user.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of subscriptions for the specified user. This is a preview API call.
+    """
+
+    columns = {
+        "Subscription Id": "string",
+        "Title": "string",
+        "Artifact Id": "string",
+        "Artifact Name": "string",
+        "Sub Artifact Name": "string",
+        "Artifact Type": "string",
+        "Is Enabled": "bool",
+        "Frequency": "string",
+        "Start Date": "datetime",
+        "End Date": "string",
+        "Link To Content": "bool",
+        "Preview Image": "bool",
+        "Attachment Format": "string",
+        "Users": "string",
+    }
+
+    df = _create_dataframe(columns=columns)
+
+    responses = _base_api(
+        request=f"/v1.0/myorg/admin/users/{user}/subscriptions",
+        client="fabric_sp",
+        uses_pagination=True,
+    )
+
+    rows = []
+    for r in responses:
+        for v in r.get("subscriptionEntities", []):
+            rows.append(
+                {
+                    "Subscription Id": v.get("id"),
+                    "Title": v.get("title"),
+                    "Artifact Id": v.get("artifactId"),
+                    "Artifact Name": v.get("artifactDisplayName"),
+                    "Sub Artifact Name": v.get("subArtifactDisplayName"),
+                    "Artifact Type": v.get("artifactType"),
+                    "Is Enabled": v.get("isEnabled"),
+                    "Frequency": v.get("frequency"),
+                    "Start Date": v.get("startDate"),
+                    "End Date": v.get("endDate"),
+                    "Link To Content": v.get("linkToContent"),
+                    "Preview Image": v.get("previewImage"),
+                    "Attachment Format": v.get("attachmentFormat"),
+                    "Users": str(v.get("users")),
+                }
+            )
+
+    if rows:
+        df = pd.DataFrame(rows, columns=list(columns.keys()))
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df