Skip to content

Commit 85df00b

Browse files
Merge pull request #2847 from MicrosoftDocs/main639064946939446904sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 59c4b9a + 6107875 commit 85df00b

11 files changed

Lines changed: 149 additions & 142 deletions

data-explorer/create-table-wizard.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@ title: Create a Table in Azure Data Explorer
33
description: Learn how to easily create a table and manually define the schema in Azure Data Explorer with the table creation wizard.
44
ms.reviewer: aksdi
55
ms.topic: how-to
6-
ms.date: 02/02/2026
6+
ms.date: 02/12/2026
77
# 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.
88
---
99

1010
# Create a table in Azure Data Explorer
1111

12-
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.
12+
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.
1313

1414
> [!NOTE]
1515
> 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).
@@ -46,7 +46,7 @@ The **Create table** window opens with the **Destination** tab selected.
4646

4747
## Schema tab
4848

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

5252
:::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.":::

data-explorer/external-table.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Create an external table using the Azure Data Explorer web UI wizard in Azure Data Explorer
2+
title: Create an External Table Using the Azure Data Explorer Web UI Wizard in Azure Data Explorer
33
description: Use the wizard experience to create an external table.
44
ms.reviewer: ohbitton
55
ms.topic: how-to
6-
ms.date: 08/25/2022
6+
ms.date: 02/12/2026
77
---
88

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

2929
### Destination tab
3030

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

3737
:::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.":::
3838

3939
### Source tab
4040

41-
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).
41+
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).
4242

4343
You can add up to 10 source containers.
4444

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

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

51-
1. Choose the relevant subscription and storage account associated with your container.
51+
1. Choose the subscription and storage account that your container uses.
5252

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

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

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

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

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

65-
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.
65+
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.
6666

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

6969
#### File filters
7070

71-
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.
71+
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.
7272

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

7575
#### Schema-defining file
7676

77-
The first source container will display files below **File filters**.
77+
The first source container displays files below **File filters**.
7878

7979
:::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.":::
8080

81-
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.
81+
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.
8282
1. Select **Next: schema**. The **Schema** tab opens.
8383

8484
### Schema tab
8585

86-
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.
86+
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.
8787

8888
> [!NOTE]
89-
> 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.
89+
> 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.
9090
9191
1. Select **Add partition**.
9292

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

95-
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:
95+
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:
9696

9797
Field | Description | Required/Optional
9898
---|---|---
@@ -102,29 +102,29 @@ In the right-hand side of the tab, you can preview your data. On the left-hand s
102102
Function | The function applied to the data column used for partitioning. | Optional
103103
Function argument | Argument to be used in the partition function. | Required if function is used.
104104
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
105-
Datetime pattern | Format of date that will be used to construct the table URI path. | Optional
105+
Datetime pattern | Format of date that you use to construct the table URI path. | Optional
106106

107107
:::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":::
108108

109-
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.
109+
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.
110110

111111
> [!NOTE]
112-
> 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.
112+
> 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.
113113
114114
1. Select **Add partition** to add another partition.
115-
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.
115+
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.
116116

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

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

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

125125
## Query the external table
126126

127-
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).
127+
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).
128128

129129
:::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.":::
130130

data-explorer/get-data-file.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@ title: Get Data From a File
33
description: Learn how to get data from a local file in Azure Data Explorer.
44
ms.reviewer: sharmaanshul
55
ms.topic: how-to
6-
ms.date: 02/08/2026
6+
ms.date: 02/12/2026
77
ms.custom: sfi-image-nochange
88
---
9+
910
# Get data from file
1011

1112
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.

0 commit comments

Comments
 (0)