Skip to content

Commit

Permalink
GITBOOK-1813: change request with no subject merged in GitBook
Browse files Browse the repository at this point in the history
  • Loading branch information
rongr authored and gitbook-bot committed Sep 21, 2023
1 parent 252ebff commit 155b8f6
Show file tree
Hide file tree
Showing 12 changed files with 173 additions and 177 deletions.
8 changes: 4 additions & 4 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,12 +103,12 @@
* [Explain Plan (Single-Stage)](users/user-guide-query/explain-plan.md)
* [Explain Plan (Multi-Stage)](users/user-guide-query/query-syntax/explain-plan-multi-stage.md)
* [Filtering with IdSet](users/user-guide-query/query-syntax/filtering-with-idset.md)
* [GapFill Function For Time-Series Dataset](users/user-guide-query/query-syntax/gap-fill-functions.md)
* [GapFill Function For Time-Series Dataset](users/user-guide-query/gap-fill-functions.md)
* [Grouping Algorithm](users/user-guide-query/grouping-algorithm.md)
* [JOINs](users/user-guide-query/query-syntax/joins.md)
* [Lookup UDF Join](users/user-guide-query/query-syntax/lookup-udf-join.md)
* [Querying JSON data](users/user-guide-query/json-queries.md)
* [Transformation Functions](users/user-guide-query/query-syntax/supported-transformations.md)
* [Transformation Functions](users/user-guide-query/supported-transformations.md)
* [Window aggregate](users/user-guide-query/query-syntax/windows-functions.md)
* [Query Options](users/user-guide-query/query-options.md)
* [User-Defined Functions (UDFs)](users/user-guide-query/scalar-functions.md)
Expand Down Expand Up @@ -380,8 +380,8 @@

## Reference

* [Single-stage query engine (v1)](reference/cluster.md)
* [Multi-stage query engine (v2)](reference/cluster-1.md)
* [Single-stage query engine (v1)](reference/single-stage-engine.md)
* [Multi-stage query engine (v2)](reference/multi-stage-engine.md)

## RESOURCES <a href="#community-1" id="community-1"></a>

Expand Down
2 changes: 1 addition & 1 deletion basics/releases/1.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: >-

This release includes the several new features, enhancements, and bug fixes, including the following highlights:

* Multi-stage query engine: [new features](1.0.0.md#multi-stage-query-engine-new-features), [enhancements](1.0.0.md#multi-stage-query-engine-enhancements), and [bug fixes](1.0.0.md#multi-stage-query-engine-bug-fixes). Learn how to [enable and use the multi-stage query engine](../../developers/advanced/v2-multi-stage-query-engine.md) or more about how the [multi-stage query engine ](../../reference/cluster-1.md)works.&#x20;
* Multi-stage query engine: [new features](1.0.0.md#multi-stage-query-engine-new-features), [enhancements](1.0.0.md#multi-stage-query-engine-enhancements), and [bug fixes](1.0.0.md#multi-stage-query-engine-bug-fixes). Learn how to [enable and use the multi-stage query engine](../../developers/advanced/v2-multi-stage-query-engine.md) or more about how the [multi-stage query engine ](../../reference/multi-stage-engine.md)works.&#x20;

### **Multi-stage query engine new features**

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: Troubleshoot issues with the multi-stage query engine (v2).

Learn how to [troubleshoot errors](troubleshoot-multi-stage-query-engine.md#troubleshoot-errors) when using the multi-stage query engine (v2), and see [multi-stage query engine limitations](troubleshoot-multi-stage-query-engine.md#limitations-of-the-multi-stage-query-engine).&#x20;

Find instructions on [how to enable the multi-stage query engine](v2-multi-stage-query-engine.md), or see a high-level overview of [how the multi-stage query engine works](../../reference/cluster-1.md).
Find instructions on [how to enable the multi-stage query engine](v2-multi-stage-query-engine.md), or see a high-level overview of [how the multi-stage query engine works](../../reference/multi-stage-engine.md).

## Limitations of the multi-stage query engine&#x20;

Expand Down
2 changes: 1 addition & 1 deletion developers/advanced/v2-multi-stage-query-engine.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ To query using distributed joins, window functions, and other multi-stage operat
* Query [using REST APIs](v2-multi-stage-query-engine.md#use-rest-apis)
* Query outside of the APIs [using the query option](v2-multi-stage-query-engine.md#use-the-query-option)

To learn more about what the multi-stage query engine is, see [Multi-stage query engine (v2)](../../reference/cluster-1.md).&#x20;
To learn more about what the multi-stage query engine is, see [Multi-stage query engine (v2)](../../reference/multi-stage-engine.md).&#x20;

## Enable the multi-stage query engine in the Query Console

Expand Down
6 changes: 1 addition & 5 deletions reference/cluster-1.md → reference/multi-stage-engine.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,15 +86,11 @@ SELECT c.uid c.ltv FROM customer AS c WHERE c.lto > 5

3. The data exchange service shuffles data shuffle, so all data with the same unique customer ID is sent to the same processing server for the next stage.
4. On each processing server, an inner JOIN is performed.
5. Each intermediary servers (shown in [_Figure 1: Multi-stage query execution model_](cluster-1.md#multi-stage-query-execution-model)) performs a local join, and

runs the same join algorithm, but on different `uids.`
6. On each processing server, an inner JOIN is performed.

### Stage 2

1. On each processing server, an inner JOIN is performed.
2. Each intermediary servers (shown in [_Figure 1: Multi-stage query execution model_](cluster-1.md#multi-stage-query-execution-model)) performs a local join, and
2. Each intermediary servers (shown in [_Figure 1: Multi-stage query execution model_](multi-stage-engine.md#multi-stage-query-execution-model)) performs a local join, and

runs the same join algorithm, but on different `uids.`

Expand Down
2 changes: 1 addition & 1 deletion reference/cluster.md → reference/single-stage-engine.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ description: An overview of the single-stage query engine.

# Single-stage query engine (v1)

The Pinot single-stage query engine (v1) uses a scatter-gather query engine model, shown in the following diagram. In certain cases, for example, if you need to query using JOINs on large data sets, the [multi-stage query engine (v2)](cluster-1.md) may be a more performant option.&#x20;
The Pinot single-stage query engine (v1) uses a scatter-gather query engine model, shown in the following diagram. In certain cases, for example, if you need to query using JOINs on large data sets, the [multi-stage query engine (v2)](multi-stage-engine.md) may be a more performant option.&#x20;

<figure><img src="../.gitbook/assets/Multi-Stage-Pinot-Query-Engine-v1 (2).png" alt=""><figcaption><p>Single-stage query engine (v1)</p></figcaption></figure>
8 changes: 4 additions & 4 deletions users/user-guide-query/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ description: >-
[filtering-with-idset.md](query-syntax/filtering-with-idset.md)
{% endcontent-ref %}

{% content-ref url="query-syntax/gap-fill-functions.md" %}
[gap-fill-functions.md](query-syntax/gap-fill-functions.md)
{% content-ref url="gap-fill-functions.md" %}
[gap-fill-functions.md](gap-fill-functions.md)
{% endcontent-ref %}

{% content-ref url="grouping-algorithm.md" %}
Expand All @@ -60,8 +60,8 @@ description: >-
[lookup-udf-join.md](query-syntax/lookup-udf-join.md)
{% endcontent-ref %}

{% content-ref url="query-syntax/supported-transformations.md" %}
[supported-transformations.md](query-syntax/supported-transformations.md)
{% content-ref url="supported-transformations.md" %}
[supported-transformations.md](supported-transformations.md)
{% endcontent-ref %}

{% content-ref url="scalar-functions.md" %}
Expand Down
2 changes: 1 addition & 1 deletion users/user-guide-query/query-syntax/joins.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ description: >-
# JOINs

{% hint style="info" %}
**Important:** To query using JOINs, you must [use Pinot's multi-stage query engine (v2).](../../../reference/cluster-1.md)
**Important:** To query using JOINs, you must [use Pinot's multi-stage query engine (v2).](../../../reference/multi-stage-engine.md)
{% endhint %}

* [Overview of JOINs in Pinot 1.0](joins.md#joins-overview)
Expand Down
Loading

0 comments on commit 155b8f6

Please sign in to comment.