semantic-link-labs 0.12.2__py3-none-any.whl → 0.12.3__py3-none-any.whl

{semantic_link_labs-0.12.2.dist-info → semantic_link_labs-0.12.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.12.2
+Version: 0.12.3
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -26,7 +26,7 @@ Dynamic: license-file
 # Semantic Link Labs
 
 [![PyPI version](https://badge.fury.io/py/semantic-link-labs.svg)](https://badge.fury.io/py/semantic-link-labs)
-[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.2&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Downloads](https://static.pepy.tech/badge/semantic-link-labs)](https://pepy.tech/project/semantic-link-labs)
 
@@ -154,6 +154,7 @@ An even better way to ensure the semantic-link-labs library is available in your
 2. Select your newly created environment within the 'Environment' drop down in the navigation bar at the top of the notebook
 
 ## Version History
+* [0.12.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.3) (September 17, 2025)
 * [0.12.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.2) (September 12, 2025)
 * [0.12.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.1) (September 4, 2025)
 * [0.12.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.0) (September 2, 2025)

{semantic_link_labs-0.12.2.dist-info → semantic_link_labs-0.12.3.dist-info}/RECORD

@@ -1,6 +1,6 @@
-semantic_link_labs-0.12.2.dist-info/licenses/LICENSE,sha256=ws_MuBL-SCEBqPBFl9_FqZkaaydIJmxHrJG2parhU4M,1141
-sempy_labs/__init__.py,sha256=ftNoWwvm0GfuyNRo3ObrtwqBFtoi71QALNLPECyx84c,16361
-sempy_labs/_a_lib_info.py,sha256=i6qs3OhdpTrleupFQc-NjZPBCANJDJeKGl37EJgjlc0,53
+semantic_link_labs-0.12.3.dist-info/licenses/LICENSE,sha256=ws_MuBL-SCEBqPBFl9_FqZkaaydIJmxHrJG2parhU4M,1141
+sempy_labs/__init__.py,sha256=YHGcCDoS9Vr9GPSIZ0ziX0bih9J6qrCDFHFBp4iep5g,16533
+sempy_labs/_a_lib_info.py,sha256=CqHuHL_fnKTvOytnNfVS-2H843UDtuG44yT4bAY9aOA,53
 sempy_labs/_ai.py,sha256=fiI3RCadJ2jG15vZIWD9rKVhvmGWoD9uth9-PlSPBNs,16196
 sempy_labs/_authentication.py,sha256=-mSXB3tlVhutOo2nhmQQOllWWVvuy4G9rTM77v4S8lw,8485
 sempy_labs/_capacities.py,sha256=TQYlbM0LP21G-KsW6QrJ7heBzKL42XxA939VldWiKeg,40436
@@ -23,10 +23,11 @@ sempy_labs/_eventhouses.py,sha256=AJXJ00AOfEaKq0wagZfoLHorztyLHaRx6pkdbunCvFI,59
 sempy_labs/_eventstreams.py,sha256=o9DPk1nBS3TDbokPP9AEtM18CmtRhaHI7LGZ2sRmTeA,4118
 sempy_labs/_external_data_shares.py,sha256=qHirKpBGseQOkg3xHOM5450Wpz3vmWfG3xexYjLQT9M,8945
 sempy_labs/_gateways.py,sha256=Nsb2qSXiAVS0CELhjji4FkKVBdnXhP-6spqqTBZc6sU,18100
-sempy_labs/_generate_semantic_model.py,sha256=hK2f61PR55080smJBIrq7BgcoTWal_4i4eQulwHjtos,18236
+sempy_labs/_generate_semantic_model.py,sha256=jx6azjeLRiFTOF1up4u6emwOoD_EqFy1X18LyDcReb8,18236
+sempy_labs/_get_connection_string.py,sha256=55AAckOhWLC2Vz1bIjseGkWrC6pnN3sgIfLD8hAy45w,2989
 sempy_labs/_git.py,sha256=x8BrvkJNWkP6I-_os_wdNjEZVNViqfINmc-q7sGoQ3Q,17903
 sempy_labs/_graphQL.py,sha256=WDallUQBiOqJdz0aJmYH3cUXCOW_AqhFLs0EpV8_5Rw,2749
-sempy_labs/_helper_functions.py,sha256=dWqifJIgGTjjGTEzNxYsCpsiVv9kvCIrrGBnM8wb3VE,85166
+sempy_labs/_helper_functions.py,sha256=YBsKm2bC29QluFy156nPBZ-h1GDVjkFxLqFF_VQVU2c,85192
 sempy_labs/_icons.py,sha256=SB9EQeoFCfD4bO6fcYuJOoPRSYenSrW0rI9G5RFsH28,3579
 sempy_labs/_job_scheduler.py,sha256=iCrtFD3pWwUCmjPwV4XzMbmJn_Bn2DwDvedxN9qQNFo,18868
 sempy_labs/_kql_databases.py,sha256=Wr338mNf0wzvpBJYHbWHjzUudoeMZMUia_smdkzbPfI,4796
@@ -48,10 +49,10 @@ sempy_labs/_notebooks.py,sha256=_0Ug6SF2bihCEFt6P-6DjoGj3302OlDfXmfOJ-ue5Tg,1439
 sempy_labs/_one_lake_integration.py,sha256=aThg8Fcei9qTFUTzg2Qwsn-3deTk0ICTCXx53Y23oso,6293
 sempy_labs/_query_scale_out.py,sha256=tcIEJSHjZ1gh7--WMS8sDqDfF3wbfIEX9Xm2qgahXrc,15348
 sempy_labs/_refresh_semantic_model.py,sha256=yu92m4Ys6lbW68PP9tVCeUNHXj7cGXvyGr2WYRqgl1g,17365
-sempy_labs/_semantic_models.py,sha256=PbDM0u1mv6-aRwUJbxfsGm2yFFBTJvYotLFUHyvMF6g,12585
+sempy_labs/_semantic_models.py,sha256=WGIyzDA6AiuJG6A3VSMMNtVlUbAcHrEKJNTfxyiYosM,16975
 sempy_labs/_spark.py,sha256=aQAqmRAm04NWH9j4_qmYJAWdIluoWKzHDTBPr01GWbA,19404
 sempy_labs/_sql.py,sha256=Y7yRO8j0P6h68VNaqmWVSyfLrI9L9TMBLykovDkgIzY,8274
-sempy_labs/_sql_endpoints.py,sha256=eD2i5r7l9FA9YIW4i0PIpsG3H5mr1HPXJ9g6Lae1uNQ,6766
+sempy_labs/_sql_endpoints.py,sha256=EUiJxWdnivxYw5ZQxam9kipxy67RZfUVSJUpKnaUw0Q,6679
 sempy_labs/_sqldatabase.py,sha256=vmTsB1IAluQ99cf8fmcPO2z0SjAjTOM8OCD5nuJdSOI,6908
 sempy_labs/_tags.py,sha256=tqQlj7AvbaniN8mZl59g145Ofj_wdA6Bnrna0PzlwI4,5897
 sempy_labs/_translations.py,sha256=6A8CPmH_xvsONX4dOG5XSZ-XeJuAy5VokFJql6uf_Ak,1432
@@ -59,7 +60,7 @@ sempy_labs/_user_delegation_key.py,sha256=dj540zd_IGNt2GQ_a69_8IBoyZdpldx_3z6NxN
 sempy_labs/_utils.py,sha256=X7wcjg809ZyEgf6fE0mZIv9qe1n1oQX_hHXEHgR4u0U,2737
 sempy_labs/_vertipaq.py,sha256=1UvB79xOxeGdRFINsUsreXxtZtiatHlACAfbQhv45as,38536
 sempy_labs/_vpax.py,sha256=4rtXXGVoadvdu7uiU9PVsgKszST3XH-K56zmWdMmZEg,15471
-sempy_labs/_warehouses.py,sha256=ep4ZMa_1CNbWuQ3AGbGu8udOZ_SIochFJa4fCLqgkL0,9757
+sempy_labs/_warehouses.py,sha256=l5oJQTwqi0yW6ewHM2mS9TmRy7w1IWeeyQjDHJgWnuU,7788
 sempy_labs/_workloads.py,sha256=K2KPY1_e6SDqz_NQDBrrMlRwzEyVV5dqd1shBs8Bu6E,4731
 sempy_labs/_workspace_identity.py,sha256=rLzrNjnWbpjNn4bu7xW0nSjG9t1nbc4xG6BdkZNKP1Q,2605
 sempy_labs/_workspaces.py,sha256=djjY7zLLKqsN0UJqzVpCp3j6_k81RP3VimCv1IM8Eb4,18334
@@ -136,8 +137,9 @@ sempy_labs/directlake/_update_directlake_model_lakehouse_connection.py,sha256=dX
 sempy_labs/directlake/_update_directlake_partition_entity.py,sha256=EQpePqgTsetDG5JJrL5pfYjibmsuzrYk6x2mj0PDfEY,8984
 sempy_labs/directlake/_warm_cache.py,sha256=ks_rX2WOUk77rLsvwsCYyQOx-5U-pts27_guLYgMw6w,9236
 sempy_labs/dotnet_lib/dotnet.runtime.config.json,sha256=syhDFQv6cEmZnE1WtFjNe3NwhsIsnd-CFULv-vEWOFI,167
-sempy_labs/graph/__init__.py,sha256=OwFxe_JvIETazMCPw0Cx-tHXh5sGOiEPwawCeR6O7jg,794
+sempy_labs/graph/__init__.py,sha256=LLWs0t_rdu4oGBz9948Ob1UPDscDjhTWAswO8B4YthY,891
 sempy_labs/graph/_groups.py,sha256=T3uzMepJC3SYISV4C9y4sVY7r_qH609sScBMljhC5rY,17763
+sempy_labs/graph/_sensitivity_labels.py,sha256=tTTBQDevbaG5cdmCjgzbXIigamOi_Tx9o_2Wkfkc0bY,2907
 sempy_labs/graph/_teams.py,sha256=UH5ETsReD0pzmdgqQFkcX_95o1aUAv2lAajRJc0RIZY,3175
 sempy_labs/graph/_users.py,sha256=2QwwUYfaJnPHPY6M2a9QBWYwwkVDjpcbOQd_Bo9GjJ8,15181
 sempy_labs/lakehouse/__init__.py,sha256=jOCjgkIZgwl373pb6lmEwqIkbifwJUKY3K0eZ8LAVws,1245
@@ -209,10 +211,10 @@ sempy_labs/report/_bpareporttemplate/definition/pages/d37dce724a0ccc30044b/visua
 sempy_labs/theme/__init__.py,sha256=JN0z8w_Hc7VUIchRbpY-rjU6879msrFiSTRtMMlr_5g,185
 sempy_labs/theme/_org_themes.py,sha256=ArLqr1KYI6CT1_mxKOsZlVPaTO0KSkkQ1LbFy4A1fqg,3323
 sempy_labs/tom/__init__.py,sha256=ZwSpgYDP5VamZTnYP3a1cYHiaKdktOvlOBSOY1816zY,107
-sempy_labs/tom/_model.py,sha256=Izf1YSh2nE4VZq9K92cefJN8_onmqP7DD_o4oiOUCOQ,223020
+sempy_labs/tom/_model.py,sha256=8ArPJJJ8Wgo6FYWfEPWlVl60Umq8INdU6NOyMXaYavY,223643
 sempy_labs/variable_library/__init__.py,sha256=qyTw5vNldnwYv-TotQSFupwznKIQfcws1UxGjf1RNNo,437
 sempy_labs/variable_library/_functions.py,sha256=eoB3hUKFGdGMSBNDEsEF9bVoELZp5AnyDxp5BsLGeDc,13733
-semantic_link_labs-0.12.2.dist-info/METADATA,sha256=2ft_8tljZ0wn-asR56HeweU56aup-69e2a0WJFytrSY,27646
-semantic_link_labs-0.12.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-semantic_link_labs-0.12.2.dist-info/top_level.txt,sha256=kiQX1y42Dbein1l3Q8jMUYyRulDjdlc2tMepvtrvixQ,11
-semantic_link_labs-0.12.2.dist-info/RECORD,,
+semantic_link_labs-0.12.3.dist-info/METADATA,sha256=HhegWEKJLmk-NZMGq9L4gRnrODhbC3HzSvlZNZnRw3M,27747
+semantic_link_labs-0.12.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+semantic_link_labs-0.12.3.dist-info/top_level.txt,sha256=kiQX1y42Dbein1l3Q8jMUYyRulDjdlc2tMepvtrvixQ,11
+semantic_link_labs-0.12.3.dist-info/RECORD,,

sempy_labs/__init__.py

@@ -31,6 +31,8 @@ from ._semantic_models import (
     delete_semantic_model,
     update_semantic_model_refresh_schedule,
     list_semantic_model_datasources,
+    bind_semantic_model_connection,
+    unbind_semantic_model_connection,
 )
 from ._graphQL import (
     list_graphql_apis,
@@ -100,7 +102,6 @@ from ._warehouses import (
     delete_warehouse,
     get_warehouse_columns,
     get_warehouse_tables,
-    get_warehouse_connection_string,
 )
 from ._data_pipelines import (
     list_data_pipelines,
@@ -351,6 +352,9 @@ from ._user_delegation_key import (
 from ._data_access_security import (
     list_data_access_roles,
 )
+from ._get_connection_string import (
+    get_connection_string,
+)
 
 __all__ = [
     "resolve_warehouse_id",
@@ -603,6 +607,8 @@ __all__ = [
     "get_item_definition",
     "get_workspace_network_communication_policy",
     "set_workspace_network_communication_policy",
-    "get_warehouse_connection_string",
+    "get_connection_string",
     "list_data_access_roles",
+    "bind_semantic_model_connection",
+    "unbind_semantic_model_connection",
 ]

sempy_labs/_a_lib_info.py

@@ -1,2 +1,2 @@
 lib_name = "semanticlinklabs"
-lib_version = "0.12.2"
+lib_version = "0.12.3"

sempy_labs/_generate_semantic_model.py

@@ -22,7 +22,7 @@ from uuid import UUID
 @log
 def create_blank_semantic_model(
     dataset: str,
-    compatibility_level: int = 1605,
+    compatibility_level: int = 1702,
     workspace: Optional[str | UUID] = None,
     overwrite: bool = True,
 ):
@@ -33,7 +33,7 @@ def create_blank_semantic_model(
     ----------
     dataset : str
         Name of the semantic model.
-    compatibility_level : int, default=1605
+    compatibility_level : int, default=1702
         The compatibility level of the semantic model.
     workspace : str | uuid.UUID, default=None
         The Fabric workspace name or ID.

sempy_labs/_get_connection_string.py

@@ -0,0 +1,84 @@
+from sempy_labs._helper_functions import (
+    resolve_item_id,
+    _base_api,
+    resolve_workspace_id,
+)
+from typing import Optional, Literal
+import sempy_labs._icons as icons
+from uuid import UUID
+from sempy._utils._log import log
+
+
+@log
+def get_connection_string(
+    item: str | UUID,
+    type: Literal["Lakehouse", "Warehouse", "SQLEndpoint"],
+    workspace: Optional[str | UUID] = None,
+    guest_tenant_id: Optional[UUID] = None,
+    private_link_type: Optional[str] = None,
+) -> str:
+    """
+    Returns the SQL connection string of the specified item.
+
+    Parameters
+    ----------
+    item : str | uuid.UUID
+        The name or ID of the item (Lakehouse or MirroredDatabase).
+    type : Literal['Lakehouse', 'Warehouse', 'SQLEndpoint']
+        The type of the item. Must be 'Lakehouse' or 'MirroredDatabase'.
+    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.
+    guest_tenant_id : uuid.UUID, default=None
+        The guest tenant ID if the end user's tenant is different from the warehouse tenant.
+    private_link_type : str, default=None
+        Indicates the type of private link this connection string uses. Must be either 'Workspace' or 'None' or left as None.
+
+    Returns
+    -------
+    str
+        Returns the SQL connection string of the specified item.
+    """
+    workspace_id = resolve_workspace_id(workspace)
+    item_id = resolve_item_id(item=item, type=type, workspace=workspace)
+
+    type_dict = {
+        "Warehouse": "warehouses",
+        "SQLEndpoint": "sqlEndpoints",
+    }
+    type_for_url = type_dict.get(type)
+
+    if type == "Lakehouse":
+        response = _base_api(
+            f"/v1/workspaces/{workspace_id}/lakehouses/{item_id}", client="fabric_sp"
+        ).json()
+        return (
+            response.get("properties", {})
+            .get("sqlEndpointProperties", {})
+            .get("connectionString", {})
+        )
+    if type in ["SQLEndpoint", "Warehouse"]:
+        url = f"/v1/workspaces/{workspace_id}/{type_for_url}/{item_id}/connectionString"
+    else:
+        raise ValueError(
+            f"{icons.red_dot} The type must be 'Lakehouse', 'Warehouse' or 'SQLEndpoint'."
+        )
+
+    if private_link_type is not None and private_link_type not in ["Workspace", "None"]:
+        raise ValueError(
+            f"{icons.red_dot} private_link_type must be 'Workspace' or 'None' or left as None."
+        )
+
+    if guest_tenant_id or private_link_type:
+        params = []
+        if guest_tenant_id:
+            params.append(f"guestTenantId={guest_tenant_id}")
+        if private_link_type:
+            params.append(f"privateLinkType={private_link_type}")
+        param_str = "?" + "&".join(params)
+        url += param_str
+
+    response = _base_api(request=url, client="fabric_sp")
+
+    return response.json().get("connectionString")

sempy_labs/_helper_functions.py

@@ -549,6 +549,7 @@ def get_item_definition(
             definition["definition"]["parts"].append(
                 {"path": path, "payload": decoded_payload}
             )
+        return definition
     else:
         return result
 

sempy_labs/_semantic_models.py

@@ -348,3 +348,121 @@ def list_semantic_model_datasources(
         df = pd.DataFrame(rows, columns=list(columns.keys()))
 
     return df
+
+
+@log
+def bind_semantic_model_connection(
+    dataset: str | UUID,
+    connection_id: UUID,
+    connectivity_type: str,
+    connection_type: str,
+    connection_path: str,
+    workspace: Optional[str | UUID] = None,
+):
+    """
+    Binds a semantic model data source reference to a data connection.
+    This API can also be used to unbind data source references.
+
+    This is a wrapper function for the following API: `Items - Bind Semantic Model Connection <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
+    connection_id : uuid.UUID
+        The object ID of the connection.
+    connectivity_type : str
+        The connectivity type of the connection. Additional connectivity types may be added over time.
+    connection_type : str
+        The `type <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection?tabs=HTTP#connectivitytype>`_ of the connection.
+    connection_path : str
+        The path of the connection.
+    workspace : str | uuid.UUID, default=None
+        The 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)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(
+        dataset=dataset, workspace=workspace_id
+    )
+
+    payload = {
+        "connectionBinding": {
+            "id": str(connection_id),
+            "connectivityType": connectivity_type,
+            "connectionDetails": {
+                "type": connection_type,
+                "path": connection_path,
+            },
+        }
+    }
+
+    _base_api(
+        request=f"/v1/workspaces/{workspace_id}/semanticModels/{dataset_id}/bindConnection",
+        method="post",
+        client="fabric_sp",
+        payload=payload,
+    )
+
+    print(
+        f"{icons.green_dot} Connection '{connection_id}' has been bound to the '{dataset_name}' semantic model within the '{workspace_name}' workspace."
+    )
+
+
+@log
+def unbind_semantic_model_connection(
+    dataset: str | UUID,
+    connection_type: str,
+    connection_path: str,
+    workspace: Optional[str | UUID] = None,
+):
+    """
+    Unbinds a semantic model data source reference to a data connection.
+
+    This is a wrapper function for the following API: `Items - Bind Semantic Model Connection <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
+    connection_type : str
+        The `type <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/bind-semantic-model-connection?tabs=HTTP#connectivitytype>`_ of the connection.
+    connection_path : str
+        The path of the connection.
+    workspace : str | uuid.UUID, default=None
+        The 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)
+    (dataset_name, dataset_id) = resolve_dataset_name_and_id(
+        dataset=dataset, workspace=workspace_id
+    )
+
+    payload = {
+        "connectionBinding": {
+            "connectivityType": "None",
+            "connectionDetails": {
+                "type": connection_type,
+                "path": connection_path,
+            },
+        }
+    }
+
+    _base_api(
+        request=f"/v1/workspaces/{workspace_id}/semanticModels/{dataset_id}/bindConnection",
+        method="post",
+        client="fabric_sp",
+        payload=payload,
+    )
+
+    print(
+        f"{icons.green_dot} The '{dataset_name}' semantic model within the '{workspace_name}' workspace has been unbound from its connection."
+    )

sempy_labs/_sql_endpoints.py

@@ -66,7 +66,8 @@ def refresh_sql_endpoint_metadata(
     item: str | UUID,
     type: Literal["Lakehouse", "MirroredDatabase"],
     workspace: Optional[str | UUID] = None,
-    tables: dict[str, list[str]] = None,
+    timeout_unit: Literal["Seconds", "Minutes", "Hours", "Days"] = "Minutes",
+    timeout_value: int = 15,
 ) -> pd.DataFrame:
     """
     Refreshes the metadata of a SQL endpoint.
@@ -85,15 +86,10 @@ def refresh_sql_endpoint_metadata(
         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.
-    tables : dict[str, list[str]], default=None
-        A dictionary where the keys are schema names and the values are lists of table names.
-        If empty, all table metadata will be refreshed.
-
-        Example:
-        {
-            "dbo": ["DimDate", "DimGeography"],
-            "sls": ["FactSales", "FactBudget"],
-        }
+    timeout_unit : Literal['Seconds', 'Minutes', 'Hours', 'Days'], default='Minutes'
+        The unit of time for the request duration before timing out. Additional duration types may be added over time.
+    timeout_value : int, default=15
+        The number of time units in the request duration.
 
     Returns
     -------
@@ -132,14 +128,10 @@ def refresh_sql_endpoint_metadata(
     else:
         raise ValueError("Invalid type. Must be 'Lakehouse' or 'MirroredDatabase'.")
 
-    payload = {}
-    if tables:
-        payload = {
-            "tableDefinitions": [
-                {"schema": schema, "tableNames": tables}
-                for schema, tables in tables.items()
-            ]
-        }
+    payload = None
+    timeout_unit = timeout_unit.capitalize()
+    if timeout_unit != "Minutes" and timeout_value != 15:
+        payload = {"timeout": {"timeUnit": timeout_unit, "value": timeout_value}}
 
     result = _base_api(
         request=f"v1/workspaces/{workspace_id}/sqlEndpoints/{sql_endpoint_id}/refreshMetadata",
@@ -195,10 +187,8 @@ def refresh_sql_endpoint_metadata(
         df = df[column_order]
 
         printout = f"{icons.green_dot} The metadata of the SQL endpoint for the '{item_name}' {type.lower()} within the '{workspace_name}' workspace has been refreshed"
-        if tables:
-            print(f"{printout} for the following tables: {tables}.")
-        else:
-            print(f"{printout} for all tables.")
+        print(f"{printout} for all tables.")
+        _update_dataframe_datatypes(df, columns)
     else:
         # If the target item has no tables to refresh the metadata for
         df = pd.DataFrame(columns=columns.keys())
@@ -206,6 +196,4 @@ def refresh_sql_endpoint_metadata(
             f"{icons.yellow_dot} The SQL endpoint '{item_name}' {type.lower()} within the '{workspace_name}' workspace has no tables to refresh..."
         )
 
-    _update_dataframe_datatypes(df, columns)
-
     return df

sempy_labs/_warehouses.py

@@ -1,5 +1,4 @@
-from ._helper_functions import (
-    resolve_item_id,
+from sempy_labs._helper_functions import (
     resolve_workspace_name_and_id,
     _base_api,
     _create_dataframe,
@@ -233,57 +232,3 @@ def get_warehouse_columns(
         )
 
     return df
-
-
-@log
-def get_warehouse_connection_string(
-    warehouse: str | UUID,
-    workspace: Optional[str | UUID] = None,
-    guest_tenant_id: Optional[UUID] = None,
-    private_link_type: Optional[str] = None,
-) -> str:
-    """
-    Returns the SQL connection string of the specified warehouse.
-
-    Parameters
-    ----------
-    warehouse : str | uuid.UUID
-        Name or ID of the Fabric warehouse.
-    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.
-    guest_tenant_id : uuid.UUID, default=None
-        The guest tenant ID if the end user's tenant is different from the warehouse tenant.
-    private_link_type : str, default=None
-        Indicates the type of private link this connection string uses. Must be either 'Workspace' or 'None' or left as None.
-
-    Returns
-    -------
-    str
-        Returns the SQL connection string of the specified warehouse.
-    """
-    workspace_id = resolve_workspace_id(workspace)
-    warehouse_id = resolve_item_id(
-        item=warehouse, type="Warehouse", workspace=workspace
-    )
-
-    url = f"/v1/workspaces/{workspace_id}/warehouses/{warehouse_id}/connectionString"
-
-    if private_link_type is not None and private_link_type not in ["Workspace", "None"]:
-        raise ValueError(
-            f"{icons.red_dot} private_link_type must be 'Workspace' or 'None' or left as None."
-        )
-
-    if guest_tenant_id or private_link_type:
-        params = []
-        if guest_tenant_id:
-            params.append(f"guestTenantId={guest_tenant_id}")
-        if private_link_type:
-            params.append(f"privateLinkType={private_link_type}")
-        param_str = "?" + "&".join(params)
-        url += param_str
-
-    response = _base_api(request=url, client="fabric_sp")
-
-    return response.json().get("connectionString")

sempy_labs/graph/__init__.py

@@ -22,6 +22,9 @@ from ._users import (
 from ._teams import (
     list_teams,
 )
+from ._sensitivity_labels import (
+    list_sensitivity_labels,
+)
 
 __all__ = [
     "list_groups",
@@ -42,4 +45,5 @@ __all__ = [
     "delete_group",
     "update_user",
     "update_group",
+    "list_sensitivity_labels",
 ]

sempy_labs/graph/_sensitivity_labels.py

@@ -0,0 +1,81 @@
+import pandas as pd
+from uuid import UUID
+from typing import Optional
+from sempy_labs._helper_functions import (
+    _base_api,
+    _create_dataframe,
+    _update_dataframe_datatypes,
+)
+from sempy._utils._log import log
+
+
+@log
+def list_sensitivity_labels(user: Optional[str | UUID] = None) -> pd.DataFrame:
+    """
+    Get a list of `sensitivity label <https://learn.microsoft.com/graph/api/resources/security-sensitivitylabel>`_ objects associated with a user or organization.
+
+    This is a wrapper function for the following API: `List sensitivityLabels https://learn.microsoft.com/graph/api/security-informationprotection-list-sensitivitylabels>`_.
+
+    Service Principal Authentication is required (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    user : str | uuid.UUID
+        The user ID or user principal name.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of `sensitivity label <https://learn.microsoft.com/graph/api/resources/security-sensitivitylabel>`_ objects associated with a user or organization.
+    """
+    from sempy_labs.graph import resolve_user_id
+
+    url = "/security/informationProtection/sensitivityLabels"
+
+    if user is not None:
+        user_id = resolve_user_id(user=user)
+        url = f"users/{user_id}{url}"
+
+    result = _base_api(request=url, client="graph").json()
+
+    columns = {
+        "Sensitivity Label Id": "str",
+        "Sensitivity Label Name": "str",
+        "Description": "str",
+        "Color": "str",
+        "Sensitivity": "int",
+        "Tooltip": "str",
+        "Is Active": "bool",
+        "Is Appliable": "bool",
+        "Has Protection": "bool",
+        "Parent Sensitivity Label Id": "str",
+        "Parent Sensitivity Label Name": "str",
+    }
+    df = _create_dataframe(columns=columns)
+
+    rows = []
+    for item in result.get("value", []):
+        row = {
+            "Sensitivity Label Id": item.get("id"),
+            "Sensitivity Label Name": item.get("name"),
+            "Description": item.get("description"),
+            "Color": item.get("color"),
+            "Sensitivity": item.get("sensitivity"),
+            "Tooltip": item.get("tooltip"),
+            "Is Active": item.get("isActive"),
+            "Is Appliable": item.get("isAppliable"),
+            "Has Protection": item.get("hasProtection"),
+            "Parent Sensitivity Label Id": (
+                item.get("parent", {}).get("id") if item.get("parent") else None
+            ),
+            "Parent Sensitivity Label Name": (
+                item.get("parent", {}).get("name") if item.get("parent") else None
+            ),
+        }
+        rows.append(row)
+
+    if rows:
+        df = pd.DataFrame(rows, columns=list(columns.keys()))
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df

sempy_labs/tom/_model.py

@@ -12,7 +12,6 @@ from sempy_labs._helper_functions import (
     _make_list_unique,
     resolve_dataset_name_and_id,
     resolve_workspace_name_and_id,
-    _base_api,
     resolve_workspace_id,
     resolve_item_id,
     resolve_lakehouse_id,
@@ -4670,9 +4669,7 @@ class TOMWrapper:
                 json=payload,
             )
             if response.status_code != 200:
-                raise FabricHTTPException(
-                    f"Failed to retrieve descriptions: {response.text}"
-                )
+                raise FabricHTTPException(response)
 
             for item in response.json().get("modelItems", []):
                 ms_name = item["urn"]
@@ -5109,7 +5106,9 @@ class TOMWrapper:
         """
         import Microsoft.AnalysisServices.Tabular as TOM
 
-        p = next(p for p in self.model.Tables[table_name].Partitions)
+        t = self.model.Tables[table_name]
+
+        p = next(p for p in t.Partitions)
         if p.Mode != TOM.ModeType.DirectLake:
             print(f"{icons.info} The '{table_name}' table is not in Direct Lake mode.")
             return
@@ -5119,9 +5118,7 @@ class TOMWrapper:
         partition_schema = schema or p.Source.SchemaName
 
         # Update name of the Direct Lake partition (will be removed later)
-        self.model.Tables[table_name].Partitions[
-            partition_name
-        ].Name = f"{partition_name}_remove"
+        t.Partitions[partition_name].Name = f"{partition_name}_remove"
 
         source_workspace_id = resolve_workspace_id(workspace=source_workspace)
         if source_type == "Lakehouse":
@@ -5133,21 +5130,41 @@ class TOMWrapper:
                 item=source, type=source_type, workspace=source_workspace_id
             )
 
+        column_pairs = []
+        m_filter = None
+        for c in t.Columns:
+            if c.Type == TOM.ColumnType.Data:
+                if c.Name != c.SourceColumn:
+                    column_pairs.append((c.SourceColumn, c.Name))
+
+        if column_pairs:
+            m_filter = (
+                f'#"Renamed Columns" = Table.RenameColumns(ToDelta, {{'
+                + ", ".join([f'{{"{old}", "{new}"}}' for old, new in column_pairs])
+                + "})"
+            )
+
         def _generate_m_expression(
-            workspace_id, artifact_id, artifact_type, table_name, schema_name
+            workspace_id, artifact_id, artifact_type, table_name, schema_name, m_filter
         ):
             """
-            Generates the M expression for the import partition.
+            Generates the M expression for the import partition. Adds a rename step if any columns have been renamed in the model.
             """
 
             full_table_name = (
                 f"{schema_name}/{table_name}" if schema_name else table_name
             )
 
-            return f"""let\n\tSource = AzureStorage.DataLake("https://onelake.dfs.fabric.microsoft.com/{workspace_id}/{artifact_id}", [HierarchicalNavigation=true]),
+            code = f"""let\n\tSource = AzureStorage.DataLake("https://onelake.dfs.fabric.microsoft.com/{workspace_id}/{artifact_id}", [HierarchicalNavigation=true]),
         Tables = Source{{[Name = "Tables"]}}[Content],
         ExpressionTable = Tables{{[Name = "{full_table_name}"]}}[Content],
-        ToDelta = DeltaLake.Table(ExpressionTable)\nin\n\tToDelta"""
+        ToDelta = DeltaLake.Table(ExpressionTable)"""
+            if m_filter is None:
+                code += "\n in\n\tToDelta"
+            else:
+                code += f',\n\t {m_filter} \n in\n\t#"Renamed Columns"'
+
+            return code
 
         m_expression = _generate_m_expression(
             source_workspace_id,
@@ -5155,6 +5172,7 @@ class TOMWrapper:
             source_type,
             partition_entity_name,
             partition_schema,
+            m_filter,
         )
 
         # Add the import partition