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

sempy_labs/_capacities.py

@@ -37,6 +37,8 @@ def create_fabric_capacity(
     """
     This function creates a new Fabric capacity within an Azure subscription.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Create Or Update <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/create-or-update?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -253,6 +255,8 @@ def suspend_fabric_capacity(
     """
     This function suspends a Fabric capacity.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Suspend <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/suspend?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -286,7 +290,7 @@ def suspend_fabric_capacity(
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been suspended.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been suspended.")
 
 
 def resume_fabric_capacity(
@@ -301,6 +305,8 @@ def resume_fabric_capacity(
     """
     This function resumes a Fabric capacity.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Resume <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/resume?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -335,7 +341,7 @@ def resume_fabric_capacity(
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been resumed.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been resumed.")
 
 
 def delete_embedded_capacity(
@@ -384,7 +390,7 @@ def delete_embedded_capacity(
     if response.status_code not in [200, 202]:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been deleted.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
 
 
 def delete_premium_capacity(capacity_name: str):
@@ -427,6 +433,8 @@ def delete_fabric_capacity(
     """
     This function deletes a Fabric capacity.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Delete <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/delete?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -461,7 +469,7 @@ def delete_fabric_capacity(
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been deleted.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
 
 
 def update_fabric_capacity(
@@ -479,6 +487,8 @@ def update_fabric_capacity(
     """
     This function updates a Fabric capacity's properties.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Update <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/update?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -521,26 +531,47 @@ def update_fabric_capacity(
 
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Fabric/capacities/{capacity_name}?api-version={icons.azure_api_version}"
 
+    get_response = requests.get(url, headers=headers)
+    if get_response.status_code != 200:
+        raise FabricHTTPException(get_response)
+
+    get_json = get_response.json()
+    current_sku = get_json.get("sku", {}).get("name")
+    current_admins = (
+        get_json.get("properties", {}).get("administration", {}).get("members")
+    )
+    current_tags = get_json.get("tags")
+
     payload = {}
+    payload["sku"] = {
+        "name": current_sku,
+        "tier": "Fabric",
+    }
+    payload["tags"] = current_tags
+    payload["properties"] = get_json["properties"]
+
     if sku is not None:
-        payload["sku"] = {"name": sku, "tier": "Fabric"}
+        payload["sku"]["name"] = sku
     if admin_members is not None:
-        payload["properties"] = {"administration": {"members": [admin_members]}}
-
-    payload = _add_sll_tag(payload, tags)
+        payload["properties"] = {"administration": {"members": admin_members}}
+    if tags is not None:
+        payload["tags"] = tags
 
-    if payload == {}:
-        raise ValueError(
-            f"{icons.warning} No parameters have been set to update the '{capacity_name}' capacity."
+    # Do not proceed if no properties are being changed
+    if current_sku == sku and current_admins == admin_members and current_tags == tags:
+        print(
+            f"{icons.yellow_dot} The properties of the '{capacity_name}' are the same as those specified in the parameters of this function. No changes have been made."
         )
+        return
 
-    response = requests.patch(url, headers=headers, data=payload)
+    payload = _add_sll_tag(payload, tags)
+    response = requests.patch(url, headers=headers, json=payload)
 
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
     print(
-        f"{icons.green_dot} The '{capacity_name} capacity has been updated accordingly."
+        f"{icons.green_dot} The '{capacity_name}' capacity has been updated accordingly."
     )
 
 
@@ -556,6 +587,8 @@ def check_fabric_capacity_name_availablility(
     """
     This function updates a Fabric capacity's properties.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Check Name Availability <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/check-name-availability?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -611,6 +644,8 @@ def create_resource_group(
     """
     This function creates a resource group in a region within an Azure subscription.
 
+    This is a wrapper function for the following API: `ResourceGroupsOperations Class - CreateOrUpdate <https://learn.microsoft.com/python/api/azure-mgmt-resource/azure.mgmt.resource.resources.v2022_09_01.operations.resourcegroupsoperations?view=azure-python#azure-mgmt-resource-resources-v2022-09-01-operations-resourcegroupsoperations-create-or-update>`_.
+
     Parameters
     ----------
     azure_subscription_id : str
@@ -631,7 +666,7 @@ def create_resource_group(
 
     from azure.mgmt.resource import ResourceManagementClient
 
-    azure_token, credential, headers = get_azure_token_credentials(
+    azure_token, credential, headers = _get_azure_token_credentials(
         key_vault_uri=key_vault_uri,
         key_vault_tenant_id=key_vault_tenant_id,
         key_vault_client_id=key_vault_client_id,

sempy_labs/_capacity_migration.py

@@ -632,7 +632,6 @@ def migrate_fabric_trial_capacity(
     source_capacity: str,
     target_capacity: str,
     target_capacity_sku: str = "F64",
-    target_capacity_region: Optional[str] = None,
     target_capacity_admin_members: Optional[str | List[str]] = None,
 ):
     """
@@ -658,9 +657,6 @@ def migrate_fabric_trial_capacity(
         The name of the new Fabric capacity (F SKU). If this capacity does not exist, it will be created.
     target_capacity_sku : str, default="F64"
         If the target capacity does not exist, this property sets the SKU size for the target capacity.
-    target_capacity_region : str, default=None
-        If the target capacity does not exist, this property sets the region for the target capacity.
-        Defaults to None which resolves to the region in which the Trial SKU exists.
     target_capacity_admin_members : str, default=None
         If the target capacity does not exist, this property sets the admin members for the target capacity.
         Defaults to None which resolves to the admin members on the Trial SKU.
@@ -691,9 +687,7 @@ def migrate_fabric_trial_capacity(
         )
         return
 
-    # Use same region as source capacity if no region is specified
-    if target_capacity_region is None:
-        target_capacity_region = dfC_filt["Region"].iloc[0]
+    target_capacity_region = dfC_filt["Region"].iloc[0]
 
     # Use same admins as source capacity
     if isinstance(target_capacity_admin_members, str):

sempy_labs/_data_pipelines.py

@@ -15,6 +15,8 @@ def list_data_pipelines(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the data pipelines within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Data Pipelines <https://learn.microsoft.com/rest/api/fabric/datapipeline/items/list-data-pipelines>`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -57,6 +59,8 @@ def create_data_pipeline(
     """
     Creates a Fabric data pipeline.
 
+    This is a wrapper function for the following API: `Items - Create Data Pipeline <https://learn.microsoft.com/rest/api/fabric/datapipeline/items/create-data-pipeline>`_.
+
     Parameters
     ----------
     name: str
@@ -92,6 +96,8 @@ def delete_data_pipeline(name: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric data pipeline.
 
+    This is a wrapper function for the following API: `Items - Delete Data Pipeline <https://learn.microsoft.com/rest/api/fabric/datapipeline/items/delete-data-pipeline>`_.
+
     Parameters
     ----------
     name: str

sempy_labs/_dataflows.py

@@ -2,10 +2,12 @@ import sempy.fabric as fabric
 import pandas as pd
 from sempy_labs._helper_functions import (
     resolve_workspace_name_and_id,
+    _is_valid_uuid,
 )
-from typing import Optional
+from typing import Optional, Tuple
 import sempy_labs._icons as icons
 from sempy.fabric.exceptions import FabricHTTPException
+from uuid import UUID
 
 
 def list_dataflows(workspace: Optional[str] = None):
@@ -59,6 +61,8 @@ def assign_workspace_to_dataflow_storage(
     """
     Assigns a dataflow storage account to a workspace.
 
+    This is a wrapper function for the following API: `Dataflow Storage Accounts - Groups AssignToDataflowStorage <https://learn.microsoft.com/rest/api/power-bi/dataflow-storage-accounts/groups-assign-to-dataflow-storage>`_.
+
     Parameters
     ----------
     dataflow_storage_account : str
@@ -99,6 +103,8 @@ def list_dataflow_storage_accounts() -> pd.DataFrame:
     """
     Shows the accessible dataflow storage accounts.
 
+    This is a wrapper function for the following API: `Dataflow Storage Accounts - Get Dataflow Storage Accounts <https://learn.microsoft.com/rest/api/power-bi/dataflow-storage-accounts/get-dataflow-storage-accounts>`_.
+
     Returns
     -------
     pandas.DataFrame
@@ -128,3 +134,114 @@ def list_dataflow_storage_accounts() -> pd.DataFrame:
     df["Enabled"] = df["Enabled"].astype(bool)
 
     return df
+
+
+def list_upstream_dataflows(
+    dataflow: str | UUID, workspace: Optional[str] = None
+) -> pd.DataFrame:
+    """
+    Shows a list of upstream dataflows for the specified dataflow.
+
+    This is a wrapper function for the following API: `Dataflows - Get Upstream Dataflows In Group <https://learn.microsoft.com/rest/api/power-bi/dataflows/get-upstream-dataflows-in-group>`_.
+
+    Parameters
+    ----------
+    dataflow : str | UUID
+        Name or UUID of the dataflow.
+    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.
+
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of upstream dataflows for the specified dataflow.
+    """
+
+    workspace_name = fabric.resolve_workspace_name(workspace)
+    workspace_id = fabric.resolve_workspace_id(workspace)
+    (dataflow_name, dataflow_id) = _resolve_dataflow_name_and_id(
+        dataflow=dataflow, workspace=workspace
+    )
+    client = fabric.PowerBIRestClient()
+
+    df = pd.DataFrame(
+        columns=[
+            "Dataflow Name",
+            "Dataflow Id",
+            "Workspace Name",
+            "Workspace Id",
+            "Upstream Dataflow Name",
+            "Upstream Dataflow Id",
+            "Upstream Workspace Name",
+            "Upstream Workspace Id",
+        ]
+    )
+
+    def collect_upstreams(
+        client, dataflow_id, dataflow_name, workspace_id, workspace_name
+    ):
+        response = client.get(
+            f"/v1.0/myorg/groups/{workspace_id}/dataflows/{dataflow_id}/upstreamDataflows"
+        )
+        if response.status_code != 200:
+            raise FabricHTTPException(response)
+
+        values = response.json().get("value", [])
+        for v in values:
+            tgt_dataflow_id = v.get("targetDataflowId")
+            tgt_workspace_id = v.get("groupId")
+            tgt_workspace_name = fabric.resolve_workspace_name(tgt_workspace_id)
+            (tgt_dataflow_name, _) = _resolve_dataflow_name_and_id(
+                dataflow=tgt_dataflow_id, workspace=tgt_workspace_name
+            )
+
+            df.loc[len(df)] = {
+                "Dataflow Name": dataflow_name,
+                "Dataflow Id": dataflow_id,
+                "Workspace Name": workspace_name,
+                "Workspace Id": workspace_id,
+                "Upstream Dataflow Name": tgt_dataflow_name,
+                "Upstream Dataflow Id": tgt_dataflow_id,
+                "Upstream Workspace Name": tgt_workspace_name,
+                "Upstream Workspace Id": tgt_workspace_id,
+            }
+
+            collect_upstreams(
+                client,
+                tgt_dataflow_id,
+                tgt_dataflow_name,
+                tgt_workspace_id,
+                tgt_workspace_name,
+            )
+
+    collect_upstreams(client, dataflow_id, dataflow_name, workspace_id, workspace_name)
+
+    return df
+
+
+def _resolve_dataflow_name_and_id(
+    dataflow: str | UUID, workspace: Optional[str] = None
+) -> Tuple[str, UUID]:
+
+    if workspace is None:
+        workspace = fabric.resolve_workspace_name(workspace)
+
+    dfD = list_dataflows(workspace=workspace)
+
+    if _is_valid_uuid(dataflow):
+        dfD_filt = dfD[dfD["Dataflow Id"] == dataflow]
+    else:
+        dfD_filt = dfD[dfD["Dataflow Name"] == dataflow]
+
+    if len(dfD_filt) == 0:
+        raise ValueError(
+            f"{icons.red_dot} The '{dataflow}' dataflow does not exist within the '{workspace}' workspace."
+        )
+
+    dataflow_id = dfD_filt["Dataflow Id"].iloc[0]
+    dataflow_name = dfD_filt["Dataflow Name"].iloc[0]
+
+    return dataflow_name, dataflow_id

sempy_labs/_dax.py

@@ -3,9 +3,12 @@ import pandas as pd
 from sempy_labs._helper_functions import (
     resolve_dataset_id,
     resolve_workspace_name_and_id,
+    format_dax_object_name,
 )
+from sempy_labs._model_dependencies import get_model_calc_dependencies
 from typing import Optional
 from sempy._utils._log import log
+from tqdm.auto import tqdm
 
 
 @log
@@ -40,10 +43,7 @@ def evaluate_dax_impersonation(
         A pandas dataframe holding the result of the DAX query.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/power-bi/datasets/execute-queries-in-group
-
     (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
-
     dataset_id = resolve_dataset_id(dataset=dataset, workspace=workspace)
 
     request_body = {
@@ -62,3 +62,189 @@ def evaluate_dax_impersonation(
     df = pd.DataFrame(data_rows, columns=column_names)
 
     return df
+
+
+@log
+def get_dax_query_dependencies(
+    dataset: str,
+    dax_string: str,
+    put_in_memory: bool = False,
+    workspace: Optional[str] = None,
+) -> pd.DataFrame:
+    """
+    Obtains the columns on which a DAX query depends, including model dependencies. Shows Vertipaq statistics (i.e. Total Size, Data Size, Dictionary Size, Hierarchy Size) for easy prioritizing.
+
+    Parameters
+    ----------
+    dataset : str
+        Name of the semantic model.
+    dax_string : str
+        The DAX query.
+    put_in_memory : bool, default=False
+        If True, ensures that the dependent columns are put into memory in order to give realistic Vertipaq stats (i.e. Total Size etc.).
+    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.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the dependent columns of a given DAX query including model dependencies.
+    """
+
+    if workspace is None:
+        workspace = fabric.resolve_workspace_name(workspace)
+
+    # Escape quotes in dax
+    dax_string = dax_string.replace('"', '""')
+    final_query = f"""
+        EVALUATE
+        VAR source_query = "{dax_string}"
+        VAR all_dependencies = SELECTCOLUMNS(
+            INFO.CALCDEPENDENCY("QUERY", source_query),
+                "Referenced Object Type",[REFERENCED_OBJECT_TYPE],
+                "Referenced Table", [REFERENCED_TABLE],
+                "Referenced Object", [REFERENCED_OBJECT]
+            )             
+        RETURN all_dependencies
+        """
+    dep = fabric.evaluate_dax(
+        dataset=dataset, workspace=workspace, dax_string=final_query
+    )
+
+    # Clean up column names and values (remove outside square brackets, underscorees in object type)
+    dep.columns = dep.columns.map(lambda x: x[1:-1])
+    dep["Referenced Object Type"] = (
+        dep["Referenced Object Type"].str.replace("_", " ").str.title()
+    )
+    dep
+
+    # Dataframe df will contain the output of all dependencies of the objects used in the query
+    df = dep.copy()
+
+    cd = get_model_calc_dependencies(dataset=dataset, workspace=workspace)
+
+    for _, r in dep.iterrows():
+        ot = r["Referenced Object Type"]
+        object_name = r["Referenced Object"]
+        table_name = r["Referenced Table"]
+        cd_filt = cd[
+            (cd["Object Type"] == ot)
+            & (cd["Object Name"] == object_name)
+            & (cd["Table Name"] == table_name)
+        ]
+
+        # Adds in the dependencies of each object used in the query (i.e. relationship etc.)
+        if len(cd_filt) > 0:
+            subset = cd_filt[
+                ["Referenced Object Type", "Referenced Table", "Referenced Object"]
+            ]
+            df = pd.concat([df, subset], ignore_index=True)
+
+    df.columns = df.columns.map(lambda x: x.replace("Referenced ", ""))
+    # Remove duplicates
+    df = df.drop_duplicates().reset_index(drop=True)
+    # Only show columns and remove the rownumber column
+    df = df[
+        (df["Object Type"].isin(["Column", "Calc Column"]))
+        & (~df["Object"].str.startswith("RowNumber-"))
+    ]
+
+    # Get vertipaq stats, filter to just the objects in the df dataframe
+    df["Full Object"] = format_dax_object_name(df["Table"], df["Object"])
+    dfC = fabric.list_columns(dataset=dataset, workspace=workspace, extended=True)
+    dfC["Full Object"] = format_dax_object_name(dfC["Table Name"], dfC["Column Name"])
+
+    dfC_filtered = dfC[dfC["Full Object"].isin(df["Full Object"].values)][
+        [
+            "Table Name",
+            "Column Name",
+            "Total Size",
+            "Data Size",
+            "Dictionary Size",
+            "Hierarchy Size",
+            "Is Resident",
+            "Full Object",
+        ]
+    ].reset_index(drop=True)
+
+    if put_in_memory:
+        not_in_memory = dfC_filtered[dfC_filtered["Is Resident"] == False]
+
+        if len(not_in_memory) > 0:
+            tbls = not_in_memory["Table Name"].unique()
+
+            # Run basic query to get columns into memory; completed one table at a time (so as not to overload the capacity)
+            for table_name in (bar := tqdm(tbls)):
+                bar.set_description(f"Warming the '{table_name}' table...")
+                css = ", ".join(
+                    not_in_memory[not_in_memory["Table Name"] == table_name][
+                        "Full Object"
+                    ]
+                    .astype(str)
+                    .tolist()
+                )
+                dax = f"""EVALUATE TOPN(1,SUMMARIZECOLUMNS({css}))"""
+                fabric.evaluate_dax(
+                    dataset=dataset, dax_string=dax, workspace=workspace
+                )
+
+            # Get column stats again
+            dfC = fabric.list_columns(
+                dataset=dataset, workspace=workspace, extended=True
+            )
+            dfC["Full Object"] = format_dax_object_name(
+                dfC["Table Name"], dfC["Column Name"]
+            )
+
+            dfC_filtered = dfC[dfC["Full Object"].isin(df["Full Object"].values)][
+                [
+                    "Table Name",
+                    "Column Name",
+                    "Total Size",
+                    "Data Size",
+                    "Dictionary Size",
+                    "Hierarchy Size",
+                    "Is Resident",
+                    "Full Object",
+                ]
+            ].reset_index(drop=True)
+
+    dfC_filtered.drop(["Full Object"], axis=1, inplace=True)
+
+    return dfC_filtered
+
+
+@log
+def get_dax_query_memory_size(
+    dataset: str, dax_string: str, workspace: Optional[str] = None
+) -> int:
+    """
+    Obtains the total size, in bytes, used by all columns that a DAX query depends on.
+
+    Parameters
+    ----------
+    dataset : str
+        Name of the semantic model.
+    dax_string : str
+        The DAX query.
+    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.
+
+    Returns
+    -------
+    int
+        The total size, in bytes, used by all columns that the DAX query depends on.
+    """
+
+    if workspace is None:
+        workspace = fabric.resolve_workspace_name(workspace)
+
+    df = get_dax_query_dependencies(
+        dataset=dataset, workspace=workspace, dax_string=dax_string, put_in_memory=True
+    )
+
+    return df["Total Size"].sum()

sempy_labs/_deployment_pipelines.py

@@ -11,6 +11,8 @@ def list_deployment_pipelines() -> pd.DataFrame:
     """
     Shows a list of deployment pipelines the user can access.
 
+    This is a wrapper function for the following API: `Deployment Pipelines - List Deployment Pipelines <https://learn.microsoft.com/rest/api/fabric/core/deployment-pipelines/list-deployment-pipelines>`_.
+
     Returns
     -------
     pandas.DataFrame
@@ -45,6 +47,8 @@ def list_deployment_pipeline_stages(deployment_pipeline: str) -> pd.DataFrame:
     """
     Shows the specified deployment pipeline stages.
 
+    This is a wrapper function for the following API: `Deployment Pipelines - List Deployment Pipeline Stages <https://learn.microsoft.com/rest/api/fabric/core/deployment-pipelines/list-deployment-pipeline-stages>`_.
+
     Parameters
     ----------
     deployment_pipeline : str
@@ -84,13 +88,13 @@ def list_deployment_pipeline_stages(deployment_pipeline: str) -> pd.DataFrame:
     for r in responses:
         for v in r.get("value", []):
             new_data = {
-                "Deployment Pipeline Stage Id": v["id"],
-                "Deployment Pipeline Stage Name": v["displayName"],
-                "Description": v["description"],
-                "Order": v["order"],
-                "Workspace Id": v["workspaceId"],
-                "Workspace Name": v["workspaceName"],
-                "Public": v["isPublic"],
+                "Deployment Pipeline Stage Id": v.get("id"),
+                "Deployment Pipeline Stage Name": v.get("displayName"),
+                "Description": v.get("description"),
+                "Order": v.get("order"),
+                "Workspace Id": v.get("workspaceId"),
+                "Workspace Name": v.get("workspaceName"),
+                "Public": v.get("isPublic"),
             }
             df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
 
@@ -106,6 +110,8 @@ def list_deployment_pipeline_stage_items(
     """
     Shows the supported items from the workspace assigned to the specified stage of the specified deployment pipeline.
 
+    This is a wrapper function for the following API: `Deployment Pipelines - List Deployment Pipeline Stage Items <https://learn.microsoft.com/rest/api/fabric/core/deployment-pipelines/list-deployment-pipeline-stage-items>`_.
+
     Parameters
     ----------
     deployment_pipeline : str

sempy_labs/_environments.py

@@ -16,6 +16,8 @@ def create_environment(
     """
     Creates a Fabric environment.
 
+    This is a wrapper function for the following API: `Items - Create Environment <https://learn.microsoft.com/rest/api/fabric/environment/items/create-environment>`_.
+
     Parameters
     ----------
     environment: str
@@ -51,6 +53,8 @@ def list_environments(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the environments within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Environments <https://learn.microsoft.com/rest/api/fabric/environment/items/list-environments>`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -91,6 +95,8 @@ def delete_environment(environment: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric environment.
 
+    This is a wrapper function for the following API: `Items - Delete Environment <https://learn.microsoft.com/rest/api/fabric/environment/items/delete-environment>`_.
+
     Parameters
     ----------
     environment: str

sempy_labs/_eventhouses.py

@@ -16,6 +16,8 @@ def create_eventhouse(
     """
     Creates a Fabric eventhouse.
 
+    This is a wrapper function for the following API: `Items - Create Eventhouse <https://learn.microsoft.com/rest/api/fabric/environment/items/create-eventhouse>`_.
+
     Parameters
     ----------
     name: str
@@ -51,6 +53,8 @@ def list_eventhouses(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the eventhouses within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Eventhouses <https://learn.microsoft.com/rest/api/fabric/environment/items/list-eventhouses>`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -91,6 +95,8 @@ def delete_eventhouse(name: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric eventhouse.
 
+    This is a wrapper function for the following API: `Items - Delete Eventhouse <https://learn.microsoft.com/rest/api/fabric/environment/items/delete-eventhouse>`_.
+
     Parameters
     ----------
     name: str