Skip to content

Commit a152897

Browse files
Fix auth guidance: update tab name, add Azure CLI prereq, fix shared include for VS Code
- Rename tab from 'DefaultAzureCredential' to 'ActiveDirectoryDefault' (correct terminology) - Add Azure CLI to prerequisites (required for ActiveDirectoryDefault auth) - Update shared include: fix outdated VS Code guidance (Azure Account extension deprecated) - Update 'Azure AD' to 'Microsoft Entra' branding - Fix 'sign-in' to 'sign in' per MS Style Guide
1 parent bf63470 commit a152897

2 files changed

Lines changed: 18 additions & 18 deletions

File tree

azure-sql/database/azure-sql-python-quickstart.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ This quickstart describes how to connect an application to a database in Azure S
2626

2727
- An [Azure subscription](https://azure.microsoft.com/pricing/purchase-options/azure-account?icid=azurefreeaccountpython/).
2828
- An Azure SQL database configured with Microsoft Entra authentication. You can create one using the [Quickstart: Create a single database - Azure SQL Database](single-database-create-quickstart.md).
29-
- The latest version of the [Azure CLI](/cli/azure/get-started-with-azure-cli).
3029
- Visual Studio Code with the [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python).
3130
- Python 3.10 or later.
31+
- The [Azure CLI](/cli/azure/install-azure-cli) (required for `ActiveDirectoryDefault` authentication).
3232

3333
## Configure the database
3434

@@ -97,9 +97,9 @@ For local development, create a `.env` file in your project folder to store your
9797
9898
The mssql-python driver has built-in support for Microsoft Entra authentication. Use the `Authentication` parameter to specify the authentication method.
9999
100-
## [DefaultAzureCredential](#tab/sql-default)
100+
## [ActiveDirectoryDefault](#tab/sql-default)
101101
102-
`ActiveDirectoryDefault` automatically discovers credentials from multiple sources (Azure CLI, environment variables, Visual Studio, etc.) without requiring interactive login. This is convenient for local development but is slower due to credential discovery.
102+
`ActiveDirectoryDefault` automatically discovers credentials from multiple sources (Visual Studio Code, Azure CLI, environment variables, etc.) without requiring interactive login. This is convenient for local development but is slower due to credential discovery.
103103
104104
```text
105105
AZURE_SQL_CONNECTIONSTRING=Server=<database-server-name>.database.windows.net;Database=<database-name>;Authentication=ActiveDirectoryDefault;Encrypt=yes;TrustServerCertificate=no;
Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
11
---
22
title: "include file"
33
description: "include file"
4-
services: storage
54
author: WilliamDAssafMSFT
65
ms.author: wiassaf
7-
ms.reviewer: rotabor, alexwolf
8-
ms.service: storage
6+
ms.reviewer: rotabor, alexwolf, dlevy
7+
ms.service: azure-sql-database
98
ms.topic: include
10-
ms.date: 09/09/2022
9+
ms.date: 02/03/2026
1110
ms.custom: include file
1211
---
1312

14-
For local development, make sure you're signed-in with the same Azure AD account you want to use to access Azure SQL Database. You can authenticate via popular development tools, such as the Azure CLI or Azure PowerShell. The development tools with which you can authenticate vary across languages.
13+
For local development, make sure you're signed in with the same Microsoft Entra account you want to use to access Azure SQL Database. You can authenticate via popular development tools, such as the Azure CLI or Azure PowerShell. The development tools with which you can authenticate vary across languages.
1514

1615
### [Azure CLI](#tab/sign-in-azure-cli)
1716

18-
Sign-in to Azure through the Azure CLI using the following command:
17+
Sign in to Azure through the Azure CLI using the following command. This works on Windows, macOS, and Linux.
1918

2019
```azurecli
2120
az login
@@ -27,28 +26,29 @@ Select the **Sign in** button in the top right of Visual Studio.
2726

2827
:::image type="content" source="../../database/media/passwordless-connections/sign-in-visual-studio-small.png" alt-text="Screenshot showing the button to sign in to Azure using Visual Studio.":::
2928

30-
Sign-in using the Azure AD account you assigned a role to previously.
29+
Sign in using the Microsoft Entra account you assigned a role to previously.
3130

3231
:::image type="content" source="../../database/media/passwordless-connections/sign-in-visual-studio-account-small.png" alt-text="Screenshot showing the account selection.":::
3332

3433
### [Visual Studio Code](#tab/sign-in-visual-studio-code)
3534

36-
You will need to [install the Azure CLI](/cli/azure/install-azure-cli) to work with `DefaultAzureCredential` through Visual Studio Code.
35+
For Visual Studio Code, sign in using the Azure CLI in the integrated terminal:
3736

38-
On the main menu of Visual Studio Code, navigate to **Terminal > New Terminal**.
37+
1. Open the terminal in VS Code (**Terminal > New Terminal**).
38+
1. Sign in to Azure with the following command:
3939

40-
Sign-in to Azure through the Azure CLI using the following command:
40+
```azurecli
41+
az login
42+
```
4143
42-
```azurecli
43-
az login
44-
```
44+
This method works reliably across Windows, macOS, and Linux.
4545
4646
### [PowerShell](#tab/sign-in-powershell)
4747
48-
Sign-in to Azure using PowerShell via the following command:
48+
Sign in to Azure using PowerShell via the following command:
4949
5050
```azurepowershell
5151
Connect-AzAccount
5252
```
5353

54-
---
54+
---

0 commit comments

Comments
 (0)