Merge pull request #25159 from markingmyname/linterbobby

Linter tool testing

Author: v-shils

docs/azure-data-studio/notebooks/notebooks-kqlmagic.md

@@ -3,9 +3,11 @@ title: Notebooks with Kqlmagic (Kusto Query Language) in Azure Data Studio
 description: This tutorial shows how you can create and run Kqlmagic in an Azure Data Studio notebook.
 author: markingmyname
 ms.author: maghan
-ms.reviewer: jukoesma
-ms.date: 06/28/2021
+ms.reviewer: ""
+ms.date: 12/07/2022
 ms.service: azure-data-studio
+ms.subservice: ""
+ms.custonm: ""
 ms.topic: how-to
 ---
 
@@ -26,13 +28,13 @@ The steps in this section all run within an Azure Data Studio notebook.
 
 1. Create a new notebook and change the **Kernel** to *Python 3*.
 
-   ![New Notebook](media/notebooks-kqlmagic/install-new-notebook.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-new-notebook.png" alt-text="Screenshot of a new notebook.":::
 
-2. You may be prompted to upgrade your Python packages when your packages need updating.
+1. You may be prompted to upgrade your Python packages when your packages need updating.
 
-   ![Yes](media/notebooks-kqlmagic/install-python-yes.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-python-yes.png" alt-text="Screenshot of the result - yes.":::
 
-3. Install Kqlmagic:
+1. Install Kqlmagic:
 
    ```python
    import sys
@@ -46,29 +48,29 @@ The steps in this section all run within an Azure Data Studio notebook.
    !{sys.executable} -m pip list
    ```
 
-   ![List](media/notebooks-kqlmagic/install-list.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-list.png" alt-text="Screenshot of the list.":::
 
-4. Load Kqlmagic:
+1. Load Kqlmagic:
 
    ```python
    %reload_ext Kqlmagic
    ```
 
-   > [!Note]
+   > [!NOTE]  
    > If this step fails, then close the file and reopen it.
 
-   ![Load the Kqlmagic extension](media/notebooks-kqlmagic/install-load-kql-magic-ext.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-load-kql-magic-ext.png" alt-text="Screenshot of the load the Kqlmagic extension.":::
 
-5. You can test if Kqlmagic is loaded properly by browsing the help documentation or by checking for the version.
+1. You can test if Kqlmagic is loaded properly by browsing the help documentation or by checking for the version.
 
    ```python
    %kql --help "help"
    ```
 
-   > [!Note]
+   > [!NOTE]  
    > If `Samples@help` is asking for a password, then you can leave it blank and press **Enter**.
 
-   ![Help](media/notebooks-kqlmagic/install-help.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-help.png" alt-text="Screenshot of help.":::
 
    To see which version of Kqlmagic is installed, run the command below.
 
@@ -80,36 +82,36 @@ The steps in this section all run within an Azure Data Studio notebook.
 
 This section explains how to run data analysis using Kqlmagic with an Azure Data Explorer cluster.
 
-### <a name="ade-load-auth"></a> Load and authenticate Kqlmagic for Azure Data Explorer
+### <a id="ade-load-auth"></a> Load and authenticate Kqlmagic for Azure Data Explorer
 
-   > [!Note]
+   > [!NOTE]  
    > Every time you create a new notebook in Azure Data Studio you must load the Kqlmagic extension.
 
 1. Verify the **Kernel** is set to *Python3*.
 
-   ![Kernel change](media/notebooks-kqlmagic/change-kernel.png)
+   :::image type="content" source="media/notebooks-kqlmagic/change-kernel.png" alt-text="Screenshot of the kernel change.":::
 
-2. Load Kqlmagic:
+1. Load Kqlmagic:
 
    ```python
    %reload_ext Kqlmagic
    ```
 
-   ![Load the Kqlmagic extension](media/notebooks-kqlmagic/install-load-kql-magic-ext.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-load-kql-magic-ext.png" alt-text="Screenshot of the load the Kqlmagic extension.":::
 
-3. Connect to the cluster and authenticate:
+1. Connect to the cluster and authenticate:
 
    ```python
    %kql azureDataExplorer://code;cluster='help';database='Samples'
    ```
 
-    > [!Note]
-    > If you are using your own ADX cluster, you must include the region in the connection string as follows:   
-    ```%kql azuredataexplorer://code;cluster='mycluster.westus';database='mykustodb'```
+    > [!NOTE]  
+    > If you are using your own ADX cluster, you must include the region in the connection string as follows:
 
-   You use Device Login to authenticate. Copy the code from the output and select **authenticate** which opens a browser where you need to paste the code. Once you authenticate successfully, you can come back to Azure Data Studio to continue with the rest of the script.
+    ```%kql azuredataexplorer://code;cluster='mycluster.westus';database='mykustodb'```
+   You use device sign-in to authenticate. Copy the code from the output and select **authenticate** which opens a browser where you need to paste the code. Once you authenticate successfully, you can come back to Azure Data Studio to continue with the rest of the script.
 
-   ![Azure Data Explorer authentication](media/notebooks-kqlmagic/ade-auth.png)
+   :::image type="content" source="media/notebooks-kqlmagic/ade-auth.png" alt-text="Screenshot of the Azure Data Explorer authentication.":::
 
 ### Query and visualize for Azure Data Explorer
 
@@ -123,7 +125,7 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
 
    If you're familiar with the Kusto Query Language (KQL), you can type the query after `%kql`.
 
-   ![Analyze storm events](media/notebooks-kqlmagic/ade-analyze-storm-events.png)
+   :::image type="content" source="media/notebooks-kqlmagic/ade-analyze-storm-events.png" alt-text="Screenshot of the analyze storm events.":::
 
 2. Visualize a timeline chart:
 
@@ -133,7 +135,7 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    | render timechart title= 'Daily Storm Events'
    ```
 
-   ![visualize timechart](media/notebooks-kqlmagic/ade-visualize-timechart.png)
+   :::image type="content" source="media/notebooks-kqlmagic/ade-visualize-timechart.png" alt-text="Screenshot of a time chart.":::
 
 3. Multiline Query sample using `%%kql`.
 
@@ -146,23 +148,32 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    | render columnchart title='Top 10 States by Storm Event count'
    ```
 
-   ![Multiline Query sample](media/notebooks-kqlmagic/ade-multiline-query-sample.png)
+   ```python
+   %%kql
+   StormEvents
+   | summarize count() by State
+   | sort by count_
+   | limit 10
+   | render columnchart title='Top 10 States by Storm Event count'
+   ```
+
+   :::image type="content" source="media/notebooks-kqlmagic/ade-multiline-query-sample.png" alt-text="Screenshot of a multiline Query sample.":::
 
 ## Kqlmagic with Application Insights
 
 ### <a name="appin-load-auth"></a> Load and authenticate Kqlmagic for Application Insights
 
 1. Verify the **Kernel** is set to *Python3*.
 
-   ![Kernel](media/notebooks-kqlmagic/change-kernel.png)
+   :::image type="content" source="media/notebooks-kqlmagic/change-kernel.png" alt-text="Screenshot of a kernel.":::
 
 2. Load Kqlmagic:
 
    ```python
    %reload_ext Kqlmagic
    ```
 
-   ![Load the Kqlmagic extension](media/notebooks-kqlmagic/install-load-kql-magic-ext.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-load-kql-magic-ext.png" alt-text="Screenshot of loading the Kqlmagic extension.":::
 
    > [!Note]
    > Every time you create a new notebook in Azure Data Studio you must load the Kqlmagic extension.
@@ -174,7 +185,6 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    ```python
    %kql appinsights://appid='DEMO_APP';appkey='DEMO_KEY'
    ```
-
 ### Query and visualize for Application Insights
 
 Query data using the [render operator](/azure/data-explorer/kusto/query/renderoperator) and visualize data using the ploy.ly library. This query and visualization supplies an integrated experience that uses native KQL.
@@ -187,7 +197,7 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    | limit 10
    ```
 
-   ![Page Views](media/notebooks-kqlmagic/appin-page-views.png)
+   :::image type="content" source="media/notebooks-kqlmagic/appin-page-views.png" alt-text="Screenshot of page views.":::
 
    > [!Note]
    > Use your mouse to drag on an area of the chart to zoom in to the specific date(s).
@@ -201,23 +211,23 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    | render timechart title= 'Daily Page Views'
    ```
 
-   ![Timeline Chart](media/notebooks-kqlmagic/appin-timechart.png)
+   :::image type="content" source="media/notebooks-kqlmagic/appin-timechart.png" alt-text="Screenshot of the timeline chart.":::
 
 ## Kqlmagic with Azure Monitor logs
 
 ### <a name="aml-load-auth"></a> Load and authenticate Kqlmagic for Azure Monitor logs
 
 1. Verify the **Kernel** is set to *Python3*.
 
-   ![Change](media/notebooks-kqlmagic/change-kernel.png)
+   :::image type="content" source="media/notebooks-kqlmagic/change-kernel.png" alt-text="Screenshot of the change.":::
 
 2. Load Kqlmagic:
 
    ```python
    %reload_ext Kqlmagic
    ```
 
-   ![Load the Kqlmagic extension](media/notebooks-kqlmagic/install-load-kql-magic-ext.png)
+   :::image type="content" source="media/notebooks-kqlmagic/install-load-kql-magic-ext.png" alt-text="Screenshot showing to load the Kqlmagic extension.":::
 
    > [!Note]
    > Every time you create a new notebook in Azure Data Studio you must load the Kqlmagic extension.
@@ -228,7 +238,7 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    %kql loganalytics://workspace='DEMO_WORKSPACE';appkey='DEMO_KEY';alias='myworkspace'
    ```
 
-   ![Log Analytics auth](media/notebooks-kqlmagic/aml-auth.png)
+   :::image type="content" source="media/notebooks-kqlmagic/aml-auth.png" alt-text="Screenshot of the log analytics authentication.":::
 
 ### Query and visualize for Azure Monitor Logs
 
@@ -243,7 +253,7 @@ Query data using the [render operator](/azure/data-explorer/kusto/query/renderop
    | render timechart title= 'Daily Kubernetes Nodes'
    ```
 
-   ![Log Analytics Daily Kubernetes Nodes timechart](media/notebooks-kqlmagic/aml-timechart-daily-kubernetes-nodes.png)
+   :::image type="content" source="media/notebooks-kqlmagic/aml-timechart-daily-kubernetes-nodes.png" alt-text="Screenshot showing the Log Analytics Daily Kubernetes Nodes timechart.":::
 
 ## Next steps
 
@@ -252,6 +262,6 @@ Learn more about notebooks and Kqlmagic:
 - [Kusto (KQL) extension for Azure Data Studio (Preview)](../extensions/kusto-extension.md)
 - [Create and run a Kusto (KQL) notebook (Preview)](./notebooks-kusto-kernel.md)
 - [Use a Jupyter Notebook and Kqlmagic extension to analyze data in Azure Data Explorer](/azure/data-explorer/Kqlmagic)
-- [Extension (Magic) to Jupyter Notebook and Jupyter lab](https://github.com/Microsoft/jupyter-Kqlmagic), that enable notebook experience working with Kusto, Application Insights, and LogAnalytics data.
+- [Extension (Magic) to Jupyter Notebook and Jupyter lab](https://github.com/Microsoft/jupyter-Kqlmagic) that enable notebook experience working with Kusto Application Insights, and LogAnalytics data.
 - [Kqlmagic](https://pypi.org/project/Kqlmagic/)
-- [How to use notebooks in Azure Data Studio](./notebooks-guidance.md)
+- [How to use notebooks in Azure Data Studio](./notebooks-guidance.md)

docs/sql-server/azure-arc/connect.md

@@ -61,6 +61,7 @@ az provider register --namespace 'Microsoft.AzureArcData'
 If the machine with SQL Server is already connected to Azure Arc, you can connect the SQL Server instances by installing *Azure extension for SQL Server*. The SQL Server extension for Azure Arc Server can be found in the extension manager as **SQL Server Extension - Azure Arc**. Once installed, the Azure extension for SQL Server will recognize all the installed SQL Server instances and connect them with Azure Arc. The extension will run continuously to detect changes in the SQL Server configuration. For example, if a new SQL Server instance is installed on the machine, it will be automatically registered with Azure Arc. See [virtual machine extension management](/azure/azure-arc/servers/manage-vm-extensions) for instructions on how to install and uninstall extensions to [Azure connected machine agent](/azure/azure-arc/servers/agent-overview) using the Azure portal, Azure PowerShell or Azure CLI.
 
 > [!IMPORTANT]  
+>
 > - The Managed System Identity used by the Azure connected machine agent must have the *Azure Connected SQL Server Onboarding* role at the resource group level.
 > - The Azure resource with type `SQL Server - Azure Arc` representing the SQL Server instance installed on the machine uses the same region and resource group as the Azure resources for Arc-enabled servers.
 
@@ -105,6 +106,7 @@ To install *Azure extension for SQL Server* for Linux operating system, run:
 > [!NOTE]  
 > The specified resource group must match the resource group where the corresponding connected server is registered. Otherwise, the command will fail.
  an
+
 ## When the machine isn't connected to an Arc-enabled Server
 
 If the server that runs your SQL Server instance isn't yet connected to Azure, you can initiate the connection from the target machine using the onboarding script. This script will connect the server to Azure and install the Azure extension for SQL Server.
@@ -203,7 +205,7 @@ Go to **Azure Arc > SQL Server** and open the newly registered Arc-enabled SQL S
 To delete your Arc-enabled SQL Server resource, go to **Azure Arc > SQL Server**, open the Arc-enabled SQL Server resource for that instance, and select the **Delete** button.
 
 > [!IMPORTANT]  
-> Because multiple SQL Server instances could be installed on the same machine, the *Delete* button will not uninstall the Azure extension for SQL Server on that machine. To uninstall it, follow the [uninstall extension](/azure/azure-arc/servers/manage-vm-extensions-portal#uninstall-extension) steps.
+> Because multiple SQL Server instances could be installed on the same machine, the *Delete* button doesn't uninstall the Azure extension for SQL Server on that machine. To uninstall it, follow the [uninstall extension](/azure/azure-arc/servers/manage-vm-extensions-portal#uninstall-extension) steps.
 
 ## Restore a deleted Arc-enabled SQL Server resource
 
@@ -218,7 +220,7 @@ If you accidentally deleted your Arc-enabled SQL Server resource, you can restor
    > [!IMPORTANT]  
    > The location property must match the location of the Arc-enabled SQL Server resource for the server specified by the `--machine-name` parameter.
 
-1. Check to make sure your instance is in the exclusion list (see the value of the _excludedSqlInstances_ property).
+1. Check to make sure your instance is in the exclusion list (see the value of the *excludedSqlInstances* property).
 
     ```azurecli
         az connectedmachine extension show --machine-name "{your machine name}" --resource-group "{your resource group name}" -n WindowsAgent.SqlServer
@@ -235,4 +237,4 @@ The instance is restored after the next sync with the agent. For information on
 ## Next steps
 
 - [Configure advanced data security for your SQL Server instance](configure-advanced-data-security.md)
-- [Configure on-demand SQL assessment for your SQL Server instance](assess.md)
+- [Configure on-demand SQL assessment for your SQL Server instance](assess.md)