semantic-link-labs 0.8.3__py3-none-any.whl → 0.8.5__py3-none-any.whl

sempy_labs/directlake/_update_directlake_model_lakehouse_connection.py

@@ -1,5 +1,6 @@
 import sempy.fabric as fabric
 from sempy_labs.directlake._get_shared_expression import get_shared_expression
+from sempy_labs.directlake._generate_shared_expression import generate_shared_expression
 from sempy_labs._helper_functions import (
     resolve_lakehouse_name,
 )
@@ -53,6 +54,8 @@ def update_direct_lake_model_lakehouse_connection(
             f"Therefore it cannot be used to support the '{dataset}' semantic model within the '{workspace}' workspace."
         )
 
+    icons.sll_tags.append("UpdateDLConnection")
+
     shEx = get_shared_expression(lakehouse, lakehouse_workspace)
 
     with connect_semantic_model(
@@ -69,3 +72,78 @@ def update_direct_lake_model_lakehouse_connection(
     print(
         f"{icons.green_dot} The expression in the '{dataset}' semantic model has been updated to point to the '{lakehouse}' lakehouse in the '{lakehouse_workspace}' workspace."
     )
+
+
+def update_direct_lake_model_connection(
+    dataset: str,
+    workspace: Optional[str] = None,
+    source: Optional[str] = None,
+    source_type: Optional[str] = "Lakehouse",
+    source_workspace: Optional[str] = None,
+):
+    """
+    Remaps a Direct Lake semantic model's SQL Endpoint connection to a new lakehouse/warehouse.
+
+    Parameters
+    ----------
+    dataset : str
+        Name of the semantic model.
+    workspace : str, default=None
+        The Fabric workspace name in which the semantic model exists.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+    source : str, default=None
+        The name of the Fabric lakehouse/warehouse used by the Direct Lake semantic model.
+        Defaults to None which resolves to the lakehouse attached to the notebook.
+    source_type : str, default="Lakehouse"
+        The type of source for the Direct Lake semantic model. Valid options: "Lakehouse", "Warehouse".
+    source_workspace : str, default=None
+        The Fabric workspace used by the lakehouse/warehouse.
+        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 workspace is None:
+        workspace = fabric.resolve_workspace_name(workspace)
+
+    source_type = source_type.capitalize()
+
+    if source_type not in ["Lakehouse", "Warehouse"]:
+        raise ValueError(
+            f"{icons.red_dot} The 'source_type' must be either 'Lakehouse' or 'Warehouse'."
+        )
+
+    if source_workspace is None:
+        source_workspace = workspace
+
+    if source is None:
+        source_id = fabric.get_lakehouse_id()
+        source = resolve_lakehouse_name(source_id, source_workspace)
+    else:
+        source_id = fabric.resolve_item_id(
+            item_name=source, type=source_type, workspace=source_workspace
+        )
+        source = fabric.resolve_item_name(
+            item_id=source_id, workspace=source_workspace, type=source_type
+        )
+
+    icons.sll_tags.append("UpdateDLConnection")
+
+    shEx = generate_shared_expression(
+        item_name=source, item_type=source_type, workspace=source_workspace
+    )
+
+    with connect_semantic_model(
+        dataset=dataset, readonly=False, workspace=workspace
+    ) as tom:
+
+        if not tom.is_direct_lake():
+            raise ValueError(
+                f"{icons.red_dot} The '{dataset}' semantic model is not in Direct Lake. This function is only applicable to Direct Lake semantic models."
+            )
+
+        tom.model.Expressions["DatabaseQuery"].Expression = shEx
+
+    print(
+        f"{icons.green_dot} The expression in the '{dataset}' semantic model has been updated to point to the '{source}' {source_type.lower()} in the '{source_workspace}' workspace."
+    )

sempy_labs/directlake/_update_directlake_partition_entity.py

@@ -3,6 +3,7 @@ import sempy.fabric as fabric
 from sempy_labs.tom import connect_semantic_model
 from sempy_labs._refresh_semantic_model import refresh_semantic_model
 from sempy_labs.directlake._dl_helper import get_direct_lake_source
+from sempy_labs._helper_functions import _convert_data_type
 from typing import List, Optional, Union
 import sempy_labs._icons as icons
 
@@ -12,7 +13,6 @@ def update_direct_lake_partition_entity(
     table_name: Union[str, List[str]],
     entity_name: Union[str, List[str]],
     workspace: Optional[str] = None,
-    **kwargs,
 ):
     """
     Remaps a table (or tables) in a Direct Lake semantic model to a table in a lakehouse.
@@ -31,28 +31,8 @@ def update_direct_lake_partition_entity(
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    if "lakehouse" in kwargs:
-        print(
-            "The 'lakehouse' parameter has been deprecated as it is no longer necessary. Please remove this parameter from the function going forward."
-        )
-        del kwargs["lakehouse"]
-    if "lakehouse_workspace" in kwargs:
-        print(
-            "The 'lakehouse_workspace' parameter has been deprecated as it is no longer necessary. Please remove this parameter from the function going forward."
-        )
-        del kwargs["lakehouse_workspace"]
-
-    workspace = fabric.resolve_workspace_name(workspace)
-
-    artifact_type, lakehouse_name, lakehouse_id, lakehouse_workspace_id = (
-        get_direct_lake_source(dataset=dataset, workspace=workspace)
-    )
-
-    if artifact_type == "Warehouse":
-        raise ValueError(
-            f"{icons.red_dot} This function is only valid for Direct Lake semantic models which source from lakehouses, not warehouses."
-        )
-    lakehouse_workspace = fabric.resolve_workspace_name(lakehouse_workspace_id)
+    if workspace is None:
+        workspace = fabric.resolve_workspace_name(workspace)
 
     # Support both str & list types
     if isinstance(table_name, str):
@@ -65,6 +45,8 @@ def update_direct_lake_partition_entity(
             f"{icons.red_dot} The 'table_name' and 'entity_name' arrays must be of equal length."
         )
 
+    icons.sll_tags.append("UpdateDLPartition")
+
     with connect_semantic_model(
         dataset=dataset, readonly=False, workspace=workspace
     ) as tom:
@@ -88,12 +70,11 @@ def update_direct_lake_partition_entity(
                 raise ValueError(
                     f"{icons.red_dot} The '{tName}' table in the '{dataset}' semantic model has not been updated."
                 )
-            else:
-                tom.model.Tables[tName].Partitions[part_name].EntityName = eName
-                print(
-                    f"{icons.green_dot} The '{tName}' table in the '{dataset}' semantic model has been updated to point to the '{eName}' table "
-                    f"in the '{lakehouse_name}' lakehouse within the '{lakehouse_workspace}' workspace."
-                )
+
+            tom.model.Tables[tName].Partitions[part_name].Source.EntityName = eName
+            print(
+                f"{icons.green_dot} The '{tName}' table in the '{dataset}' semantic model has been updated to point to the '{eName}' table."
+            )
 
 
 def add_table_to_direct_lake_semantic_model(
@@ -149,9 +130,9 @@ def add_table_to_direct_lake_semantic_model(
 
         table_count = tom.model.Tables.Count
 
-        if tom.is_direct_lake() is False and table_count > 0:
+        if not tom.is_direct_lake() and table_count > 0:
             raise ValueError(
-                "This function is only valid for Direct Lake semantic models or semantic models with no tables."
+                f"{icons.red_dot} This function is only valid for Direct Lake semantic models or semantic models with no tables."
             )
 
         if any(
@@ -204,7 +185,7 @@ def add_table_to_direct_lake_semantic_model(
         for i, r in dfLC_filt.iterrows():
             lakeCName = r["Column Name"]
             dType = r["Data Type"]
-            dt = icons.data_type_mapping.get(dType)
+            dt = _convert_data_type(dType)
             tom.add_data_column(
                 table_name=table_name,
                 column_name=lakeCName,

sempy_labs/directlake/_warm_cache.py

@@ -177,7 +177,7 @@ def warm_direct_lake_cache_isresident(
     dfC["DAX Object Name"] = format_dax_object_name(
         dfC["Table Name"], dfC["Column Name"]
     )
-    dfC_filtered = dfC[dfC["Is Resident"]]
+    dfC_filtered = dfC[dfC["Is Resident"] == True]
 
     if len(dfC_filtered) == 0:
         raise ValueError(
@@ -186,17 +186,18 @@ def warm_direct_lake_cache_isresident(
 
     # Refresh/frame dataset
     refresh_semantic_model(dataset=dataset, refresh_type="full", workspace=workspace)
-
     time.sleep(2)
 
-    tbls = dfC_filtered["Table Name"].unique()
-    column_values = dfC_filtered["DAX Object Name"].tolist()
-
     # Run basic query to get columns into memory; completed one table at a time (so as not to overload the capacity)
-    for tableName in (bar := tqdm(tbls)):
-        bar.set_description(f"Warming the '{tableName}' table...")
-        css = ",".join(map(str, column_values))
-        dax = """EVALUATE TOPN(1,SUMMARIZECOLUMNS(""" + css + "))" ""
+    tbls = dfC_filtered["Table Name"].unique()
+    for table_name in (bar := tqdm(tbls)):
+        bar.set_description(f"Warming the '{table_name}' table...")
+        css = ", ".join(
+            dfC_filtered[dfC_filtered["Table Name"] == table_name]["DAX Object Name"]
+            .astype(str)
+            .tolist()
+        )
+        dax = f"""EVALUATE TOPN(1,SUMMARIZECOLUMNS({css}))"""
         fabric.evaluate_dax(dataset=dataset, dax_string=dax, workspace=workspace)
 
     print(

sempy_labs/lakehouse/_get_lakehouse_tables.py

@@ -31,12 +31,14 @@ def get_lakehouse_tables(
     """
     Shows the tables of a lakehouse and their respective properties. Option to include additional properties relevant to Direct Lake guardrails.
 
+    This is a wrapper function for the following API: `Tables - List Tables <https://learn.microsoft.com/rest/api/fabric/lakehouse/tables/list-tables>`_ plus extended capabilities.
+
     Parameters
     ----------
     lakehouse : str, default=None
         The Fabric lakehouse.
         Defaults to None which resolves to the lakehouse attached to the notebook.
-    lakehouse_workspace : str, default=None
+    workspace : str, default=None
         The Fabric workspace used by the lakehouse.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
@@ -155,7 +157,9 @@ def get_lakehouse_tables(
     if extended:
         intColumns = ["Files", "Row Groups", "Table Size"]
         df[intColumns] = df[intColumns].astype(int)
-        df["SKU"] = guardrail["Fabric SKUs"].iloc[0]
+
+        col_name = guardrail.columns[0]
+        df["SKU"] = guardrail[col_name].iloc[0]
         df["Parquet File Guardrail"] = guardrail["Parquet files per table"].iloc[0]
         df["Row Group Guardrail"] = guardrail["Row groups per table"].iloc[0]
         df["Row Count Guardrail"] = (

sempy_labs/lakehouse/_shortcuts.py

@@ -20,6 +20,8 @@ def create_shortcut_onelake(
     """
     Creates a `shortcut <https://learn.microsoft.com/fabric/onelake/onelake-shortcuts>`_ to a delta table in OneLake.
 
+    This is a wrapper function for the following API: `OneLake Shortcuts - Create Shortcut <https://learn.microsoft.com/rest/api/fabric/core/onelake-shortcuts/create-shortcut>`_.
+
     Parameters
     ----------
     table_name : str
@@ -169,6 +171,8 @@ def delete_shortcut(
     """
     Deletes a shortcut.
 
+    This is a wrapper function for the following API: `OneLake Shortcuts - Delete Shortcut <https://learn.microsoft.com/rest/api/fabric/core/onelake-shortcuts/delete-shortcut>`_.
+
     Parameters
     ----------
     shortcut_name : str

sempy_labs/migration/_create_pqt_file.py

@@ -47,7 +47,6 @@ def create_pqt_file(
 
     folderPath = "/lakehouse/default/Files"
     subFolderPath = os.path.join(folderPath, "pqtnewfolder")
-    os.makedirs(subFolderPath, exist_ok=True)
 
     with connect_semantic_model(
         dataset=dataset, workspace=workspace, readonly=True
@@ -81,8 +80,10 @@ def create_pqt_file(
         for e in tom.model.Expressions:
             expr_map[e.Name] = [str(e.Kind), e.Expression]
 
+        expressions = tom.model.Expressions.Count
+
         # Dataflows Gen2 max table limit is 50.
-        max_length = 50
+        max_length = 50 - expressions
         table_chunks = [
             dict(list(table_map.items())[i : i + max_length])
             for i in range(0, len(table_map), max_length)
@@ -90,6 +91,8 @@ def create_pqt_file(
 
         def create_pqt(table_map: dict, expr_map: dict, file_name: str):
 
+            os.makedirs(subFolderPath, exist_ok=True)
+
             class QueryMetadata:
                 def __init__(
                     self,

sempy_labs/migration/_migrate_calctables_to_lakehouse.py

@@ -282,6 +282,8 @@ def migrate_field_parameters(
     if new_dataset_workspace is None:
         new_dataset_workspace = workspace
 
+    icons.sll_tags.append("DirectLakeMigration")
+
     dfC = fabric.list_columns(dataset=dataset, workspace=workspace)
     dfC["Column Object"] = format_dax_object_name(dfC["Table Name"], dfC["Column Name"])
     dfP = fabric.list_partitions(dataset=dataset, workspace=workspace)
@@ -337,6 +339,7 @@ def migrate_field_parameters(
             try:
                 par = TOM.Partition()
                 par.Name = tName
+                par.Mode = TOM.ModeType.Import
 
                 parSource = TOM.CalculatedPartitionSource()
                 par.Source = parSource
@@ -345,7 +348,6 @@ def migrate_field_parameters(
                 tbl = TOM.Table()
                 tbl.Name = tName
                 tbl.LineageTag = generate_guid()
-                tbl.SourceLineageTag = generate_guid()
                 tbl.Partitions.Add(par)
 
                 columns = ["Value1", "Value2", "Value3"]
@@ -356,7 +358,6 @@ def migrate_field_parameters(
                     col.SourceColumn = "[" + colName + "]"
                     col.DataType = TOM.DataType.String
                     col.LineageTag = generate_guid()
-                    col.SourceLineageTag = generate_guid()
 
                     tbl.Columns.Add(col)
 

sempy_labs/migration/_migrate_calctables_to_semantic_model.py

@@ -64,6 +64,8 @@ def migrate_calc_tables_to_semantic_model(
         lakehouse_id = fabric.get_lakehouse_id()
         lakehouse = resolve_lakehouse_name(lakehouse_id, lakehouse_workspace)
 
+    icons.sll_tags.append("DirectLakeMigration")
+
     # Get calc tables but not field parameters
     dfP = fabric.list_partitions(dataset=dataset, workspace=workspace)
     dfP_filt = dfP[(dfP["Source Type"] == "Calculated")]

sempy_labs/migration/_migrate_model_objects_to_semantic_model.py

@@ -52,6 +52,8 @@ def migrate_model_objects_to_semantic_model(
     if new_dataset_workspace is None:
         new_dataset_workspace = workspace
 
+    icons.sll_tags.append("DirectLakeMigration")
+
     dfT = fabric.list_tables(dataset=dataset, workspace=workspace)
     dfC = fabric.list_columns(dataset=dataset, workspace=workspace)
     dfM = fabric.list_measures(dataset=dataset, workspace=workspace)
@@ -334,14 +336,6 @@ def migrate_model_objects_to_semantic_model(
                     print(
                         f"{icons.warning} The {relName} relationship was not created as Direct Lake does not support relationships based on columns with different data types."
                     )
-                # Direct Lake using DateTime columns
-                elif isDirectLake and (
-                    r.FromColumn.DataType == TOM.DataType.DateTime
-                    or r.ToColumn.DataType == TOM.DataType.DateTime
-                ):
-                    print(
-                        f"{icons.red_dot} The {relName} relationship was not created as Direct Lake does not support relationships based on columns of DateTime data type."
-                    )
                 # Columns do not exist in the new semantic model
                 elif not any(
                     c.Name == r.FromColumn.Name and c.Parent.Name == r.FromTable.Name

sempy_labs/migration/_migrate_tables_columns_to_semantic_model.py

@@ -61,6 +61,8 @@ def migrate_tables_columns_to_semantic_model(
         lakehouse_id = fabric.get_lakehouse_id()
         lakehouse = resolve_lakehouse_name(lakehouse_id, lakehouse_workspace)
 
+    icons.sll_tags.append("DirectLakeMigration")
+
     # Check that lakehouse is attached to the notebook
     if not lakehouse_attached() and (lakehouse is None and lakehouse_workspace is None):
         raise ValueError(
@@ -106,9 +108,24 @@ def migrate_tables_columns_to_semantic_model(
     with connect_semantic_model(
         dataset=new_dataset, readonly=False, workspace=new_dataset_workspace
     ) as tom:
+
+        # Additional updates
+        tom.set_annotation(
+            object=tom.model, name="__PBI_TimeIntelligenceEnabled", value="0"
+        )
+        tom.set_annotation(
+            object=tom.model, name="PBI_QueryOrder", value='["DatabaseQuery"]'
+        )
+
+        # Begin migration
         if not any(e.Name == "DatabaseQuery" for e in tom.model.Expressions):
             tom.add_expression("DatabaseQuery", expression=shEx)
             print(f"{icons.green_dot} The 'DatabaseQuery' expression has been added.")
+            tom.set_annotation(
+                object=tom.model.Expressions["DatabaseQuery"],
+                name="PBI_IncludeFutureArtifacts",
+                value="False",
+            )
 
         for i, r in dfT_filt.iterrows():
             tName = r["Name"]

sempy_labs/migration/_migration_validation.py

@@ -46,6 +46,8 @@ def migration_validation(
     if new_dataset_workspace is None:
         new_dataset_workspace = workspace
 
+    icons.sll_tags.append("DirectLakeMigration")
+
     dfA = list_semantic_model_objects(dataset=dataset, workspace=workspace)
     dfB = list_semantic_model_objects(
         dataset=new_dataset, workspace=new_dataset_workspace

sempy_labs/migration/_refresh_calc_tables.py

@@ -26,6 +26,7 @@ def refresh_calc_tables(dataset: str, workspace: Optional[str] = None):
 
     spark = SparkSession.builder.getOrCreate()
     workspace = fabric.resolve_workspace_name(workspace)
+    icons.sll_tags.append("DirectLakeMigration")
 
     @retry(
         sleep_time=1,

sempy_labs/report/__init__.py

@@ -1,13 +1,16 @@
 from sempy_labs.report._reportwrapper import (
     ReportWrapper,
 )
-
+from sempy_labs.report._paginated import (
+    get_report_datasources,
+)
 from sempy_labs.report._generate_report import (
     create_report_from_reportjson,
     get_report_definition,
     update_report_from_reportjson,
     create_model_bpa_report,
 )
+from sempy_labs.report._download_report import download_report
 from sempy_labs.report._report_functions import (
     get_report_json,
     # report_dependency_tree,
@@ -39,4 +42,6 @@ __all__ = [
     "ReportWrapper",
     "report_bpa_rules",
     "run_report_bpa",
+    "get_report_datasources",
+    "download_report",
 ]

sempy_labs/report/_download_report.py

@@ -0,0 +1,75 @@
+import sempy.fabric as fabric
+import sempy_labs._icons as icons
+from typing import Optional
+from sempy_labs._helper_functions import (
+    resolve_workspace_name_and_id,
+    resolve_lakehouse_name,
+)
+from sempy_labs.lakehouse._lakehouse import lakehouse_attached
+from sempy.fabric.exceptions import FabricHTTPException
+
+
+def download_report(
+    report: str,
+    file_name: Optional[str] = None,
+    download_type: str = "LiveConnect",
+    workspace: Optional[str] = None,
+):
+    """
+    Downloads the specified report from the specified workspace to a Power BI .pbix file.
+
+    This is a wrapper function for the following API: `Reports - Export Report In Group <https://learn.microsoft.com/rest/api/power-bi/reports/export-report-in-group>`.
+
+    Parameters
+    ----------
+    report: str
+        Name of the report.
+    file_name : str, default=None
+        Name of the .pbix file to be saved.
+        Defaults to None which resolves to the name of the report.
+    download_type : str, default="LiveConnect"
+        The type of download. Valid values are "LiveConnect" and "IncludeModel".
+    workspace : str, default=None
+        The Fabric workspace name.
+        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 not lakehouse_attached():
+        raise ValueError(
+            f"{icons.red_dot} A lakehouse must be attached to the notebook."
+        )
+
+    lakehouse_id = fabric.get_lakehouse_id()
+    workspace_name = fabric.resolve_workspace_name()
+    lakehouse_name = resolve_lakehouse_name(
+        lakehouse_id=lakehouse_id, workspace=workspace_name
+    )
+
+    download_types = ["LiveConnect", "IncludeModel"]
+    if download_type not in download_types:
+        raise ValueError(
+            f"{icons.red_dot} Invalid download_type parameter. Valid options: {download_types}."
+        )
+
+    file_name = file_name or report
+    (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
+    report_id = fabric.resolve_item_id(
+        item_name=report, type="Report", workspace=workspace
+    )
+
+    client = fabric.PowerBIRestClient()
+    response = client.get(
+        f"/v1.0/myorg/groups/{workspace_id}/reports/{report_id}/Export?downloadType={download_type}"
+    )
+
+    if response.status_code != 200:
+        raise FabricHTTPException(response)
+
+    # Save file to the attached lakehouse
+    with open(f"/lakehouse/default/Files/{file_name}.pbix", "wb") as file:
+        file.write(response.content)
+
+    print(
+        f"{icons.green_dot} The '{report}' report within the '{workspace}' workspace has been exported as the '{file_name}' file in the '{lakehouse_name}' lakehouse within the '{workspace_name} workspace."
+    )

sempy_labs/report/_generate_report.py

@@ -23,6 +23,8 @@ def create_report_from_reportjson(
     """
     Creates a report based on a report.json file (and an optional themes.json file).
 
+    This is a wrapper function for the following API: `Items - Create Report <https://learn.microsoft.com/rest/api/fabric/report/items/create-report>`_.
+
     Parameters
     ----------
     report : str
@@ -124,6 +126,8 @@ def update_report_from_reportjson(
     """
     Updates a report based on a report.json file.
 
+    This is a wrapper function for the following API: `Items - Update Report Definition <https://learn.microsoft.com/rest/api/fabric/report/items/update-report-definition>`_.
+
     Parameters
     ----------
     report : str
@@ -179,6 +183,8 @@ def get_report_definition(report: str, workspace: Optional[str] = None) -> pd.Da
     """
     Gets the collection of definition files of a report.
 
+    This is a wrapper function for the following API: `Items - Get Report Definition <https://learn.microsoft.com/rest/api/fabric/report/items/get-report-definition>`_.
+
     Parameters
     ----------
     report : str

sempy_labs/report/_paginated.py

@@ -0,0 +1,74 @@
+import sempy.fabric as fabric
+from typing import Optional
+from sempy.fabric.exceptions import FabricHTTPException
+import pandas as pd
+
+
+def get_report_datasources(
+    report: str,
+    workspace: Optional[str] = None,
+) -> pd.DataFrame:
+    """
+    Returns a list of data sources for the specified paginated report (RDL) from the specified workspace.
+
+    Parameters
+    ----------
+    report : str | List[str]
+        Name(s) of the Power BI report(s).
+    workspace : str, default=None
+        The name of the Fabric workspace in which the report resides.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of data sources for the specified paginated report (RDL) from the specified workspace.
+    """
+
+    df = pd.DataFrame(
+        columns=[
+            "Report Name",
+            "Report Id",
+            "Datasource Id",
+            "Datasource Type",
+            "Gateway Id",
+            "Server",
+            "Database",
+        ]
+    )
+
+    if workspace is None:
+        workspace_id = fabric.get_workspace_id()
+        workspace = fabric.resolve_workspace_name(workspace_id)
+    else:
+        workspace_id = fabric.resolve_workspace_id(workspace)
+
+    report_id = fabric.resolve_item_id(
+        item_name=report, type="PaginatedReport", workspace=workspace
+    )
+
+    client = fabric.PowerBIRestClient()
+
+    response = client.get(
+        f"/v1.0/myorg/groups/{workspace_id}/reports/{report_id}/datasources"
+    )
+
+    if response.status_code != 200:
+        raise FabricHTTPException(response)
+
+    for i in response.json().get("value", []):
+        conn = i.get("connectionDetails", {})
+        new_data = {
+            "Report Name": report,
+            "Report Id": report_id,
+            "Datasource Id": i.get("datasourceId"),
+            "Datasource Type": i.get("datasourceType"),
+            "Gateway Id": i.get("gatewayId"),
+            "Server": conn.get("server") if conn else None,
+            "Database": conn.get("database") if conn else None,
+        }
+
+        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    return df

sempy_labs/report/_report_functions.py

@@ -33,6 +33,8 @@ def get_report_json(
     """
     Gets the report.json file content of a Power BI report.
 
+    This is a wrapper function for the following API: `Items - Get Report Definition <https://learn.microsoft.com/rest/api/fabric/report/items/get-report-definition>`_.
+
     Parameters
     ----------
     report : str
@@ -157,6 +159,8 @@ def export_report(
     """
     Exports a Power BI report to a file in your lakehouse.
 
+    This is a wrapper function for the following APIs: `Reports - Export To File In Group <https://learn.microsoft.com/rest/api/power-bi/reports/export-to-file-in-group>`_, `Reports - Get Export To File Status In Group <https://learn.microsoft.com/rest/api/power-bi/reports/get-export-to-file-status-in-group>`_, `Reports - Get File Of Export To File In Group <https://learn.microsoft.com/rest/api/power-bi/reports/get-file-of-export-to-file-in-group>`_.
+
     Parameters
     ----------
     report : str
@@ -401,6 +405,8 @@ def clone_report(
     """
     Clones a Power BI report.
 
+    This is a wrapper function for the following API: `Reports - Clone Report In Group <https://learn.microsoft.com/rest/api/power-bi/reports/clone-report-in-group>`_.
+
     Parameters
     ----------
     report : str

sempy_labs/report/_report_rebind.py

@@ -19,6 +19,8 @@ def report_rebind(
     """
     Rebinds a report to a semantic model.
 
+    This is a wrapper function for the following API: `Reports - Rebind Report In Group <https://learn.microsoft.com/rest/api/power-bi/reports/rebind-report-in-group>`_.
+
     Parameters
     ----------
     report : str | List[str]