This is an automated email from the ASF dual-hosted git repository.
FrankChen021 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/druid.git
The following commit(s) were added to refs/heads/master by this push:
new 6fb885e055c docs: Update tutorials to not use bin/post-index-task
(#19637)
6fb885e055c is described below
commit 6fb885e055ce9b0efb20eb9f3a65f5b60aba9a3a
Author: ava nunes <[email protected]>
AuthorDate: Fri Jul 10 05:08:21 2026 -0700
docs: Update tutorials to not use bin/post-index-task (#19637)
* docs: updated isolation.level description
* added yarn serve to scripts
* Update docs/ingestion/kafka-ingestion.md
Co-authored-by: 317brian <[email protected]>
* docs: updated all commands referencing bin/post-index-task
* cleaned up some instructions around updated commands
* removed mention of script
* removed duplicated information from tutorial
* updated cURL command per feedback
* updated loading data from CLI section per feedback
* Apply suggestion from @317brian
---------
Co-authored-by: 317brian <[email protected]>
---
docs/tutorials/tutorial-batch.md | 40 +++++--------------------------
docs/tutorials/tutorial-compaction.md | 2 +-
docs/tutorials/tutorial-delete-data.md | 2 +-
docs/tutorials/tutorial-ingestion-spec.md | 8 +++----
4 files changed, 12 insertions(+), 40 deletions(-)
diff --git a/docs/tutorials/tutorial-batch.md b/docs/tutorials/tutorial-batch.md
index 3fc0f64d820..f01231a5d20 100644
--- a/docs/tutorials/tutorial-batch.md
+++ b/docs/tutorials/tutorial-batch.md
@@ -31,7 +31,7 @@ specs by hand or using the _data loader_ built into the web
console.
For production environments, it's likely that you'll want to automate data
ingestion. This tutorial starts by showing
you how to submit an ingestion spec directly in the web console, and then
introduces ways to ingest batch data that
-lend themselves to automation—from the command line and from a script.
+lend themselves to automation—from the command line.
## Loading data with a spec (via console)
@@ -116,9 +116,9 @@ This brings up the spec submission dialog where you can
paste the spec above.
Once the spec is submitted, wait a few moments for the data to load, after
which you can query it.
-## Loading data with a spec (via command line)
+## Loading data from the command line
-To load data with a spec, you need to POST an ingestion task to the Druid
Overlord and poll Druid until the data is available for querying.
+To load data from the command line, you need to POST an ingestion spec to the
Druid Overlord using its task API.
Run the following command from Druid package root:
@@ -127,41 +127,13 @@ curl -X POST http://localhost:8081/druid/indexer/v1/task \
-H "Content-Type: application/json" \
-d @quickstart/tutorial/wikipedia-index.json
```
-
-You should see output like the following:
-
-```bash
-Beginning indexing data for wikipedia
-Task started: index_wikipedia_2018-07-27T06:37:44.323Z
-Task log:
http://localhost:8081/druid/indexer/v1/task/index_wikipedia_2018-07-27T06:37:44.323Z/log
-Task status:
http://localhost:8081/druid/indexer/v1/task/index_wikipedia_2018-07-27T06:37:44.323Z/status
-Task index_wikipedia_2018-07-27T06:37:44.323Z still running...
-Task index_wikipedia_2018-07-27T06:37:44.323Z still running...
-Task finished with status: SUCCESS
-Completed indexing data for wikipedia. Now loading indexed data onto the
cluster...
-wikipedia loading complete! You may now query your data
-```
-
-Once the spec is submitted, you can follow the same instructions as above to
wait for the data to load and then query it.
-
-
-## Loading data without the script
-
-Let's briefly discuss how we would've submitted the ingestion task without
using the script. You do not need to run these commands.
-
-To submit the task, POST it to Druid in a new terminal window from the
`apache-druid-{{DRUIDVERSION}}` directory:
-
-```bash
-curl -X 'POST' -H 'Content-Type:application/json' -d
@quickstart/tutorial/wikipedia-index.json
http://localhost:8081/druid/indexer/v1/task
-```
-
-Which will print the ID of the task if the submission was successful:
+If the submission was successful, Druid will print a task ID similar to the
following:
```bash
-{"task":"index_wikipedia_2018-06-09T21:30:32.802Z"}
+{"task":"index_parallel_wikipedia_oiemabcp_2026-07-07T16:05:33.242Z"}
```
-You can monitor the status of this task from the console as outlined above.
+Wait a few moments for the data to load, then move on to querying it.
## Querying your data
diff --git a/docs/tutorials/tutorial-compaction.md
b/docs/tutorials/tutorial-compaction.md
index fa84e6cd080..329082b3f4b 100644
--- a/docs/tutorials/tutorial-compaction.md
+++ b/docs/tutorials/tutorial-compaction.md
@@ -173,7 +173,7 @@ The Druid distribution includes a compaction task spec to
create `DAY` granulari
Note that `segmentGranularity` is set to `DAY` in this compaction task spec.
-Submit this task now:
+Now, submit this task:
```bash
curl -X POST http://localhost:8081/druid/indexer/v1/task \
diff --git a/docs/tutorials/tutorial-delete-data.md
b/docs/tutorials/tutorial-delete-data.md
index 2f7a8f6dc59..50564e8a9e1 100644
--- a/docs/tutorials/tutorial-delete-data.md
+++ b/docs/tutorials/tutorial-delete-data.md
@@ -34,7 +34,7 @@ This tutorial requires the following:
In this tutorial, we will use the Wikipedia edits data, with an indexing spec
that creates hourly segments. This spec is located at
`quickstart/tutorial/deletion-index.json`, and it creates a datasource called
`deletion-tutorial`.
-Let's load this initial data by calling the Druid Overlord API:
+Let's load our initial data by calling the Druid Overlord API:
```bash
curl -X POST http://localhost:8081/druid/indexer/v1/task \
diff --git a/docs/tutorials/tutorial-ingestion-spec.md
b/docs/tutorials/tutorial-ingestion-spec.md
index 49b2e12d3e1..4c5f9a6d100 100644
--- a/docs/tutorials/tutorial-ingestion-spec.md
+++ b/docs/tutorials/tutorial-ingestion-spec.md
@@ -580,15 +580,15 @@ We've finished defining the ingestion spec, it should now
look like the followin
## Submit the task and query the data
-From the `apache-druid-{{DRUIDVERSION}}` package root, run the following
command:
+From the `apache-druid-{{DRUIDVERSION}}` package root, run the following
command to create a datasource called `ingestion tutorial`:
```bash
curl -X POST http://localhost:8081/druid/indexer/v1/task \
-H "Content-Type: application/json" \
- -d @quickstart/tutorial/ingestion-tutorial-index.json
+ -d @quickstart/ingestion-tutorial-index.json
```
-After the script completes, we will query the data.
+After the ingestion completes, we will query the data.
In the web console, open a new tab in the **Query** view. Run the following
query to view the ingested data:
@@ -604,4 +604,4 @@ Returns the following:
| `2018-01-01T01:02:00.000Z` | `9000` | `18.1` | `2` | `2.2.2.2` | `7000` |
`90` | `6` | `1.1.1.1` | `5000` |
| `2018-01-01T01:03:00.000Z` | `6000` | `4.3` | `1` | `2.2.2.2` | `7000` |
`60` | `6` | `1.1.1.1` | `5000` |
| `2018-01-01T02:33:00.000Z` | `30000` | `56.9` | `2` | `8.8.8.8` | `5000` |
`300` | `17` | `7.7.7.7` | `4000` |
-| `2018-01-01T02:35:00.000Z` | `30000` | `46.3` | `1` | `8.8.8.8` | `5000` |
`300` | `17` | `7.7.7.7` | `4000` |
\ No newline at end of file
+| `2018-01-01T02:35:00.000Z` | `30000` | `46.3` | `1` | `8.8.8.8` | `5000` |
`300` | `17` | `7.7.7.7` | `4000` |
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
