Merge pull request #28969 from MicrosoftDocs/main

11/1/2023 PM Publish

Author: PhilKang0704

azure-sql/database/ai-artificial-intelligence-intelligent-applications.md

@@ -147,7 +147,9 @@ Implement RAG-patterns with Azure SQL Database and Azure Cognitive Search. You c
 
 ## Intelligent applications
 
-Azure SQL Database can be used to build intelligent applications that include AI features, such as recommenders, and Retrieval Augmented Generation (RAG).
+Azure SQL Database can be used to build intelligent applications that include AI features, such as recommenders, and Retrieval Augmented Generation (RAG) as the following diagram demonstrates: 
+
+:::image type="content" source="media/ai-artificial-intelligence-intelligent-applications/session-recommender-architecture.png" alt-text="Diagram of different AI features to build intelligent applications with Azure SQL Database.":::
 
 For an end-to-end sample to build a recommender using session abstract as a sample dataset, see [How I built a session recommender in 1 hour using Open AI](https://devblogs.microsoft.com/azure-sql/how-i-built-a-session-recommender-in-1-hour-using-open-ai/).
 

azure-sql/database/elastic-query-getting-started-vertical.md

@@ -71,7 +71,7 @@ INSERT INTO [dbo].[CustomerInformation] ([CustomerID], [CustomerName], [Company]
 
     The "master_key_password" is a strong password of your choosing used to encrypt the connection credentials. 
     The "username" and "password" should be the username and password used to log in into the Customers database (create a new user in Customers database if one does not already exists).
-    Authentication using Microsoft Entra ID ([formerly Azure Active Directory](/azure/active-directory/fundamentals/new-name)) with elastic queries is not currently supported.
+    Authentication using Microsoft Entra ID ([formerly Azure Active Directory](/entra/fundamentals/new-name)) with elastic queries is not currently supported.
 
 ### External data sources
 
@@ -119,7 +119,7 @@ For pricing information, see [SQL Database Pricing](https://azure.microsoft.com/
 ## Next steps
 
 * For an overview of elastic query, see [Elastic query overview](elastic-query-overview.md).
-* For syntax and sample queries for vertically partitioned data, see [Querying vertically partitioned data)](elastic-query-vertical-partitioning.md)
+* For syntax and sample queries for vertically partitioned data, see [Querying vertically partitioned data](elastic-query-vertical-partitioning.md).
 * For a horizontal partitioning (sharding) tutorial, see [Getting started with elastic query for horizontal partitioning (sharding)](elastic-query-getting-started.md).
-* For syntax and sample queries for horizontally partitioned data, see [Querying horizontally partitioned data)](elastic-query-horizontal-partitioning.md)
-* See [sp\_execute \_remote](/sql/relational-databases/system-stored-procedures/sp-execute-remote-azure-sql-database) for a stored procedure that executes a Transact-SQL statement on a single remote Azure SQL Database or set of databases serving as shards in a horizontal partitioning scheme.
+* For syntax and sample queries for horizontally partitioned data, see [Querying horizontally partitioned data](elastic-query-horizontal-partitioning.md).
+* See [sp\_execute\_remote](/sql/relational-databases/system-stored-procedures/sp-execute-remote-azure-sql-database) for a stored procedure that executes a Transact-SQL statement on a single remote Azure SQL Database or set of databases serving as shards in a horizontal partitioning scheme.

azure-sql/database/long-term-backup-retention-configure.md

@@ -47,6 +47,7 @@ Prepare your environment for PowerShell.
 For `Get-AzSqlDatabaseLongTermRetentionBackup` and `Restore-AzSqlDatabase`, you need to be a member of one of the following roles:
 
 - Subscription Owner role or
+- Subscription Contributor role or
 - SQL Server Contributor role or
 - Custom role with the following permissions:
 
@@ -57,6 +58,7 @@ For `Get-AzSqlDatabaseLongTermRetentionBackup` and `Restore-AzSqlDatabase`, you
 For `Remove-AzSqlDatabaseLongTermRetentionBackup`, you need to be a member of one of the following roles:
 
 - Subscription Owner role or
+- Subscription Contributor role or
 - Custom role with the following permission:
 
    `Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups/delete`
@@ -68,6 +70,7 @@ For `Remove-AzSqlDatabaseLongTermRetentionBackup`, you need to be a member of on
 To view and restore LTR backups, you need:
 
 - Subscription Owner role or
+- Subscription Contributor role or
 - SQL Server Contributor role or
 - Custom role with the following permissions:
 
@@ -78,6 +81,7 @@ To view and restore LTR backups, you need:
 To delete LTR backups, you need to be a member of one of the following roles:
 
 - Subscription Owner role or
+- Subscription Contributor role or
 - Custom role with the following permission:
 
    `Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups/delete`

azure-sql/database/media/ai-artificial-intelligence-intelligent-applications/session-recommender-architecture.png

@@ -220,7 +220,7 @@ Standard-series (Gen5) hardware is available in all public regions worldwide.
 
 - Premium-series hardware options use the latest CPU and memory technology from Intel and AMD. Premium-series provides a boost to compute performance relative to standard-series hardware.
 - Premium-series option offers faster CPU performance compared to Standard-series and a higher number of maximum vCores.
-- Premium-series memory optimized option offers double the amount of memory relative to premium-series.
+- Premium-series memory optimized option offers double the amount of memory relative to Standard-series.
 
 - For more information, see the [Hyperscale premium series blog announcement](https://aka.ms/AAiq28n).
 

azure-sql/database/service-tiers-sql-database-vcore.md

@@ -281,7 +281,7 @@
       href: database/free-offer.md
     - name: Try Azure SQL Database free FAQ
       href: database/free-offer-faq.yml
-    - name: Intelligent applications
+    - name: Intelligent applications and AI
       href: database/ai-artificial-intelligence-intelligent-applications.md
   - name: Quickstarts
     href: database/quickstart-content-reference-guide.md

azure-sql/toc.yml

@@ -3,7 +3,7 @@ title: Step 3 - Connecting to SQL using pyodbc
 description: Step 3 is a PoC, which shows how you can connect to SQL Server using Python and pyodbc. The basic examples demonstrate selecting and inserting data.
 author: David-Engel
 ms.author: v-davidengel
-ms.date: 08/22/2023
+ms.date: 11/01/2023
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: how-to
@@ -24,6 +24,7 @@ This sample proof of concept uses `pyodbc` to connect to an SQL database. This s
   - Prefer to not use your own environment? Open as a devcontainer using [GitHub Codespaces](https://github.com/features/codespaces).
     - [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/github/codespaces-blank?quickstart=1).
 - `pyodbc` package from PyPI.
+- [Install the Microsoft ODBC Driver 18 for SQL Server](step-1-configure-development-environment-for-pyodbc-python-development.md#install-the-odbc-driver)
 - An SQL database and credentials.
 
 ## Connect and query data

docs/connect/python/pyodbc/step-3-proof-of-concept-connecting-to-sql-using-pyodbc.md

@@ -333,7 +333,7 @@ Database users who access a DATABASE SCOPED CREDENTIAL must have permission to u
 To use the credential, a database user must have `REFERENCES` permission on a specific credential:
 
 ```sql
-GRANT REFERENCES ON CREDENTIAL::[<CREDENTIAL_NAME>] TO [<PRINCIPAL>];
+GRANT REFERENCES ON DATABASE SCOPED CREDENTIAL::[<CREDENTIAL_NAME>] TO [<PRINCIPAL>];
 ```
 
 ## Remarks