From 3b5b6c6a418c20b7e70e42074202b14b0ff45c7c Mon Sep 17 00:00:00 2001 From: 317brian <53799971+317brian@users.noreply.github.com> Date: Thu, 3 Aug 2023 22:40:08 -0700 Subject: [PATCH] docs: query from deep storage (#14609) * cold tier wip * wip * copyedits * wip * copyedits * copyedits * wip * wip * update rules page * typo * typo * update sidebar * moves durable storage info to its own page in operations * update screenshots * add apache license * Apply suggestions from code review Co-authored-by: Victoria Lim * add query from deep storage tutorial stub * address some of the feedback * revert screenshot update. handled in separate pr * load rule update * wip tutorial * reformat deep storage endpoints * rest of tutorial * typo * cleanup * screenshot and sidebar for tutorial * add license * typos * Apply suggestions from code review Co-authored-by: Victoria Lim * rest of review comments * clarify where results are stored * update api reference for durablestorage context param * Apply suggestions from code review Co-authored-by: Karan Kumar * comments * incorporate #14720 * address rest of comments * missed one * Update docs/api-reference/sql-api.md * Update docs/api-reference/sql-api.md --------- Co-authored-by: Victoria Lim Co-authored-by: demo-kratia <56242907+demo-kratia@users.noreply.github.com> Co-authored-by: Karan Kumar --- docs/api-reference/sql-api.md | 813 +++++++++++++++++- ...orial-query-deepstorage-retention-rule.png | Bin 0 -> 99106 bytes docs/design/architecture.md | 23 +- docs/design/deep-storage.md | 26 +- docs/multi-stage-query/reference.md | 65 +- docs/operations/durable-storage.md | 86 ++ docs/operations/rule-configuration.md | 10 +- docs/querying/query-from-deep-storage.md | 195 +++++ docs/tutorials/tutorial-query-deep-storage.md | 293 +++++++ website/sidebars.json | 3 + 10 files changed, 1453 insertions(+), 61 deletions(-) create mode 100644 docs/assets/tutorial-query-deepstorage-retention-rule.png create mode 100644 docs/operations/durable-storage.md create mode 100644 docs/querying/query-from-deep-storage.md create mode 100644 docs/tutorials/tutorial-query-deep-storage.md diff --git a/docs/api-reference/sql-api.md b/docs/api-reference/sql-api.md index aaaf499851d5..2589be8882a0 100644 --- a/docs/api-reference/sql-api.md +++ b/docs/api-reference/sql-api.md @@ -186,4 +186,815 @@ Druid returns an HTTP 404 response in the following cases: - `sqlQueryId` is incorrect. - The query completes before your cancellation request is processed. -Druid returns an HTTP 403 response for authorization failure. \ No newline at end of file +Druid returns an HTTP 403 response for authorization failure. + +## Query from deep storage + +> Query from deep storage is an [experimental feature](../development/experimental.md). + +You can use the `sql/statements` endpoint to query segments that exist only in deep storage and are not loaded onto your Historical processes as determined by your load rules. + +Note that at least one segment of a datasource must be available on a Historical process so that the Broker can plan your query. A quick way to check if this is true is whether or not a datasource is visible in the Druid console. + + +For more information, see [Query from deep storage](../querying/query-from-deep-storage.md). + +### Submit a query + +Submit a query for data stored in deep storage. Any data ingested into Druid is placed into deep storage. The query is contained in the "query" field in the JSON object within the request payload. + +Note that at least part of a datasource must be available on a Historical process so that Druid can plan your query and only the user who submits a query can see the results. + +#### URL + +POST /druid/v2/sql/statements + +#### Request body + +Generally, the `sql` and `sql/statements` endpoints support the same response body fields with minor differences. For general information about the available fields, see [Submit a query to the `sql` endpoint](#submit-a-query). + +Keep the following in mind when submitting queries to the `sql/statements` endpoint: + +- There are additional context parameters for `sql/statements`: + + - `executionMode` determines how query results are fetched. Druid currently only supports `ASYNC`. You must manually retrieve your results after the query completes. + - `selectDestination` determines where final results get written. By default, results are written to task reports. Set this parameter to `durableStorage` to instruct Druid to write the results from SELECT queries to durable storage, which allows you to fetch larger result sets. Note that this requires you to have [durable storage for MSQ enabled](../operations/durable-storage.md). + +- The only supported value for `resultFormat` is JSON LINES. + +#### Responses + + + + + +*Successfully queried from deep storage* + + + +*Error thrown due to bad query. Returns a JSON object detailing the error with the following format:* + +```json +{ + "error": "Summary of the encountered error.", + "errorClass": "Class of exception that caused this error.", + "host": "The host on which the error occurred.", + "errorCode": "Well-defined error code.", + "persona": "Role or persona associated with the error.", + "category": "Classification of the error.", + "errorMessage": "Summary of the encountered issue with expanded information.", + "context": "Additional context about the error." +} +``` + + + +--- + +#### Sample request + + + + + +```shell +curl "http://ROUTER_IP:ROUTER_PORT/druid/v2/sql/statements" \ +--header 'Content-Type: application/json' \ +--data '{ + "query": "SELECT * FROM wikipedia WHERE user='\''BlueMoon2662'\''", + "context": { + "executionMode":"ASYNC" + } +}' +``` + + + +```HTTP +POST /druid/v2/sql/statements HTTP/1.1 +Host: http://ROUTER_IP:ROUTER_PORT +Content-Type: application/json +Content-Length: 134 + +{ + "query": "SELECT * FROM wikipedia WHERE user='BlueMoon2662'", + "context": { + "executionMode":"ASYNC" + } +} +``` + + + +#### Sample response + +
+ Click to show sample response + + ```json +{ + "queryId": "query-b82a7049-b94f-41f2-a230-7fef94768745", + "state": "ACCEPTED", + "createdAt": "2023-07-26T21:16:25.324Z", + "schema": [ + { + "name": "__time", + "type": "TIMESTAMP", + "nativeType": "LONG" + }, + { + "name": "channel", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "cityName", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "comment", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "countryIsoCode", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "countryName", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "isAnonymous", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isMinor", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isNew", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isRobot", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isUnpatrolled", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "metroCode", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "namespace", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "page", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "regionIsoCode", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "regionName", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "user", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "delta", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "added", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "deleted", + "type": "BIGINT", + "nativeType": "LONG" + } + ], + "durationMs": -1 +} + ``` +
+ +### Get query status + +Retrieves information about the query associated with the given query ID. The response matches the response from the POST API if the query is accepted or running and the execution mode is `ASYNC`. In addition to the fields that this endpoint shares with `POST /sql/statements`, a completed query's status includes the following: + +- A `result` object that summarizes information about your results, such as the total number of rows and sample records. +- A `pages` object that includes the following information for each page of results: + - `numRows`: the number of rows in that page of results. + - `sizeInBytes`: the size of the page. + - `id`: the page number that you can use to reference a specific page when you get query results. + +#### URL + +GET /druid/v2/sql/statements/:queryId + +#### Responses + + + + + +*Successfully retrieved query status* + + + +*Error thrown due to bad query. Returns a JSON object detailing the error with the following format:* + +```json +{ + "error": "Summary of the encountered error.", + "errorCode": "Well-defined error code.", + "persona": "Role or persona associated with the error.", + "category": "Classification of the error.", + "errorMessage": "Summary of the encountered issue with expanded information.", + "context": "Additional context about the error." +} +``` + + + +#### Sample request + +The following example retrieves the status of a query with specified ID `query-9b93f6f7-ab0e-48f5-986a-3520f84f0804`. + + + + + +```shell +curl "http://ROUTER_IP:ROUTER_PORT/druid/v2/sql/statements/query-9b93f6f7-ab0e-48f5-986a-3520f84f0804" +``` + + + +```HTTP +GET /druid/v2/sql/statements/query-9b93f6f7-ab0e-48f5-986a-3520f84f0804 HTTP/1.1 +Host: http://ROUTER_IP:ROUTER_PORT +``` + + + +#### Sample response + +
+ Click to show sample response + + ```json +{ + "queryId": "query-9b93f6f7-ab0e-48f5-986a-3520f84f0804", + "state": "SUCCESS", + "createdAt": "2023-07-26T22:57:46.620Z", + "schema": [ + { + "name": "__time", + "type": "TIMESTAMP", + "nativeType": "LONG" + }, + { + "name": "channel", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "cityName", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "comment", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "countryIsoCode", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "countryName", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "isAnonymous", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isMinor", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isNew", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isRobot", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "isUnpatrolled", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "metroCode", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "namespace", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "page", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "regionIsoCode", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "regionName", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "user", + "type": "VARCHAR", + "nativeType": "STRING" + }, + { + "name": "delta", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "added", + "type": "BIGINT", + "nativeType": "LONG" + }, + { + "name": "deleted", + "type": "BIGINT", + "nativeType": "LONG" + } + ], + "durationMs": 25591, + "result": { + "numTotalRows": 1, + "totalSizeInBytes": 375, + "dataSource": "__query_select", + "sampleRecords": [ + [ + 1442018873259, + "#ja.wikipedia", + "", + "/* 対戦通算成績と得失点 */", + "", + "", + 0, + 1, + 0, + 0, + 0, + 0, + "Main", + "アルビレックス新潟の年度別成績一覧", + "", + "", + "BlueMoon2662", + 14, + 14, + 0 + ] + ], + "pages": [ + { + "id": 0, + "numRows": 1, + "sizeInBytes": 375 + } + ] + } +} + ``` +
+ + +### Get query results + +Retrieves results for completed queries. Results are separated into pages, so you can use the optional `page` parameter to refine the results you get. Druid returns information about the composition of each page and its page number (`id`). For information about pages, see [Get query status](#get-query-status). + +If a page number isn't passed, all results are returned sequentially in the same response. If you have large result sets, you may encounter timeouts based on the value configured for `druid.router.http.readTimeout`. + +When getting query results, keep the following in mind: + +- JSON Lines is the only supported result format. +- Getting the query results for an ingestion query returns an empty response. + +#### URL + +GET /druid/v2/sql/statements/:queryId/results + +#### Query parameters +* `page` + * Int (optional) + * Refine paginated results + +#### Responses + + + + + +*Successfully retrieved query results* + + + +*Query in progress. Returns a JSON object detailing the error with the following format:* + +```json +{ + "error": "Summary of the encountered error.", + "errorCode": "Well-defined error code.", + "persona": "Role or persona associated with the error.", + "category": "Classification of the error.", + "errorMessage": "Summary of the encountered issue with expanded information.", + "context": "Additional context about the error." +} +``` + + + +*Query not found, failed or canceled* + + + +*Error thrown due to bad query. Returns a JSON object detailing the error with the following format:* + +```json +{ + "error": "Summary of the encountered error.", + "errorCode": "Well-defined error code.", + "persona": "Role or persona associated with the error.", + "category": "Classification of the error.", + "errorMessage": "Summary of the encountered issue with expanded information.", + "context": "Additional context about the error." +} +``` + + + +--- + +#### Sample request + +The following example retrieves the status of a query with specified ID `query-f3bca219-173d-44d4-bdc7-5002e910352f`. + + + + + +```shell +curl "http://ROUTER_IP:ROUTER_PORT/druid/v2/sql/statements/query-f3bca219-173d-44d4-bdc7-5002e910352f/results" +``` + + + +```HTTP +GET /druid/v2/sql/statements/query-f3bca219-173d-44d4-bdc7-5002e910352f/results HTTP/1.1 +Host: http://ROUTER_IP:ROUTER_PORT +``` + + + +#### Sample response + +
+ Click to show sample response + + ```json +[ + { + "__time": 1442018818771, + "channel": "#en.wikipedia", + "cityName": "", + "comment": "added project", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 0, + "isRobot": 0, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Talk", + "page": "Talk:Oswald Tilghman", + "regionIsoCode": "", + "regionName": "", + "user": "GELongstreet", + "delta": 36, + "added": 36, + "deleted": 0 + }, + { + "__time": 1442018820496, + "channel": "#ca.wikipedia", + "cityName": "", + "comment": "Robot inserta {{Commonscat}} que enllaça amb [[commons:category:Rallicula]]", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 1, + "isNew": 0, + "isRobot": 1, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Rallicula", + "regionIsoCode": "", + "regionName": "", + "user": "PereBot", + "delta": 17, + "added": 17, + "deleted": 0 + }, + { + "__time": 1442018825474, + "channel": "#en.wikipedia", + "cityName": "Auburn", + "comment": "/* Status of peremptory norms under international law */ fixed spelling of 'Wimbledon'", + "countryIsoCode": "AU", + "countryName": "Australia", + "isAnonymous": 1, + "isMinor": 0, + "isNew": 0, + "isRobot": 0, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Peremptory norm", + "regionIsoCode": "NSW", + "regionName": "New South Wales", + "user": "60.225.66.142", + "delta": 0, + "added": 0, + "deleted": 0 + }, + { + "__time": 1442018828770, + "channel": "#vi.wikipedia", + "cityName": "", + "comment": "fix Lỗi CS1: ngày tháng", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 1, + "isNew": 0, + "isRobot": 1, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Apamea abruzzorum", + "regionIsoCode": "", + "regionName": "", + "user": "Cheers!-bot", + "delta": 18, + "added": 18, + "deleted": 0 + }, + { + "__time": 1442018831862, + "channel": "#vi.wikipedia", + "cityName": "", + "comment": "clean up using [[Project:AWB|AWB]]", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 0, + "isRobot": 1, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Atractus flammigerus", + "regionIsoCode": "", + "regionName": "", + "user": "ThitxongkhoiAWB", + "delta": 18, + "added": 18, + "deleted": 0 + }, + { + "__time": 1442018833987, + "channel": "#vi.wikipedia", + "cityName": "", + "comment": "clean up using [[Project:AWB|AWB]]", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 0, + "isRobot": 1, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Agama mossambica", + "regionIsoCode": "", + "regionName": "", + "user": "ThitxongkhoiAWB", + "delta": 18, + "added": 18, + "deleted": 0 + }, + { + "__time": 1442018837009, + "channel": "#ca.wikipedia", + "cityName": "", + "comment": "/* Imperi Austrohongarès */", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 0, + "isRobot": 0, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Campanya dels Balcans (1914-1918)", + "regionIsoCode": "", + "regionName": "", + "user": "Jaumellecha", + "delta": -20, + "added": 0, + "deleted": 20 + }, + { + "__time": 1442018839591, + "channel": "#en.wikipedia", + "cityName": "", + "comment": "adding comment on notability and possible COI", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 1, + "isRobot": 0, + "isUnpatrolled": 1, + "metroCode": 0, + "namespace": "Talk", + "page": "Talk:Dani Ploeger", + "regionIsoCode": "", + "regionName": "", + "user": "New Media Theorist", + "delta": 345, + "added": 345, + "deleted": 0 + }, + { + "__time": 1442018841578, + "channel": "#en.wikipedia", + "cityName": "", + "comment": "Copying assessment table to wiki", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 0, + "isRobot": 1, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "User", + "page": "User:WP 1.0 bot/Tables/Project/Pubs", + "regionIsoCode": "", + "regionName": "", + "user": "WP 1.0 bot", + "delta": 121, + "added": 121, + "deleted": 0 + }, + { + "__time": 1442018845821, + "channel": "#vi.wikipedia", + "cityName": "", + "comment": "clean up using [[Project:AWB|AWB]]", + "countryIsoCode": "", + "countryName": "", + "isAnonymous": 0, + "isMinor": 0, + "isNew": 0, + "isRobot": 1, + "isUnpatrolled": 0, + "metroCode": 0, + "namespace": "Main", + "page": "Agama persimilis", + "regionIsoCode": "", + "regionName": "", + "user": "ThitxongkhoiAWB", + "delta": 18, + "added": 18, + "deleted": 0 + } +] + ``` +
+ +### Cancel a query + +Cancels a running or accepted query. + +#### URL + +DELETE /druid/v2/sql/statements/:queryId + +#### Responses + + + + + +*A no op operation since the query is not in a state to be cancelled* + + + +*Successfully accepted query for cancellation* + + + +*Invalid query ID. Returns a JSON object detailing the error with the following format:* + +```json +{ + "error": "Summary of the encountered error.", + "errorCode": "Well-defined error code.", + "persona": "Role or persona associated with the error.", + "category": "Classification of the error.", + "errorMessage": "Summary of the encountered issue with expanded information.", + "context": "Additional context about the error." +} +``` + + + +--- + +#### Sample request + +The following example cancels a query with specified ID `query-945c9633-2fa2-49ab-80ae-8221c38c024da`. + + + + + +```shell +curl --request DELETE "http://ROUTER_IP:ROUTER_PORT/druid/v2/sql/statements/query-945c9633-2fa2-49ab-80ae-8221c38c024da" +``` + + + +```HTTP +DELETE /druid/v2/sql/statements/query-945c9633-2fa2-49ab-80ae-8221c38c024da HTTP/1.1 +Host: http://ROUTER_IP:ROUTER_PORT +``` + + + +#### Sample response + +A successful request returns a `202 ACCEPTED` response and an empty response. \ No newline at end of file diff --git a/docs/assets/tutorial-query-deepstorage-retention-rule.png b/docs/assets/tutorial-query-deepstorage-retention-rule.png new file mode 100644 index 0000000000000000000000000000000000000000..9dee37bdeaad1c9a5e5823998878a6092518f636 GIT binary patch literal 99106 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 literal 0 HcmV?d00001 diff --git a/docs/design/architecture.md b/docs/design/architecture.md index 323cfb4fd3c3..df59dcb25eab 100644 --- a/docs/design/architecture.md +++ b/docs/design/architecture.md @@ -70,12 +70,20 @@ Druid uses deep storage to store any data that has been ingested into the system storage accessible by every Druid server. In a clustered deployment, this is typically a distributed object store like S3 or HDFS, or a network mounted filesystem. In a single-server deployment, this is typically local disk. -Druid uses deep storage only as a backup of your data and as a way to transfer data in the background between -Druid processes. Druid stores data in files called _segments_. Historical processes cache data segments on -local disk and serve queries from that cache as well as from an in-memory cache. -This means that Druid never needs to access deep storage -during a query, helping it offer the best query latencies possible. It also means that you must have enough disk space -both in deep storage and across your Historical servers for the data you plan to load. +Druid uses deep storage for the following purposes: + +- To store all the data you ingest. Segments that get loaded onto Historical processes for low latency queries are also kept in deep storage for backup purposes. Additionally, segments that are only in deep storage can be used for [queries from deep storage](../querying/query-from-deep-storage.md). +- As a way to transfer data in the background between Druid processes. Druid stores data in files called _segments_. + +Historical processes cache data segments on local disk and serve queries from that cache as well as from an in-memory cache. +Segments on disk for Historical processes provide the low latency querying performance Druid is known for. + +You can also query directly from deep storage. When you query segments that exist only in deep storage, you trade some performance for the ability to query more of your data without necessarily having to scale your Historical processes. + +When determining sizing for your storage, keep the following in mind: + +- Deep storage needs to be able to hold all the data that you ingest into Druid. +- On disk storage for Historical processes need to be able to accommodate the data you want to load onto them to run queries. The data on Historical processes should be data you access frequently and need to run low latency queries for. Deep storage is an important part of Druid's elastic, fault-tolerant design. Druid bootstraps from deep storage even if every single data server is lost and re-provisioned. @@ -210,8 +218,7 @@ available before they are published, since they are only published when the segm any additional rows of data. 2. **Deep storage:** Segment data files are pushed to deep storage once a segment is done being constructed. This happens immediately before publishing metadata to the metadata store. -3. **Availability for querying:** Segments are available for querying on some Druid data server, like a realtime task -or a Historical process. +3. **Availability for querying:** Segments are available for querying on some Druid data server, like a realtime task, directly from deep storage, or a Historical process. You can inspect the state of currently active segments using the Druid SQL [`sys.segments` table](../querying/sql-metadata-tables.md#segments-table). It includes the following flags: diff --git a/docs/design/deep-storage.md b/docs/design/deep-storage.md index f5adf35c6aaf..0674f324292c 100644 --- a/docs/design/deep-storage.md +++ b/docs/design/deep-storage.md @@ -23,9 +23,15 @@ title: "Deep storage" --> -Deep storage is where segments are stored. It is a storage mechanism that Apache Druid does not provide. This deep storage infrastructure defines the level of durability of your data, as long as Druid processes can see this storage infrastructure and get at the segments stored on it, you will not lose data no matter how many Druid nodes you lose. If segments disappear from this storage layer, then you will lose whatever data those segments represented. +Deep storage is where segments are stored. It is a storage mechanism that Apache Druid does not provide. This deep storage infrastructure defines the level of durability of your data. As long as Druid processes can see this storage infrastructure and get at the segments stored on it, you will not lose data no matter how many Druid nodes you lose. If segments disappear from this storage layer, then you will lose whatever data those segments represented. -## Local +In addition to being the backing store for segments, you can use [query from deep storage](#querying-from-deep-storage) and run queries against segments stored primarily in deep storage. The [load rules](../operations/rule-configuration.md#load-rules) you configure determine whether segments exist primarily in deep storage or in a combination of deep storage and Historical processes. + +## Deep storage options + +Druid supports multiple options for deep storage, including blob storage from major cloud providers. Select the one that fits your environment. + +### Local Local storage is intended for use in the following situations: @@ -55,22 +61,28 @@ druid.storage.storageDirectory=/tmp/druid/localStorage The `druid.storage.storageDirectory` must be set to a different path than `druid.segmentCache.locations` or `druid.segmentCache.infoDir`. -## Amazon S3 or S3-compatible +### Amazon S3 or S3-compatible See [`druid-s3-extensions`](../development/extensions-core/s3.md). -## Google Cloud Storage +### Google Cloud Storage See [`druid-google-extensions`](../development/extensions-core/google.md). -## Azure Blob Storage +### Azure Blob Storage See [`druid-azure-extensions`](../development/extensions-core/azure.md). -## HDFS +### HDFS See [druid-hdfs-storage extension documentation](../development/extensions-core/hdfs.md). -## Additional options +### Additional options For additional deep storage options, please see our [extensions list](../configuration/extensions.md). + +## Querying from deep storage + +Although not as performant as querying segments stored on disk for Historical processes, you can query from deep storage to access segments that you may not need frequently or with the extreme low latency Druid queries traditionally provide. You trade some performance for a total lower storage cost because you can access more of your data without the need to increase the number or capacity of your Historical processes. + +For information about how to run queries, see [Query from deep storage](../querying/query-from-deep-storage.md). \ No newline at end of file diff --git a/docs/multi-stage-query/reference.md b/docs/multi-stage-query/reference.md index 3fa179e1de2b..5389da48af8b 100644 --- a/docs/multi-stage-query/reference.md +++ b/docs/multi-stage-query/reference.md @@ -343,59 +343,42 @@ CLUSTERED BY user The context parameter that sets `sqlJoinAlgorithm` to `sortMerge` is not shown in the above example. -## Durable Storage +## Durable storage -Using durable storage with your SQL-based ingestion can improve their reliability by writing intermediate files to a storage location temporarily. +SQL-based ingestion supports using durable storage to store intermediate files temporarily. Enabling it can improve reliability. For more information, see [Durable storage](../operations/durable-storage.md). -To prevent durable storage from getting filled up with temporary files in case the tasks fail to clean them up, a periodic -cleaner can be scheduled to clean the directories corresponding to which there isn't a controller task running. It utilizes -the storage connector to work upon the durable storage. The durable storage location should only be utilized to store the output -for cluster's MSQ tasks. If the location contains other files or directories, then they will get cleaned up as well. - -Enabling durable storage also enables the use of local disk to store temporary files, such as the intermediate files produced -by the super sorter. Tasks will use whatever has been configured for their temporary usage as described in [Configuring task storage sizes](../ingestion/tasks.md#configuring-task-storage-sizes) -If the configured limit is too low, `NotEnoughTemporaryStorageFault` may be thrown. - -### Enable durable storage - -To enable durable storage, you need to set the following common service properties: - -``` -druid.msq.intermediate.storage.enable=true -druid.msq.intermediate.storage.type=s3 -druid.msq.intermediate.storage.bucket=YOUR_BUCKET -druid.msq.intermediate.storage.prefix=YOUR_PREFIX -druid.msq.intermediate.storage.tempDir=/path/to/your/temp/dir -``` - -For detailed information about the settings related to durable storage, see [Durable storage configurations](#durable-storage-configurations). - - -### Use durable storage for queries - -When you run a query, include the context parameter `durableShuffleStorage` and set it to `true`. - -For queries where you want to use fault tolerance for workers, set `faultTolerance` to `true`, which automatically sets `durableShuffleStorage` to `true`. - -Set `selectDestination`:`durableStorage` for select queries that want to write the final results to durable storage instead of the task reports. Saving the results in the durable -storage allows users to fetch large result sets. The location where the workers write the intermediate results is different than the location where final results get stored. Therefore, `durableShuffleStorage`:`false` and -`selectDestination`:`durableStorage` is a valid configuration to use in the query context, that instructs the controller to persist only the final result in the durable storage, and not the -intermediate results. +### Durable storage configurations +The following common service properties control how durable storage behaves: -## Durable storage configurations +|Parameter |Default | Description | +|-------------------|----------------------------------------|----------------------| +|`druid.msq.intermediate.storage.enable` | true | Required. Whether to enable durable storage for the cluster. For more information about enabling durable storage, see [Durable storage](../operations/durable-storage.md).| +|`druid.msq.intermediate.storage.type` | `s3` for Amazon S3 | Required. The type of storage to use. `s3` is the only supported storage type. | +|`druid.msq.intermediate.storage.bucket` | n/a | The S3 bucket to store intermediate files. | +|`druid.msq.intermediate.storage.prefix` | n/a | S3 prefix to store intermediate stage results. Provide a unique value for the prefix. Don't share the same prefix between clusters. If the location includes other files or directories, then they will get cleaned up as well. | +|`druid.msq.intermediate.storage.tempDir`| n/a | Required. Directory path on the local disk to temporarily store intermediate stage results. | +|`druid.msq.intermediate.storage.maxRetry` | 10 | Optional. Defines the max number times to attempt S3 API calls to avoid failures due to transient errors. | +|`druid.msq.intermediate.storage.chunkSize` | 100MiB | Optional. Defines the size of each chunk to temporarily store in `druid.msq.intermediate.storage.tempDir`. The chunk size must be between 5 MiB and 5 GiB. A large chunk size reduces the API calls made to the durable storage, however it requires more disk space to store the temporary chunks. Druid uses a default of 100MiB if the value is not provided.| The following common service properties control how durable storage behaves: |Parameter |Default | Description | |-------------------|----------------------------------------|----------------------| -|`druid.msq.intermediate.storage.bucket` | n/a | The bucket in S3 where you want to store intermediate files. | -|`druid.msq.intermediate.storage.chunkSize` | 100MiB | Optional. Defines the size of each chunk to temporarily store in `druid.msq.intermediate.storage.tempDir`. The chunk size must be between 5 MiB and 5 GiB. A large chunk size reduces the API calls made to the durable storage, however it requires more disk space to store the temporary chunks. Druid uses a default of 100MiB if the value is not provided.| |`druid.msq.intermediate.storage.enable` | true | Required. Whether to enable durable storage for the cluster.| -|`druid.msq.intermediate.storage.maxRetry` | 10 | Optional. Defines the max number times to attempt S3 API calls to avoid failures due to transient errors. | +|`druid.msq.intermediate.storage.type` | `s3` if your deep storage is S3 | Required. The type of storage to use. Currently only `s3` is supported. | +|`druid.msq.intermediate.storage.chunkSize` | 100MiB | Optional. Defines the size of each chunk to temporarily store in `druid.msq.intermediate.storage.tempDir`. The chunk size must be between 5 MiB and 5 GiB. A large chunk size reduces the API calls made to the durable storage, however it requires more disk space to store the temporary chunks. Druid uses a default of 100MiB if the value is not provided.| +|`druid.msq.intermediate.storage.maxRetry` | 10 | Optional. Defines the max number times to attempt S3 API calls to avoid failures due to transient errors. | +|`druid.msq.intermediate.storage.bucket` | n/a | The bucket in S3 where you want to store intermediate files. | |`druid.msq.intermediate.storage.prefix` | n/a | S3 prefix to store intermediate stage results. Provide a unique value for the prefix. Don't share the same prefix between clusters. If the location includes other files or directories, then they will get cleaned up as well. | |`druid.msq.intermediate.storage.tempDir`| n/a | Required. Directory path on the local disk to temporarily store intermediate stage results. | -|`druid.msq.intermediate.storage.type` | `s3` if your deep storage is S3 | Required. The type of storage to use. You can either set this to `local` or `s3`. | + +In addition to the common service properties, there are certain properties that you configure on the Overlord specifically to clean up intermediate files: + +|Parameter |Default | Description | +|-------------------|----------------------------------------|----------------------| +|`druid.msq.intermediate.storage.cleaner.enabled`| false | Optional. Whether durable storage cleaner should be enabled for the cluster. | +|`druid.msq.intermediate.storage.cleaner.delaySeconds`| 86400 | Optional. The delay (in seconds) after the last run post which the durable storage cleaner would clean the outputs. | In addition to the common service properties, there are certain properties that you configure on the Overlord specifically to clean up intermediate files: diff --git a/docs/operations/durable-storage.md b/docs/operations/durable-storage.md new file mode 100644 index 000000000000..80545f9a9b28 --- /dev/null +++ b/docs/operations/durable-storage.md @@ -0,0 +1,86 @@ +--- +id: durable-storage +title: "Durable storage for the multi-stage query engine" +sidebar_label: "Durable storage" +--- + + + +You can use durable storage to improve querying from deep storage and SQL-based ingestion. + +> Note that only S3 is supported as a durable storage location. + +Durable storage for queries from deep storage provides a location where you can write the results of deep storage queries to. Durable storage for SQL-based ingestion is used to temporarily house intermediate files, which can improve reliability. + +Enabling durable storage also enables the use of local disk to store temporary files, such as the intermediate files produced +while sorting the data. Tasks will use whatever has been configured for their temporary usage as described in [Configuring task storage sizes](../ingestion/tasks.md#configuring-task-storage-sizes). +If the configured limit is too low, Druid may throw the error, `NotEnoughTemporaryStorageFault`. + +## Enable durable storage + +To enable durable storage, you need to set the following common service properties: + +``` +druid.msq.intermediate.storage.enable=true +druid.msq.intermediate.storage.type=s3 +druid.msq.intermediate.storage.bucket=YOUR_BUCKET +druid.msq.intermediate.storage.prefix=YOUR_PREFIX +druid.msq.intermediate.storage.tempDir=/path/to/your/temp/dir +``` + +For detailed information about the settings related to durable storage, see [Durable storage configurations](../multi-stage-query/reference.md#durable-storage-configurations). + + +## Use durable storage for SQL-based ingestion queries + +When you run a query, include the context parameter `durableShuffleStorage` and set it to `true`. + +For queries where you want to use fault tolerance for workers, set `faultTolerance` to `true`, which automatically sets `durableShuffleStorage` to `true`. + +## Use durable storage for queries from deep storage + +Depending on the size of the results you're expecting, saving the final results for queries from deep storage to durable storage might be needed. + +By default, Druid saves the final results for queries from deep storage to task reports. Generally, this is acceptable for smaller result sets but may lead to timeouts for larger result sets. + +When you run a query, include the context parameter `selectDestination` and set it to `DURABLESTORAGE`: + +```json + "context":{ + ... + "selectDestination": "DURABLESTORAGE" + } +``` + +You can also write intermediate results to durable storage (`durableShuffleStorage`) for better reliability. The location where workers write intermediate results is different than the location where final results get stored. This means that durable storage for results can be enabled even if you don't write intermediate results to durable storage. + +If you write the results for queries from deep storage to durable storage, the results are cleaned up when the task is removed from the metadata store. + +## Durable storage clean up + +To prevent durable storage from getting filled up with temporary files in case the tasks fail to clean them up, a periodic +cleaner can be scheduled to clean the directories corresponding to which there isn't a controller task running. It utilizes +the storage connector to work upon the durable storage. The durable storage location should only be utilized to store the output +for the cluster's MSQ tasks. If the location contains other files or directories, then they will get cleaned up as well. + +Use `druid.msq.intermediate.storage.cleaner.enabled` and `druid.msq.intermediate.storage.cleaner.delaySEconds` to configure the cleaner. For more information, see [Durable storage configurations](../multi-stage-query/reference.md#durable-storage-configurations). + +Note that if you choose to write query results to durable storage,the results are cleaned up when the task is removed from the metadata store. + diff --git a/docs/operations/rule-configuration.md b/docs/operations/rule-configuration.md index 8d12beac96ca..aa42ef461b28 100644 --- a/docs/operations/rule-configuration.md +++ b/docs/operations/rule-configuration.md @@ -107,7 +107,7 @@ In the web console you can use the up and down arrows on the right side of the i ## Load rules -Load rules define how Druid assigns segments to [historical process tiers](./mixed-workloads.md#historical-tiering), and how many replicas of a segment exist in each tier. +Load rules define how Druid assigns segments to [Historical process tiers](./mixed-workloads.md#historical-tiering), and how many replicas of a segment exist in each tier. If you have a single tier, Druid automatically names the tier `_default`. If you define an additional tier, you must define a load rule to specify which segments to load on that tier. Until you define a load rule, your new tier remains empty. @@ -120,6 +120,8 @@ All load rules can have these properties: Specific types of load rules discussed below may have other properties too. +Load rules are also how you take advantage of the resource savings that [query the data from deep storage](../querying/query-from-deep-storage.md) provides. One way to configure data so that certain segments are not loaded onto Historical tiers but are available to query from deep storage is to set `tieredReplicants` to an empty array and `useDefaultTierForNull` to `false` for those segments, either by interval or by period. + ### Forever load rule The forever load rule assigns all datasource segments to specified tiers. It is the default rule Druid applies to datasources. Forever load rules have type `loadForever`. @@ -167,7 +169,7 @@ Set the following properties: - the segment interval starts any time after the rule interval starts. You can use this property to load segments with future start and end dates, where "future" is relative to the time when the Coordinator evaluates data against the rule. Defaults to `true`. -- `tieredReplicants`: a map of tier names to the number of segment replicas for that tier. +- `tieredReplicants`: a map of tier names to the number of segment replicas for that tier. - `useDefaultTierForNull`: This parameter determines the default value of `tieredReplicants` and only has an effect if the field is not present. The default value of `useDefaultTierForNull` is true. ### Interval load rule @@ -190,7 +192,7 @@ Interval load rules have type `loadByInterval`. The following example places one Set the following properties: - `interval`: the load interval specified as an [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) range encoded as a string. -- `tieredReplicants`: a map of tier names to the number of segment replicas for that tier. +- `tieredReplicants`: a map of tier names to the number of segment replicas for that tier. - `useDefaultTierForNull`: This parameter determines the default value of `tieredReplicants` and only has an effect if the field is not present. The default value of `useDefaultTierForNull` is true. ## Drop rules @@ -256,7 +258,7 @@ Set the following property: ### Interval drop rule -You can use a drop interval rule to prevent Druid from loading a specified range of data onto any tier. The range is typically your oldest data. The dropped data resides in cold storage, but is not queryable. If you need to query the data, update or remove the interval drop rule so that Druid reloads the data. +You can use a drop interval rule to prevent Druid from loading a specified range of data onto any tier. The range is typically your oldest data. The dropped data resides in deep storage and can still be [queried from deep storage](../querying/query-from-deep-storage.md). Interval drop rules have type `dropByInterval` and the following JSON structure: diff --git a/docs/querying/query-from-deep-storage.md b/docs/querying/query-from-deep-storage.md new file mode 100644 index 000000000000..5f076ca47cdf --- /dev/null +++ b/docs/querying/query-from-deep-storage.md @@ -0,0 +1,195 @@ +--- +id: query-deep-storage +title: "Query from deep storage" +--- + + + +> Query from deep storage is an [experimental feature](../development/experimental.md). + +Druid can query segments that are only stored in deep storage. Running a query from deep storage is slower than running queries from segments that are loaded on Historical processes, but it's a great tool for data that you either access infrequently or where the low latency results that typical Druid queries provide is not necessary. Queries from deep storage can increase the surface area of data available to query without requiring you to scale your Historical processes to accommodate more segments. + +## Keep segments in deep storage only + +Any data you ingest into Druid is already stored in deep storage, so you don't need to perform any additional configuration from that perspective. However, to take advantage of the cost savings that querying from deep storage provides, make sure not all your segments get loaded onto Historical processes. + +To do this, configure [load rules](../operations/rule-configuration.md#load-rules) to manage the which segments are only in deep storage and which get loaded onto Historical processes. + +The easiest way to do this is to explicitly configure the segments that don't get loaded onto Historical processes. Set `tieredReplicants` to an empty array and `useDefaultTierForNull` to `false`. For example, if you configure the following rule for a datasource: + +```json +[ + { + "interval": "2016-06-27T00:00:00.000Z/2016-06-27T02:59:00.000Z", + "tieredReplicants": {}, + "useDefaultTierForNull": false, + "type": "loadByInterval" + } +] +``` + +Any segment that falls within the specified interval exists only in deep storage. For segments that aren't in this interval, they'll use the default cluster load rules or any other load rules you configure. + +To configure the load rules through the Druid console, go to **Datasources > ... in the Actions column > Edit retention rules**. Then, paste the provided JSON into the JSON tab: + +![](../assets/tutorial-query-deepstorage-retention-rule.png) + + +You can verify that a segment is not loaded on any Historical tiers by querying the Druid metadata table: + +```sql +SELECT "segment_id", "replication_factor" FROM sys."segments" WHERE "replication_factor" = 0 AND "datasource" = YOUR_DATASOURCE +``` + +Segments with a `replication_factor` of `0` are not assigned to any Historical tiers. Queries against these segments are run directly against the segment in deep storage. + +You can also confirm this through the Druid console. On the **Segments** page, see the **Replication factor** column. + +Keep the following in mind when working with load rules to control what exists only in deep storage: + +- At least one of the segments in a datasource must be loaded onto a Historical process so that Druid can plan the query. The segment on the Historical process can be any segment from the datasource. It does not need to be a specific segment. One way to verify that a datasource has at least one segment on a Historical process is if it's visible in the Druid console. +- The actual number of replicas may differ from the replication factor temporarily as Druid processes your load rules. + +## Run a query from deep storage + +### Submit a query + +You can query data from deep storage by submitting a query to the API using `POST /sql/statements` or the Druid console. Druid uses the multi-stage query (MSQ) task engine to perform the query. + +To run a query from deep storage, send your query to the Router using the POST method: + +``` +POST https://ROUTER:8888/druid/v2/sql/statements +``` + +Submitting a query from deep storage uses the same syntax as any other Druid SQL query where the query is contained in the "query" field in the JSON object within the request payload. For example: + +```json +{"query" : "SELECT COUNT(*) FROM data_source WHERE foo = 'bar'"} +``` + +Generally, the request body fields are the same between the `sql` and `sql/statements` endpoints. + +There are additional context parameters for `sql/statements` specifically: + + - `executionMode` (required) determines how query results are fetched. Set this to `ASYNC`. + - `selectDestination` (optional) set to `durableStorage` instructs Druid to write the results from SELECT queries to durable storage. Note that this requires you to have [durable storage for MSQ enabled](../operations/durable-storage.md). + +The following sample query includes the two additional context parameters that querying from deep storage supports: + +``` +curl --location 'http://localhost:8888/druid/v2/sql/statements' \ +--header 'Content-Type: application/json' \ +--data '{ + "query":"SELECT * FROM \"YOUR_DATASOURCE\" where \"__time\" >TIMESTAMP'\''2017-09-01'\'' and \"__time\" <= TIMESTAMP'\''2017-09-02'\''", + "context":{ + "executionMode":"ASYNC", + "selectDestination": "durableStorage" + + } +}' +``` + +The response for submitting a query includes the query ID along with basic information, such as when you submitted the query and the schema of the results: + +```json +{ + "queryId": "query-ALPHANUMBERIC-STRING", + "state": "ACCEPTED", + "createdAt": CREATION_TIMESTAMP, +"schema": [ + { + "name": COLUMN_NAME, + "type": COLUMN_TYPE, + "nativeType": COLUMN_TYPE + }, + ... +], +"durationMs": DURATION_IN_MS, +} +``` + + +### Get query status + +You can check the status of a query with the following API call: + +``` +GET https://ROUTER:8888/druid/v2/sql/statements/QUERYID +``` + +The query returns the status of the query, such as `ACCEPTED` or `RUNNING`. Before you attempt to get results, make sure the state is `SUCCESS`. + +When you check the status on a successful query, it includes useful information about your query results including a sample record and information about how the results are organized by `pages`. The information for each page includes the following: + +- `numRows`: the number of rows in that page of results +- `sizeInBytes`: the size of the page +- `id`: the indexed page number that you can use to reference a specific page when you get query results + +You can use `page` as a parameter to refine the results you retrieve. + +The following snippet shows the structure of the `result` object: + +```json +{ + ... + "result": { + "numTotalRows": INTEGER, + "totalSizeInBytes": INTEGER, + "dataSource": "__query_select", + "sampleRecords": [ + [ + RECORD_1, + RECORD_2, + ... + ] + ], + "pages": [ + { + "numRows": INTEGER, + "sizeInBytes": INTEGER, + "id": INTEGER_PAGE_NUMBER + } + ... + ] +} +} +``` + +### Get query results + +Only the user who submitted a query can retrieve the results for the query. + +Use the following endpoint to retrieve results: + +``` +GET https://ROUTER:8888/druid/v2/sql/statements/QUERYID/results?page=PAGENUMBER&size=RESULT_SIZE&timeout=TIMEOUT_MS +``` + +Results are returned in JSON format. + +You can use the optional `page`, `size`, and `timeout` parameters to refine your results. You can retrieve the `page` information for your results by fetching the status of the completed query. + +When you try to get results for a query from deep storage, you may receive an error that states the query is still running. Wait until the query completes before you try again. + +## Further reading + +* [Query from deep storage tutorial](../tutorials/tutorial-query-deep-storage.md) +* [Query from deep storage API reference](../api-reference/sql-api.md#query-from-deep-storage) diff --git a/docs/tutorials/tutorial-query-deep-storage.md b/docs/tutorials/tutorial-query-deep-storage.md new file mode 100644 index 000000000000..5502ad94228d --- /dev/null +++ b/docs/tutorials/tutorial-query-deep-storage.md @@ -0,0 +1,293 @@ +--- +id: tutorial-query-deep-storage +title: "Tutorial: Query from deep storage" +sidebar_label: "Query from deep storage" +--- + + + + +> Query from deep storage is an [experimental feature](../development/experimental.md). + +Query from deep storage allows you to query segments that are stored only in deep storage, which provides lower costs than if you were to load everything onto Historical processes. The tradeoff is that queries from deep storage may take longer to complete. + +This tutorial walks you through loading example data, configuring load rules so that not all the segments get loaded onto Historical processes, and querying data from deep storage. + +To run the queries in this tutorial, replace `ROUTER:PORT` with the location of the Router process and its port number. For example, use `localhost:8888` for the quickstart deployment. + +For more general information, see [Query from deep storage](../querying/query-from-deep-storage.md). + +## Load example data + +Use the **Load data** wizard or the following SQL query to ingest the `wikipedia` sample datasource bundled with Druid. If you use the wizard, make sure you change the partitioning to be by hour. + +Partitioning by hour provides more segment granularity, so you can selectively load segments onto Historicals or keep them in deep storage. + +
Show the query + +```sql +REPLACE INTO "wikipedia" OVERWRITE ALL +WITH "ext" AS (SELECT * +FROM TABLE( + EXTERN( + '{"type":"http","uris":["https://druid.apache.org/data/wikipedia.json.gz"]}', + '{"type":"json"}' + ) +) EXTEND ("isRobot" VARCHAR, "channel" VARCHAR, "timestamp" VARCHAR, "flags" VARCHAR, "isUnpatrolled" VARCHAR, "page" VARCHAR, "diffUrl" VARCHAR, "added" BIGINT, "comment" VARCHAR, "commentLength" BIGINT, "isNew" VARCHAR, "isMinor" VARCHAR, "delta" BIGINT, "isAnonymous" VARCHAR, "user" VARCHAR, "deltaBucket" BIGINT, "deleted" BIGINT, "namespace" VARCHAR, "cityName" VARCHAR, "countryName" VARCHAR, "regionIsoCode" VARCHAR, "metroCode" BIGINT, "countryIsoCode" VARCHAR, "regionName" VARCHAR)) +SELECT + TIME_PARSE("timestamp") AS "__time", + "isRobot", + "channel", + "flags", + "isUnpatrolled", + "page", + "diffUrl", + "added", + "comment", + "commentLength", + "isNew", + "isMinor", + "delta", + "isAnonymous", + "user", + "deltaBucket", + "deleted", + "namespace", + "cityName", + "countryName", + "regionIsoCode", + "metroCode", + "countryIsoCode", + "regionName" +FROM "ext" +PARTITIONED BY HOUR +``` + +
+ +## Configure a load rule + +The load rule configures Druid to keep any segments that fall within the following interval only in deep storage: + +``` +2016-06-27T00:00:00.000Z/2016-06-27T02:59:00.000Z +``` + +The JSON form of the rule is as follows: + +```json +[ + { + "interval": "2016-06-27T00:00:00.000Z/2016-06-27T02:59:00.000Z", + "tieredReplicants": {}, + "useDefaultTierForNull": false, + "type": "loadByInterval" + } +] +``` + +The rest of the segments use the default load rules for the cluster. For the quickstart, that means all the other segments get loaded onto Historical processes. + +You can configure the load rules through the API or the Druid console. To configure the load rules through the Druid console, go to **Datasources > ... in the Actions column > Edit retention rules**. Then, paste the provided JSON into the JSON tab: + +![](../assets/tutorial-query-deepstorage-retention-rule.png) + + +### Verify the replication factor + +Segments that are only available from deep storage have a `replication_factor` of 0 in the Druid system table. You can verify that your load rule worked as intended using the following query: + +```sql +SELECT "segment_id", "replication_factor", "num_replicas" FROM sys."segments" WHERE datasource = 'wikipedia' +``` + +You can also verify it through the Druid console by checking the **Replication factor** column in the **Segments** view. + +Note that the number of replicas and replication factor may differ temporarily as Druid processes your retention rules. + +## Query from deep storage + +Now that there are segments that are only available from deep storage, run the following query: + +```sql +SELECT page FROM wikipedia WHERE __time < TIMESTAMP'2016-06-27 00:10:00' LIMIT 10 +``` + +With the context parameter: + +```json +"executionMode": "ASYNC" +``` + +For example, run the following curl command: + +``` +curl --location 'http://localhost:8888/druid/v2/sql/statements' \ +--header 'Content-Type: application/json' \ +--data '{ + "query":"SELECT page FROM wikipedia WHERE __time < TIMESTAMP'\''2016-06-27 00:10:00'\'' LIMIT 10", + "context":{ + "executionMode":"ASYNC" + } +}' +``` + +This query looks for records with timestamps that precede `00:10:00`. Based on the load rule you configured earlier, this data is only available from deep storage. + +When you submit the query from deep storage through the API, you get the following response: + +
Show the response + +```json +{ + "queryId": "query-6888b6f6-e597-456c-9004-222b05b97051", + "state": "ACCEPTED", + "createdAt": "2023-07-28T21:59:02.334Z", + "schema": [ + { + "name": "page", + "type": "VARCHAR", + "nativeType": "STRING" + } + ], + "durationMs": -1 +} +``` + +Make sure you note the `queryID`. You'll need it to interact with the query. + +
+ +Compare this to if you were to submit the query to Druid SQL's regular endpoint, `POST /sql`: + +``` +curl --location 'http://localhost:8888/druid/v2/sql/' \ +--header 'Content-Type: application/json' \ +--data '{ + "query":"SELECT page FROM wikipedia WHERE __time < TIMESTAMP'\''2016-06-27 00:10:00'\'' LIMIT 10", + "context":{ + "executionMode":"ASYNC" + } +}' +``` + +The response you get back is an empty response cause there are no records on the Historicals that match the query. + +## Get query status + +Replace `:queryId` with the ID for your query and run the following curl command to get your query status: + +``` +curl --location --request GET 'http://localhost:8888/druid/v2/sql/statements/:queryId' \ +--header 'Content-Type: application/json' \ +``` + + +### Response for a running query + +The response for a running query is the same as the response from when you submitted the query except the `state` is `RUNNING` instead of `ACCEPTED`. + +### Response for a completed query + +A successful query also returns a `pages` object that includes the page numbers (`id`), rows per page (`numRows`), and the size of the page (`sizeInBytes`). You can pass the page number as a parameter when you get results to refine the results you get. + +Note that `sampleRecords` has been truncated for brevity. + +
Show the response + +```json +{ + "queryId": "query-6888b6f6-e597-456c-9004-222b05b97051", + "state": "SUCCESS", + "createdAt": "2023-07-28T21:59:02.334Z", + "schema": [ + { + "name": "page", + "type": "VARCHAR", + "nativeType": "STRING" + } + ], + "durationMs": 87351, + "result": { + "numTotalRows": 152, + "totalSizeInBytes": 9036, + "dataSource": "__query_select", + "sampleRecords": [ + [ + "Salo Toraut" + ], + [ + "利用者:ワーナー成増/放送ウーマン賞" + ], + [ + "Bailando 2015" + ], + ... + ... + ... + ], + "pages": [ + { + "id": 0, + "numRows": 152, + "sizeInBytes": 9036 + } + ] + } +} +``` + +
+ +## Get query results + +Replace `:queryId` with the ID for your query and run the following curl command to get your query results: + +``` +curl --location 'http://ROUTER:PORT/druid/v2/sql/statements/:queryId' +``` + +Note that the response has been truncated for brevity. + +
Show the response + +```json +[ + { + "page": "Salo Toraut" + }, + { + "page": "利用者:ワーナー成増/放送ウーマン賞" + }, + { + "page": "Bailando 2015" + }, + ... + ... + ... +] +``` + +
+ +## Further reading + +* [Query from deep storage](../querying/query-from-deep-storage.md) +* [Query from deep storage API reference](../api-reference/sql-api.md#query-from-deep-storage) \ No newline at end of file diff --git a/website/sidebars.json b/website/sidebars.json index 458d2bfe033d..0dbb95a44b3f 100644 --- a/website/sidebars.json +++ b/website/sidebars.json @@ -24,6 +24,7 @@ "tutorials/tutorial-kerberos-hadoop", "tutorials/tutorial-sql-query-view", "tutorials/tutorial-unnest-arrays", + "tutorials/tutorial-query-deep-storage", "tutorials/tutorial-jupyter-index", "tutorials/tutorial-jupyter-docker", "tutorials/tutorial-jdbc" @@ -98,6 +99,7 @@ "label": "Druid SQL", "ids": [ "querying/sql", + "querying/query-deep-storage", "querying/sql-data-types", "querying/sql-operators", "querying/sql-scalar", @@ -200,6 +202,7 @@ "Operations": [ "operations/web-console", "operations/java", + "operations/durable-storage", { "type": "subcategory", "label": "Security",