Merge pull request #27642 from ingebeumer/patch-2

KQL syntax error, KQL recommended practices, etc.

Author: JamesJBarnett

docs/sql-server/azure-arc/view-databases.md

@@ -24,60 +24,60 @@ Before you begin, verify that the SQL Server instance that hosts the databases:
 
 ## Inventory databases
 
-1. Locate the Azure Arc-enabled SQL Server instance in Azure portal
+1. Locate the Azure Arc-enabled SQL Server instance in the Azure portal.
 1. **Select** the SQL Server resource.
 1. Under **Data management**, select **Databases**.
 
    :::image type="content" source="media/view-databases/databases.png" alt-text="Screenshot of Azure portal, SQL Server databases - Azure Arc.":::
 
-Azure portal shows **SQL Server databases - Azure Arc**. Use this area to view the databases that belong to the instance.
+The Azure portal shows **SQL Server databases - Azure Arc**. Use this area to view the databases that belong to the instance.
 
 ## View database properties
 
 To view database properties for a specific database, select the database on the portal.
 
-After you create, modify, or delete a database, changes are visible in Azure portal within an hour.
+After you create, modify, or delete a database, changes are visible in the Azure portal within an hour.
 
 :::image type="content" source="media/view-databases/database-properties.png" alt-text="Screenshot of Azure portal, SQL Server database properties.":::
 
 ## How to use Azure Resource Graph to query data
 
-Here are some example scenarios showing how you use [Azure Resource Graph](/azure/governance/resource-graph/overview) to query data that is available with the release of viewing databases for Azure Arc-enabled SQL Server.
+Here are some example scenarios showing how you use [Azure Resource Graph](/azure/governance/resource-graph/overview) to query data that is available when viewing Azure Arc-enabled SQL Server databases.
 
 ### Scenario 1: Get 10 databases
 
 Get 10 databases and return what properties are available to query:
 
 ```kusto
 resources
-| where type =~ 'Microsoft.AzureArcData/sqlServerInstances/databases'
+| where type == 'microsoft.azurearcdata/sqlserverinstances/databases'
 | limit 10
 ```
 
-Many of the most interesting properties to query on are in the `properties` property. To explore the available properties, run this query and then select **See details** on a row.  This returns the properties in a json viewer on the right side.
+Many of the most interesting properties to query are in the `properties` property. To explore the available properties, run this query and then select **See details** on a row.  This returns the properties in a json viewer on the right side.
 
 ```kusto
 resources
-| where type =~ 'Microsoft.AzureArcData/sqlServerInstances/databases'
+| where type == 'microsoft.azurearcdata/sqlserverinstances/databases'
 | project properties
 ```
 
 You can navigate the hierarchy of the properties json by using a period in between each level of the properties json.
 
-### Scenario 2: Get all the databases that aren't encrypted
+### Scenario 2: Get all the databases that have database option AUTO_CLOSE set to ON
 
 ```kusto
-resources
-| where type =~ 'Microsoft.AzureArcData/sqlServerInstances/databases'
-| where properties.databaseOptions.isEncrypted == false
+| where (type == 'microsoft.azurearcdata/sqlserverinstances/databases' and properties.databaseOptions.isAutoCloseOn == true)
+| extend isAutoCloseOn = properties.databaseOptions.isAutoCloseOn
+| project name, isAutoCloseOn
 ```
 
 ### Scenario 3: Obtain the count of databases that are encrypted vs not encrypted
 
 ```kusto
 resources
-| extend isEncrypted =properties.databaseOptions.isEncrypted
-| where type contains("microsoft.azurearcdata/sqlserverinstances/databases")
+| where type == 'microsoft.azurearcdata/sqlserverinstances/databases'
+| extend isEncrypted = properties.databaseOptions.isEncrypted
 | summarize count() by tostring(isEncrypted)
 | order by ['isEncrypted'] asc
 ```
@@ -86,9 +86,9 @@ resources
 
 ```kusto
 resources
-| extend isEncrypted =properties.databaseOptions.isEncrypted
-| where type contains("microsoft.azurearcdata/sqlserverinstances/databases") and isEncrypted ==false
-| project name,isEncrypted
+| where (type == 'microsoft.azurearcdata/sqlserverinstances/databases' and properties.databaseOptions.isEncrypted == false)
+| extend isEncrypted = properties.databaseOptions.isEncrypted
+| project name, isEncrypted
 ```
 
 ### Scenario 5: Get all the databases by region and compatibility level
@@ -97,29 +97,29 @@ This example returns all databases in `westus3` location with compatibility leve
 
 ```kusto
 resources
-| where type =~ 'Microsoft.AzureArcData/sqlServerInstances/databases'
-| where location == "westus3"
-| where  properties.compatibilityLevel == "160"
+| where type == 'microsoft.azurearcdata/sqlserverinstances/databases'
+| where location == "westus3"
+| where properties.compatibilityLevel == "160"
 ```
 
 ### Scenario 6: Show the SQL Server version distribution
 
 ```kusto
 resources
-| extend SQLversion =properties.version
-| where type contains("microsoft.azurearcdata/sqlserverinstances")
+| where type == 'microsoft.azurearcdata/sqlserverinstances'
+| extend SQLversion = properties.version
 | summarize count() by tostring(SQLversion)
 ```
 
 ### Scenario 7: SQL Server by version, edition, and license type
 
 ```kusto
 resources
-| extend SQLversion =properties.version
-| extend SQLEdition =properties.edition
-| extend LicenseType =properties.licenseType
-| where type contains("microsoft.azurearcdata/sqlserverinstances")
-| project name,SQLversion,SQLEdition,LicenseType
+| where type == 'microsoft.azurearcdata/sqlserverinstances'
+| extend SQLversion = properties.version
+| extend SQLedition = properties.edition
+| extend licenseType = properties.licenseType
+| project name, SQLversion, SQLedition, licenseType
 ```
 
 ### Scenario 8: Show a count of databases by compatibility
@@ -128,7 +128,7 @@ This example returns the number of databases, ordered by the compatibility level
 
 ```kusto
 resources
-| where type =~ 'Microsoft.AzureArcData/sqlServerInstances/databases'
+| where type == 'microsoft.azurearcdata/sqlserverinstances/databases'
 | summarize count() by tostring(properties.compatibilityLevel)
 | order by properties_compatibilityLevel asc
 ```
@@ -140,4 +140,4 @@ You can also [create charts and pin them to dashboards](/azure/governance/resour
 ## Next steps
 
 - [Protect Azure Arc-enabled SQL Server with Microsoft Defender for Cloud](configure-advanced-data-security.md)
-- [Configure SQL Assessment | Azure Arc-enabled SQL Server](assess.md)
+- [Configure best practices assessment on an Azure Arc-enabled SQL Server instance](assess.md)