semantic-link-labs 0.12.3__tar.gz → 0.12.4__tar.gz

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.12.3
+Version: 0.12.4
 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.12.0
+Requires-Dist: semantic-link-sempy>=0.12.1
 Requires-Dist: anytree
 Requires-Dist: polib
 Requires-Dist: jsonpath_ng
@@ -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.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.4&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.4](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.4) (October 16, 2025)
 * [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)

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/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.12.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.4&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)
 
@@ -129,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.12.4](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.4) (October 16, 2025)
 * [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)

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/docs/source/conf.py

@@ -13,7 +13,7 @@ sys.path.insert(0, os.path.abspath('../../src/'))
 project = 'semantic-link-labs'
 copyright = '2024, Microsoft and community'
 author = 'Microsoft and community'
-release = '0.12.3'
+release = '0.12.4'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/environment.yml

@@ -6,7 +6,7 @@ dependencies:
 - pytest-cov
 - pytest-mock
 - pip:
-  - semantic-link-sempy>=0.12.0
+  - semantic-link-sempy>=0.12.1
   - azure-identity==1.7.1
   - azure-storage-blob>=12.9.0
   - pandas-stubs

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/pyproject.toml

@@ -7,7 +7,7 @@ name="semantic-link-labs"
 authors = [
     { name = "Microsoft Corporation" },
 ]
-version="0.12.3"
+version="0.12.4"
 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.12.0",
+    "semantic-link-sempy>=0.12.1",
     "anytree",
     "polib",
     "jsonpath_ng",

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/semantic_link_labs.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.12.3
+Version: 0.12.4
 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.12.0
+Requires-Dist: semantic-link-sempy>=0.12.1
 Requires-Dist: anytree
 Requires-Dist: polib
 Requires-Dist: jsonpath_ng
@@ -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.3&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.12.4&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.4](https://github.com/microsoft/semantic-link-labs/releases/tag/0.12.4) (October 16, 2025)
 * [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)

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/semantic_link_labs.egg-info/SOURCES.txt

@@ -57,7 +57,6 @@ src/sempy_labs/_dictionary_diffs.py
 src/sempy_labs/_documentation.py
 src/sempy_labs/_environments.py
 src/sempy_labs/_eventhouses.py
-src/sempy_labs/_eventstreams.py
 src/sempy_labs/_external_data_shares.py
 src/sempy_labs/_gateways.py
 src/sempy_labs/_generate_semantic_model.py
@@ -89,6 +88,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_audit_settings.py
 src/sempy_labs/_sql_endpoints.py
 src/sempy_labs/_sqldatabase.py
 src/sempy_labs/_tags.py
@@ -151,6 +151,7 @@ src/sempy_labs/admin/_domains.py
 src/sempy_labs/admin/_external_data_share.py
 src/sempy_labs/admin/_git.py
 src/sempy_labs/admin/_items.py
+src/sempy_labs/admin/_labels.py
 src/sempy_labs/admin/_reports.py
 src/sempy_labs/admin/_scanner.py
 src/sempy_labs/admin/_shared.py
@@ -174,10 +175,14 @@ src/sempy_labs/directlake/_update_directlake_model_lakehouse_connection.py
 src/sempy_labs/directlake/_update_directlake_partition_entity.py
 src/sempy_labs/directlake/_warm_cache.py
 src/sempy_labs/dotnet_lib/dotnet.runtime.config.json
+src/sempy_labs/eventstream/__init__.py
+src/sempy_labs/eventstream/_items.py
+src/sempy_labs/eventstream/_topology.py
 src/sempy_labs/graph/__init__.py
 src/sempy_labs/graph/_groups.py
 src/sempy_labs/graph/_sensitivity_labels.py
 src/sempy_labs/graph/_teams.py
+src/sempy_labs/graph/_user_licenses.py
 src/sempy_labs/graph/_users.py
 src/sempy_labs/lakehouse/__init__.py
 src/sempy_labs/lakehouse/_blobs.py
@@ -187,6 +192,7 @@ src/sempy_labs/lakehouse/_helper.py
 src/sempy_labs/lakehouse/_lakehouse.py
 src/sempy_labs/lakehouse/_livy_sessions.py
 src/sempy_labs/lakehouse/_materialized_lake_views.py
+src/sempy_labs/lakehouse/_partitioning.py
 src/sempy_labs/lakehouse/_shortcuts.py
 src/sempy_labs/migration/__init__.py
 src/sempy_labs/migration/_create_pqt_file.py

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/semantic_link_labs.egg-info/requires.txt

@@ -1,4 +1,4 @@
-semantic-link-sempy>=0.12.0
+semantic-link-sempy>=0.12.1
 anytree
 polib
 jsonpath_ng

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/__init__.py

@@ -115,11 +115,6 @@ from ._eventhouses import (
     delete_eventhouse,
     get_eventhouse_definition,
 )
-from ._eventstreams import (
-    list_eventstreams,
-    create_eventstream,
-    delete_eventstream,
-)
 from ._kql_querysets import (
     list_kql_querysets,
     create_kql_queryset,
@@ -284,6 +279,7 @@ from ._list_functions import (
     list_server_properties,
     list_semantic_model_errors,
     list_synonyms,
+    list_user_defined_functions,
 )
 from ._helper_functions import (
     get_item_definition,
@@ -355,6 +351,11 @@ from ._data_access_security import (
 from ._get_connection_string import (
     get_connection_string,
 )
+from ._sql_audit_settings import (
+    get_sql_audit_settings,
+    update_sql_audit_settings,
+    set_audit_actions_and_group,
+)
 
 __all__ = [
     "resolve_warehouse_id",
@@ -486,9 +487,6 @@ __all__ = [
     "list_data_pipelines",
     "create_data_pipeline",
     "delete_data_pipeline",
-    "list_eventstreams",
-    "create_eventstream",
-    "delete_eventstream",
     "list_kql_querysets",
     "create_kql_queryset",
     "delete_kql_queryset",
@@ -611,4 +609,8 @@ __all__ = [
     "list_data_access_roles",
     "bind_semantic_model_connection",
     "unbind_semantic_model_connection",
+    "list_user_defined_functions",
+    "get_sql_audit_settings",
+    "update_sql_audit_settings",
+    "set_audit_actions_and_group",
 ]

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_a_lib_info.py

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

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_authentication.py

@@ -130,7 +130,7 @@ class ServicePrincipalTokenProvider(TokenCredential):
         if audience not in self._shorthand_scopes:
             raise NotImplementedError
 
-        return self.get_token(audience).token
+        return self.get_token(audience, region=region).token
 
     def get_token(self, *scopes, **kwargs) -> AccessToken:
         """

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_capacities.py

@@ -876,7 +876,7 @@ def create_storage_account(
     """
     Asynchronously creates a new storage account with the specified parameters. If an account is already created and a subsequent create request is issued with different properties, the account properties will be updated. If an account is already created and a subsequent create or update request is issued with the exact same set of properties, the request will succeed.
 
-    This is a wrapper function for the following API: `Storage Accounts - Create <https://learn.microsoft.com/rest/api/storagerp/storage-accounts/create`_.
+    This is a wrapper function for the following API: `Storage Accounts - Create <https://learn.microsoft.com/rest/api/storagerp/storage-accounts/create>`_.
 
     Service Principal Authentication is required (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
 

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_git.py

@@ -157,7 +157,7 @@ def get_git_status(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Obtains the Git status of items in the workspace, that can be committed to Git.
 
-    This is a wrapper function for the following API: `Git - Get Status <https://learn.microsoft.com/rest/api/fabric/core/git/get-status>.
+    This is a wrapper function for the following API: `Git - Get Status <https://learn.microsoft.com/rest/api/fabric/core/git/get-status>`_.
 
     Parameters
     ----------

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_helper_functions.py

@@ -282,8 +282,7 @@ def create_item(
     """
 
     (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
-    item_type = utils.item_types.get(type)[0].lower()
-    item_type_url = utils.item_types.get(type)[1]
+    item_type_url = utils.items.get(type)
 
     payload = {
         "displayName": name,
@@ -306,7 +305,7 @@ def create_item(
         client="fabric_sp",
     )
     print(
-        f"{icons.green_dot} The '{name}' {item_type} has been successfully created within the '{workspace_name}' workspace."
+        f"{icons.green_dot} The '{name}' {type} has been successfully created within the '{workspace_name}' workspace."
     )
 
 
@@ -1619,6 +1618,27 @@ def pagination(client, response):
     return responses
 
 
+def graph_pagination(response, headers):
+
+    responses = []
+    response_json = response.json()
+    responses.append(response_json)
+
+    # Check for pagination
+    odata_next_link = response_json.get("@odata.nextLink")
+
+    # Loop to handle pagination
+    while odata_next_link is not None:
+        response = requests.get(odata_next_link, headers=headers)
+        response_json = response.json()
+        responses.append(response_json)
+
+        # Update the odata next link for the next iteration
+        odata_next_link = response_json.get("@odata.nextLink")
+
+    return responses
+
+
 def resolve_deployment_pipeline_id(deployment_pipeline: str | UUID) -> UUID:
     """
     Obtains the Id for a given deployment pipeline.
@@ -2254,7 +2274,10 @@ def _base_api(
         if response.status_code not in status_codes:
             raise FabricHTTPException(response)
         if uses_pagination:
-            responses = pagination(c, response)
+            if client == "graph":
+                responses = graph_pagination(response, headers)
+            else:
+                responses = pagination(c, response)
             return responses
         else:
             return response

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_list_functions.py

@@ -756,6 +756,53 @@ def update_item(
         )
 
 
+@log
+def list_user_defined_functions(
+    dataset: str | UUID, workspace: Optional[str | UUID] = None
+) -> pd.DataFrame:
+    """
+    Shows a list of the user-defined functions within a semantic model.
+
+    Parameters
+    ----------
+    dataset: str | uuid.UUID
+        Name or UUID of the semantic model.
+    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 a list of the user-defined functions within a semantic model.
+    """
+
+    from sempy_labs.tom import connect_semantic_model
+
+    columns = {
+        "Function Name": "string",
+        "Expression": "string",
+        "Lineage Tag": "string",
+    }
+    df = _create_dataframe(columns=columns)
+    rows = []
+    with connect_semantic_model(dataset=dataset, workspace=workspace) as tom:
+        for f in tom.model.Functions:
+            rows.append(
+                {
+                    "Function Name": f.Name,
+                    "Expression": f.Expression,
+                    "Lineage Tag": f.LineageTag,
+                }
+            )
+
+    if rows:
+        df = pd.DataFrame(rows)
+
+    return df
+
+
 @log
 def list_relationships(
     dataset: str | UUID, workspace: Optional[str | UUID] = None, extended: bool = False
@@ -1484,15 +1531,14 @@ def list_semantic_model_errors(
 
     from sempy_labs.tom import connect_semantic_model
 
-    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
-    (dataset_name, dataset_id) = resolve_dataset_name_and_id(
-        dataset, workspace=workspace_id
+    df = pd.DataFrame(
+        columns=["Object Type", "Table Name", "Object Name", "Error Message"]
     )
 
     error_rows = []
 
     with connect_semantic_model(
-        dataset=dataset_id, workspace=workspace_id, readonly=True
+        dataset=dataset, workspace=workspace, readonly=True
     ) as tom:
         # Define mappings of TOM objects to object types and attributes
         error_checks = [
@@ -1546,6 +1592,7 @@ def list_semantic_model_errors(
                     else ""
                 ),
             ),
+            ("Function", tom.all_functions, lambda o: o.ErrorMessage),
         ]
 
         # Iterate over all error checks
@@ -1562,7 +1609,10 @@ def list_semantic_model_errors(
                         }
                     )
 
-    return pd.DataFrame(error_rows)
+    if error_rows:
+        df = pd.DataFrame(error_rows)
+
+    return df
 
 
 @log

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_managed_private_endpoints.py

@@ -24,7 +24,7 @@ def create_managed_private_endpoint(
     """
     Creates a managed private endpoint.
 
-    This is a wrapper function for the following API: `Managed Private Endpoints - Create Workspace Managed Private Endpoint <https://learn.microsoft.com/rest/api/fabric/core/managed-private-endpoints/create-workspace-managed-private-endpoint>`.
+    This is a wrapper function for the following API: `Managed Private Endpoints - Create Workspace Managed Private Endpoint <https://learn.microsoft.com/rest/api/fabric/core/managed-private-endpoints/create-workspace-managed-private-endpoint>`_.
 
     Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
 

{semantic_link_labs-0.12.3 → semantic_link_labs-0.12.4}/src/sempy_labs/_notebooks.py

@@ -163,7 +163,7 @@ def import_notebook_from_web(
     if len(dfI_filt) == 0:
         create_notebook(
             name=notebook_name,
-            notebook_content=response.content,
+            notebook_content=response.content.decode("utf-8"),
             workspace=workspace_id,
             description=description,
             format="ipynb",
@@ -216,7 +216,9 @@ def create_notebook(
         Defaults to None which places the notebook in the root of the workspace.
     """
 
-    notebook_payload = base64.b64encode(notebook_content).decode("utf-8")
+    notebook_payload = base64.b64encode(notebook_content.encode("utf-8")).decode(
+        "utf-8"
+    )
 
     definition_payload = {
         "parts": [

semantic_link_labs-0.12.4/src/sempy_labs/_sql_audit_settings.py

@@ -0,0 +1,208 @@
+from sempy_labs._helper_functions import (
+    resolve_item_id,
+    resolve_workspace_name_and_id,
+    _base_api,
+    _create_dataframe,
+    _update_dataframe_datatypes,
+    resolve_workspace_id,
+    resolve_item_name_and_id,
+)
+import pandas as pd
+from typing import Optional, List, Literal
+import sempy_labs._icons as icons
+from uuid import UUID
+from sempy._utils._log import log
+
+
+def _get_base_url(item, type, workspace):
+
+    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 in ["SQLEndpoint", "Warehouse"]:
+        url = f"/v1/workspaces/{workspace_id}/{type_for_url}/{item_id}"
+    else:
+        raise ValueError(
+            f"{icons.red_dot} The type must be 'Warehouse' or 'SQLEndpoint'."
+        )
+
+    return url
+
+
+@log
+def get_sql_audit_settings(
+    item: str | UUID,
+    type: Literal["Warehouse", "SQLEndpoint"],
+    workspace: Optional[str | UUID] = None,
+) -> pd.DataFrame:
+    """
+    Shows the SQL audit settings of a Fabric item.
+
+    This is a wrapper function for the following API: `SQL Audit Settings - Get SQL Audit Settings <https://learn.microsoft.com/rest/api/fabric/warehouse/sql-audit-settings/get-sql-audit-settings>`_.
+
+    Service Principal Authentication is supported (see `here <https://learn.microsoft.com/rest/api/fabric/warehouse/sql-audit-settings/get-sql-audit-settings#service-principal-authentication>`_).
+
+    Parameters
+    ----------
+    item : str | uuid.UUID
+        The name or ID of the item (Warehouse or SQLEndpoint).
+    type : Literal['Warehouse', 'SQLEndpoint']
+        The type of the item. Must be 'Warehouse' or 'SQLEndpoint'.
+    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 containing the SQL audit settings of the specified warehouse.
+    """
+
+    columns = {
+        "State": "string",
+        "Retention Days": "int",
+        "Audit Actions And Group": "list",
+    }
+
+    df = _create_dataframe(columns=columns)
+
+    url = _get_base_url(item=item, type=type, workspace=workspace)
+    response = _base_api(
+        request=f"{url}/settings/sqlAudit",
+        client="fabric_sp",
+    ).json()
+
+    rows = []
+    rows.append(
+        {
+            "State": response.get("state"),
+            "Retention Days": response.get("retentionDays"),
+            "Audit Actions And Group": response.get("auditActionsAndGroups"),
+        }
+    )
+
+    if rows:
+        df = pd.DataFrame(rows, columns=list(columns.keys()))
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df
+
+
+@log
+def update_sql_audit_settings(
+    item: str | UUID,
+    type: Literal["Warehouse", "SQLEndpoint"],
+    workspace: Optional[str | UUID] = None,
+    retention_days: Optional[int] = None,
+    state: Optional[str] = None,
+):
+    """
+    Update settings associated with the item.
+
+    This is a wrapper function for the following API: SQL Audit Settings - Update SQL Audit Settings <https://learn.microsoft.com/rest/api/fabric/warehouse/sql-audit-settings/update-sql-audit-settings>`_.
+
+    Service Principal Authentication is supported (see `here <https://learn.microsoft.com/rest/api/fabric/warehouse/sql-audit-settings/get-sql-audit-settings#service-principal-authentication>`_).
+
+    Parameters
+    ----------
+    item : str | uuid.UUID
+        The name or ID of the item (Warehouse or SQLEndpoint).
+    type : Literal['Warehouse', 'SQLEndpoint']
+        The type of the item. Must be 'Warehouse' or 'SQLEndpoint'.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+    """
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+
+    payload = {}
+    if retention_days is not None:
+        if not isinstance(retention_days, int) or retention_days < 0:
+            raise ValueError(
+                f"{icons.red_dot} retention_days must be a non-negative integer."
+            )
+        payload["retentionDays"] = retention_days
+    if state is not None:
+        state = state.capitalize()
+        if state not in ["Enabled", "Disabled"]:
+            raise ValueError(
+                f"{icons.red_dot} state must be either 'Enabled' or 'Disabled'."
+            )
+        payload["state"] = state
+
+    if not payload:
+        print(
+            f"{icons.info} No updates were made as neither retention_days nor state were provided."
+        )
+        return
+
+    url = _get_base_url(item=item, type=type, workspace=workspace)
+    _base_api(
+        request=f"{url}/settings/sqlAudit",
+        client="fabric_sp",
+        method="patch",
+        payload=payload,
+    )
+
+    print(
+        f"{icons.green_dot} The SQL audit settings for the '{item}' {type.lower()} within the '{workspace_name}' workspace have been updated accordingly."
+    )
+
+
+@log
+def set_audit_actions_and_group(
+    item: str | UUID,
+    type: Literal["Warehouse", "SQLEndpoint"],
+    sql_audit_groups: List[str],
+    workspace: Optional[str | UUID] = None,
+):
+    """
+    Update the audit actions and groups for this item.
+
+    This is a wrapper function for the following API: SQL Audit Settings - Set Audit Actions And Groups <https://learn.microsoft.com/rest/api/fabric/warehouse/sql-audit-settings/set-audit-actions-and-groups>`_.
+
+    Service Principal Authentication is supported (see `here <https://learn.microsoft.com/rest/api/fabric/warehouse/sql-audit-settings/get-sql-audit-settings#service-principal-authentication>`_).
+
+    Parameters
+    ----------
+    item : str | uuid.UUID
+        The name or ID of the item (Warehouse or SQLEndpoint).
+    type : Literal['Warehouse', 'SQLEndpoint']
+        The type of the item. Must be 'Warehouse' or 'SQLEndpoint'.
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+    """
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+
+    if (
+        not sql_audit_groups
+        or not isinstance(sql_audit_groups, list)
+        or not all(isinstance(item, str) for item in sql_audit_groups)
+    ):
+        raise ValueError(
+            f"{icons.red_dot} sql_audit_groups must be a non-empty list of strings."
+        )
+
+    url = _get_base_url(item=item, type=type, workspace=workspace)
+    _base_api(
+        request=f"{url}/settings/sqlAudit/setAuditActionsAndGroups",
+        client="fabric_sp",
+        method="post",
+        payload=sql_audit_groups,
+    )
+
+    print(
+        f"{icons.green_dot} The SQL audit actions and groups for the '{item}' {type.lower()} within the '{workspace_name}' workspace have been updated accordingly."
+    )