From 6912d15f61c1d9d9dade8f3b2f8d0efaaf772884 Mon Sep 17 00:00:00 2001 From: vplauzon Date: Mon, 8 May 2023 20:34:13 -0400 Subject: [PATCH 01/37] Add Linux Container install instructions --- data-explorer/kusto-emulator-install.md | 29 ++++++++++++++++-------- data-explorer/kusto-emulator-overview.md | 4 ++-- 2 files changed, 22 insertions(+), 11 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index b022986d18..2a2611c987 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -3,7 +3,7 @@ title: Install the Azure Data Explorer Kusto emulator description: In this article, you'll learn how to install the Azure Data Explorer Kusto emulator and run your first query. ms.reviewer: vplauzon ms.topic: how-to -ms.date: 08/22/2022 +ms.date: 05/08/2023 --- # Install the Azure Data Explorer Kusto emulator @@ -13,6 +13,8 @@ You can install the Azure Data Explorer Kusto emulator in the following ways: - On your own device: Consider using this option if you need to provision a local development environment - On a CI/CD agent virtual machine (VM): Use this option if you require a CI/CD pipeline for running automated tests +Azure Data Explorer Kusto emulator is available in both *Linux* and *Windows* *Docker container image*. + In this article, you'll learn how to: - [Install the Kusto emulator](#install-the-kusto-emulator) @@ -24,17 +26,20 @@ In this article, you'll learn how to: ## Prerequisites - The host operating system must be either: - - Windows Server 2022 - - Windows Server 2019 Version 10.0.17763.2928 or newer - - Windows 11 + - For Linux container only + - Any Linux distro supporting Docker client + - For both Windows and Linux container + - Windows Server 2022 + - Windows Server 2019 Version 10.0.17763.2928 or newer + - Windows 11 - 2 gigabytes (GB) of RAM minimum; we recommend using 4 GB or more -- [Docker Client](https://docs.docker.com/desktop/windows/install/) +- Docker Client for [Linux](https://docs.docker.com/desktop/install/linux-install/) or [Windows](https://docs.docker.com/desktop/windows/install/) ## Install the Kusto emulator The following steps are for using PowerShell to start the emulator using the [Kusto emulator container image](https://aka.ms/adx.emulator.image). For other options, see [Run emulator options](#run-emulator-options). -1. Switch Docker to run with Windows containers. You may need to enable the feature in the Docker settings. +1. (For Windows container only) Switch Docker to run with Windows containers. You may need to enable the feature in the Docker settings. :::image type="content" source="media/kusto-emulator/kusto-emulator-docker-windows-container.png" alt-text="Screenshot of the Docker settings, showing the Switch to Windows containers option."::: @@ -46,15 +51,21 @@ The following steps are for using PowerShell to start the emulator using the [Ku > [!NOTE] > > - The first time this command is run, Docker pulls the container image which is several GBs in size and may take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. - > - The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. + > - (For Windows container only) The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. + + - To start the Linux container: + + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + ``` - - To start the emulator on a Windows Server operating system, make sure you use the `latest` or `stable` tag. + - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest ``` - - To start the image container on a Windows 11, make sure you use the `windows11` tag: + - To start the Windows container on Windows 11, make sure you use the `windows11` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 diff --git a/data-explorer/kusto-emulator-overview.md b/data-explorer/kusto-emulator-overview.md index a94d56a15c..6303c1b21e 100644 --- a/data-explorer/kusto-emulator-overview.md +++ b/data-explorer/kusto-emulator-overview.md @@ -3,7 +3,7 @@ title: Azure Data Explorer Kusto emulator overview description: In this article, you'll learn about the Azure Data Explorer Kusto emulator ms.reviewer: vplauzon ms.topic: conceptual -ms.date: 08/22/2022 +ms.date: 05/08/2023 --- # Azure Data Explorer Kusto emulator @@ -17,7 +17,7 @@ The Kusto emulator is a local environment that encapsulates the [Kusto Query Eng ## Architecture -The Kusto emulator is packaged as a *Docker Windows container image*. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](kusto/tools/kusto-explorer-using.md), [Kusto.CLI](kusto/tools/kusto-cli.md), or [Kusto.Data SDKs](kusto/api/netfx/about-kusto-data.md). +The Kusto emulator is packaged as both a *Linux* and *Windows* *Docker container image*. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](kusto/tools/kusto-explorer-using.md), [Kusto.CLI](kusto/tools/kusto-cli.md), or [Kusto.Data SDKs](kusto/api/netfx/about-kusto-data.md). ![Schematic representation of Kusto emulator architecture.](media/kusto-emulator/kusto-emulator-architecture.png) From 1d11d307b22fd27c0c4182a5baccd415a752e965 Mon Sep 17 00:00:00 2001 From: vplauzon Date: Fri, 17 Jan 2025 14:38:39 -0500 Subject: [PATCH 02/37] . --- data-explorer/kusto-emulator-install.md | 2 +- data-explorer/kusto-emulator-overview.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index b8e05f21f3..2fabf48d14 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -3,7 +3,7 @@ title: Install the Azure Data Explorer Kusto emulator description: In this article, you'll learn how to install the Azure Data Explorer Kusto emulator and run your first query. ms.reviewer: vplauzon ms.topic: how-to -ms.date: 12/05/2023 +ms.date: 01/17/2025 --- # Install the Azure Data Explorer Kusto emulator diff --git a/data-explorer/kusto-emulator-overview.md b/data-explorer/kusto-emulator-overview.md index 154376cdb6..348352e4f6 100644 --- a/data-explorer/kusto-emulator-overview.md +++ b/data-explorer/kusto-emulator-overview.md @@ -3,7 +3,7 @@ title: Azure Data Explorer Kusto emulator overview description: In this article, you'll learn about the Azure Data Explorer Kusto emulator ms.reviewer: vplauzon ms.topic: conceptual -ms.date: 05/08/2023 +ms.date: 01/17/2025 --- # Azure Data Explorer Kusto emulator @@ -17,7 +17,7 @@ The Kusto emulator is a local environment that encapsulates the query engine. Yo ## Architecture -The emulator is available as a *Windows* or *Linux* Docker container image. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true), [Kusto.CLI](/kusto/tools/kusto-cli?view=azure-data-explorer&preserve-view=true), or [Kusto.Data SDKs](/kusto/api/netfx/about-kusto-data?view=azure-data-explorer&preserve-view=true). +The emulator is available as a *Linux* and *Windows* Docker container images. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true), [Kusto.CLI](/kusto/tools/kusto-cli?view=azure-data-explorer&preserve-view=true), or [Kusto.Data SDKs](/kusto/api/netfx/about-kusto-data?view=azure-data-explorer&preserve-view=true). ![Schematic representation of Kusto emulator architecture.](media/kusto-emulator/kusto-emulator-architecture.png) From 013dbfd6105b289bfb2b8b945282fa1698fde732 Mon Sep 17 00:00:00 2001 From: vplauzon Date: Fri, 17 Jan 2025 16:51:00 -0500 Subject: [PATCH 03/37] First draft for Linux-focus how-to --- .../includes/kusto-emulator-limitations.md | 4 +- data-explorer/kusto-emulator-install.md | 56 +++++++++++-------- data-explorer/kusto-emulator-overview.md | 2 +- 3 files changed, 36 insertions(+), 26 deletions(-) diff --git a/data-explorer/includes/kusto-emulator-limitations.md b/data-explorer/includes/kusto-emulator-limitations.md index c390177e4f..94d1cd6d79 100644 --- a/data-explorer/includes/kusto-emulator-limitations.md +++ b/data-explorer/includes/kusto-emulator-limitations.md @@ -1,7 +1,7 @@ --- ms.service: azure ms.topic: include -ms.date: 08/14/2022 +ms.date: 01/17/2025 --- ## Limitations @@ -23,5 +23,5 @@ In general, this offering isn't suited for production workloads. - Although ingested data can be stored externally to the container, we don't recommend persisting data for long periods of time for the following reasons: - There's no guarantee the [extent](/kusto/management/extents-overview?view=azure-data-explorer&preserve-view=true) format will be compatible between versions of the Kusto emulator - Extents aren't [merged](/kusto/management/merge-policy?view=azure-data-explorer&preserve-view=true) and therefore can become fragmented as data get ingested - - Retention policies can be set but won't be honored + - Retention policies & Partitioning policies can be set but won't be honored - The [Python plugin](/kusto/query/python-plugin?view=azure-data-explorer&preserve-view=true?view=azure-data-explorer&preserve-view=true) isn't supported diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 2fabf48d14..d56bc10b8b 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -13,7 +13,7 @@ You can install the Azure Data Explorer Kusto emulator in the following ways: - On your own device: Consider using this option if you need to provision a local development environment - On a CI/CD agent virtual machine (VM): Use this option if you require a CI/CD pipeline for running automated tests -The emulator is available as a *Windows* or *Linux* Docker container image. +The emulator is available as a *Linux* and *Windows* Docker container image. In this article, you'll learn how to: @@ -23,25 +23,27 @@ In this article, you'll learn how to: - [Ingest data](#ingest-data) - [Query data](#query-data) +This article focuses on how to install the Linux Docker container on a Windows client. + ## Prerequisites - The host operating system must be one of: - - Windows Server 2022 - - Windows Server 2019 Version 10.0.17763.2928 or newer - - Windows 11 - Any Linux distro that supports Docker Client for Linux > [!IMPORTANT] > Linux distros only support Linux container images. + - Windows Server 2022 + - Windows Server 2019 Version 10.0.17763.2928 or newer + - Windows 11 - 2 gigabytes (GB) of RAM minimum; we recommend using 4 GB or more -- Docker Client for [Windows](https://docs.docker.com/desktop/windows/install/) or [Linux](https://docs.docker.com/desktop/install/linux-install/) +- Docker Client for [Linux](https://docs.docker.com/desktop/install/linux-install/) or [Windows](https://docs.docker.com/desktop/windows/install/) ## Install the Kusto emulator The following steps are for using PowerShell to start the emulator using the [Kusto emulator container image](https://aka.ms/adx.emulator.image). For other options, see [Run emulator options](#run-emulator-options). -1. For Windows only, switch Docker to run with Windows containers. You may need to enable the feature in the Docker settings. +1. For Windows container only, switch Docker to run with Windows containers. You may need to enable the feature in the Docker settings. :::image type="content" source="media/kusto-emulator/kusto-emulator-docker-windows-container.png" alt-text="Screenshot of the Docker settings, showing the Switch to Windows containers option."::: @@ -55,22 +57,22 @@ The following steps are for using PowerShell to start the emulator using the [Ku > - The first time this command is run, Docker pulls the container image which is several GBs in size and may take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. > - (For Windows container only) The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: + - To start the Linux container: ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest ``` - - To start the Windows container on Windows 11, make sure you use the `windows11` tag: + - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest ``` - - To start the Linux container: + - To start the Windows container on Windows 11, make sure you use the `windows11` tag: ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 ``` 1. Run the following command to verify that the container is running. @@ -120,7 +122,15 @@ You can use any of the following options when running the emulator: - Mount a local folder to the container: Use this option to mount a folder in the host environment into the container. Mounting a host folder enables your queries to interact with local files, which is useful for [creating a database persistent between container runs](#create-a-database) and [ingesting data](#ingest-data). - For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodatadata" in the container, use the next command on Windows Server: + [Linux container] + For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the next command on Windows Server: + + ```powershell + docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + ``` + + [Windows container] + For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the next command on Windows Server: ```powershell docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest @@ -131,7 +141,7 @@ You can use any of the following options when running the emulator: For example, to map port 9000 on the host to the engine, use the following command on Windows Server: ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 9000:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + docker run -e ACCEPT_EULA=Y -m 4G -d -p 9000:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest ``` ## Connect to the emulator @@ -166,21 +176,21 @@ A database can be persisted in a container folder or on a [mounted folder](#run- In this example, we keep the data on the container. -In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true#query-mode), run the following command to create a persistent database if using a Windows container image: +In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true#query-mode), run the following command to create a persistent database: + ```kusto .create database persist ( - @"c:\kustodata\dbs\\md", - @"c:\kustodata\dbs\\data" + @"/kustodata/dbs//md", + @"/kustodata/dbs//data" ) ``` -The equivalent command for a Linux container image is: - + ```kusto .create database persist ( - @"/kustodata/dbs//md", - @"/kustodata/dbs//data" + @"c:\kustodata\dbs\\md", + @"c:\kustodata\dbs\\data" ) ``` @@ -200,7 +210,7 @@ It's also possible to detach the database from the emulator, which will keep all To ingest data, you must first create an external table linked to a file and then ingest the data into a table in the database. -Use the steps in the following example to create an external table and ingest data into it. For the example, in the local folder *c:\kustodata*, create a file called `sample.csv` with the following data: +Use the steps in the following example to create an external table and ingest data into it. For the example, in the local folder *d:\host\local*, create a file called `sample.csv` with the following data: ```text Alice, 1 @@ -217,7 +227,7 @@ Carl, 3 1. Run the following command to [ingest the file into the table](/kusto/management/data-ingestion/ingest-from-storage?view=azure-data-explorer&preserve-view=true): ```kusto - .ingest into table MyIngestedSample(@"c:\kustodata\sample.csv") + .ingest into table MyIngestedSample(@"/kustodata/sample.csv") ``` ## Query data diff --git a/data-explorer/kusto-emulator-overview.md b/data-explorer/kusto-emulator-overview.md index 348352e4f6..106da42fac 100644 --- a/data-explorer/kusto-emulator-overview.md +++ b/data-explorer/kusto-emulator-overview.md @@ -17,7 +17,7 @@ The Kusto emulator is a local environment that encapsulates the query engine. Yo ## Architecture -The emulator is available as a *Linux* and *Windows* Docker container images. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true), [Kusto.CLI](/kusto/tools/kusto-cli?view=azure-data-explorer&preserve-view=true), or [Kusto.Data SDKs](/kusto/api/netfx/about-kusto-data?view=azure-data-explorer&preserve-view=true). +The emulator is available as a *Linux* and *Windows* Docker container image. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true), [Kusto.CLI](/kusto/tools/kusto-cli?view=azure-data-explorer&preserve-view=true), or [Kusto.Data SDKs](/kusto/api/netfx/about-kusto-data?view=azure-data-explorer&preserve-view=true). ![Schematic representation of Kusto emulator architecture.](media/kusto-emulator/kusto-emulator-architecture.png) From 2957b865d3736dfd4cf24655eb38874deb00693a Mon Sep 17 00:00:00 2001 From: vplauzon Date: Fri, 17 Jan 2025 17:08:35 -0500 Subject: [PATCH 04/37] Fix merge issues --- data-explorer/kusto-emulator-install.md | 20 +++++++++++--------- data-explorer/kusto-emulator-overview.md | 2 +- 2 files changed, 12 insertions(+), 10 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 9df4c617d0..c5f3579342 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -13,7 +13,7 @@ You can install the Azure Data Explorer Kusto emulator in the following ways: - On your own device: Consider using this option if you need to provision a local development environment - On a CI/CD agent virtual machine (VM): Use this option if you require a CI/CD pipeline for running automated tests -Azure Data Explorer Kusto emulator is available in both *Linux* and *Windows* *Docker container image*. +The emulator is available as a *Linux* and *Windows* Docker container image. In this article, you'll learn how to: @@ -27,13 +27,15 @@ This article focuses on how to install the Linux Docker container on a Windows c ## Prerequisites -- The host operating system must be either: - - For Linux container only - - Any Linux distro supporting Docker client - - For both Windows and Linux container - - Windows Server 2022 - - Windows Server 2019 Version 10.0.17763.2928 or newer - - Windows 11 +- The host operating system must be one of: + - Windows Server 2022 + - Windows Server 2019 Version 10.0.17763.2928 or newer + - Windows 11 + - Any Linux distro that supports Docker Client for Linux + + > [!IMPORTANT] + > Linux distros only support Linux container images. + - 2 gigabytes (GB) of RAM minimum; we recommend using 4 GB or more - Docker Client for [Linux](https://docs.docker.com/desktop/install/linux-install/) or [Windows](https://docs.docker.com/desktop/windows/install/) @@ -55,7 +57,7 @@ The following steps are for using PowerShell to start the emulator using the [Ku > - The first time this command is run, Docker pulls the container image which is several GBs in size and may take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. > - (For Windows container only) The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - - To start the Linux container: + - To start the Linux container, make sure you use the `latest` or `stable` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest diff --git a/data-explorer/kusto-emulator-overview.md b/data-explorer/kusto-emulator-overview.md index ded4bb5767..106da42fac 100644 --- a/data-explorer/kusto-emulator-overview.md +++ b/data-explorer/kusto-emulator-overview.md @@ -17,7 +17,7 @@ The Kusto emulator is a local environment that encapsulates the query engine. Yo ## Architecture -The Kusto emulator is packaged as both a *Linux* and *Windows* *Docker container image*. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](kusto/tools/kusto-explorer-using.md), [Kusto.CLI](kusto/tools/kusto-cli.md), or [Kusto.Data SDKs](kusto/api/netfx/about-kusto-data.md). +The emulator is available as a *Linux* and *Windows* Docker container image. It exposes a query endpoint over HTTP that can be used with any client including [Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true), [Kusto.CLI](/kusto/tools/kusto-cli?view=azure-data-explorer&preserve-view=true), or [Kusto.Data SDKs](/kusto/api/netfx/about-kusto-data?view=azure-data-explorer&preserve-view=true). ![Schematic representation of Kusto emulator architecture.](media/kusto-emulator/kusto-emulator-architecture.png) From d67a84e0eb99f3e91a08caf5f932ab4255869d36 Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Sun, 26 Jan 2025 19:33:04 +0200 Subject: [PATCH 05/37] replace branch PR 6555 (4) --- data-explorer/kusto/query/visualization-piechart.md | 4 +++- data-explorer/kusto/query/visualization-pivotchart.md | 4 +++- data-explorer/kusto/query/visualization-plotly.md | 4 +++- data-explorer/kusto/query/visualization-scatterchart.md | 4 +++- data-explorer/kusto/query/visualization-stackedareachart.md | 4 +++- data-explorer/kusto/query/visualization-table.md | 4 +++- data-explorer/kusto/query/visualization-timechart.md | 4 +++- data-explorer/kusto/query/visualization-timepivot.md | 4 +++- data-explorer/kusto/query/visualization-treemap.md | 4 +++- 9 files changed, 27 insertions(+), 9 deletions(-) diff --git a/data-explorer/kusto/query/visualization-piechart.md b/data-explorer/kusto/query/visualization-piechart.md index e7569d24f7..ea5f7de0a9 100644 --- a/data-explorer/kusto/query/visualization-piechart.md +++ b/data-explorer/kusto/query/visualization-piechart.md @@ -3,7 +3,7 @@ title: Pie chart visualization description: This article describes the pie chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Pie chart @@ -77,6 +77,8 @@ The supported values of this property are: ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query diff --git a/data-explorer/kusto/query/visualization-pivotchart.md b/data-explorer/kusto/query/visualization-pivotchart.md index 5b3506670b..335f05edea 100644 --- a/data-explorer/kusto/query/visualization-pivotchart.md +++ b/data-explorer/kusto/query/visualization-pivotchart.md @@ -3,7 +3,7 @@ title: Pivot chart visualization description: This article describes the pivot chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "azure-data-explorer" --- # Pivot chart @@ -31,6 +31,8 @@ Displays a pivot table and chart. You can interactively select data, columns, ro ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + ```kusto SalesFact | join kind= inner Products on ProductKey diff --git a/data-explorer/kusto/query/visualization-plotly.md b/data-explorer/kusto/query/visualization-plotly.md index 11c5cd265a..e573b1b317 100644 --- a/data-explorer/kusto/query/visualization-plotly.md +++ b/data-explorer/kusto/query/visualization-plotly.md @@ -3,7 +3,7 @@ title: Plotly visualization description: This article describes how to visualize data using the Plotly graphics library. ms.reviewer: adieldar ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Plotly (preview) @@ -30,6 +30,8 @@ Using this method, all types of Plotly visualizations are supported. ### Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + The following KQL query uses inline Python to create a 3D scatter chart: ~~~kusto diff --git a/data-explorer/kusto/query/visualization-scatterchart.md b/data-explorer/kusto/query/visualization-scatterchart.md index 930a5cd1fa..c45b3ad247 100644 --- a/data-explorer/kusto/query/visualization-scatterchart.md +++ b/data-explorer/kusto/query/visualization-scatterchart.md @@ -3,7 +3,7 @@ title: Scatter chart visualization description: This article describes the scatter chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Scatter chart @@ -75,6 +75,8 @@ The supported values of this property are: ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query diff --git a/data-explorer/kusto/query/visualization-stackedareachart.md b/data-explorer/kusto/query/visualization-stackedareachart.md index 6830d19cf9..14ca1cdc27 100644 --- a/data-explorer/kusto/query/visualization-stackedareachart.md +++ b/data-explorer/kusto/query/visualization-stackedareachart.md @@ -3,7 +3,7 @@ title: Stacked area chart visualization description: This article describes the stacked area chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 11/27/2024 +ms.date: 01/21/2025 monikerRange: "microsoft-fabric || azure-data-explorer" --- # Stacked area chart @@ -49,6 +49,8 @@ All properties are optional. ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + The following query summarizes data from the `nyc_taxi` table by number of passengers and visualizes the data in a stacked area chart. The x-axis shows the pickup time in two day intervals, and the stacked areas represent different passenger counts. :::moniker range="azure-data-explorer" diff --git a/data-explorer/kusto/query/visualization-table.md b/data-explorer/kusto/query/visualization-table.md index bd264e0db3..cf88e1a670 100644 --- a/data-explorer/kusto/query/visualization-table.md +++ b/data-explorer/kusto/query/visualization-table.md @@ -3,7 +3,7 @@ title: Table visualization description: This article describes the table visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Table @@ -62,6 +62,8 @@ All properties are optional. ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query diff --git a/data-explorer/kusto/query/visualization-timechart.md b/data-explorer/kusto/query/visualization-timechart.md index 6473c00d4d..a68e789623 100644 --- a/data-explorer/kusto/query/visualization-timechart.md +++ b/data-explorer/kusto/query/visualization-timechart.md @@ -3,7 +3,7 @@ title: Time chart visualization description: This article describes the time chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 11/13/2024 +ms.date: 01/21/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Time chart @@ -62,6 +62,8 @@ This visualization supports splitting into multiple y-axis values: ## Examples +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + ### Render a timechart The following example renders a timechart with a title "Web app. traffic over a month, decomposing" that decomposes the data into baseline, seasonal, trend, and residual components. diff --git a/data-explorer/kusto/query/visualization-timepivot.md b/data-explorer/kusto/query/visualization-timepivot.md index d0389a5e53..8a1948eb33 100644 --- a/data-explorer/kusto/query/visualization-timepivot.md +++ b/data-explorer/kusto/query/visualization-timepivot.md @@ -3,7 +3,7 @@ title: Time pivot visualization description: This article describes the time pivot visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "azure-data-explorer" --- # Time pivot @@ -51,6 +51,8 @@ All properties are optional. ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + ```kusto let midwesternStates = dynamic([ "ILLINOIS", "INDIANA", "IOWA", "KANSAS", "MICHIGAN", "MINNESOTA", diff --git a/data-explorer/kusto/query/visualization-treemap.md b/data-explorer/kusto/query/visualization-treemap.md index 1fa3847daf..ea187c893c 100644 --- a/data-explorer/kusto/query/visualization-treemap.md +++ b/data-explorer/kusto/query/visualization-treemap.md @@ -3,7 +3,7 @@ title: Treemap visualization description: Learn how to use the treemap visualization to visualize data. ms.reviewer: alexans ms.topic: reference -ms.date: 08/11/2024 +ms.date: 01/21/2025 monikerRange: "azure-data-explorer" --- # Treemap @@ -40,6 +40,8 @@ All properties are optional. ## Example +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + ```kusto StormEvents | summarize StormEvents=count() by EventType, State From 85cff7e6f52c22e904807b4c6d0e2bf7ea6bf3fc Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Tue, 28 Jan 2025 19:21:54 +0200 Subject: [PATCH 06/37] Added example descriptions --- data-explorer/kusto/query/visualization-piechart.md | 10 ++++++---- .../kusto/query/visualization-pivotchart.md | 4 +++- data-explorer/kusto/query/visualization-plotly.md | 12 ++++++------ .../kusto/query/visualization-scatterchart.md | 9 +++++---- data-explorer/kusto/query/visualization-table.md | 6 ++++-- data-explorer/kusto/query/visualization-timechart.md | 4 +++- data-explorer/kusto/query/visualization-timepivot.md | 4 +++- data-explorer/kusto/query/visualization-treemap.md | 6 ++++-- 8 files changed, 34 insertions(+), 21 deletions(-) diff --git a/data-explorer/kusto/query/visualization-piechart.md b/data-explorer/kusto/query/visualization-piechart.md index ea5f7de0a9..5d870411c2 100644 --- a/data-explorer/kusto/query/visualization-piechart.md +++ b/data-explorer/kusto/query/visualization-piechart.md @@ -3,7 +3,7 @@ title: Pie chart visualization description: This article describes the pie chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 01/21/2025 +ms.date: 01/28/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Pie chart @@ -31,7 +31,7 @@ The pie chart visual can also be used in the context of [Geospatial visualizatio | Name | Type | Required | Description | | -- | -- | -- | -- | -| *T* | `string` | :heavy_check_mark: | Input table name. +| *T* | `string` | :heavy_check_mark: | Input table name.| | *propertyName*, *propertyValue* | `string` | | A comma-separated list of key-value property pairs. See [supported properties](#supported-properties).| ### Supported properties @@ -43,7 +43,7 @@ All properties are optional. |*PropertyName*|*PropertyValue* | |--------------|----------------------------------------------------------------------------------| |`accumulate` |Whether the value of each measure gets added to all its predecessors. (`true` or `false`)| -|`kind` |Further elaboration of the visualization kind. For more information, see [`kind` property](#kind-property). | +|`kind` |Further elaboration of the visualization kind. For more information, see [`kind` property](#kind-property). | |`legend` |Whether to display a legend or not (`visible` or `hidden`). | |`series` |Comma-delimited list of columns whose combined per-record values define the series that record belongs to.| |`title` |The title of the visualization (of type `string`). | @@ -79,6 +79,8 @@ The supported values of this property are: [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query provides a visual representation of the top 10 states with the highest number of storm events, displayed as a pie chart + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query @@ -92,4 +94,4 @@ StormEvents | render piechart with(title="Storm Events by State") ``` -:::image type="content" source="media/visualization-piechart/pie-chart.png" alt-text="Screenshot of pie chart visualization output." lightbox="media/visualization-piechart/pie-chart.png"::: \ No newline at end of file +:::image type="content" source="media/visualization-piechart/pie-chart.png" alt-text="Screenshot of pie chart visualization output." lightbox="media/visualization-piechart/pie-chart.png"::: diff --git a/data-explorer/kusto/query/visualization-pivotchart.md b/data-explorer/kusto/query/visualization-pivotchart.md index 335f05edea..363cea6591 100644 --- a/data-explorer/kusto/query/visualization-pivotchart.md +++ b/data-explorer/kusto/query/visualization-pivotchart.md @@ -15,7 +15,7 @@ Displays a pivot table and chart. You can interactively select data, columns, ro > [!NOTE] > > * This visualization can only be used in the context of the [render operator](render-operator.md). -> * This visualization can be used in Kusto.Explorer but is not available in the Azure Data Explorer web UI. +> * This visualization can be used in Kusto.Explorer but isn't available in the Azure Data Explorer web UI. ## Syntax @@ -33,6 +33,8 @@ Displays a pivot table and chart. You can interactively select data, columns, ro [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query provides a detailed analysis of sales for Contoso computer products within the specified date range, visualized as a pivot chart. + ```kusto SalesFact | join kind= inner Products on ProductKey diff --git a/data-explorer/kusto/query/visualization-plotly.md b/data-explorer/kusto/query/visualization-plotly.md index e573b1b317..62d1d3dabe 100644 --- a/data-explorer/kusto/query/visualization-plotly.md +++ b/data-explorer/kusto/query/visualization-plotly.md @@ -3,7 +3,7 @@ title: Plotly visualization description: This article describes how to visualize data using the Plotly graphics library. ms.reviewer: adieldar ms.topic: reference -ms.date: 01/21/2025 +ms.date: 01/28/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Plotly (preview) @@ -12,7 +12,7 @@ monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || micro ::: moniker range="microsoft-fabric || azure-data-explorer" -The Plotly graphics library supports ~80 chart types that are useful for advanced charting including geographic, scientific, machine learning, 3d, animation, and many other chart types. For more information, see [Plotly](https://plotly.com/python/). +The Plotly graphics library supports ~80 chart types that are useful for advanced charting including geographic, scientific, machine learning, 3d, animation, and many other chart types. For more information, see [Plotly](https://plotly.com/python/). To render a Plotly visual in Kusto Query Language, the query must generate a table with a single string cell containing [Plotly JSON](https://plotly.com/chart-studio-help/json-chart-schema/). This Plotly JSON string can be generated by one of the following two methods: @@ -23,16 +23,16 @@ To render a Plotly visual in Kusto Query Language, the query must generate a tab In this method, you dynamically create the Plotly JSON string in Python using the [Plotly package](https://plotly.com/python/getting-started/). This process requires use of the [python() plugin](python-plugin.md). The Python script is run on the existing nodes using the inline python() plugin. It generates a Plotly JSON that is rendered by the client application. -Using this method, all types of Plotly visualizations are supported. +All types of Plotly visualizations are supported. > [!NOTE] -> For best performance, make sure that the python plugin image contains the latest version of the Python engine (currently 3.10.8). This can be checked with the [get_packages_version_fl()](../functions-library/get-packages-version-fl.md) function. To upgrade the Python image see [Change the Python language extensions image on your cluster](/azure/data-explorer/language-extensions#change-the-python-language-extensions-image-on-your-cluster). +> For best performance, make sure that the python plugin image contains the latest version of the Python engine (currently 3.10.8). Check the latest version with the [get_packages_version_fl()](../functions-library/get-packages-version-fl.md) function. To upgrade the Python image, see [Change the Python language extensions image on your cluster](/azure/data-explorer/language-extensions#change-the-python-language-extensions-image-on-your-cluster). ### Example [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] -The following KQL query uses inline Python to create a 3D scatter chart: +The following query uses inline Python to create a 3D scatter chart: ~~~kusto OccupancyDetection @@ -56,7 +56,7 @@ OccupancyDetection The Plotly graphics library supports ~80 chart types including basic charts, scientific, statistical, financial, maps, 3D, animations, and more. To render a Plotly visual in KQL, the query must generate a table with a single string cell containing [Plotly JSON](https://plotly.com/chart-studio-help/json-chart-schema/). -Since python is not available in this service, you create this Plotly JSON using a preprepared template. +Since python isn't available in this service, you create this Plotly JSON using a preprepared template. ::: moniker-end diff --git a/data-explorer/kusto/query/visualization-scatterchart.md b/data-explorer/kusto/query/visualization-scatterchart.md index c45b3ad247..c7716917ca 100644 --- a/data-explorer/kusto/query/visualization-scatterchart.md +++ b/data-explorer/kusto/query/visualization-scatterchart.md @@ -3,7 +3,7 @@ title: Scatter chart visualization description: This article describes the scatter chart visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 01/21/2025 +ms.date: 01/28/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Scatter chart @@ -38,7 +38,7 @@ All properties are optional. |*PropertyName*|*PropertyValue* | |--------------|----------------------------------------------------------------------------------| |`accumulate` |Whether the value of each measure gets added to all its predecessors. (`true` or `false`)| -|`kind` |Further elaboration of the visualization kind. For more information, see [`kind` property](#kind-property). | +|`kind` |Further elaboration of the visualization kind. For more information, see [`kind` property](#kind-property). | |`legend` |Whether to display a legend or not (`visible` or `hidden`). | |`series` |Comma-delimited list of columns whose combined per-record values define the series that record belongs to.| |`ymin` |The minimum value to be displayed on Y-axis. | @@ -63,7 +63,6 @@ All properties are optional. ::: moniker-end - #### `kind` property This visualization can be further elaborated by providing the `kind` property. @@ -77,6 +76,8 @@ The supported values of this property are: [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query provides a scatter chart that helps you analyze the correlation between state populations and the total property damage caused by storm events. + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query @@ -90,4 +91,4 @@ StormEvents | render scatterchart with (xtitle="State population", title="Property damage by state", legend=hidden) ``` -:::image type="content" source="media/visualization-scatterchart/scatter-chart.png" alt-text="Screenshot of scatter chart visualization output." lightbox="media/visualization-scatterchart/scatter-chart.png"::: \ No newline at end of file +:::image type="content" source="media/visualization-scatterchart/scatter-chart.png" alt-text="Screenshot of scatter chart visualization output." lightbox="media/visualization-scatterchart/scatter-chart.png"::: diff --git a/data-explorer/kusto/query/visualization-table.md b/data-explorer/kusto/query/visualization-table.md index cf88e1a670..f4bfaf1741 100644 --- a/data-explorer/kusto/query/visualization-table.md +++ b/data-explorer/kusto/query/visualization-table.md @@ -3,7 +3,7 @@ title: Table visualization description: This article describes the table visualization. ms.reviewer: alexans ms.topic: reference -ms.date: 01/21/2025 +ms.date: 01/28/2025 monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Table @@ -64,6 +64,8 @@ All properties are optional. [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query outputs a snapshot of the first 10 storm event records, displayed in a table format. + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query @@ -75,4 +77,4 @@ StormEvents | render table ``` -:::image type="content" source="media/visualization-table/table-visualization.png" alt-text="Screenshot of table visualization output." lightbox="media/visualization-table/table-visualization.png"::: \ No newline at end of file +:::image type="content" source="media/visualization-table/table-visualization.png" alt-text="Screenshot of table visualization output." lightbox="media/visualization-table/table-visualization.png"::: diff --git a/data-explorer/kusto/query/visualization-timechart.md b/data-explorer/kusto/query/visualization-timechart.md index a68e789623..c694ce0624 100644 --- a/data-explorer/kusto/query/visualization-timechart.md +++ b/data-explorer/kusto/query/visualization-timechart.md @@ -64,6 +64,8 @@ This visualization supports splitting into multiple y-axis values: [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +Review the examples and run them in your Data Explorer query page. + ### Render a timechart The following example renders a timechart with a title "Web app. traffic over a month, decomposing" that decomposes the data into baseline, seasonal, trend, and residual components. @@ -91,7 +93,7 @@ demo_make_series2 ### Label a timechart -The following example renders a timechart that depicts crop damage grouped by week. The timechart x axis is labled "Date" and the y axis is labled "Crop damage." +The following example renders a timechart that depicts crop damage grouped by week. The timechart x axis label is "Date" and the y axis label is "Crop damage." ::: moniker-end ::: moniker range="azure-data-explorer" diff --git a/data-explorer/kusto/query/visualization-timepivot.md b/data-explorer/kusto/query/visualization-timepivot.md index 8a1948eb33..f99015b6ee 100644 --- a/data-explorer/kusto/query/visualization-timepivot.md +++ b/data-explorer/kusto/query/visualization-timepivot.md @@ -15,7 +15,7 @@ The time pivot visualization is an interactive navigation over the events time-l > [!NOTE] > > * This visualization can only be used in the context of the [render operator](render-operator.md). -> * This visualization can be used in Kusto.Explorer but is not available in the Azure Data Explorer web UI. +> * This visualization can be used in Kusto.Explorer but isn't available in the Azure Data Explorer web UI. ## Syntax @@ -53,6 +53,8 @@ All properties are optional. [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query outputs a visualization of flood events in the specified Midwestern states, displayed as a time pivot chart + ```kusto let midwesternStates = dynamic([ "ILLINOIS", "INDIANA", "IOWA", "KANSAS", "MICHIGAN", "MINNESOTA", diff --git a/data-explorer/kusto/query/visualization-treemap.md b/data-explorer/kusto/query/visualization-treemap.md index ea187c893c..283f48b428 100644 --- a/data-explorer/kusto/query/visualization-treemap.md +++ b/data-explorer/kusto/query/visualization-treemap.md @@ -3,7 +3,7 @@ title: Treemap visualization description: Learn how to use the treemap visualization to visualize data. ms.reviewer: alexans ms.topic: reference -ms.date: 01/21/2025 +ms.date: 01/28/2025 monikerRange: "azure-data-explorer" --- # Treemap @@ -15,7 +15,7 @@ Treemaps display hierarchical data as a set of nested rectangles. Each level of > [!NOTE] > > * This visualization can only be used in the context of the [render operator](render-operator.md). -> * This visualization can be used in Kusto.Explorer but is not available in the Azure Data Explorer web UI. +> * This visualization can be used in Kusto.Explorer but isn't available in the Azure Data Explorer web UI. ## Syntax @@ -42,6 +42,8 @@ All properties are optional. [!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query counts the number of storm events for each type and state, sorts them in descending order, limits the results to the top 30, and then visualizes the data as a treemap. + ```kusto StormEvents | summarize StormEvents=count() by EventType, State From 96c213b3b2107e914f627d67acd2dcf0be7043bb Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Wed, 29 Jan 2025 10:29:27 +0200 Subject: [PATCH 07/37] deleted sentence --- data-explorer/kusto/query/visualization-pivotchart.md | 2 -- data-explorer/kusto/query/visualization-plotly.md | 2 -- 2 files changed, 4 deletions(-) diff --git a/data-explorer/kusto/query/visualization-pivotchart.md b/data-explorer/kusto/query/visualization-pivotchart.md index 363cea6591..87179ba6e0 100644 --- a/data-explorer/kusto/query/visualization-pivotchart.md +++ b/data-explorer/kusto/query/visualization-pivotchart.md @@ -31,8 +31,6 @@ Displays a pivot table and chart. You can interactively select data, columns, ro ## Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - This query provides a detailed analysis of sales for Contoso computer products within the specified date range, visualized as a pivot chart. ```kusto diff --git a/data-explorer/kusto/query/visualization-plotly.md b/data-explorer/kusto/query/visualization-plotly.md index 62d1d3dabe..edc0a468ee 100644 --- a/data-explorer/kusto/query/visualization-plotly.md +++ b/data-explorer/kusto/query/visualization-plotly.md @@ -30,8 +30,6 @@ All types of Plotly visualizations are supported. ### Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - The following query uses inline Python to create a 3D scatter chart: ~~~kusto From 3e3381eadeab0b02f85cee65ec4ba203cf9fc44e Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Wed, 5 Feb 2025 13:06:59 +0200 Subject: [PATCH 08/37] Added Examples introductory sentence --- data-explorer/kusto/query/visualization-pivotchart.md | 2 ++ .../kusto/query/visualization-scatterchart.md | 4 ++-- .../kusto/query/visualization-stackedareachart.md | 4 ++-- data-explorer/kusto/query/visualization-table.md | 4 ++-- data-explorer/kusto/query/visualization-timechart.md | 6 +++--- data-explorer/kusto/query/visualization-treemap.md | 10 +++++----- 6 files changed, 16 insertions(+), 14 deletions(-) diff --git a/data-explorer/kusto/query/visualization-pivotchart.md b/data-explorer/kusto/query/visualization-pivotchart.md index 87179ba6e0..a5a4d32d37 100644 --- a/data-explorer/kusto/query/visualization-pivotchart.md +++ b/data-explorer/kusto/query/visualization-pivotchart.md @@ -33,6 +33,8 @@ Displays a pivot table and chart. You can interactively select data, columns, ro This query provides a detailed analysis of sales for Contoso computer products within the specified date range, visualized as a pivot chart. +[!INCLUDE [help-cluster](../includes/help-cluster-note.md)] + ```kusto SalesFact | join kind= inner Products on ProductKey diff --git a/data-explorer/kusto/query/visualization-scatterchart.md b/data-explorer/kusto/query/visualization-scatterchart.md index c7716917ca..764c746890 100644 --- a/data-explorer/kusto/query/visualization-scatterchart.md +++ b/data-explorer/kusto/query/visualization-scatterchart.md @@ -74,10 +74,10 @@ The supported values of this property are: ## Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - This query provides a scatter chart that helps you analyze the correlation between state populations and the total property damage caused by storm events. +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query diff --git a/data-explorer/kusto/query/visualization-stackedareachart.md b/data-explorer/kusto/query/visualization-stackedareachart.md index 14ca1cdc27..d0ea958a9d 100644 --- a/data-explorer/kusto/query/visualization-stackedareachart.md +++ b/data-explorer/kusto/query/visualization-stackedareachart.md @@ -49,10 +49,10 @@ All properties are optional. ## Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - The following query summarizes data from the `nyc_taxi` table by number of passengers and visualizes the data in a stacked area chart. The x-axis shows the pickup time in two day intervals, and the stacked areas represent different passenger counts. +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query diff --git a/data-explorer/kusto/query/visualization-table.md b/data-explorer/kusto/query/visualization-table.md index f4bfaf1741..29102df69d 100644 --- a/data-explorer/kusto/query/visualization-table.md +++ b/data-explorer/kusto/query/visualization-table.md @@ -62,10 +62,10 @@ All properties are optional. ## Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - This query outputs a snapshot of the first 10 storm event records, displayed in a table format. +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query diff --git a/data-explorer/kusto/query/visualization-timechart.md b/data-explorer/kusto/query/visualization-timechart.md index 774ad7cb0e..fb94001d89 100644 --- a/data-explorer/kusto/query/visualization-timechart.md +++ b/data-explorer/kusto/query/visualization-timechart.md @@ -62,9 +62,9 @@ This visualization supports splitting into multiple y-axis values: ## Examples -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - -Review the examples and run them in your Data Explorer query page. +The example in this section shows how to use the syntax to help you get started. + +[!INCLUDE [help-cluster](../includes/help-cluster-note.md)] ### Render a timechart diff --git a/data-explorer/kusto/query/visualization-treemap.md b/data-explorer/kusto/query/visualization-treemap.md index 283f48b428..7e3cfcb21a 100644 --- a/data-explorer/kusto/query/visualization-treemap.md +++ b/data-explorer/kusto/query/visualization-treemap.md @@ -26,9 +26,9 @@ Treemaps display hierarchical data as a set of nested rectangles. Each level of ## Parameters | Name | Type | Required | Description | -| -- | -- | -- | -- | -| *T* | `string` | :heavy_check_mark: | Input table name. -| *propertyName*, *propertyValue* | `string` | | A comma-separated list of key-value property pairs. See [supported properties](#supported-properties).| +|--|--|--|--| +| *T* | `string` | :heavy_check_mark: | Input table name. | +| *propertyName*, *propertyValue* | `string` | | A comma-separated list of key-value property pairs. See [supported properties](#supported-properties). | ### Supported properties @@ -40,10 +40,10 @@ All properties are optional. ## Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] - This query counts the number of storm events for each type and state, sorts them in descending order, limits the results to the top 30, and then visualizes the data as a treemap. +[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] + ```kusto StormEvents | summarize StormEvents=count() by EventType, State From c52bf5497a6058a4e1d6db67641ce1d99e4eb341 Mon Sep 17 00:00:00 2001 From: PavanPesala-MSFT <129385121+PesalaPavan@users.noreply.github.com> Date: Thu, 6 Feb 2025 15:58:54 +0530 Subject: [PATCH 09/37] (AzureCXP) fixes MicrosoftDocs//dataexplorer-docs#367732 Updated line : 36 Replaced with updated query URL. --- data-explorer/kusto/query/project-rename-operator.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/query/project-rename-operator.md b/data-explorer/kusto/query/project-rename-operator.md index 87f59c0353..1a84787cc3 100644 --- a/data-explorer/kusto/query/project-rename-operator.md +++ b/data-explorer/kusto/query/project-rename-operator.md @@ -33,7 +33,7 @@ A table that has the columns in the same order as in an existing table, with col :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] -> Run the query +> Run the query ::: moniker-end ```kusto From c1ae500731342e3109679f415112304679fcd362 Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Thu, 6 Feb 2025 13:04:18 +0200 Subject: [PATCH 10/37] Remove `monikerRange` from visualization articles --- data-explorer/kusto/query/visualization-piechart.md | 1 - data-explorer/kusto/query/visualization-plotly.md | 1 - data-explorer/kusto/query/visualization-scatterchart.md | 1 - data-explorer/kusto/query/visualization-table.md | 1 - data-explorer/kusto/query/visualization-timechart.md | 1 - 5 files changed, 5 deletions(-) diff --git a/data-explorer/kusto/query/visualization-piechart.md b/data-explorer/kusto/query/visualization-piechart.md index 5d870411c2..1c36f3d3b7 100644 --- a/data-explorer/kusto/query/visualization-piechart.md +++ b/data-explorer/kusto/query/visualization-piechart.md @@ -4,7 +4,6 @@ description: This article describes the pie chart visualization. ms.reviewer: alexans ms.topic: reference ms.date: 01/28/2025 -monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Pie chart diff --git a/data-explorer/kusto/query/visualization-plotly.md b/data-explorer/kusto/query/visualization-plotly.md index edc0a468ee..bbf8e6caf4 100644 --- a/data-explorer/kusto/query/visualization-plotly.md +++ b/data-explorer/kusto/query/visualization-plotly.md @@ -4,7 +4,6 @@ description: This article describes how to visualize data using the Plotly grap ms.reviewer: adieldar ms.topic: reference ms.date: 01/28/2025 -monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Plotly (preview) diff --git a/data-explorer/kusto/query/visualization-scatterchart.md b/data-explorer/kusto/query/visualization-scatterchart.md index c7716917ca..848201de51 100644 --- a/data-explorer/kusto/query/visualization-scatterchart.md +++ b/data-explorer/kusto/query/visualization-scatterchart.md @@ -4,7 +4,6 @@ description: This article describes the scatter chart visualization. ms.reviewer: alexans ms.topic: reference ms.date: 01/28/2025 -monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Scatter chart diff --git a/data-explorer/kusto/query/visualization-table.md b/data-explorer/kusto/query/visualization-table.md index f4bfaf1741..4bb0b330a9 100644 --- a/data-explorer/kusto/query/visualization-table.md +++ b/data-explorer/kusto/query/visualization-table.md @@ -4,7 +4,6 @@ description: This article describes the table visualization. ms.reviewer: alexans ms.topic: reference ms.date: 01/28/2025 -monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Table diff --git a/data-explorer/kusto/query/visualization-timechart.md b/data-explorer/kusto/query/visualization-timechart.md index 774ad7cb0e..237de95150 100644 --- a/data-explorer/kusto/query/visualization-timechart.md +++ b/data-explorer/kusto/query/visualization-timechart.md @@ -4,7 +4,6 @@ description: This article describes the time chart visualization. ms.reviewer: alexans ms.topic: reference ms.date: 01/21/2025 -monikerRange: "microsoft-fabric || azure-data-explorer || azure-monitor || microsoft-sentinel" --- # Time chart From 7507c4eba7e6a9d3416d18b504bca15c13e2898c Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 16:09:25 +0200 Subject: [PATCH 11/37] Emulator updates --- .../includes/kusto-emulator-limitations.md | 6 +-- data-explorer/kusto-emulator-install.md | 48 +++++++++++-------- data-explorer/kusto-emulator-overview.md | 10 ++-- 3 files changed, 35 insertions(+), 29 deletions(-) diff --git a/data-explorer/includes/kusto-emulator-limitations.md b/data-explorer/includes/kusto-emulator-limitations.md index 94d1cd6d79..56a9d21349 100644 --- a/data-explorer/includes/kusto-emulator-limitations.md +++ b/data-explorer/includes/kusto-emulator-limitations.md @@ -1,7 +1,7 @@ --- ms.service: azure ms.topic: include -ms.date: 01/17/2025 +ms.date: 02/05/2025 --- ## Limitations @@ -21,7 +21,7 @@ In general, this offering isn't suited for production workloads. - No support for ingestion endpoints, including Kusto.Ingest SDKs - No streaming ingestion - Although ingested data can be stored externally to the container, we don't recommend persisting data for long periods of time for the following reasons: - - There's no guarantee the [extent](/kusto/management/extents-overview?view=azure-data-explorer&preserve-view=true) format will be compatible between versions of the Kusto emulator + - There's no guarantee the [extent](/kusto/management/extents-overview?view=azure-data-explorer&preserve-view=true) format is compatible between versions of the Kusto emulator - Extents aren't [merged](/kusto/management/merge-policy?view=azure-data-explorer&preserve-view=true) and therefore can become fragmented as data get ingested - - Retention policies & Partitioning policies can be set but won't be honored + - Retention and partitioning policies can be set but aren't honored - The [Python plugin](/kusto/query/python-plugin?view=azure-data-explorer&preserve-view=true?view=azure-data-explorer&preserve-view=true) isn't supported diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index c5f3579342..45c60ab104 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -1,21 +1,21 @@ --- title: Install the Azure Data Explorer Kusto emulator -description: In this article, you'll learn how to install the Azure Data Explorer Kusto emulator and run your first query. +description: In this article, you learn how to install the Azure Data Explorer Kusto emulator and run your first query. ms.reviewer: vplauzon ms.topic: how-to -ms.date: 01/17/2025 +ms.date: 02/06/2025 --- # Install the Azure Data Explorer Kusto emulator You can install the Azure Data Explorer Kusto emulator in the following ways: -- On your own device: Consider using this option if you need to provision a local development environment -- On a CI/CD agent virtual machine (VM): Use this option if you require a CI/CD pipeline for running automated tests +- **On your own device:** Consider using this option if you need to provision a local development environment +- **On a CI/CD agent virtual machine (VM):** Use this option if you require a CI/CD pipeline for running automated tests The emulator is available as a *Linux* and *Windows* Docker container image. -In this article, you'll learn how to: +In this article, you learn how to: - [Install the Kusto emulator](#install-the-kusto-emulator) - [Connect to the emulator](#connect-to-the-emulator) @@ -43,7 +43,7 @@ This article focuses on how to install the Linux Docker container on a Windows c The following steps are for using PowerShell to start the emulator using the [Kusto emulator container image](https://aka.ms/adx.emulator.image). For other options, see [Run emulator options](#run-emulator-options). -1. (For Windows container only) Switch Docker to run with Windows containers. You may need to enable the feature in the Docker settings. +1. (For Windows container only) Switch Docker to run with Windows containers. You might need to enable the feature in the Docker settings. :::image type="content" source="media/kusto-emulator/kusto-emulator-docker-windows-container.png" alt-text="Screenshot of the Docker settings, showing the Switch to Windows containers option."::: @@ -54,8 +54,8 @@ The following steps are for using PowerShell to start the emulator using the [Ku > [!NOTE] > - > - The first time this command is run, Docker pulls the container image which is several GBs in size and may take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. - > - (For Windows container only) The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. + > - The first time this command is run, Docker pulls the container image which is several GBs in size and might take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. + > - **For Windows container only:** The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - To start the Linux container, make sure you use the `latest` or `stable` tag: @@ -122,20 +122,23 @@ You can use any of the following options when running the emulator: - Mount a local folder to the container: Use this option to mount a folder in the host environment into the container. Mounting a host folder enables your queries to interact with local files, which is useful for [creating a database persistent between container runs](#create-a-database) and [ingesting data](#ingest-data). - [Linux container] - For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the next command on Windows Server: + [Linux container](#tab/linuxcontainer) + + For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: ```powershell docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest ``` - [Windows container] - For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the next command on Windows Server: + [Windows container](#tab/windowscontainer) + For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the following command on Windows Server: ```powershell docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest ``` + --- + - Run on a different port: The Kusto emulator exposes access to the Kusto Query Engine on port 8080; hence in other examples you mapped the host port 8080 to the emulator port 8080. You can use this option to map a different host to the engine. For example, to map port 9000 on the host to the engine, use the following command on Windows Server: @@ -152,19 +155,19 @@ You can use any of the following tools to connect to and interact with the emula - [Kusto.CLI](/kusto/tools/kusto-cli?view=azure-data-explorer&preserve-view=true) - [Kusto.Data SDKs](/kusto/api/netfx/about-kusto-data?view=azure-data-explorer&preserve-view=true) -In the following sections, you'll use Kusto.Explorer to create a database, ingest data, and query it. To learn more, see [Using Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true). +In the following sections, you use Kusto.Explorer to create a database, ingest data, and query it. To learn more, see [Using Kusto.Explorer](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true). > [!IMPORTANT] > The Kusto Emulator doesn't support HTTPS or Microsoft Entra authentication. > > You must first allow unsafe connections in **Tools** > **Options** > **Connections** > **Allow unsafe connections**. -> +> > :::image type="content" source="media/kusto-emulator/unsafe-connections.png" alt-text="Screenshot of Kusto Explorer connection options."::: -> +> > The following image highlights the affected fields in the **Add connection** properties. > > - The **Cluster connection** must begin with `http://` and not `https://`. -> - In **Security** > **Advanced: Connection String**, you'll need to remove the `AAD Federated Security=True` portion of the connection string to disable Microsoft Entra authentication. +> - In **Security** > **Advanced: Connection String**, you need to remove the `AAD Federated Security=True` portion of the connection string to disable Microsoft Entra authentication. > > :::image type="content" source="media/kusto-emulator/kusto-emulator-connection.png" alt-text="Screenshot of Kusto Explorer single connection setup."::: @@ -172,13 +175,14 @@ In the following sections, you'll use Kusto.Explorer to create a database, inges To store data and run queries, create a database or attach the emulator to an existing database. -A database can be persisted in a container folder or on a [mounted folder](#run-emulator-options). The former's lifetime is bound to the container, so restarting the container loses any changes. Also, the container virtual storage is less efficient than native one. Mounted folder enables you to keep the data between container runs. +A database can be persisted in a container folder or on a [mounted folder](#run-emulator-options). The former's lifetime is bound to the container, so restarting the container loses any changes. Also, the container virtual storage is less efficient than native one. Mounted folder enables you to keep the data between container runs. In this example, we keep the data on the container. In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true#query-mode), run the following command to create a persistent database: - +[Linux container](#tab/linuxcontainer) + ```kusto .create database persist ( @"/kustodata/dbs//md", @@ -186,13 +190,15 @@ In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure- ) ``` - +[Windows container](#tab/windowscontainer) + ```kusto .create database persist ( @"c:\kustodata\dbs\\md", @"c:\kustodata\dbs\\data" ) ``` +--- This command requires that the folders don't already exist, to prevent over-writing existing information. To attach to an existing database, use the following command instead, specifying the path that ends with `md`: @@ -200,7 +206,7 @@ This command requires that the folders don't already exist, to prevent over-writ .attach database from @"" ``` -It's also possible to detach the database from the emulator, which will keep all the database metadata and data intact (so you could reattach to it in the future): +It's also possible to detach the database from the emulator, which will keep all the database metadata and data intact so you can reattach to it in the future: ```kusto .detach database @@ -210,7 +216,7 @@ It's also possible to detach the database from the emulator, which will keep all To ingest data, you must first create an external table linked to a file and then ingest the data into a table in the database. -Use the steps in the following example to create an external table and ingest data into it. For the example, in the local folder *d:\host\local*, create a file called `sample.csv` with the following data: +Use the steps in the following example to create an external table and ingest data into it. As part of the example, create a file called `sample.csv` in the local folder *d:\host\local*, with the following data: ```text Alice, 1 diff --git a/data-explorer/kusto-emulator-overview.md b/data-explorer/kusto-emulator-overview.md index 106da42fac..9722dfde4d 100644 --- a/data-explorer/kusto-emulator-overview.md +++ b/data-explorer/kusto-emulator-overview.md @@ -1,9 +1,9 @@ --- title: Azure Data Explorer Kusto emulator overview -description: In this article, you'll learn about the Azure Data Explorer Kusto emulator +description: In this article, you'll learn about the Azure Data Explorer Kusto emulator. ms.reviewer: vplauzon ms.topic: conceptual -ms.date: 01/17/2025 +ms.date: 02/06/2025 --- # Azure Data Explorer Kusto emulator @@ -13,7 +13,7 @@ The Kusto emulator is a local environment that encapsulates the query engine. Yo > > - The emulator is provided *as-is*, without any support or warranties. > - The emulator isn't intended for use in production environments. -> - The [license terms](https://aka.ms/adx.emulator.license) explicitly prohibit benchmark tests using the emulator as it is not intended or optimized for that purpose. The emulator has a very different performance profile compared to the Azure Data Explorer service. +> - The [license terms](https://aka.ms/adx.emulator.license) explicitly prohibit benchmark tests using the emulator as it isn't intended or optimized for that purpose. The emulator has a very different performance profile compared to the Azure Data Explorer service. ## Architecture @@ -34,7 +34,7 @@ The main scenarios for the emulator are: ## Kusto emulator vs. free cluster -There are some overlaps between the Kusto emulator and the [free cluster](start-for-free.md) offerings. The following table contrasts the features of the offerings. +There are some overlaps between the Kusto emulator and the [free cluster](start-for-free.md) offerings. The following table contrasts the features of the offerings. | Item | Kusto emulator | Free cluster | |--|--|--| @@ -52,7 +52,7 @@ There are some overlaps between the Kusto emulator and the [free cluster](start- When choosing the best option for your use case, you should consider the following: - **Local development**: The best fit for local development depends on the features you require. For instance, if your scenario requires the use of managed pipelines, the free cluster offering works best. On the other hand, if your scenario requires local development in a disconnected environment, the Kusto emulator would be a better fit. -- **Automated testing**: In general, the Kusto emulator is more suited to automated testing than the free cluster offering. It's faster to provision and doesn't require any Azure principal to set up. +- **Automated testing**: In general, the Kusto emulator is more suited to automated testing than the free cluster offering. It's faster to provision and doesn't require any Azure principal to set up. [!INCLUDE [kusto-emulator-limitations](includes/kusto-emulator-limitations.md)] From 5ba4f0f9db994e2e10500dafa20046f7fc04bc6a Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:03:10 +0200 Subject: [PATCH 12/37] tabs --- data-explorer/kusto-emulator-install.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 45c60ab104..6d23d64e14 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -122,7 +122,7 @@ You can use any of the following options when running the emulator: - Mount a local folder to the container: Use this option to mount a folder in the host environment into the container. Mounting a host folder enables your queries to interact with local files, which is useful for [creating a database persistent between container runs](#create-a-database) and [ingesting data](#ingest-data). - [Linux container](#tab/linuxcontainer) + # [Linux container](#tab/linuxcontainer) For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: @@ -130,7 +130,7 @@ You can use any of the following options when running the emulator: docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest ``` - [Windows container](#tab/windowscontainer) + # [Windows container](#tab/windowscontainer) For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the following command on Windows Server: ```powershell @@ -181,7 +181,7 @@ In this example, we keep the data on the container. In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true#query-mode), run the following command to create a persistent database: -[Linux container](#tab/linuxcontainer) +# [Linux container](#tab/linuxcontainer) ```kusto .create database persist ( @@ -190,7 +190,7 @@ In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure- ) ``` -[Windows container](#tab/windowscontainer) +# [Windows container](#tab/windowscontainer) ```kusto .create database persist ( From b806eefff008d16853957670db991cc0b28d7830 Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:17:05 +0200 Subject: [PATCH 13/37] edits --- data-explorer/kusto-emulator-install.md | 26 +++++++++++++++---------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 6d23d64e14..c437d28525 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -55,25 +55,31 @@ The following steps are for using PowerShell to start the emulator using the [Ku > [!NOTE] > > - The first time this command is run, Docker pulls the container image which is several GBs in size and might take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. - > - **For Windows container only:** The container must be run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. + > - **For Windows container only:** The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - - To start the Linux container, make sure you use the `latest` or `stable` tag: + # [Linux container](#tab/linuxcontainer) + To start the Linux container, make sure you use the `latest` or `stable` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest - ``` + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + ``` - - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: + # [Windows Server](#tab/windowsservercontainer) - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest - ``` + To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: - - To start the Windows container on Windows 11, make sure you use the `windows11` tag: + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + ``` + + # [Windows container](#tab/windowscontainer) + + To start the Windows container on Windows 11, make sure you use the `windows11` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 ``` +--- 1. Run the following command to verify that the container is running. From 17996a36bf399a35726a2a5a0ff436994d29feb6 Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:24:04 +0200 Subject: [PATCH 14/37] edits --- data-explorer/kusto-emulator-install.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index c437d28525..5f05e2c77b 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -122,28 +122,28 @@ The following steps are for using PowerShell to start the emulator using the [Ku RawContentLength : 988 ``` -### Run emulator options +## Run emulator options You can use any of the following options when running the emulator: - Mount a local folder to the container: Use this option to mount a folder in the host environment into the container. Mounting a host folder enables your queries to interact with local files, which is useful for [creating a database persistent between container runs](#create-a-database) and [ingesting data](#ingest-data). - # [Linux container](#tab/linuxcontainer) +# [Linux container](#tab/linuxcontainer) - For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: +For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: - ```powershell - docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest - ``` +```powershell +docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest +``` - # [Windows container](#tab/windowscontainer) - For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the following command on Windows Server: +# [Windows container](#tab/windowscontainer) +For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the following command on Windows Server: - ```powershell - docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest - ``` +```powershell +docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest +``` - --- +--- - Run on a different port: The Kusto emulator exposes access to the Kusto Query Engine on port 8080; hence in other examples you mapped the host port 8080 to the emulator port 8080. You can use this option to map a different host to the engine. From c7dbf147e2e6b9de339bed6d88fc997e88f18beb Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:35:38 +0200 Subject: [PATCH 15/37] edits --- data-explorer/kusto-emulator-install.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 5f05e2c77b..9f5310bbe5 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -76,10 +76,10 @@ The following steps are for using PowerShell to start the emulator using the [Ku To start the Windows container on Windows 11, make sure you use the `windows11` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 - ``` ---- + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 + ``` + --- 1. Run the following command to verify that the container is running. From daf4a15dd35e0f0745857bc602f85c5e5a555d02 Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:45:36 +0200 Subject: [PATCH 16/37] edits --- data-explorer/kusto-emulator-install.md | 12 +++--------- data-explorer/kusto-emulator-overview.md | 6 +++--- 2 files changed, 6 insertions(+), 12 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 9f5310bbe5..4161828c58 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -57,29 +57,23 @@ The following steps are for using PowerShell to start the emulator using the [Ku > - The first time this command is run, Docker pulls the container image which is several GBs in size and might take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. > - **For Windows container only:** The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - # [Linux container](#tab/linuxcontainer) - To start the Linux container, make sure you use the `latest` or `stable` tag: + - To start the Linux container, make sure you use the `latest` or `stable` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest ``` - # [Windows Server](#tab/windowsservercontainer) - - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: + - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest ``` - # [Windows container](#tab/windowscontainer) - - To start the Windows container on Windows 11, make sure you use the `windows11` tag: + - To start the Windows container on Windows 11, make sure you use the `windows11` tag: ```powershell docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 ``` - --- 1. Run the following command to verify that the container is running. diff --git a/data-explorer/kusto-emulator-overview.md b/data-explorer/kusto-emulator-overview.md index 9722dfde4d..e9193c77f4 100644 --- a/data-explorer/kusto-emulator-overview.md +++ b/data-explorer/kusto-emulator-overview.md @@ -1,6 +1,6 @@ --- title: Azure Data Explorer Kusto emulator overview -description: In this article, you'll learn about the Azure Data Explorer Kusto emulator. +description: In this article, you learn about the Azure Data Explorer Kusto emulator. ms.reviewer: vplauzon ms.topic: conceptual ms.date: 02/06/2025 @@ -13,7 +13,7 @@ The Kusto emulator is a local environment that encapsulates the query engine. Yo > > - The emulator is provided *as-is*, without any support or warranties. > - The emulator isn't intended for use in production environments. -> - The [license terms](https://aka.ms/adx.emulator.license) explicitly prohibit benchmark tests using the emulator as it isn't intended or optimized for that purpose. The emulator has a very different performance profile compared to the Azure Data Explorer service. +> - The [license terms](https://aka.ms/adx.emulator.license) explicitly prohibit benchmark tests using the emulator as it isn't intended or optimized for that purpose. The emulator has a different performance profile compared to the Azure Data Explorer service. ## Architecture @@ -49,7 +49,7 @@ There are some overlaps between the Kusto emulator and the [free cluster](start- | Long term data management | No extent merge capability | Full support | | Internet requirement | No connectivity required | Cloud service | -When choosing the best option for your use case, you should consider the following: +When choosing the best option for your use case, you should consider: - **Local development**: The best fit for local development depends on the features you require. For instance, if your scenario requires the use of managed pipelines, the free cluster offering works best. On the other hand, if your scenario requires local development in a disconnected environment, the Kusto emulator would be a better fit. - **Automated testing**: In general, the Kusto emulator is more suited to automated testing than the free cluster offering. It's faster to provision and doesn't require any Azure principal to set up. From e8c3e40ed64168ab5ee9a7414e5f5e32a4bc80b5 Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:53:46 +0200 Subject: [PATCH 17/37] edits --- data-explorer/kusto-emulator-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 4161828c58..96be58720e 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -43,7 +43,7 @@ This article focuses on how to install the Linux Docker container on a Windows c The following steps are for using PowerShell to start the emulator using the [Kusto emulator container image](https://aka.ms/adx.emulator.image). For other options, see [Run emulator options](#run-emulator-options). -1. (For Windows container only) Switch Docker to run with Windows containers. You might need to enable the feature in the Docker settings. +1. **For Windows container only:** Switch Docker to run with Windows containers. You might need to enable the feature in the Docker settings. :::image type="content" source="media/kusto-emulator/kusto-emulator-docker-windows-container.png" alt-text="Screenshot of the Docker settings, showing the Switch to Windows containers option."::: From 04781cd6304434857c4b09c0d39ab5f4f9f2dff6 Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Thu, 6 Feb 2025 17:58:13 +0200 Subject: [PATCH 18/37] edits --- data-explorer/kusto-emulator-install.md | 40 ++++++++++++------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 96be58720e..c4e4d878ed 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -59,21 +59,21 @@ The following steps are for using PowerShell to start the emulator using the [Ku - To start the Linux container, make sure you use the `latest` or `stable` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest - ``` + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + ``` - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest - ``` + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + ``` - To start the Windows container on Windows 11, make sure you use the `windows11` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 - ``` + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 + ``` 1. Run the following command to verify that the container is running. @@ -122,22 +122,22 @@ You can use any of the following options when running the emulator: - Mount a local folder to the container: Use this option to mount a folder in the host environment into the container. Mounting a host folder enables your queries to interact with local files, which is useful for [creating a database persistent between container runs](#create-a-database) and [ingesting data](#ingest-data). -# [Linux container](#tab/linuxcontainer) + # [Linux container](#tab/linuxcontainer) -For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: + For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: -```powershell -docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest -``` + ```powershell + docker run -v d:\host\local:/kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + ``` -# [Windows container](#tab/windowscontainer) -For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the following command on Windows Server: + # [Windows container](#tab/windowscontainer) + For example, to mount the folder "D:\host\local" on the host to the folder "c:\kustodata" in the container, use the following command on Windows Server: -```powershell -docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest -``` + ```powershell + docker run -v d:\host\local:c:\kustodata -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + ``` ---- + --- - Run on a different port: The Kusto emulator exposes access to the Kusto Query Engine on port 8080; hence in other examples you mapped the host port 8080 to the emulator port 8080. You can use this option to map a different host to the engine. From a09d9d5a6a83d253c64d937a3ae516eb81a31262 Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Sun, 9 Feb 2025 22:11:23 +0200 Subject: [PATCH 19/37] edit --- data-explorer/kusto-emulator-install.md | 30 ++++++++++++++----------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index c4e4d878ed..7d5bdb4bd4 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -3,7 +3,7 @@ title: Install the Azure Data Explorer Kusto emulator description: In this article, you learn how to install the Azure Data Explorer Kusto emulator and run your first query. ms.reviewer: vplauzon ms.topic: how-to -ms.date: 02/06/2025 +ms.date: 02/09/2025 --- # Install the Azure Data Explorer Kusto emulator @@ -57,23 +57,27 @@ The following steps are for using PowerShell to start the emulator using the [Ku > - The first time this command is run, Docker pulls the container image which is several GBs in size and might take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. > - **For Windows container only:** The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - - To start the Linux container, make sure you use the `latest` or `stable` tag: + # [Linux container](#tab/linuxcontainer) + To start the Linux container, make sure you use the `latest` or `stable` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest - ``` + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer-linux:latest + ``` + + # [Windows container](#tab/windowscontainer) + To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: - - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + ``` - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest - ``` + To start the Windows container on Windows 11, make sure you use the `windows11` tag: - - To start the Windows container on Windows 11, make sure you use the `windows11` tag: + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 + ``` - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 - ``` + --- 1. Run the following command to verify that the container is running. From 3f0e3659f6a2b1b4a1d2639195306c4f9863318c Mon Sep 17 00:00:00 2001 From: Meira Josephy <144697924+mjosephym@users.noreply.github.com> Date: Sun, 9 Feb 2025 22:31:01 +0200 Subject: [PATCH 20/37] edit --- data-explorer/kusto-emulator-install.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 7d5bdb4bd4..94e1045782 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -58,6 +58,7 @@ The following steps are for using PowerShell to start the emulator using the [Ku > - **For Windows container only:** The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. # [Linux container](#tab/linuxcontainer) + To start the Linux container, make sure you use the `latest` or `stable` tag: ```powershell @@ -65,17 +66,18 @@ The following steps are for using PowerShell to start the emulator using the [Ku ``` # [Windows container](#tab/windowscontainer) - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest - ``` + - To start the Windows container on Windows Server operating system, make sure you use the `latest` or `stable` tag: - To start the Windows container on Windows 11, make sure you use the `windows11` tag: + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:latest + ``` - ```powershell - docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 - ``` + - To start the Windows container on Windows 11, make sure you use the `windows11` tag: + + ```powershell + docker run -e ACCEPT_EULA=Y -m 4G -d -p 8080:8080 -t mcr.microsoft.com/azuredataexplorer/kustainer:windows11 + ``` --- From d1dd64bb6cd02b0db534ff66f525ac63c4c5d38b Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Tue, 11 Feb 2025 15:42:56 +0200 Subject: [PATCH 21/37] New include for ADX only help cluster --- .../kusto/includes/help-cluster-note-ADX-only.md | 8 ++++++++ data-explorer/kusto/query/visualization-pivotchart.md | 4 +++- data-explorer/kusto/query/visualization-timepivot.md | 6 ++++-- 3 files changed, 15 insertions(+), 3 deletions(-) create mode 100644 data-explorer/kusto/includes/help-cluster-note-ADX-only.md diff --git a/data-explorer/kusto/includes/help-cluster-note-ADX-only.md b/data-explorer/kusto/includes/help-cluster-note-ADX-only.md new file mode 100644 index 0000000000..f968e9b4dc --- /dev/null +++ b/data-explorer/kusto/includes/help-cluster-note-ADX-only.md @@ -0,0 +1,8 @@ +--- +ms.topic: include +ms.date: 01/22/2025 +--- + +:::moniker range="azure-data-explorer" +> The examples in this article use publicly available tables in the [help cluster](https://dataexplorer.azure.com/clusters/help/), such as the `StormEvents` table in the *Samples* database. +::: moniker-end \ No newline at end of file diff --git a/data-explorer/kusto/query/visualization-pivotchart.md b/data-explorer/kusto/query/visualization-pivotchart.md index a5a4d32d37..0ba9cd9014 100644 --- a/data-explorer/kusto/query/visualization-pivotchart.md +++ b/data-explorer/kusto/query/visualization-pivotchart.md @@ -33,7 +33,7 @@ Displays a pivot table and chart. You can interactively select data, columns, ro This query provides a detailed analysis of sales for Contoso computer products within the specified date range, visualized as a pivot chart. -[!INCLUDE [help-cluster](../includes/help-cluster-note.md)] +[!INCLUDE [help-cluster-note-ADX-only](../includes/help-cluster-note-ADX-only.md)] ```kusto SalesFact @@ -44,4 +44,6 @@ SalesFact | render pivotchart ``` +**Output** + :::image type="content" source="media/visualize-pivotchart/pivotchart.png" alt-text="Screenshot of query result showing a pivot chart visualization." lightbox="media/visualize-pivotchart/pivotchart.png"::: diff --git a/data-explorer/kusto/query/visualization-timepivot.md b/data-explorer/kusto/query/visualization-timepivot.md index f99015b6ee..9eb7d9948b 100644 --- a/data-explorer/kusto/query/visualization-timepivot.md +++ b/data-explorer/kusto/query/visualization-timepivot.md @@ -51,9 +51,9 @@ All properties are optional. ## Example -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +This query outputs a visualization of flood events in the specified Midwestern states, displayed as a time pivot chart. -This query outputs a visualization of flood events in the specified Midwestern states, displayed as a time pivot chart +[!INCLUDE [help-cluster-note-ADX-only](../includes/help-cluster-note-ADX-only.md)] ```kusto let midwesternStates = dynamic([ @@ -65,4 +65,6 @@ StormEvents | render timepivot with (xcolumn=State) ``` +**Output** + :::image type="content" source="media/visualization-timepivot/time-pivot-visualization.jpg" lightbox="media/visualization-timepivot/time-pivot-visualization.jpg" alt-text="Screenshot of timepivot in Kusto.Explorer."::: From ef2e29751b5f1cbe6703d3a79372ac1cd3f4460e Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Tue, 11 Feb 2025 15:48:24 +0200 Subject: [PATCH 22/37] Include for ADX only help cluster --- data-explorer/kusto/query/visualization-timepivot.md | 2 +- data-explorer/kusto/query/visualization-treemap.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/data-explorer/kusto/query/visualization-timepivot.md b/data-explorer/kusto/query/visualization-timepivot.md index 9eb7d9948b..2ef93d23f1 100644 --- a/data-explorer/kusto/query/visualization-timepivot.md +++ b/data-explorer/kusto/query/visualization-timepivot.md @@ -27,7 +27,7 @@ The time pivot visualization is an interactive navigation over the events time-l | Name | Type | Required | Description | | -- | -- | -- | -- | -| *T* | `string` | :heavy_check_mark: | Input table name. +| *T* | `string` | :heavy_check_mark: | Input table name.| | *propertyName*, *propertyValue* | `string` | | A comma-separated list of key-value property pairs. See [supported properties](#supported-properties).| ### Supported properties diff --git a/data-explorer/kusto/query/visualization-treemap.md b/data-explorer/kusto/query/visualization-treemap.md index 7e3cfcb21a..34f12a0fc1 100644 --- a/data-explorer/kusto/query/visualization-treemap.md +++ b/data-explorer/kusto/query/visualization-treemap.md @@ -42,7 +42,7 @@ All properties are optional. This query counts the number of storm events for each type and state, sorts them in descending order, limits the results to the top 30, and then visualizes the data as a treemap. -[!INCLUDE [help-cluster-note](../includes/help-cluster-note.md)] +[!INCLUDE [help-cluster-note-ADX-only](../includes/help-cluster-note-ADX-only.md)] ```kusto StormEvents From 7d043127a18ac06ab006ea14276f9e76bfe00fe9 Mon Sep 17 00:00:00 2001 From: Slavik N <34075198+slavikn84@users.noreply.github.com> Date: Tue, 11 Feb 2025 18:13:12 +0200 Subject: [PATCH 23/37] Update alter-merge-managed-identity-policy-command.md --- .../management/alter-merge-managed-identity-policy-command.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index 496856341e..b4ee608fc5 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -32,7 +32,7 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md |Name|Type|Required|Description| |--|--|--|--| |*DatabaseName*| `string` | :heavy_check_mark:|The name of the database.| -|*ArrayOPolicyObjects*|array| :heavy_check_mark:|A serialized array with zero or more [ManagedIdentity policy](managed-identity-policy.md#the-managedidentity-policy-object) objects defined.| +|*ArrayOPolicyObjects*|array| :heavy_check_mark:|A serialized array with zero or more [ManagedIdentity policy](managed-identity-policy.md#the-managedidentity-policy-object) objects defined, each defined with only the `ObjectId` and `AllowedUsages` properties.| > [!NOTE] > From 3c61750b225fb7fa560665b578cab1708d1bd9af Mon Sep 17 00:00:00 2001 From: Slavik N <34075198+slavikn84@users.noreply.github.com> Date: Tue, 11 Feb 2025 18:24:46 +0200 Subject: [PATCH 24/37] Update managed identity policy command documentation. --- .../management/alter-merge-managed-identity-policy-command.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index b4ee608fc5..5d85ca5f1f 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -41,7 +41,9 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > * For every item in `ArrayOfManagedIdentityPolicyObjects`: > > * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item will be added to the policy. -> * If the ObjectId *already exists* in the ManagedIdentity policy, the identity's AllowedUsages property will be added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfManagedIdentityPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the Managed Identity policy will become "NativeIngestion, ExternalTables". +> * If the ObjectId *already exists* in the ManagedIdentity policy: +> * The identity's AllowedUsages property will be added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfManagedIdentityPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the Managed Identity policy will become "NativeIngestion, ExternalTables". +> * The latest information (such as the `DisplayName`) about the managed identity will be retrieved from Entra and updated in the policy. ### Getting the managed identity object ID From dc0f8dd739f004e0e9a64db5c885714b0f816a26 Mon Sep 17 00:00:00 2001 From: Slavik N <34075198+slavikn84@users.noreply.github.com> Date: Wed, 12 Feb 2025 13:40:18 +0200 Subject: [PATCH 25/37] Update data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md Co-authored-by: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> --- .../management/alter-merge-managed-identity-policy-command.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index 5d85ca5f1f..7b5467de12 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -42,8 +42,8 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > > * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item will be added to the policy. > * If the ObjectId *already exists* in the ManagedIdentity policy: -> * The identity's AllowedUsages property will be added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfManagedIdentityPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the Managed Identity policy will become "NativeIngestion, ExternalTables". -> * The latest information (such as the `DisplayName`) about the managed identity will be retrieved from Entra and updated in the policy. +> * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfManagedIdentityPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". +> * The latest information (such as the `DisplayName`) about the managed identity is retrieved from Microsoft Entra and updated in the policy. ### Getting the managed identity object ID From 001cc92d216053346ddc69d5edd3e04af9907e4f Mon Sep 17 00:00:00 2001 From: Slavik N <34075198+slavikn84@users.noreply.github.com> Date: Wed, 12 Feb 2025 13:40:36 +0200 Subject: [PATCH 26/37] Update data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md Co-authored-by: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> --- .../management/alter-merge-managed-identity-policy-command.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index 7b5467de12..137daa84e9 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -32,7 +32,7 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md |Name|Type|Required|Description| |--|--|--|--| |*DatabaseName*| `string` | :heavy_check_mark:|The name of the database.| -|*ArrayOPolicyObjects*|array| :heavy_check_mark:|A serialized array with zero or more [ManagedIdentity policy](managed-identity-policy.md#the-managedidentity-policy-object) objects defined, each defined with only the `ObjectId` and `AllowedUsages` properties.| +|*ArrayOfPolicyObjects*|array| :heavy_check_mark:|A serialized array with zero or more [ManagedIdentity policy](managed-identity-policy.md#the-managedidentity-policy-object) objects defined, each defined with only the *ObjectId* and *AllowedUsages* properties.| > [!NOTE] > From ee72f02ca5eb86956bf987b33d434d80e8741676 Mon Sep 17 00:00:00 2001 From: Slavik N <34075198+slavikn84@users.noreply.github.com> Date: Wed, 12 Feb 2025 13:40:45 +0200 Subject: [PATCH 27/37] Update data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md Co-authored-by: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> --- .../management/alter-merge-managed-identity-policy-command.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index 137daa84e9..899a143b50 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -40,7 +40,7 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > > * For every item in `ArrayOfManagedIdentityPolicyObjects`: > -> * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item will be added to the policy. +> * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item is added to the policy. > * If the ObjectId *already exists* in the ManagedIdentity policy: > * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfManagedIdentityPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". > * The latest information (such as the `DisplayName`) about the managed identity is retrieved from Microsoft Entra and updated in the policy. From b3524cf08aba4e63453831f6edafee6beea6c615 Mon Sep 17 00:00:00 2001 From: Slavik N <34075198+slavikn84@users.noreply.github.com> Date: Wed, 12 Feb 2025 13:41:28 +0200 Subject: [PATCH 28/37] Update data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md --- .../management/alter-merge-managed-identity-policy-command.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index 899a143b50..c35b60a105 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -42,7 +42,7 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > > * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item is added to the policy. > * If the ObjectId *already exists* in the ManagedIdentity policy: -> * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfManagedIdentityPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". +> * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". > * The latest information (such as the `DisplayName`) about the managed identity is retrieved from Microsoft Entra and updated in the policy. ### Getting the managed identity object ID From 537c77ac6b13ba812bb2309581bc54b46fa8b749 Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 14:22:20 +0200 Subject: [PATCH 29/37] Apply suggestions from code review --- .../alter-merge-managed-identity-policy-command.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index c35b60a105..763a7aeaca 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -38,12 +38,12 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > > * Policy objects must define the *ObjectId* and *AllowedUsages* properties. Other properties are automatically populated. > -> * For every item in `ArrayOfManagedIdentityPolicyObjects`: +> * For every item in *ArrayOfPolicyObjects*: > > * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item is added to the policy. > * If the ObjectId *already exists* in the ManagedIdentity policy: -> * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if `ArrayOfPolicyObjects` has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". -> * The latest information (such as the `DisplayName`) about the managed identity is retrieved from Microsoft Entra and updated in the policy. +> * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if *ArrayOfPolicyObjects* has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". +> * The latest information (such as the *DisplayName*) about the managed identity is retrieved from Microsoft Entra and updated in the policy. ### Getting the managed identity object ID From 9c70338ecbc721a80d57d7108bc57e72905a7628 Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 14:23:18 +0200 Subject: [PATCH 30/37] Update data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md --- .../management/alter-merge-managed-identity-policy-command.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index 763a7aeaca..c4378972ce 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -43,7 +43,7 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item is added to the policy. > * If the ObjectId *already exists* in the ManagedIdentity policy: > * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if *ArrayOfPolicyObjects* has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". -> * The latest information (such as the *DisplayName*) about the managed identity is retrieved from Microsoft Entra and updated in the policy. +> * The latest information about the managed identity, such as the *DisplayName*, is retrieved from Microsoft Entra and updated in the policy. ### Getting the managed identity object ID From 736eb956c37f72d41d5e2e0e9ec6c0aabcf62491 Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 14:26:31 +0200 Subject: [PATCH 31/37] Update data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md --- .../management/alter-merge-managed-identity-policy-command.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md index c4378972ce..19f41a73a3 100644 --- a/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md +++ b/data-explorer/kusto/management/alter-merge-managed-identity-policy-command.md @@ -40,8 +40,8 @@ You must have [AllDatabasesAdmin](../access-control/role-based-access-control.md > > * For every item in *ArrayOfPolicyObjects*: > -> * If the ObjectId *doesn't exist* in the ManagedIdentity policy, the item is added to the policy. -> * If the ObjectId *already exists* in the ManagedIdentity policy: +> * If the *ObjectId* doesn't exist in the ManagedIdentity policy, the item is added to the policy. +> * If the *ObjectId* already exists in the ManagedIdentity policy: > * The identity's *AllowedUsages* property is added to the relevant item in the policy. For example, if the current policy has AllowedUsages="NativeIngestion" for a specific managed identity, then if *ArrayOfPolicyObjects* has an item for this managed identity with AllowedUsages="ExternalTables", then the AllowedUsages for this managed identity in the ManagedIdentity policy becomes "NativeIngestion, ExternalTables". > * The latest information about the managed identity, such as the *DisplayName*, is retrieved from Microsoft Entra and updated in the policy. From c09549beb612320e0b2b9b025ce678951e988658 Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 15:01:12 +0200 Subject: [PATCH 32/37] Update project-rename-operator.md example and output --- data-explorer/kusto/query/project-rename-operator.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/data-explorer/kusto/query/project-rename-operator.md b/data-explorer/kusto/query/project-rename-operator.md index 1a84787cc3..a7a0ea2241 100644 --- a/data-explorer/kusto/query/project-rename-operator.md +++ b/data-explorer/kusto/query/project-rename-operator.md @@ -37,12 +37,12 @@ A table that has the columns in the same order as in an existing table, with col ::: moniker-end ```kusto -print a='a', b='b', c='c' -| project-rename new_b=b, new_a=a +print a='alpha', b='bravo', c='charlie' +| project-rename new_a=a, new_b=b, new_c=c ``` **Output** -|new_a|new_b|c| -|---|---|---| -|a|b|c| +|new_a|new_b|new_c| +|--|--|--| +|alpha|bravo|charlie| From c826c3fe7a03db37d7cf739b64ae0cb5b41aa8eb Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 15:09:01 +0200 Subject: [PATCH 33/37] Apply suggestions from code review --- data-explorer/kusto-emulator-install.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 94e1045782..6734963db7 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -10,8 +10,8 @@ ms.date: 02/09/2025 You can install the Azure Data Explorer Kusto emulator in the following ways: -- **On your own device:** Consider using this option if you need to provision a local development environment -- **On a CI/CD agent virtual machine (VM):** Use this option if you require a CI/CD pipeline for running automated tests +- **On your own device**: Consider using this option if you need to provision a local development environment +- **On a CI/CD agent virtual machine (VM)**: Use this option if you require a CI/CD pipeline for running automated tests The emulator is available as a *Linux* and *Windows* Docker container image. @@ -43,7 +43,7 @@ This article focuses on how to install the Linux Docker container on a Windows c The following steps are for using PowerShell to start the emulator using the [Kusto emulator container image](https://aka.ms/adx.emulator.image). For other options, see [Run emulator options](#run-emulator-options). -1. **For Windows container only:** Switch Docker to run with Windows containers. You might need to enable the feature in the Docker settings. +1. **For Windows container only**: Switch Docker to run with Windows containers. You might need to enable the feature in the Docker settings. :::image type="content" source="media/kusto-emulator/kusto-emulator-docker-windows-container.png" alt-text="Screenshot of the Docker settings, showing the Switch to Windows containers option."::: From 7ff398e8877c46d97a986c26119b5782e60a15ad Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 15:11:16 +0200 Subject: [PATCH 34/37] Fix broken links in Kusto emulator install doc --- data-explorer/kusto-emulator-install.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 6734963db7..11ab1bbdcb 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -50,14 +50,14 @@ The following steps are for using PowerShell to start the emulator using the [Ku 1. Run the following command to start the emulator. > [!IMPORTANT] - > The Kusto emulator container image is a free offering under the [Microsoft Software License Terms](https://aka.ms/adx.emulator.license). Since the emulator runs in a container, you must accept the license terms by passing the `ACCEPT_EULA` environment variable to the container with its value set to `Y` indicating. + > The Kusto emulator container image is a free offering under the [Microsoft Software License Terms](https://aka.ms/adx.emulator.license). Since the emulator runs in a container, you must accept the license terms by passing the `ACCEPT_EULA` environment variable to the container with its value set to `Y`. > [!NOTE] > > - The first time this command is run, Docker pulls the container image which is several GBs in size and might take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. > - **For Windows container only:** The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. - # [Linux container](#tab/linuxcontainer) + # [Linux container](#tab/linux-container) To start the Linux container, make sure you use the `latest` or `stable` tag: @@ -128,7 +128,7 @@ You can use any of the following options when running the emulator: - Mount a local folder to the container: Use this option to mount a folder in the host environment into the container. Mounting a host folder enables your queries to interact with local files, which is useful for [creating a database persistent between container runs](#create-a-database) and [ingesting data](#ingest-data). - # [Linux container](#tab/linuxcontainer) + # [Linux container](#tab/linux-container) For example, to mount the folder "D:\host\local" on the host to the folder "/kustodatadata" in the container, use the following command on Windows Server: @@ -187,7 +187,7 @@ In this example, we keep the data on the container. In the [Kusto.Explorer Query mode](/kusto/tools/kusto-explorer-using?view=azure-data-explorer&preserve-view=true#query-mode), run the following command to create a persistent database: -# [Linux container](#tab/linuxcontainer) +# [Linux container](#tab/linux-container) ```kusto .create database persist ( From 48d5ad5dea2f73daa196dbad275897e2b3d3eaf6 Mon Sep 17 00:00:00 2001 From: Shlomo Sagir <51323195+shsagir@users.noreply.github.com> Date: Wed, 12 Feb 2025 15:15:17 +0200 Subject: [PATCH 35/37] Apply suggestions from code review --- data-explorer/kusto-emulator-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data-explorer/kusto-emulator-install.md b/data-explorer/kusto-emulator-install.md index 11ab1bbdcb..0d6c13fbd0 100644 --- a/data-explorer/kusto-emulator-install.md +++ b/data-explorer/kusto-emulator-install.md @@ -55,7 +55,7 @@ The following steps are for using PowerShell to start the emulator using the [Ku > [!NOTE] > > - The first time this command is run, Docker pulls the container image which is several GBs in size and might take several minutes to download. Once downloaded, the image is cached and available for subsequent runs without having to download it again. - > - **For Windows container only:** The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. + > - **For Windows container only**: The container must run in process-isolation mode. This is the default on some versions of Docker. For other versions, you can start the container in Hyper-V isolation mode by adding `--isolation=hyperv` to the run command. # [Linux container](#tab/linux-container) From 572279cad085bd9dd59b20893ea31a5a091d5de1 Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Wed, 12 Feb 2025 16:49:33 +0200 Subject: [PATCH 36/37] renamed file --- ...r-note-ADX-only.md => help-cluster-note-data-explorer-only.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename data-explorer/kusto/includes/{help-cluster-note-ADX-only.md => help-cluster-note-data-explorer-only.md} (100%) diff --git a/data-explorer/kusto/includes/help-cluster-note-ADX-only.md b/data-explorer/kusto/includes/help-cluster-note-data-explorer-only.md similarity index 100% rename from data-explorer/kusto/includes/help-cluster-note-ADX-only.md rename to data-explorer/kusto/includes/help-cluster-note-data-explorer-only.md From 04cafa79bd2f0cfe856f951d7e0fa1b60cd46ecf Mon Sep 17 00:00:00 2001 From: ktalmor <193799742+ktalmor@users.noreply.github.com> Date: Wed, 12 Feb 2025 16:53:12 +0200 Subject: [PATCH 37/37] replaced link to renamed include file --- data-explorer/kusto/query/visualization-pivotchart.md | 2 +- data-explorer/kusto/query/visualization-timepivot.md | 2 +- data-explorer/kusto/query/visualization-treemap.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/data-explorer/kusto/query/visualization-pivotchart.md b/data-explorer/kusto/query/visualization-pivotchart.md index 0ba9cd9014..6bec9c572a 100644 --- a/data-explorer/kusto/query/visualization-pivotchart.md +++ b/data-explorer/kusto/query/visualization-pivotchart.md @@ -33,7 +33,7 @@ Displays a pivot table and chart. You can interactively select data, columns, ro This query provides a detailed analysis of sales for Contoso computer products within the specified date range, visualized as a pivot chart. -[!INCLUDE [help-cluster-note-ADX-only](../includes/help-cluster-note-ADX-only.md)] +[!INCLUDE [help-cluster-note-data-explorer-only](../includes/help-cluster-note-data-explorer-only.md)] ```kusto SalesFact diff --git a/data-explorer/kusto/query/visualization-timepivot.md b/data-explorer/kusto/query/visualization-timepivot.md index 2ef93d23f1..cd78f6709a 100644 --- a/data-explorer/kusto/query/visualization-timepivot.md +++ b/data-explorer/kusto/query/visualization-timepivot.md @@ -53,7 +53,7 @@ All properties are optional. This query outputs a visualization of flood events in the specified Midwestern states, displayed as a time pivot chart. -[!INCLUDE [help-cluster-note-ADX-only](../includes/help-cluster-note-ADX-only.md)] +[!INCLUDE [help-cluster-note-data-explorer-only](../includes/help-cluster-note-data-explorer-only.md)] ```kusto let midwesternStates = dynamic([ diff --git a/data-explorer/kusto/query/visualization-treemap.md b/data-explorer/kusto/query/visualization-treemap.md index 34f12a0fc1..ffc759abc3 100644 --- a/data-explorer/kusto/query/visualization-treemap.md +++ b/data-explorer/kusto/query/visualization-treemap.md @@ -42,7 +42,7 @@ All properties are optional. This query counts the number of storm events for each type and state, sorts them in descending order, limits the results to the top 30, and then visualizes the data as a treemap. -[!INCLUDE [help-cluster-note-ADX-only](../includes/help-cluster-note-ADX-only.md)] +[!INCLUDE [help-cluster-note-data-explorer-only](../includes/help-cluster-note-data-explorer-only.md)] ```kusto StormEvents