Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions data-explorer/create-table-wizard.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@ title: Create a Table in Azure Data Explorer
description: Learn how to easily create a table and manually define the schema in Azure Data Explorer with the table creation wizard.
ms.reviewer: aksdi
ms.topic: how-to
ms.date: 02/02/2026
ms.date: 02/12/2026
# Customer intent: As a data engineer, I want to create an empty table in Azure Data Explorer so that I can ingest data and query it.
---

# Create a table in Azure Data Explorer

Creating a table is an important step in the process of [data ingestion](ingest-data-overview.md) and [query](/azure/data-explorer/kusto/query/tutorials/learn-common-operators) in Azure Data Explorer. The following article shows how to create a table and schema mapping quickly and easily by using the Azure Data Explorer web UI.
Creating a table is an important step in the process of [data ingestion](ingest-data-overview.md) and [querying](/azure/data-explorer/kusto/query/tutorials/learn-common-operators) in Azure Data Explorer. The following article shows how to create a table and schema mapping quickly and easily by using the Azure Data Explorer web UI.

> [!NOTE]
> To create a new table based on existing data, see [Get data from file](get-data-file.md) or [Get data from Azure storage](get-data-storage.md).
Expand Down Expand Up @@ -46,7 +46,7 @@ The **Create table** window opens with the **Destination** tab selected.

## Schema tab

1. Select **Add new column**. The **Edit columns** panel opens.
1. Select **Add new column** to open the **Edit columns** panel.
1. For each column, enter **Column name** and **Data type**. Create more columns by selecting **Add column**.

:::image type="content" source="media/create-table-wizard/edit-columns.png" alt-text="Screenshot of Edit columns pane, in which you input the column name and data type in Azure Data Explorer.":::
Expand Down
42 changes: 21 additions & 21 deletions data-explorer/external-table.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: Create an external table using the Azure Data Explorer web UI wizard in Azure Data Explorer
title: Create an External Table Using the Azure Data Explorer Web UI Wizard in Azure Data Explorer
description: Use the wizard experience to create an external table.
ms.reviewer: ohbitton
ms.topic: how-to
ms.date: 08/25/2022
ms.date: 02/12/2026
---

# Create an external table using the Azure Data Explorer web UI wizard
Expand All @@ -28,17 +28,17 @@ The **Create external table** window opens with the **Destination** tab selected

### Destination tab

1. The **Cluster** and **Database** fields are prepopulated. You may select a different destination from the dropdown menu.
1. The **Cluster** and **Database** fields are prepopulated. You can select a different destination from the dropdown menu.
1. In **Table name**, enter a name for your table.
> [!TIP]
> Table names can be up to 1024 characters including alphanumeric, hyphens, and underscores. Special characters aren't supported.
1. Select **Next: Source**
> Table names can be up to 1,024 characters including alphanumeric, hyphens, and underscores. Special characters aren't supported.
1. Select **Next: Source**.

:::image type="content" source="media/external-table/destination-tab.png" alt-text="Screen capture of the Destination tab with Cluster, Database, and Table name fields.":::

### Source tab

In **Link to containers**, there are two ways to add a container: [Add a container with the **Select container** button](#add-a-container-with-the-select-container-button) and [Add a container with the **Add URL or Add container** button](#add-a-container-with-the-add-url-or-add-container-button).
In **Link to containers**, you can add a container in two ways: [Add a container with the **Select container** button](#add-a-container-with-the-select-container-button) and [Add a container with the **Add URL or Add container** button](#add-a-container-with-the-add-url-or-add-container-button).

You can add up to 10 source containers.

Expand All @@ -48,11 +48,11 @@ You can add up to 10 source containers.

:::image type="content" source="media/external-table/select-container.png" alt-text="Screenshot of select container button in source tab.":::

1. Choose the relevant subscription and storage account associated with your container.
1. Choose the subscription and storage account that your container uses.

:::image type="content" source="media/select-container-window.png" alt-text="Screenshot of select container window.":::

1. Select the **Add** button. When verification has completed, a green check will appear to the right of the container link.
1. Select **Add**. When verification finishes, a green check appears to the right of the container link.

:::image type="content" source="media/external-table/container-verified.png" alt-text="Screenshot of verified container link.":::

Expand All @@ -62,37 +62,37 @@ You can add up to 10 source containers.

:::image type="content" source="media/external-table/add-url-button.png" alt-text="Screenshot of add URL button.":::

1. Enter a [storage connection strings](/kusto/api/connection-strings/storage-connection-strings?view=azure-data-explorer&preserve-view=true) to your source container with read and list permissions. When verification has completed, a green check will appear to the right of the container link.
1. Enter a [storage connection strings](/kusto/api/connection-strings/storage-connection-strings?view=azure-data-explorer&preserve-view=true) to your source container with read and list permissions. When verification finishes, a green check appears to the right of the container link.

:::image type="content" source="media/external-table/add-sas-url.png" alt-text="Screenshot of adding SAS URL.":::

#### File filters

Use **File filters** to filter the files that the table should include. Files can be filtered according to folder path, file begins with, or file extension.
Use **File filters** to filter the files that the table should include. You can filter files by folder path, file begins with, or file extension.

:::image type="content" source="media/external-table/file-filters.png" alt-text="Screenshot of selecting schema-defining file.":::

#### Schema-defining file

The first source container will display files below **File filters**.
The first source container displays files below **File filters**.

:::image type="content" source="media/external-table/schema-defining-file.png" alt-text="Screen shot of create external table source tab in Azure Data Explorer.":::

1. Choose the schema-defining file by selecting the circle to the left of the file. This file will be used to generate the table schema.
1. Choose the schema-defining file by selecting the circle to the left of the file. This file is used to generate the table schema.
1. Select **Next: schema**. The **Schema** tab opens.

### Schema tab

In the right-hand side of the tab, you can preview your data. On the left-hand side, you can add [partitions](/kusto/management/partitioning-policy?view=azure-data-explorer&preserve-view=true) to your table definitions to access the source data more quickly and achieve better performance.
On the right side of the tab, you can preview your data. On the left side, you can add [partitions](/kusto/management/partitioning-policy?view=azure-data-explorer&preserve-view=true) to your table definitions to access the source data more quickly and achieve better performance.

> [!NOTE]
> Mappings are not part of the definition of an external table, and are not supported in this wizard. Mappings can be [configured later](/kusto/management/external-table-mapping-create?view=azure-data-explorer&preserve-view=true) if necessary. Some functionalities, such as deleting the last column in CSV files or changing column names in JSON files, require mappings in order to work correctly.
> Mappings aren't part of the definition of an external table, and the wizard doesn't support them. You can [configure mappings later](/kusto/management/external-table-mapping-create?view=azure-data-explorer&preserve-view=true) if necessary. Some functionalities, such as deleting the last column in CSV files or changing column names in JSON files, require mappings in order to work correctly.

1. Select **Add partition**.

:::image type="content" source="media/external-table/view-file.png" alt-text="Screen shot of view file for external table in Azure Data Explorer.":::

1. The partition window opens. A partition is defined over a subpath of the file, which can be altered using the **Path prefix** field. For each partition you wish to apply, fill out the fields as follows:
1. The partition window opens. A partition is defined over a subpath of the file, which you can change by using the **Path prefix** field. For each partition you want to apply, fill out the fields as follows:

Field | Description | Required/Optional
---|---|---
Expand All @@ -102,29 +102,29 @@ In the right-hand side of the tab, you can preview your data. On the left-hand s
Function | The function applied to the data column used for partitioning. | Optional
Function argument | Argument to be used in the partition function. | Required if function is used.
Path prefix | The subpath of the file on which the partitioning is defined. This prefix changes the URL of the external table, as seen in the **Uri preview** box, and should match the schema-defining file URI. | Optional
Datetime pattern | Format of date that will be used to construct the table URI path. | Optional
Datetime pattern | Format of date that you use to construct the table URI path. | Optional

:::image type="content" source="media/external-table/add-partitions.png" alt-text="Screen shot add partitions to external table in Azure Data Explorer." lightbox="media/external-table/add-partitions.png":::

For example, the partition name *CustomerName* suggests that the value to partition by is in the customer name part of the URL. The above example declared two partitions: one partition over the customer name and one partition over the date embedded in the URL.
For example, the partition name *CustomerName* suggests that the value to partition by is in the customer name part of the URL. The preceding example declares two partitions: one partition over the customer name and one partition over the date embedded in the URL.

> [!NOTE]
> Virtual columns appear as part of the schema as the columns data extracted from the file path, and this data can be used later in queries.
> Virtual columns appear as part of the schema as the columns data extracted from the file path, and you can use this data later in queries.

1. Select **Add partition** to add another partition.
1. Select **Save**. The partitions you added now appear in the list of **Partitions** in the left pane. Partitioned columns can't be changed in preview.
1. Select **Save**. The partitions you added now appear in the list of **Partitions** in the left pane. You can't change partitioned columns in preview.

:::image type="content" source="media/external-table/schema.png" alt-text="Screenshot of schema external table Azure Data Explorer.":::

1. Select **Next: Create table**. When the table is created, an **External table successfully created** window opens.
1. Select **Next: Create table**. When you create the table, an **External table successfully created** window opens.
1. To view the command used to create the table, select **View command**.

:::image type="content" source="media/external-table/successfully-created.png" alt-text="Screenshot of successful creation of external table in Azure Data Explorer.":::
1. To undo the creation of the external table, select **Tools** > **Undo**.

## Query the external table

The resulting table includes data from all the files that fit the criteria defined above. You can query this table using the `external_table()` function. For more information on how to query external tables, see [Querying an external table](data-lake-query-data.md#querying-an-external-table).
The resulting table includes data from all the files that fit the criteria you defined. You can query this table by using the `external_table()` function. For more information on how to query external tables, see [Querying an external table](data-lake-query-data.md#querying-an-external-table).

:::image type="content" source="media/external-table/view-table.png" alt-text="Screen shot of table output from querying external table in Azure Data Explorer.":::

Expand Down
3 changes: 2 additions & 1 deletion data-explorer/get-data-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,10 @@ title: Get Data From a File
description: Learn how to get data from a local file in Azure Data Explorer.
ms.reviewer: sharmaanshul
ms.topic: how-to
ms.date: 02/08/2026
ms.date: 02/12/2026
ms.custom: sfi-image-nochange
---

# Get data from file

Data ingestion is the process of loading data from one or more sources into a table in Azure Data Explorer. Once ingested, the data is available for query. In this article, you learn how to get data from a local file into either a new or existing table.
Expand Down
Loading