Merge pull request #35668 from dlevy-msft-sql/dlevy-10-28-2025-mac-update

Add extra instructions for mac users

Author: prmerger-automator[bot]

docs/connect/python/mssql-python/python-sql-driver-mssql-python-connect-jupyter-notebook.md

@@ -4,7 +4,7 @@ description: This quickstart describes connect to your SQL database from a Jupyt
 author: dlevy-msft-sql
 ms.author: dlevy
 ms.reviewer: vanto, randolphwest
-ms.date: 10/06/2025
+ms.date: 10/30/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: quickstart-sdk
@@ -36,6 +36,10 @@ The `mssql-python` driver doesn't require any external dependencies on Windows m
 
   - [Jupyter Extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
 
+  - [(Optional) Azure Repos](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-repos)
+
+- [(Optional) Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli)
+
 - If you don't already have `uv`, install `uv` by following the instructions from [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/).
 
 - A database on SQL Server, Azure SQL Database, or SQL database in Fabric with the [!INCLUDE [sssampledbobject-md](../../../includes/sssampledbobject-md.md)] sample schema and a valid connection string.
@@ -44,37 +48,37 @@ The `mssql-python` driver doesn't require any external dependencies on Windows m
 
   ### [Alpine](#tab/alpine-linux)
 
-  ```bash
+  ```console
   apk add libtool krb5-libs krb5-dev
   ```
 
   ### [Debian/Ubuntu](#tab/debianUbuntu-linux)
 
-  ```bash
+  ```console
   apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2
   ```
 
   ### [RHEL](#tab/RHEL-linux)
 
-  ```bash
+  ```console
   dnf install -y libtool-ltdl krb5-libs
   ```
 
   ### [SUSE](#tab/SUSE-linux)
 
-  ```bash
+  ```console
   zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2
   ```
 
   ### [openSUSE](#tab/openSUSE-linux)
 
-  ```bash
+  ```console
   zypper install -y libltdl7
   ```
 
   ### [macOS](#tab/mac)
 
-  ```bash
+  ```console
   brew install openssl
   ```
 
@@ -119,7 +123,7 @@ This quickstart requires the *[!INCLUDE [sssampledbnormal-md](../../../includes/
 
 1. Create a new [project](https://docs.astral.sh/uv/guides/projects/#project-structure) with `uv`.
 
-   ```bash
+   ```console
    uv init jupyter-notebook-qs
    cd jupyter-notebook-qs
    ```
@@ -128,7 +132,7 @@ This quickstart requires the *[!INCLUDE [sssampledbnormal-md](../../../includes/
 
 In the same directory, install the `mssql-python`, `python-dotenv`, `rich`, `pandas`, and `matplotlib` packages. Then add `ipykernel` and `uv` as dev dependencies. VS Code requires `ipykernel` and `uv` are added to be able to interact with `uv` from within your notebook cells using commands like `!uv add mssql_python`.
 
-```bash
+```console
 uv add mssql_python dotenv rich pandas matplotlib
 uv add --dev ipykernel
 uv add --dev uv
@@ -138,7 +142,7 @@ uv add --dev uv
 
 In the same directory, run the following command.
 
-```bash
+```console
 code .
 ```
 
@@ -284,6 +288,9 @@ code .
                Console().print(table)
    ```
 
+   > [!TIP]  
+   > To use Microsoft Entra Authentication in macOS, you must be signed in via either the [Azure Repos](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-repos) extension in Visual Studio Code, or by running `az login` via the [Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli).
+
 1. Use the **Run All** button at the top of the notebook to run the notebook.
 
 1. Select the **jupyter-notebook-qs** kernel when prompted.

docs/connect/python/mssql-python/python-sql-driver-mssql-python-quickstart.md

@@ -4,7 +4,7 @@ description: This quickstart describes installing Python, and mssql-python then
 author: dlevy-msft-sql
 ms.author: dlevy
 ms.reviewer: vanto, randolphwest
-ms.date: 10/06/2025
+ms.date: 10/30/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: quickstart-sdk
@@ -16,7 +16,9 @@ ms.custom:
 
 In this quickstart, you connect a Python script to a database that you created and loaded with sample data. You use the `mssql-python` driver for Python to connect to your database and perform basic operations, like reading and writing data.
 
-[mssql-python documentation](https://github.com/microsoft/mssql-python/wiki) | [mssql-python source code](https://github.com/microsoft/mssql-python/wiki) | [Package (PyPi)](https://pypi.org/project/mssql-python/)
+The `mssql-python` driver doesn't require any external dependencies on Windows machines. The driver installs everything that it needs with a single `pip` install, allowing you to use the latest version of the driver for new scripts without breaking other scripts that you don't have time to upgrade and test.
+
+[mssql-python documentation](https://github.com/microsoft/mssql-python/wiki) | [mssql-python source code](https://github.com/microsoft/mssql-python/wiki) | [Package (PyPi)](https://pypi.org/project/mssql-python/) | [Visual Studio Code](https://code.visualstudio.com/download)
 
 ## Prerequisites
 
@@ -28,6 +30,8 @@ In this quickstart, you connect a Python script to a database that you created a
 
     [:::image type="icon" source="https://github.com/codespaces/badge.svg":::](https://codespaces.new/github/codespaces-blank?quickstart=1)
 
+- [(Optional) Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli)
+
 - A database on SQL Server, Azure SQL Database, or SQL database in Fabric with the [!INCLUDE [sssampledbobject-md](../../../includes/sssampledbobject-md.md)] sample schema and a valid connection string.
 
 ## Setup
@@ -47,48 +51,48 @@ Get the [`mssql-python` package](https://pypi.org/project/mssql-python/) from Py
 
    ### [Windows](#tab/windows)
 
-   ```bash
+   ```console
    pip install mssql-python
    ```
 
    ### [Alpine](#tab/alpine-linux)
 
-   ```bash
+   ```console
    apk add libtool krb5-libs krb5-dev
    pip install mssql-python
    ```
 
    ### [Debian/Ubuntu](#tab/debianUbuntu-linux)
 
-   ```bash
+   ```console
    apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2
    pip install mssql-python
    ```
 
    ### [RHEL](#tab/RHEL-linux)
 
-   ```bash
+   ```console
    dnf install -y libtool-ltdl krb5-libs
    pip install mssql-python
    ```
 
    ### [SUSE](#tab/SUSE-linux)
 
-   ```bash
+   ```console
    zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2
    pip install mssql-python
    ```
 
    ### [openSUSE](#tab/openSUSE-linux)
 
-   ```bash
+   ```console
    zypper install -y libltdl7
    pip install mssql-python
    ```
 
    ### [macOS](#tab/mac)
 
-   ```bash
+   ```console
    brew install openssl
    pip install mssql-python
    ```
@@ -101,7 +105,7 @@ Get the [`python-dotenv`](https://pypi.org/project/python-dotenv/) from PyPI.
 
 1. In the same directory, install the `python-dotenv` package.
 
-   ```bash
+   ```console
    pip install python-dotenv
    ```
 
@@ -111,7 +115,7 @@ You can use the PyPI command-line tool to verify that your intended packages are
 
 1. Check the list of installed packages with `pip list`.
 
-   ```bash
+   ```console
    pip list
    ```
 
@@ -224,9 +228,12 @@ Use a SQL query string to execute a query and parse the results.
 
 1. **Save** the `app.py` file.
 
+> [!TIP]  
+> To use Microsoft Entra Authentication in macOS, you need to be logged in by running `az login` via the [Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli).
+
 1. Open a terminal and test the application.
 
-   ```bash
+   ```console
    python app.py
    ```
 
@@ -308,7 +315,7 @@ Execute an [INSERT](../../../t-sql/statements/insert-transact-sql.md) statement
 
 1. **Save** the `app.py` file and test the application again.
 
-   ```bash
+   ```console
    python app.py
    ```
 

docs/connect/python/mssql-python/python-sql-driver-mssql-python-rapid-prototyping-quickstart.md

@@ -4,7 +4,7 @@ description: This quickstart describes creating prototypes reports quickly using
 author: dlevy-msft-sql
 ms.author: dlevy
 ms.reviewer: vanto, randolphwest
-ms.date: 10/06/2025
+ms.date: 10/30/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: quickstart-sdk
@@ -18,7 +18,7 @@ In this quickstart, you use [`Streamlit`](https://streamlit.io/) to quickly crea
 
 The `mssql-python` driver doesn't require any external dependencies on Windows machines. The driver installs everything that it needs with a single `pip` install, allowing you to use the latest version of the driver for new scripts without breaking other scripts that you don't have time to upgrade and test.
 
-[mssql-python documentation](https://github.com/microsoft/mssql-python/wiki) | [mssql-python source code](https://github.com/microsoft/mssql-python/wiki) | [Package (PyPi)](https://pypi.org/project/mssql-python/) | [UV](https://docs.astral.sh/uv/)
+[mssql-python documentation](https://github.com/microsoft/mssql-python/wiki) | [mssql-python source code](https://github.com/microsoft/mssql-python/wiki) | [Package (PyPi)](https://pypi.org/project/mssql-python/) | [uv](https://docs.astral.sh/uv/)
 
 ## Prerequisites
 
@@ -30,43 +30,51 @@ The `mssql-python` driver doesn't require any external dependencies on Windows m
 
     [:::image type="icon" source="https://github.com/codespaces/badge.svg":::](https://codespaces.new/github/codespaces-blank?quickstart=1)
 
+- [Visual Studio Code](https://code.visualstudio.com/download) with the following extensions:
+
+  - [Python extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-python.python)
+
+  - [(Optional) Azure Repos](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-repos)
+
+- [(Optional) Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli)
+
 - If you don't already have `uv`, install `uv` by following the instructions from [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/).
 - A database on SQL Server, Azure SQL Database, or SQL database in Fabric with the [!INCLUDE [sssampledbobject-md](../../../includes/sssampledbobject-md.md)] sample schema and a valid connection string.
 - Install one-time operating system specific prerequisites.
 
   ### [Alpine](#tab/alpine-linux)
 
-  ```bash
+  ```console
   apk add libtool krb5-libs krb5-dev
   ```
 
   ### [Debian/Ubuntu](#tab/debianUbuntu-linux)
 
-  ```bash
+  ```console
   apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2
   ```
 
   ### [RHEL](#tab/RHEL-linux)
 
-  ```bash
+  ```console
   dnf install -y libtool-ltdl krb5-libs
   ```
 
   ### [SUSE](#tab/SUSE-linux)
 
-  ```bash
+  ```console
   zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2
   ```
 
   ### [openSUSE](#tab/openSUSE-linux)
 
-  ```bash
+  ```console
   zypper install -y libltdl7
   ```
 
   ### [macOS](#tab/mac)
 
-  ```bash
+  ```console
   brew install openssl
   ```
 
@@ -98,6 +106,7 @@ This quickstart requires the *[!INCLUDE [sssampledbnormal-md](../../../includes/
 
 - [Create a new project](#create-a-new-project)
 - [Add dependencies](#add-dependencies)
+- [Launch Visual Studio Code](#launch-visual-studio-code)
 - [Update pyproject.toml](#update-pyprojecttoml)
 - [Update main.py](#update-mainpy)
 - [Save the connection string](#save-the-connection-string)
@@ -109,7 +118,7 @@ This quickstart requires the *[!INCLUDE [sssampledbnormal-md](../../../includes/
 
 1. Create a new [project](https://docs.astral.sh/uv/guides/projects/#project-structure) with `uv`.
 
-   ```bash
+   ```console
    uv init rapid-prototyping-qs
    cd rapid-prototyping-qs
    ```
@@ -118,10 +127,18 @@ This quickstart requires the *[!INCLUDE [sssampledbnormal-md](../../../includes/
 
 In the same directory, install the `mssql-python`, `streamlit`, and `python-dotenv` packages.
 
-```bash
+```console
 uv add mssql-python python-dotenv streamlit
 ```
 
+### Launch Visual Studio Code
+
+In the same directory, run the following command.
+
+```console
+code .
+```
+
 ### Update pyproject.toml
 
 1. The [pyproject.toml](https://docs.astral.sh/uv/concepts/projects/layout/#the-pyprojecttoml) contains the metadata for your project. Open the file in your favorite editor.
@@ -273,9 +290,12 @@ uv add mssql-python python-dotenv streamlit
 
 ### Use uv run to execute the script
 
+> [!TIP]  
+> To use Microsoft Entra Authentication in macOS, you need to be logged in via either the [Azure Repos](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-repos) extension in Visual Studio Code or by running `az login` via the [Azure Command-Line Interface (CLI)](/cli/azure/install-azure-cli).
+
 1. In the terminal window from before, or a new terminal window open to the same directory, run the following command.
 
-   ```bash
+   ```console
     uv run streamlit run main.py
    ```