semantic-link-labs 0.10.0__tar.gz → 0.10.1__tar.gz

{semantic_link_labs-0.10.0/src/semantic_link_labs.egg-info → semantic_link_labs-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.10.0
+Version: 0.10.1
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -15,7 +15,7 @@ Classifier: Framework :: Jupyter
 Requires-Python: <3.12,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: semantic-link-sempy>=0.10.2
+Requires-Dist: semantic-link-sempy>=0.11.0
 Requires-Dist: anytree
 Requires-Dist: powerbiclient
 Requires-Dist: polib
@@ -27,7 +27,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.10.0&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.10.1&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)
 
@@ -56,6 +56,7 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Migrating an import/DirectQuery semantic model to Direct Lake](https://github.com/microsoft/semantic-link-labs?tab=readme-ov-file#direct-lake-migration)
     * [Model Best Practice Analyzer (BPA)](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#model-best-practice-analyzer)
     * [Vertipaq Analyzer](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#vertipaq-analyzer)
+    * [Create a .vpax file](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#create-a-vpax-file)
     * [Tabular Object Model](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Tabular%20Object%20Model.ipynb) [(TOM)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.tom.html)
     * [Translate a semantic model's metadata](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#translate-a-semantic-model)
     * [Check Direct Lake Guardrails](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.get_lakehouse_tables)
@@ -154,6 +155,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.10.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.1) (June 10, 2025)
 * [0.10.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.0) (May 30, 2025)
 * [0.9.11](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.11) (May 22, 2025)
 * [0.9.10](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.10) (April 24, 2025)

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/README.md

@@ -1,7 +1,7 @@
 # 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.10.0&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.10.1&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)
 
@@ -30,6 +30,7 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Migrating an import/DirectQuery semantic model to Direct Lake](https://github.com/microsoft/semantic-link-labs?tab=readme-ov-file#direct-lake-migration)
     * [Model Best Practice Analyzer (BPA)](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#model-best-practice-analyzer)
     * [Vertipaq Analyzer](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#vertipaq-analyzer)
+    * [Create a .vpax file](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#create-a-vpax-file)
     * [Tabular Object Model](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Tabular%20Object%20Model.ipynb) [(TOM)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.tom.html)
     * [Translate a semantic model's metadata](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#translate-a-semantic-model)
     * [Check Direct Lake Guardrails](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.get_lakehouse_tables)
@@ -128,6 +129,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.10.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.1) (June 10, 2025)
 * [0.10.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.0) (May 30, 2025)
 * [0.9.11](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.11) (May 22, 2025)
 * [0.9.10](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.10) (April 24, 2025)

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/pyproject.toml

@@ -7,7 +7,7 @@ name="semantic-link-labs"
 authors = [
     { name = "Microsoft Corporation" },
 ]
-version="0.10.0"
+version="0.10.1"
 description="Semantic Link Labs for Microsoft Fabric"
 readme="README.md"
 requires-python=">=3.10,<3.12"
@@ -23,7 +23,7 @@ classifiers = [
 license= { text = "MIT License" }
 
 dependencies = [
-    "semantic-link-sempy>=0.10.2",
+    "semantic-link-sempy>=0.11.0",
     "anytree",
     "powerbiclient",
     "polib",

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1/src/semantic_link_labs.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.10.0
+Version: 0.10.1
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -15,7 +15,7 @@ Classifier: Framework :: Jupyter
 Requires-Python: <3.12,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: semantic-link-sempy>=0.10.2
+Requires-Dist: semantic-link-sempy>=0.11.0
 Requires-Dist: anytree
 Requires-Dist: powerbiclient
 Requires-Dist: polib
@@ -27,7 +27,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.10.0&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.10.1&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)
 
@@ -56,6 +56,7 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Migrating an import/DirectQuery semantic model to Direct Lake](https://github.com/microsoft/semantic-link-labs?tab=readme-ov-file#direct-lake-migration)
     * [Model Best Practice Analyzer (BPA)](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#model-best-practice-analyzer)
     * [Vertipaq Analyzer](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#vertipaq-analyzer)
+    * [Create a .vpax file](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#create-a-vpax-file)
     * [Tabular Object Model](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Tabular%20Object%20Model.ipynb) [(TOM)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.tom.html)
     * [Translate a semantic model's metadata](https://github.com/microsoft/semantic-link-labs/wiki/Code-Examples#translate-a-semantic-model)
     * [Check Direct Lake Guardrails](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.get_lakehouse_tables)
@@ -154,6 +155,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.10.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.1) (June 10, 2025)
 * [0.10.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.0) (May 30, 2025)
 * [0.9.11](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.11) (May 22, 2025)
 * [0.9.10](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.10) (April 24, 2025)

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/src/semantic_link_labs.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ src/semantic_link_labs.egg-info/dependency_links.txt
 src/semantic_link_labs.egg-info/requires.txt
 src/semantic_link_labs.egg-info/top_level.txt
 src/sempy_labs/__init__.py
+src/sempy_labs/_a_lib_info.py
 src/sempy_labs/_ai.py
 src/sempy_labs/_authentication.py
 src/sempy_labs/_capacities.py
@@ -18,6 +19,7 @@ src/sempy_labs/_data_pipelines.py
 src/sempy_labs/_dataflows.py
 src/sempy_labs/_dax.py
 src/sempy_labs/_dax_query_view.py
+src/sempy_labs/_daxformatter.py
 src/sempy_labs/_delta_analyzer.py
 src/sempy_labs/_delta_analyzer_history.py
 src/sempy_labs/_deployment_pipelines.py
@@ -56,6 +58,7 @@ src/sempy_labs/_refresh_semantic_model.py
 src/sempy_labs/_semantic_models.py
 src/sempy_labs/_spark.py
 src/sempy_labs/_sql.py
+src/sempy_labs/_sql_endpoints.py
 src/sempy_labs/_sqldatabase.py
 src/sempy_labs/_tags.py
 src/sempy_labs/_translations.py
@@ -160,6 +163,9 @@ src/sempy_labs/migration/_migrate_model_objects_to_semantic_model.py
 src/sempy_labs/migration/_migrate_tables_columns_to_semantic_model.py
 src/sempy_labs/migration/_migration_validation.py
 src/sempy_labs/migration/_refresh_calc_tables.py
+src/sempy_labs/mirrored_azure_databricks_catalog/__init__.py
+src/sempy_labs/mirrored_azure_databricks_catalog/_discover.py
+src/sempy_labs/mirrored_azure_databricks_catalog/_refresh_catalog_metadata.py
 src/sempy_labs/report/_BPAReportTemplate.json
 src/sempy_labs/report/__init__.py
 src/sempy_labs/report/_download_report.py

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/src/semantic_link_labs.egg-info/requires.txt

@@ -1,4 +1,4 @@
-semantic-link-sempy>=0.10.2
+semantic-link-sempy>=0.11.0
 anytree
 powerbiclient
 polib

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/src/sempy_labs/__init__.py

@@ -1,3 +1,7 @@
+from sempy_labs._sql_endpoints import (
+    list_sql_endpoints,
+    refresh_sql_endpoint_metadata,
+)
 from sempy_labs._variable_libraries import (
     list_variable_libraries,
     delete_variable_library,
@@ -30,6 +34,7 @@ from sempy_labs._semantic_models import (
     enable_semantic_model_scheduled_refresh,
     delete_semantic_model,
     update_semantic_model_refresh_schedule,
+    list_semantic_model_datasources,
 )
 from sempy_labs._graphQL import (
     list_graphql_apis,
@@ -275,7 +280,6 @@ from sempy_labs._list_functions import (
     get_object_level_security,
     list_datamarts,
     list_lakehouses,
-    list_sql_endpoints,
     update_item,
     list_server_properties,
     list_semantic_model_errors,
@@ -589,4 +593,6 @@ __all__ = [
     "apply_tags",
     "unapply_tags",
     "get_user_delegation_key",
+    "refresh_sql_endpoint_metadata",
+    "list_semantic_model_datasources",
 ]

semantic_link_labs-0.10.1/src/sempy_labs/_a_lib_info.py

@@ -0,0 +1,2 @@
+lib_name = "semanticlinklabs"
+lib_version = "0.10.1"

semantic_link_labs-0.10.1/src/sempy_labs/_daxformatter.py

@@ -0,0 +1,78 @@
+import requests
+from typing import List, Optional
+from sempy_labs._a_lib_info import lib_name, lib_version
+
+
+def _format_dax(
+    expressions: str | List[str],
+    skip_space_after_function_name: bool = False,
+    metadata: Optional[List[dict]] = None,
+) -> List[str]:
+
+    if isinstance(expressions, str):
+        expressions = [expressions]
+        metadata = [metadata] if metadata else [{}]
+
+    # Add variable assignment to each expression
+    expressions = [f"x :={item}" for item in expressions]
+
+    url = "https://daxformatter.azurewebsites.net/api/daxformatter/daxtextformatmulti"
+
+    payload = {
+        "Dax": expressions,
+        "MaxLineLength": 0,
+        "SkipSpaceAfterFunctionName": skip_space_after_function_name,
+        "ListSeparator": ",",
+        "DecimalSeparator": ".",
+    }
+
+    headers = {
+        "Accept": "application/json, text/javascript, */*; q=0.01",
+        "Accept-Encoding": "gzip,deflate",
+        "Accept-Language": "en-US,en;q=0.8",
+        "Content-Type": "application/json; charset=UTF-8",
+        "Host": "daxformatter.azurewebsites.net",
+        "Expect": "100-continue",
+        "Connection": "Keep-Alive",
+        "CallerApp": lib_name,
+        "CallerVersion": lib_version,
+    }
+
+    response = requests.post(url, json=payload, headers=headers)
+    result = []
+    for idx, dax in enumerate(response.json()):
+        formatted_dax = dax.get("formatted")
+        errors = dax.get("errors")
+        if errors:
+            meta = metadata[idx] if metadata and idx < len(metadata) else {}
+            obj_name = meta.get("name", "Unknown")
+            table_name = meta.get("table", "Unknown")
+            obj_type = meta.get("type", "Unknown")
+            if obj_type == "calculated_tables":
+                raise ValueError(
+                    f"DAX formatting failed for the '{obj_name}' calculated table: {errors}"
+                )
+            elif obj_type == "calculated_columns":
+                raise ValueError(
+                    f"DAX formatting failed for the '{table_name}'[{obj_name}] calculated column: {errors}"
+                )
+            elif obj_type == "calculation_items":
+                raise ValueError(
+                    f"DAX formatting failed for the '{table_name}'[{obj_name}] calculation item: {errors}"
+                )
+            elif obj_type == "measures":
+                raise ValueError(
+                    f"DAX formatting failed for the '{obj_name}' measure: {errors}"
+                )
+            elif obj_type == "rls":
+                raise ValueError(
+                    f"DAX formatting failed for the row level security expression on the '{table_name}' table within the '{obj_name}' role: {errors}"
+                )
+            else:
+                NotImplementedError()
+        else:
+            if formatted_dax.startswith("x :="):
+                formatted_dax = formatted_dax[4:]
+            formatted_dax = formatted_dax.strip()
+            result.append(formatted_dax)
+    return result

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/src/sempy_labs/_list_functions.py

@@ -642,49 +642,6 @@ def list_lakehouses(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     return df
 
 
-def list_sql_endpoints(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
-    """
-    Shows the SQL endpoints within a 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.
-
-    Returns
-    -------
-    pandas.DataFrame
-        A pandas dataframe showing the SQL endpoints within a workspace.
-    """
-
-    columns = {
-        "SQL Endpoint Id": "string",
-        "SQL Endpoint Name": "string",
-        "Description": "string",
-    }
-    df = _create_dataframe(columns=columns)
-
-    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
-
-    responses = _base_api(
-        request=f"/v1/workspaces/{workspace_id}/sqlEndpoints", uses_pagination=True
-    )
-
-    for r in responses:
-        for v in r.get("value", []):
-
-            new_data = {
-                "SQL Endpoint Id": v.get("id"),
-                "SQL Endpoint Name": v.get("displayName"),
-                "Description": v.get("description"),
-            }
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
-
-    return df
-
-
 def list_datamarts(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Shows the datamarts within a workspace.

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/src/sempy_labs/_notebooks.py

@@ -159,6 +159,7 @@ def import_notebook_from_web(
             notebook_content=response.content,
             workspace=workspace_id,
             description=description,
+            format="ipynb",
         )
     elif len(dfI_filt) > 0 and overwrite:
         print(f"{icons.info} Overwrite of notebooks is currently not supported.")
@@ -202,9 +203,8 @@ def create_notebook(
         otherwise notebook_content should be GIT friendly format
     """
 
-    notebook_payload = base64.b64encode(notebook_content.encode("utf-8")).decode(
-        "utf-8"
-    )
+    notebook_payload = base64.b64encode(notebook_content).decode("utf-8")
+
     definition_payload = {
         "parts": [
             {

{semantic_link_labs-0.10.0 → semantic_link_labs-0.10.1}/src/sempy_labs/_semantic_models.py

@@ -8,6 +8,8 @@ from sempy_labs._helper_functions import (
     resolve_workspace_name_and_id,
     resolve_dataset_name_and_id,
     delete_item,
+    resolve_dataset_id,
+    resolve_workspace_id,
 )
 import sempy_labs._icons as icons
 import re
@@ -227,3 +229,102 @@ def update_semantic_model_refresh_schedule(
     print(
         f"{icons.green_dot} Refresh schedule for the '{dataset_name}' within the '{workspace_name}' workspace has been updated."
     )
+
+
+def list_semantic_model_datasources(
+    dataset: str | UUID,
+    workspace: Optional[str | UUID] = None,
+    expand_details: bool = True,
+) -> pd.DataFrame:
+    """
+    Lists the data sources for the specified semantic model.
+
+    This is a wrapper function for the following API: `Datasets - Get Datasources In Group <https://learn.microsoft.com/rest/api/power-bi/datasets/get-datasources-in-group>`_.
+
+    Parameters
+    ----------
+    dataset : str | uuid.UUID
+        Name or ID of the semantic model.
+    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.
+    expand_details : bool, default=True
+        If True, expands the connection details for each data source.
+
+    Returns
+    -------
+    pandas.DataFrame
+        DataFrame containing the data sources for the specified semantic model.
+    """
+
+    workspace_id = resolve_workspace_id(workspace)
+    dataset_id = resolve_dataset_id(dataset, workspace_id)
+
+    if expand_details:
+        columns = {
+            "Datasource Type": "str",
+            "Connection Server": "str",
+            "Connection Database": "str",
+            "Connection Path": "str",
+            "Connection Account": "str",
+            "Connection Domain": "str",
+            "Connection Kind": "str",
+            "Connection Email Address": "str",
+            "Connection URL": "str",
+            "Connection Class Info": "str",
+            "Connection Login Server": "str",
+            "Datasource Id": "str",
+            "Gateway Id": "str",
+        }
+    else:
+        columns = {
+            "Datasource Type": "str",
+            "Connection Details": "str",
+            "Datasource Id": "str",
+            "Gateway Id": "str",
+        }
+
+    df = _create_dataframe(columns)
+
+    response = _base_api(
+        request=f"/v1.0/myorg/groups/{workspace_id}/datasets/{dataset_id}/datasources",
+        client="fabric_sp",
+    )
+
+    dfs = []
+    for item in response.json().get("value", []):
+        ds_type = item.get("datasourceType")
+        conn_details = item.get("connectionDetails", {})
+        ds_id = item.get("datasourceId")
+        gateway_id = item.get("gatewayId")
+        if expand_details:
+            new_data = {
+                "Datasource Type": ds_type,
+                "Connection Server": conn_details.get("server"),
+                "Connection Database": conn_details.get("database"),
+                "Connection Path": conn_details.get("path"),
+                "Connection Account": conn_details.get("account"),
+                "Connection Domain": conn_details.get("domain"),
+                "Connection Kind": conn_details.get("kind"),
+                "Connection Email Address": conn_details.get("emailAddress"),
+                "Connection URL": conn_details.get("url"),
+                "Connection Class Info": conn_details.get("classInfo"),
+                "Connection Login Server": conn_details.get("loginServer"),
+                "Datasource Id": ds_id,
+                "Gateway Id": gateway_id,
+            }
+            dfs.append(pd.DataFrame(new_data, index=[0]))
+        else:
+            new_data = {
+                "Datasource Type": ds_type,
+                "Connection Details": conn_details,
+                "Datasource Id": ds_id,
+                "Gateway Id": gateway_id,
+            }
+            dfs.append(pd.DataFrame([new_data]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+
+    return df

semantic_link_labs-0.10.1/src/sempy_labs/_sql_endpoints.py

@@ -0,0 +1,185 @@
+from typing import Optional, Literal
+from uuid import UUID
+import pandas as pd
+from sempy_labs._helper_functions import (
+    _base_api,
+    _create_dataframe,
+    resolve_workspace_name_and_id,
+    resolve_item_name_and_id,
+    _update_dataframe_datatypes,
+)
+import sempy_labs._icons as icons
+
+
+def list_sql_endpoints(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
+    """
+    Shows the SQL endpoints within a 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.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the SQL endpoints within a workspace.
+    """
+
+    columns = {
+        "SQL Endpoint Id": "string",
+        "SQL Endpoint Name": "string",
+        "Description": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+
+    responses = _base_api(
+        request=f"/v1/workspaces/{workspace_id}/sqlEndpoints", uses_pagination=True
+    )
+
+    for r in responses:
+        for v in r.get("value", []):
+
+            new_data = {
+                "SQL Endpoint Id": v.get("id"),
+                "SQL Endpoint Name": v.get("displayName"),
+                "Description": v.get("description"),
+            }
+            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    return df
+
+
+def refresh_sql_endpoint_metadata(
+    item: str | UUID,
+    type: Literal["Lakehouse", "MirroredDatabase"],
+    workspace: Optional[str | UUID] = None,
+    tables: dict[str, list[str]] = None,
+) -> pd.DataFrame:
+    """
+    Refreshes the metadata of a SQL endpoint.
+
+    This is a wrapper function for the following API: `Items - Refresh Sql Endpoint Metadata <https://learn.microsoft.com/rest/api/fabric/sqlendpoint/items/refresh-sql-endpoint-metadata>`_.
+
+    Parameters
+    ----------
+    item : str | uuid.UUID
+        The name or ID of the item (Lakehouse or MirroredDatabase).
+    type : Literal['Lakehouse', 'MirroredDatabase']
+        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.
+    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"],
+        }
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the status of the metadata refresh operation.
+    """
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+
+    (item_name, item_id) = resolve_item_name_and_id(
+        item=item, type=type, workspace=workspace
+    )
+
+    if type == "Lakehouse":
+        response = _base_api(
+            request=f"/v1/workspaces/{workspace_id}/lakehouses/{item_id}",
+            client="fabric_sp",
+        )
+        sql_endpoint_id = (
+            response.json()
+            .get("properties", {})
+            .get("sqlEndpointProperties", {})
+            .get("id")
+        )
+    elif type == "MirroredDatabase":
+        response = _base_api(
+            request=f"/v1/workspaces/{workspace_id}/mirroredDatabases/{item_id}",
+            client="fabric_sp",
+        )
+        sql_endpoint_id = (
+            response.json()
+            .get("properties", {})
+            .get("sqlEndpointProperties", {})
+            .get("id")
+        )
+    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()
+            ]
+        }
+
+    result = _base_api(
+        request=f"v1/workspaces/{workspace_id}/sqlEndpoints/{sql_endpoint_id}/refreshMetadata?preview=true",
+        method="post",
+        status_codes=[200, 202],
+        lro_return_json=True,
+        payload=payload,
+    )
+
+    columns = {
+        "Table Name": "string",
+        "Status": "string",
+        "Start Time": "datetime",
+        "End Time": "datetime",
+        "Last Successful Sync Time": "datetime",
+        "Error Code": "string",
+        "Error Message": "string",
+    }
+
+    df = pd.json_normalize(result)
+
+    # Extract error code and message, set to None if no error
+    df['Error Code'] = df.get('error.errorCode', None)
+    df['Error Message'] = df.get('error.message', None)
+
+    # Friendly column renaming
+    df.rename(columns={
+        'tableName': 'Table Name',
+        'startDateTime': 'Start Time',
+        'endDateTime': 'End Time',
+        'status': 'Status',
+        'lastSuccessfulSyncDateTime': 'Last Successful Sync Time'
+    }, inplace=True)
+
+    # Drop the original 'error' column if present
+    df.drop(columns=[col for col in ['error'] if col in df.columns], inplace=True)
+
+    # Optional: Reorder columns
+    column_order = [
+        'Table Name', 'Status', 'Start Time', 'End Time',
+        'Last Successful Sync Time', 'Error Code', 'Error Message'
+    ]
+    df = df[column_order]
+
+    _update_dataframe_datatypes(df, columns)
+
+    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.")
+
+    return df