semantic-link-labs 0.9.1__tar.gz → 0.9.2__tar.gz

{semantic_link_labs-0.9.1 → semantic_link_labs-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: semantic-link-labs
-Version: 0.9.1
+Version: 0.9.2
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -26,7 +26,7 @@ Requires-Dist: pytest>=8.2.1; extra == "test"
 # 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.9.1&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.9.2&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)
 
@@ -64,6 +64,8 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Check why a Direct Lake semantic model would fallback to DirectQuery](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.directlake.html#sempy_labs.directlake.check_fallback_reason)
     * [View a measure dependency tree](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.measure_dependency_tree)
     * [View unique columns touched in a single (or multiple) DAX query(ies)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.get_dax_query_dependencies)
+    * [Analyze delta tables for Direct Lake semantic models using Delta Analyzer](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Delta%20Analyzer.ipynb)
+    * [View synonyms from the linguistic schema](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.list_synonyms)
 * Reports
     * [Report Best Practice Analyzer (BPA)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.report.html#sempy_labs.report.run_report_bpa)
     * [View report metadata](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Report%20Analysis.ipynb)
@@ -80,10 +82,11 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Optimize lakehouse tables](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.optimize_lakehouse_tables)
     * [Vacuum lakehouse tables](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.vacuum_lakehouse_tables)
     * [Create](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.create_shortcut_onelake), [delete](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.delete_shortcut), and [view shortcuts](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.list_shortcuts)
+    * [Analyze delta tables for Direct Lake semantic models using Delta Analyzer](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Delta%20Analyzer.ipynb)
 * Notebooks
     * [Import a notebook from the web](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.import_notebook_from_web)    
 * APIs
-    * Wrapper functions for [Power BI](https://learn.microsoft.com/rest/api/power-bi/), [Fabric](https://learn.microsoft.com/rest/api/fabric/articles/using-fabric-apis), and [Azure](https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities?view=rest-microsoftfabric-2023-11-01) APIs
+    * Wrapper functions for [Power BI](https://learn.microsoft.com/rest/api/power-bi/), [Fabric](https://learn.microsoft.com/rest/api/fabric/articles/using-fabric-apis), [Azure](https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities?view=rest-microsoftfabric-2023-11-01), and [Microsoft Graph](https://learn.microsoft.com/graph/api/overview?view=graph-rest-1.0) APIs
 * Service Principal Authentication
     * Now supported using the [service_principal_authentication](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.service_principal_authentication) context manager for the [admin](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.admin.html) subpackage, Azure API wrapper functions, and [connect_semantic_model](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.tom.html#sempy_labs.tom.connect_semantic_model). See this [helper notebook](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb) for additional instructions.
 
@@ -113,13 +116,11 @@ for file_name, file_url in notebook_files.items():
 ## Once installed, run this code to import the library into your notebook
 ```python
 import sempy_labs as labs
-from sempy_labs import migration, directlake, admin
+from sempy_labs import migration, directlake, admin, graph
 from sempy_labs import lakehouse as lake
 from sempy_labs import report as rep
 from sempy_labs.tom import connect_semantic_model
 from sempy_labs.report import ReportWrapper
-from sempy_labs import ConnectWarehouse
-from sempy_labs import ConnectLakehouse
 ```
 
 ## Load Semantic Link Labs into a custom [Fabric environment](https://learn.microsoft.com/fabric/data-engineering/create-and-use-environment)
@@ -143,8 +144,9 @@ 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.9.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.1) (January 22, 2024)
-* [0.9.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.0) (January 22, 2024)
+* [0.9.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.2) (February 5, 2025)
+* [0.9.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.1) (January 22, 2025)
+* [0.9.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.0) (January 22, 2025)
 * [0.8.11](https://github.com/microsoft/semantic-link-labs/releases/tag/0.8.11) (December 19, 2024)
 * [0.8.10](https://github.com/microsoft/semantic-link-labs/releases/tag/0.8.10) (December 16, 2024)
 * [0.8.9](https://github.com/microsoft/semantic-link-labs/releases/tag/0.8.9) (December 4, 2024)
@@ -238,6 +240,62 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
+## How to Contribute
+
+#### Initial setup
+1. Fork the Semantic Link Labs GitHub repository (Fork -> Create a new fork).
+2. Click on the green icon '<> Code' and copy the 'HTTPS' URL to the clipboard.
+3. Open Visual Studio Code.
+4. Select 'Clone Git Repository'.
+5. Paste the URL copied in step 2.
+6. Select 'Clone from URL'.
+7. Select/create a folder to map the cloned repository to your computer.
+8. When prompted to open the cloned repository, click 'Open'.
+9. Open the integrated terminal (View -> Terminal).
+10. Run the following code in the terminal to ensure a virtual environment exists.
+```python
+python -m venv venv
+```
+11. Run the following code in the terminal to activate the virtual environment.
+```python
+.\venv\Scripts\Activate.ps1
+```
+12. Run the following code in the terminal to install the build module.
+```
+pip install build
+```
+
+#### Branching
+When making changes, always create a new branch.
+
+1. Navigate to the Souce Control tab within Visual Studio Code.
+2. Click on the Source Control icon at the bottom left corner of the screen.
+3. Click 'Create new branch...'.
+4. Enter the branch name (i.e. yourusername/branchname).
+5. Click 'Enter'.
+
+#### Building the .whl file
+Running the following in the terminal in Visual Studio Code will create a .whl file in the 'dist' folder within your locally-cloned repository.
+
+```cli
+python -m build
+```
+
+#### Running and testing the .whl file
+1. Open a notebook in a Fabric workspace.
+2. Navigate to 'Resources' within the Explorer tab.
+3. Upload the .whl file here.
+4. Drag the .whl file into a notebook cell.
+5. Run the %pip install command generated by step 4.
+
+#### Submitting a Pull Request (PR)
+1. Within the 'Source Control' tab, commit your changes to the branch.
+2. Navigate to the [GitHub repo](https://github.com/microsoft/semantic-link-labs).
+3. A 'Create pull request' will appear at the top of the screen in green. Click it.
+4. Enter details into the description.
+5. Click 'Create'.
+
+
 ## Trademarks
 
 This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 

{semantic_link_labs-0.9.1 → semantic_link_labs-0.9.2}/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.9.1&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.9.2&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)
 
@@ -39,6 +39,8 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Check why a Direct Lake semantic model would fallback to DirectQuery](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.directlake.html#sempy_labs.directlake.check_fallback_reason)
     * [View a measure dependency tree](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.measure_dependency_tree)
     * [View unique columns touched in a single (or multiple) DAX query(ies)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.get_dax_query_dependencies)
+    * [Analyze delta tables for Direct Lake semantic models using Delta Analyzer](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Delta%20Analyzer.ipynb)
+    * [View synonyms from the linguistic schema](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.list_synonyms)
 * Reports
     * [Report Best Practice Analyzer (BPA)](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.report.html#sempy_labs.report.run_report_bpa)
     * [View report metadata](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Report%20Analysis.ipynb)
@@ -55,10 +57,11 @@ Check out the video below for an introduction to Semantic Link, Semantic Link La
     * [Optimize lakehouse tables](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.optimize_lakehouse_tables)
     * [Vacuum lakehouse tables](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.vacuum_lakehouse_tables)
     * [Create](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.create_shortcut_onelake), [delete](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.lakehouse.html#sempy_labs.lakehouse.delete_shortcut), and [view shortcuts](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.list_shortcuts)
+    * [Analyze delta tables for Direct Lake semantic models using Delta Analyzer](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Delta%20Analyzer.ipynb)
 * Notebooks
     * [Import a notebook from the web](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.import_notebook_from_web)    
 * APIs
-    * Wrapper functions for [Power BI](https://learn.microsoft.com/rest/api/power-bi/), [Fabric](https://learn.microsoft.com/rest/api/fabric/articles/using-fabric-apis), and [Azure](https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities?view=rest-microsoftfabric-2023-11-01) APIs
+    * Wrapper functions for [Power BI](https://learn.microsoft.com/rest/api/power-bi/), [Fabric](https://learn.microsoft.com/rest/api/fabric/articles/using-fabric-apis), [Azure](https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities?view=rest-microsoftfabric-2023-11-01), and [Microsoft Graph](https://learn.microsoft.com/graph/api/overview?view=graph-rest-1.0) APIs
 * Service Principal Authentication
     * Now supported using the [service_principal_authentication](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.html#sempy_labs.service_principal_authentication) context manager for the [admin](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.admin.html) subpackage, Azure API wrapper functions, and [connect_semantic_model](https://semantic-link-labs.readthedocs.io/en/stable/sempy_labs.tom.html#sempy_labs.tom.connect_semantic_model). See this [helper notebook](https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb) for additional instructions.
 
@@ -88,13 +91,11 @@ for file_name, file_url in notebook_files.items():
 ## Once installed, run this code to import the library into your notebook
 ```python
 import sempy_labs as labs
-from sempy_labs import migration, directlake, admin
+from sempy_labs import migration, directlake, admin, graph
 from sempy_labs import lakehouse as lake
 from sempy_labs import report as rep
 from sempy_labs.tom import connect_semantic_model
 from sempy_labs.report import ReportWrapper
-from sempy_labs import ConnectWarehouse
-from sempy_labs import ConnectLakehouse
 ```
 
 ## Load Semantic Link Labs into a custom [Fabric environment](https://learn.microsoft.com/fabric/data-engineering/create-and-use-environment)
@@ -118,8 +119,9 @@ 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.9.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.1) (January 22, 2024)
-* [0.9.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.0) (January 22, 2024)
+* [0.9.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.2) (February 5, 2025)
+* [0.9.1](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.1) (January 22, 2025)
+* [0.9.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.0) (January 22, 2025)
 * [0.8.11](https://github.com/microsoft/semantic-link-labs/releases/tag/0.8.11) (December 19, 2024)
 * [0.8.10](https://github.com/microsoft/semantic-link-labs/releases/tag/0.8.10) (December 16, 2024)
 * [0.8.9](https://github.com/microsoft/semantic-link-labs/releases/tag/0.8.9) (December 4, 2024)
@@ -213,6 +215,62 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
+## How to Contribute
+
+#### Initial setup
+1. Fork the Semantic Link Labs GitHub repository (Fork -> Create a new fork).
+2. Click on the green icon '<> Code' and copy the 'HTTPS' URL to the clipboard.
+3. Open Visual Studio Code.
+4. Select 'Clone Git Repository'.
+5. Paste the URL copied in step 2.
+6. Select 'Clone from URL'.
+7. Select/create a folder to map the cloned repository to your computer.
+8. When prompted to open the cloned repository, click 'Open'.
+9. Open the integrated terminal (View -> Terminal).
+10. Run the following code in the terminal to ensure a virtual environment exists.
+```python
+python -m venv venv
+```
+11. Run the following code in the terminal to activate the virtual environment.
+```python
+.\venv\Scripts\Activate.ps1
+```
+12. Run the following code in the terminal to install the build module.
+```
+pip install build
+```
+
+#### Branching
+When making changes, always create a new branch.
+
+1. Navigate to the Souce Control tab within Visual Studio Code.
+2. Click on the Source Control icon at the bottom left corner of the screen.
+3. Click 'Create new branch...'.
+4. Enter the branch name (i.e. yourusername/branchname).
+5. Click 'Enter'.
+
+#### Building the .whl file
+Running the following in the terminal in Visual Studio Code will create a .whl file in the 'dist' folder within your locally-cloned repository.
+
+```cli
+python -m build
+```
+
+#### Running and testing the .whl file
+1. Open a notebook in a Fabric workspace.
+2. Navigate to 'Resources' within the Explorer tab.
+3. Upload the .whl file here.
+4. Drag the .whl file into a notebook cell.
+5. Run the %pip install command generated by step 4.
+
+#### Submitting a Pull Request (PR)
+1. Within the 'Source Control' tab, commit your changes to the branch.
+2. Navigate to the [GitHub repo](https://github.com/microsoft/semantic-link-labs).
+3. A 'Create pull request' will appear at the top of the screen in green. Click it.
+4. Enter details into the description.
+5. Click 'Create'.
+
+
 ## Trademarks
 
 This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 

{semantic_link_labs-0.9.1 → semantic_link_labs-0.9.2}/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.9.1'
+release = '0.9.2'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

semantic_link_labs-0.9.2/notebooks/Delta Analyzer.ipynb

@@ -0,0 +1,155 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "5c27dfd1-4fe0-4a97-92e6-ddf78889aa93",
+   "metadata": {
+    "nteract": {
+     "transient": {
+      "deleting": false
+     }
+    }
+   },
+   "source": [
+    "### Install the latest .whl package\n",
+    "\n",
+    "Check [here](https://pypi.org/project/semantic-link-labs/) to see the latest version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d5cae9db-cef9-48a8-a351-9c5fcc99645c",
+   "metadata": {
+    "jupyter": {
+     "outputs_hidden": true,
+     "source_hidden": false
+    },
+    "nteract": {
+     "transient": {
+      "deleting": false
+     }
+    }
+   },
+   "outputs": [],
+   "source": [
+    "%pip install semantic-link-labs"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b195eae8",
+   "metadata": {},
+   "source": [
+    "### Import the library"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1344e286",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import sempy_labs as labs\n",
+    "table_name = 'MyTable'"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "baa24264",
+   "metadata": {},
+   "source": [
+    "### Run Delta Analyzer for a given table in the lakehouse attached to your notebook"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0a1903c0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "x = labs.delta_analyzer(table_name=table_name)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "285986d1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for name, df in x.items():\n",
+    "    print(name)\n",
+    "    display(df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e1d118dd",
+   "metadata": {},
+   "source": [
+    "### Get actual (not approximate) distinct counts"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d1ecf538",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "x = labs.delta_analyzer(table_name=table_name, approx_distinct_count=False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "60aa6592",
+   "metadata": {},
+   "source": [
+    "### Export the results of Delta Analyzer to a set of delta tables in your lakehouse\n",
+    "The export always appends results to the delta tables"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1d4235ff",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "x = labs.delta_analyzer(table_name=table_name, export=True)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernel_info": {
+   "name": "synapse_pyspark"
+  },
+  "kernelspec": {
+   "display_name": "Synapse PySpark",
+   "language": "Python",
+   "name": "synapse_pyspark"
+  },
+  "language_info": {
+   "name": "python"
+  },
+  "microsoft": {
+   "language": "python"
+  },
+  "nteract": {
+   "version": "nteract-front-end@1.0.0"
+  },
+  "spark_compute": {
+   "compute_id": "/trident/default"
+  },
+  "synapse_widget": {
+   "state": {},
+   "version": "0.1"
+  },
+  "widgets": {}
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

semantic_link_labs-0.9.2/notebooks/SQL.ipynb

@@ -0,0 +1,226 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "5c27dfd1-4fe0-4a97-92e6-ddf78889aa93",
+   "metadata": {
+    "nteract": {
+     "transient": {
+      "deleting": false
+     }
+    }
+   },
+   "source": [
+    "### Install the latest .whl package\n",
+    "\n",
+    "Check [here](https://pypi.org/project/semantic-link-labs/) to see the latest version."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d5cae9db-cef9-48a8-a351-9c5fcc99645c",
+   "metadata": {
+    "jupyter": {
+     "outputs_hidden": true,
+     "source_hidden": false
+    },
+    "nteract": {
+     "transient": {
+      "deleting": false
+     }
+    }
+   },
+   "outputs": [],
+   "source": [
+    "%pip install semantic-link-labs"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b195eae8",
+   "metadata": {},
+   "source": [
+    "### Import the library and necessary packages"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1344e286",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import sempy_labs as labs\n",
+    "\n",
+    "lakehouse_name = ''\n",
+    "lakehouse_workspace_name = ''\n",
+    "warehouse_name = ''\n",
+    "warehouse_workspace_name = ''"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "55e5ca67",
+   "metadata": {},
+   "source": [
+    "### Run a SQL query (or queries) against a Fabric warehouse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "a9f984e9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.ConnectWarehouse(warehouse=warehouse_name, workspace=warehouse_workspace_name) as sql:\n",
+    "    df = sql.query(\"SELECT * FROM Product\")\n",
+    "    display(df)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "865ac4a1",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.ConnectWarehouse(warehouse=warehouse_name, workspace=warehouse_workspace_name) as sql:\n",
+    "    dfs = sql.query([\"SELECT * FROM Product\", \"SELECT DISTINCT [Category] FROM Product\"])\n",
+    "\n",
+    "for df in dfs:\n",
+    "    display(df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bca53cd8",
+   "metadata": {},
+   "source": [
+    "#### See the tables in a warehouse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "9af2cce7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "labs.get_warehouse_tables(warehouse=warehouse_name, workspace=warehouse_workspace_name)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "765f99ae",
+   "metadata": {},
+   "source": [
+    "#### See the columns in each table in a warehouse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "1fabe168",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "labs.get_warehouse_columns(warehouse=warehouse_name, workspace=warehouse_workspace_name)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "634700c3",
+   "metadata": {},
+   "source": [
+    "### Run a T-SQL query (or queries) against a Fabric warehouse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "5dbf34f3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.ConnectWarehouse(warehouse=warehouse_name, workspace=warehouse_workspace_name) as sql:\n",
+    "    sql.query(\"CREATE SCHEMA [Business]\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "ec8ddb81",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.ConnectWarehouse(warehouse=warehouse_name, workspace=warehouse_workspace_name) as sql:\n",
+    "    sql.query([\"CREATE SCHEMA [Business]\", \"CREATE SCHEMA [Marketing]\"])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d5b090da",
+   "metadata": {},
+   "source": [
+    "### Run a SQL query (or queries) against a Fabric lakehouse"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4dca7f4a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.ConnectLakehouse(lakehouse=lakehouse_name, workspace=lakehouse_workspace_name) as sql:\n",
+    "    df = sql.query(\"SELECT * FROM Product\")\n",
+    "    display(df)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b9606ae8",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.ConnectLakehouse(lakehouse=lakehouse_name, workspace=lakehouse_workspace_name) as sql:\n",
+    "    dfs = sql.query([\"SELECT * FROM Product\", \"SELECT DISTINCT [Category] FROM Product\"])\n",
+    "\n",
+    "for df in dfs:\n",
+    "    display(df)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernel_info": {
+   "name": "synapse_pyspark"
+  },
+  "kernelspec": {
+   "display_name": "Synapse PySpark",
+   "language": "Python",
+   "name": "synapse_pyspark"
+  },
+  "language_info": {
+   "name": "python"
+  },
+  "microsoft": {
+   "language": "python"
+  },
+  "nteract": {
+   "version": "nteract-front-end@1.0.0"
+  },
+  "spark_compute": {
+   "compute_id": "/trident/default"
+  },
+  "synapse_widget": {
+   "state": {},
+   "version": "0.1"
+  },
+  "widgets": {}
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

{semantic_link_labs-0.9.1 → semantic_link_labs-0.9.2}/notebooks/Service Principal.ipynb

@@ -79,7 +79,7 @@
    "outputs": [],
    "source": [
     "import sempy_labs as labs\n",
-    "from sempy_labs import admin\n",
+    "from sempy_labs import admin, graph\n",
     "from sempy_labs.tom import connect_semantic_model\n",
     "\n",
     "key_vault_uri = '' # Enter your key vault URI\n",
@@ -150,6 +150,31 @@
     "    )"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "931a9ee0",
+   "metadata": {},
+   "source": [
+    "### Using wrapper functions for [Microsoft Graph](https://learn.microsoft.com/graph/overview)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f0cb20d0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "with labs.service_principal_authentication(\n",
+    "    key_vault_uri=key_vault_uri, \n",
+    "    key_vault_tenant_id=key_vault_tenant_id,\n",
+    "    key_vault_client_id=key_vault_client_id,\n",
+    "    key_vault_client_secret=key_vault_client_secret):\n",
+    "\n",
+    "    df = graph.list_users()\n",
+    "    display(df)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "fcde09a7",