Skip to content

Commit ea91c21

Browse files
authored
Merge pull request #85128 from orspod/2019-August-One-click-ingestion
One-click ingestion - text and screenshots
2 parents 1eb1dc0 + 5caa405 commit ea91c21

File tree

8 files changed

+89
-12
lines changed

8 files changed

+89
-12
lines changed
Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: Use one-click ingestion to Ingest data into Azure Data Explorer
3+
description: Learn about how to ingest (load) data into Azure Data Explorer simply using one-click ingestion.
4+
author: orspod
5+
ms.author: orspodek
6+
ms.reviewer: tzgitlin
7+
ms.service: data-explorer
8+
ms.topic: conceptual
9+
ms.date: 08/14/2019
10+
---
11+
12+
# Use one-click ingestion to ingest data into Azure Data Explorer
13+
14+
This article shows how to use one-click ingestion for quick ingestion of a new table in json or csv formats from storage into Azure Data Explorer. Once the data is ingested, you can edit the table and run queries using the Web UI.
15+
16+
## Prerequisites
17+
18+
* If you don't have an Azure subscription, create a [free Azure account](https://azure.microsoft.com/free/) before you begin.
19+
* Sign in to [the application](https://dataexplorer.azure.com/).
20+
* Create [an Azure Data Explorer cluster and database](create-cluster-database-portal.md)
21+
* Source of data in Azure Storage.
22+
23+
## Ingest new data
24+
25+
1. Right-click on the *Database name* and select **Ingest new data (Preview)**
26+
27+
![select one click ingestion in web UI](media/ingest-data-one-click/one-click-ingestion-in-webui.png)
28+
29+
1. In the **Data Ingestion (Preview)** window, in **Source** tab, complete the **Project Details**:
30+
31+
* Enter new **Table name**.
32+
* Select **Ingestion type** > **from storage**.
33+
* Enter **Link to storage** Add url to storage. Use Blob SAS URL for private storage accounts.
34+
* Select **Edit schema**
35+
36+
![one click ingestion source details](media/ingest-data-one-click/one-click-ingestion-source.png)
37+
38+
1. In **Schema** tab, select **Data format** from drop-down > **JSON** or **CSV**.
39+
40+
If select **CSV**:
41+
* Select checkbox **Ignore headline** to ignore heading row of csv file.
42+
* **Mapping name** is set automatically but can be edited.
43+
44+
![one click ingestion csv format schema.png](media/ingest-data-one-click/one-click-csv-format.png)
45+
46+
If select **JSON**:
47+
* Select **JSON levels**: 1-10 from drop-down. The levels in the json file are shown in the table on the bottom right.
48+
* **Mapping name** is set automatically but can be edited.
49+
50+
![one click ingestion json format schema](media/ingest-data-one-click/one-click-json-format.png)
51+
52+
1. In **Editor**, select **V** on right to open the editor. In the editor, you can view and copy the automatic queries generated from your inputs.
53+
54+
1. In table on the bottom right:
55+
* Select **V** on right of column to **Rename column**, **Delete column**, **Sort ascending**, or **Sort descending**
56+
* Double-click on column name to edit.
57+
* Select the icon to the left of the column name to change the data type.
58+
59+
1. Select **Start ingestion** to create table, create mapping, and data ingestion.
60+
61+
## Query data
62+
63+
1. In the **Data ingestion completed** window, all three steps will be marked with green checkmarks, if data ingestion completed successfully.
64+
65+
![one click data ingestion complete](media/ingest-data-one-click/one-click-data-ingestion-complete.png)
66+
67+
1. Select **V** to open query. Copy to Web UI to edit the query.
68+
69+
1. The menu on the right contains **Quick queries** and **Tools**.
70+
71+
* **Quick queries** includes links to Web UI with example queries.
72+
* **Tools** includes link to Web UI with **Drop commands** that allow you to troubleshoot issues by running the relevant `.drop` command.
73+
74+
> [!TIP]
75+
> Data may be lost using `.drop` commands. Use them carefully.
76+
77+
## Next steps
78+
79+
* [Query data in Azure Data Explorer Web UI](web-query-data.md)
80+
* [Write queries for Azure Data Explorer using Kusto Query Language](write-queries.md)

articles/data-explorer/ingest-sample-data.md

Lines changed: 7 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,16 @@ author: orspod
55
ms.author: orspodek
66
ms.reviewer: mblythe
77
ms.service: data-explorer
8-
ms.topic: conceptual
9-
ms.date: 09/24/2018
8+
ms.topic: quickstart
9+
ms.date: 08/12/2019
1010
---
1111

12-
# Ingest sample data into Azure Data Explorer
12+
# Quickstart: Ingest sample data into Azure Data Explorer
1313

1414
This article shows you how to ingest (load) sample data into an Azure Data Explorer database. There are [several ways to ingest data](ingest-data-overview.md); this article focuses on a basic approach that is suitable for testing purposes.
1515

1616
> [!NOTE]
17-
> You already have this data if you completed [Quickstart: Ingest data using the Azure Data Explorer Python library](python-ingest-data.md).
17+
> You already have this data if you completed [Ingest data using the Azure Data Explorer Python library](python-ingest-data.md).
1818
1919
## Prerequisites
2020

@@ -51,11 +51,6 @@ The **StormEvents** sample data set contains weather-related data from the [Nati
5151
5252
## Next steps
5353
54-
> [!div class="nextstepaction"]
55-
> [Quickstart: Query data in Azure Data Explorer](web-query-data.md)
56-
57-
> [!div class="nextstepaction"]
58-
> [Write queries](write-queries.md)
59-
60-
> [!div class="nextstepaction"]
61-
> [Azure Data Explorer data ingestion](ingest-data-overview.md)
54+
* [Azure Data Explorer data ingestion](ingest-data-overview.md) to learn more about ingestion methods.
55+
* [Quickstart: Query data in Azure Data Explorer](web-query-data.md) Web UI.
56+
* [Write queries](write-queries.md) with Kusto Query Language.
25.7 KB
Loading
66.1 KB
Loading
57.2 KB
Loading
39.4 KB
Loading
166 KB
Loading

articles/data-explorer/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@
4444
href: ingest-data-event-hub.md
4545
- name: Event Grid
4646
href: ingest-data-event-grid.md
47+
- name: One-click ingestion
48+
href: ingest-data-one-click.md
4749
- name: Kafka
4850
href: ingest-data-kafka.md
4951
- name: Python

0 commit comments

Comments
 (0)