|
| 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 | +  |
| 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 | +  |
| 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 | +  |
| 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 | +  |
| 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 | +  |
| 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) |
0 commit comments