This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris.git
The following commit(s) were added to refs/heads/master by this push:
new 5e39cdf053c [doc](nereids)Add query rewrite by materialized view
feature summary and desc doc (#29370)
5e39cdf053c is described below
commit 5e39cdf053c008b5fd53b209b67ab5b5f3426825
Author: seawinde <149132972+seawi...@users.noreply.github.com>
AuthorDate: Thu Jan 4 10:38:30 2024 +0800
[doc](nereids)Add query rewrite by materialized view feature summary and
desc doc (#29370)
---
.../query-acceleration/async-materialized-view.md | 3 +-
.../query-rewrite-summary-and-desc.md | 415 +++++++++++++++++++++
.../query-acceleration/async-materialized-view.md | 3 +-
.../query-rewrite-summary-and-desc.md | 394 +++++++++++++++++++
.../main/java/org/apache/doris/mtmv/MTMVUtil.java | 2 +-
.../java/org/apache/doris/qe/SessionVariable.java | 12 +-
6 files changed, 820 insertions(+), 9 deletions(-)
diff --git a/docs/en/docs/query-acceleration/async-materialized-view.md
b/docs/en/docs/query-acceleration/async-materialized-view.md
index 2a77ff2d4b4..8c55f3ebf05 100644
--- a/docs/en/docs/query-acceleration/async-materialized-view.md
+++ b/docs/en/docs/query-acceleration/async-materialized-view.md
@@ -213,4 +213,5 @@ The materialized view itself is also a Table, so it can be
directly queried
select * FROM mv1;
```
-### Transparent rewriting
\ No newline at end of file
+### Query rewriting by materialized view
+can be viewed [Query rewriting by materialized
view](async-materialized-view/query-rewrite-summary-and-desc.md)
diff --git
a/docs/en/docs/query-acceleration/async-materialized-view/query-rewrite-summary-and-desc.md
b/docs/en/docs/query-acceleration/async-materialized-view/query-rewrite-summary-and-desc.md
new file mode 100644
index 00000000000..c0a03204093
--- /dev/null
+++
b/docs/en/docs/query-acceleration/async-materialized-view/query-rewrite-summary-and-desc.md
@@ -0,0 +1,415 @@
+---
+{
+ "title": "Querying Asynchronous Materialized Views",
+ "language": "en"
+}
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## Overview
+
+Doris's asynchronous materialized views employ a structure based on the SPJG
(SELECT-PROJECT-JOIN-GROUP-BY) pattern
+for transparent rewriting algorithms. Doris can analyze the structural
information of the query SQL,
+automatically identify suitable materialized views, and attempt transparent
rewriting by expressing the
+query SQL using the materialized views. By utilizing precomputed materialized
view results,
+significant improvements in query performance and a reduction in computational
costs can be achieved.
+
+Using the three tables: lineitem, orders, and partsupp from TPC-H, let's
describe the capability of directly querying
+a materialized view and using the materialized view for transparent query
rewriting.
+```sql
+CREATE TABLE IF NOT EXISTS lineitem (
+ l_orderkey integer not null,
+ l_partkey integer not null,
+ l_suppkey integer not null,
+ l_linenumber integer not null,
+ l_quantity decimalv3(15,2) not null,
+ l_extendedprice decimalv3(15,2) not null,
+ l_discount decimalv3(15,2) not null,
+ l_tax decimalv3(15,2) not null,
+ l_returnflag char(1) not null,
+ l_linestatus char(1) not null,
+ l_shipdate date not null,
+ l_commitdate date not null,
+ l_receiptdate date not null,
+ l_shipinstruct char(25) not null,
+ l_shipmode char(10) not null,
+ l_comment varchar(44) not null
+ )
+ DUPLICATE KEY(l_orderkey, l_partkey, l_suppkey, l_linenumber)
+ PARTITION BY RANGE(l_shipdate)
+ (FROM ('2023-10-17') TO ('2023-10-20') INTERVAL 1 DAY)
+ DISTRIBUTED BY HASH(l_orderkey) BUCKETS 3
+ PROPERTIES ("replication_num" = "1");
+```
+```sql
+CREATE TABLE IF NOT EXISTS orders (
+ o_orderkey integer not null,
+ o_custkey integer not null,
+ o_orderstatus char(1) not null,
+ o_totalprice decimalv3(15,2) not null,
+ o_orderdate date not null,
+ o_orderpriority char(15) not null,
+ o_clerk char(15) not null,
+ o_shippriority integer not null,
+ o_comment varchar(79) not null
+ )
+ DUPLICATE KEY(o_orderkey, o_custkey)
+ PARTITION BY RANGE(o_orderdate)(
+ FROM ('2023-10-17') TO ('2023-10-20') INTERVAL 1 DAY)
+ DISTRIBUTED BY HASH(o_orderkey) BUCKETS 3
+ PROPERTIES ("replication_num" = "1");
+```
+
+```sql
+ CREATE TABLE IF NOT EXISTS partsupp (
+ ps_partkey INTEGER NOT NULL,
+ ps_suppkey INTEGER NOT NULL,
+ ps_availqty INTEGER NOT NULL,
+ ps_supplycost DECIMALV3(15,2) NOT NULL,
+ ps_comment VARCHAR(199) NOT NULL
+ )
+ DUPLICATE KEY(ps_partkey, ps_suppkey)
+ DISTRIBUTED BY HASH(ps_partkey) BUCKETS 3
+ PROPERTIES (
+ "replication_num" = "1"
+ );
+```
+
+## Direct Query of Materialized View
+A materialized view can be considered as a table and can be queried just like
a regular table.
+
+The syntax for defining a materialized view, details can be found in
+[CREATE-ASYNC-MATERIALIZED-VIEW](../../sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-ASYNC-MATERIALIZED-VIEW.md)
+
+Materialized view definition:
+```sql
+CREATE MATERIALIZED VIEW mv1
+BUILD IMMEDIATE REFRESH AUTO ON SCHEDULE EVERY 1 hour
+DISTRIBUTED BY RANDOM BUCKETS 12
+PROPERTIES ('replication_num' = '1')
+AS
+SELECT t1.l_linenumber,
+ o_custkey,
+ o_orderdate
+FROM (SELECT * FROM lineitem WHERE l_linenumber > 1) t1
+ LEFT OUTER JOIN orders
+ ON l_orderkey = o_orderkey;
+```
+
+Query statement:
+Direct queries can be performed on the materialized view with additional
filtering conditions and aggregations.
+
+```sql
+SELECT l_linenumber,
+ o_custkey
+FROM mv1
+WHERE l_linenumber > 1 and o_orderdate = '2023-12-31';
+```
+
+## Transparent Rewriting Capability
+### Join rewriting
+
+JOIN rewriting refers to the ability to transparently rewrite a query when the
tables used in the query and
+the materialized view are the same. This rewriting can occur either by joining
the materialized view
+and the query inside the JOIN clause or by placing conditions in the WHERE
clause outside of the JOIN.
+Additionally, under certain conditions, when the types of JOINs in the query
and the materialized view do not match,
+rewriting can still take place.
+
+**Case 1:**
+
+The following case can undergo transparent rewriting. The condition
`l_linenumber > 1` allows for pull-up,
+enabling transparent rewriting by expressing the query using the precomputed
results of the materialized view.
+
+Materialized view definition:
+```sql
+SELECT t1.l_linenumber,
+ o_custkey,
+ o_orderdate
+FROM (SELECT * FROM lineitem WHERE l_linenumber > 1) t1
+LEFT OUTER JOIN orders
+ON l_orderkey = o_orderkey;
+```
+Query statement:
+
+```sql
+SELECT l_linenumber,
+ o_custkey
+FROM lineitem
+LEFT OUTER JOIN orders
+ON l_orderkey = o_orderkey
+WHERE l_linenumber > 1 and o_orderdate = '2023-12-31';
+```
+
+**Case 2:**
+
+JOIN Derivation (Coming soon)
+When the types of JOINs in the query and the materialized view do not match,
but the materialized view can provide
+all the data required for the query, transparent rewriting can also occur by
compensating predicates above the JOIN.
+For example:
+
+Materialized view definition:
+```sql
+SELECT
+ l_shipdate, l_suppkey, o_orderdate
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS bitmap_union_basic
+FROM lineitem
+LEFT OUTER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND
l_shipdate = o_orderdate
+GROUP BY
+l_shipdate,
+l_suppkey,
+o_orderdate;
+```
+
+Query statement:
+```sql
+SELECT
+ l_shipdate, l_suppkey, o_orderdate
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS bitmap_union_basic
+FROM lineitem
+INNER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND l_shipdate =
o_orderdate
+WHERE o_orderdate = '2023-12-11' AND l_suppkey = 3
+GROUP BY
+l_shipdate,
+l_suppkey,
+o_orderdate;
+```
+
+### Aggregate rewriting
+
+**Case 1**
+
+The following case can undergo transparent rewriting. The query and the
materialized view use consistent dimensions
+for aggregation, allowing the use of fields from the dimensions to filter
results. The query will attempt to use the
+expressions after SELECT in the materialized view.
+
+Materialized view definition:
+
+```sql
+SELECT
+ o_shippriority, o_comment,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS cnt_1,
+ count(distinct CASE WHEN O_SHIPPRIORITY > 2 AND o_orderkey IN (2) THEN
o_custkey ELSE null END) AS cnt_2,
+ sum(o_totalprice),
+ max(o_totalprice),
+ min(o_totalprice),
+ count(*)
+FROM orders
+GROUP BY
+o_shippriority,
+o_comment;
+```
+
+Query statement:
+
+```sql
+SELECT
+ o_shippriority, o_comment,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS cnt_1,
+ count(distinct CASE WHEN O_SHIPPRIORITY > 2 AND o_orderkey IN (2) THEN
o_custkey ELSE null END) AS cnt_2,
+ sum(o_totalprice),
+ max(o_totalprice),
+ min(o_totalprice),
+ count(*)
+FROM orders
+WHERE o_shippriority in (1, 2)
+GROUP BY
+o_shippriority,
+o_comment;
+```
+
+**Case 2**
+
+The following query can undergo transparent rewriting. The query and the
materialized view use inconsistent
+dimensions for aggregation, where the dimensions used by the materialized view
include those used by the query.
+The query will attempt to roll up using the functions after SELECT, such as
the materialized view's
+bitmap_union will eventually roll up into bitmap_union_count, maintaining
consistency with the semantics of
+the count(distinct) in the query.
+
+Materialized view definition:
+
+```sql
+SELECT
+ l_shipdate, o_orderdate, l_partkey, l_suppkey,
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ bitmap_union(to_bitmap(CASE WHEN o_shippriority > 1 AND o_orderkey IN (1,
3) THEN o_custkey ELSE null END)) AS bitmap_union_basic
+FROM lineitem
+LEFT OUTER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND
l_shipdate = o_orderdate
+GROUP BY
+l_shipdate,
+o_orderdate,
+l_partkey,
+l_suppkey;
+```
+
+Query statement:
+
+```sql
+SELECT
+ l_shipdate, l_suppkey,
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS bitmap_union_basic
+FROM lineitem
+LEFT OUTER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND
l_shipdate = o_orderdate
+WHERE o_orderdate = '2023-12-11' AND l_partkey = 3
+GROUP BY
+l_shipdate,
+l_suppkey;
+```
+
+Temporary support for the aggregation roll-up functions is as follows:
+
+| Functions in Queries | Functions in Materialized Views | Aggregation
Functions After Rewriting |
+|----------------------|----------------------------------|---------------------------------------|
+| max | max | max
|
+| min | min | min
|
+| sum | sum | sum
|
+| count | count | sum
|
+| count(distinct ) | bitmap_union | bitmap_union_count
|
+| bitmap_union | bitmap_union | bitmap_union
|
+| bitmap_union_count | bitmap_union | bitmap_union_count
|
+
+## Query partial Transparent Rewriting (Coming soon)
+When the number of tables in the materialized view is greater than the query,
if the materialized view
+satisfies the conditions for JOIN elimination for tables more than the query,
transparent rewriting can also occur.
+For example:
+
+**Case 1**
+
+Materialized view definition:
+
+```sql
+ SELECT
+ l_linenumber,
+ o_custkey,
+ ps_availqty
+ FROM lineitem
+ LEFT OUTER JOIN orders ON L_ORDERKEY = O_ORDERKEY
+ LEFT OUTER JOIN partsupp ON l_partkey = ps_partkey
+ AND l_suppkey = ps_suppkey;
+```
+
+Query statement:
+```sql
+ SELECT
+ l_linenumber,
+ o_custkey,
+ ps_availqty
+ FROM lineitem
+ LEFT OUTER JOIN orders ON L_ORDERKEY = O_ORDERKEY;
+```
+
+## Union Rewriting (Coming soon)
+When the materialized view is not sufficient to provide all the data for the
query, it can use Union to return
+data by combining the original table and the materialized view.
+For example:
+
+**Case 1**
+
+Materialized view definition:
+
+```sql
+SELECT
+ o_orderkey,
+ o_custkey,
+ o_orderstatus,
+ o_totalprice
+FROM orders
+WHERE o_orderkey > 10;
+```
+
+Query statement:
+```sql
+SELECT
+ o_orderkey,
+ o_custkey,
+ o_orderstatus,
+ o_totalprice
+FROM orders
+WHERE o_orderkey > 5;
+```
+
+Rewriting result:
+```sql
+SELECT *
+FROM mv
+UNION ALL
+SELECT
+ o_orderkey,
+ o_custkey,
+ o_orderstatus,
+ o_totalprice
+FROM orders
+WHERE o_orderkey > 5 AND o_orderkey <= 10;
+```
+
+## Auxiliary Functions
+**Data Consistency Issues After Transparent Rewriting**
+
+For internal tables in the materialized view, you can control the maximum
delay allowed for the data used by
+the transparent rewriting by setting the grace_period property.
+Refer to
[CREATE-ASYNC-MATERIALIZED-VIEW](../../sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-ASYNC-MATERIALIZED-VIEW.md)
+
+**Viewing and Debugging Transparent Rewrite Hit Information**
+
+You can use the following statements to view the hit information of
transparent rewriting for a materialized view. It will display a concise
overview of the transparent rewriting process.
+
+`explain <query_sql>`
+
+If you want to know the detailed information about materialized view
candidates, rewriting, and the final selection process, you can execute the
following statement. It will provide a detailed breakdown of the transparent
rewriting process.
+
+`explain memo plan <query_sql>`
+
+## Relevant Environment Variables
+
+| Switch |
Description |
+|---------------------------------------------------------------------------|----------------------------------------|
+| SET enable_nereids_planner = true; |
Asynchronous materialized views are only supported under the new optimizer, so
the new optimizer needs to be enabled. |
+| SET enable_materialized_view_rewrite = true; |
Enable or disable query transparent rewriting, default is disabled
|
+| SET materialized_view_rewrite_enable_contain_external_table = true; |
Whether materialized views participating in transparent rewriting are allowed
to contain external tables, default is not allowed |
+| SET disable_nereids_rules = 'ELIMINATE_OUTER_JOIN'; |
Currently, outer join elimination has an impact on transparent |
+
+
+## Limitations
+- The materialized view definition statement only allows SELECT, FROM, WHERE,
JOIN, and GROUP BY statements, and
+the input to JOIN cannot contain GROUP BY. Only INNER and LEFT OUTER JOIN
types are currently supported; other
+types of JOIN operations will be supported gradually.
+- Materialized views based on External Tables do not guarantee strong
consistency of query results.
+- No support for rewriting non-deterministic functions, including rand, now,
current_time, current_date, random, uuid, etc.
+- No support for rewriting window functions.
+- The definition of materialized views currently cannot use views and other
materialized views.
+- Currently, WHERE condition compensation supports cases where the
materialized view has no WHERE clause, and
+the query has a WHERE clause; or the materialized view has a WHERE clause, and
the query's WHERE condition is a
+superset of the materialized view's. Currently, range condition compensation
is not yet supported,
+such as the materialized view definition being a > 5, and the query being a >
10.
\ No newline at end of file
diff --git a/docs/zh-CN/docs/query-acceleration/async-materialized-view.md
b/docs/zh-CN/docs/query-acceleration/async-materialized-view.md
index 15a222813c5..32e10f48648 100644
--- a/docs/zh-CN/docs/query-acceleration/async-materialized-view.md
+++ b/docs/zh-CN/docs/query-acceleration/async-materialized-view.md
@@ -213,4 +213,5 @@ DROP MATERIALIZED VIEW mv1;
select * FROM mv1;
```
-### 透明改写
\ No newline at end of file
+### 透明改写
+查询透明改写概述和能力可查看
[查询透明改写概述和能力](async-materialized-view/query-rewrite-summary-and-desc.md)
\ No newline at end of file
diff --git
a/docs/zh-CN/docs/query-acceleration/async-materialized-view/query-rewrite-summary-and-desc.md
b/docs/zh-CN/docs/query-acceleration/async-materialized-view/query-rewrite-summary-and-desc.md
new file mode 100644
index 00000000000..d35a5383dc8
--- /dev/null
+++
b/docs/zh-CN/docs/query-acceleration/async-materialized-view/query-rewrite-summary-and-desc.md
@@ -0,0 +1,394 @@
+---
+{
+ "title": "查询异步物化视图",
+ "language": "zh-CN"
+}
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## 概述
+Doris 的异步物化视图采用了基于 SPJG（SELECT-PROJECT-JOIN-GROUP-BY）模式的结构信息来进行透明改写的算法。
+
+Doris 可以分析查询 SQL 的结构信息，自动寻找满足要求的物化视图，并尝试进行透明改写，使用物化视图来表达查询SQL。
+
+通过使用预计算的物化视图结果，可以大幅提高查询性能，减少计算成本。
+
+以 TPC-H 的三张 lineitem，orders 和 partsupp 表来描述直接查询物化视图和使用物化视图进行查询透明改写的能力。
+表的定义如下：
+```sql
+CREATE TABLE IF NOT EXISTS lineitem (
+ l_orderkey integer not null,
+ l_partkey integer not null,
+ l_suppkey integer not null,
+ l_linenumber integer not null,
+ l_quantity decimalv3(15,2) not null,
+ l_extendedprice decimalv3(15,2) not null,
+ l_discount decimalv3(15,2) not null,
+ l_tax decimalv3(15,2) not null,
+ l_returnflag char(1) not null,
+ l_linestatus char(1) not null,
+ l_shipdate date not null,
+ l_commitdate date not null,
+ l_receiptdate date not null,
+ l_shipinstruct char(25) not null,
+ l_shipmode char(10) not null,
+ l_comment varchar(44) not null
+ )
+ DUPLICATE KEY(l_orderkey, l_partkey, l_suppkey, l_linenumber)
+ PARTITION BY RANGE(l_shipdate)
+ (FROM ('2023-10-17') TO ('2023-10-20') INTERVAL 1 DAY)
+ DISTRIBUTED BY HASH(l_orderkey) BUCKETS 3
+ PROPERTIES ("replication_num" = "1");
+```
+```sql
+CREATE TABLE IF NOT EXISTS orders (
+ o_orderkey integer not null,
+ o_custkey integer not null,
+ o_orderstatus char(1) not null,
+ o_totalprice decimalv3(15,2) not null,
+ o_orderdate date not null,
+ o_orderpriority char(15) not null,
+ o_clerk char(15) not null,
+ o_shippriority integer not null,
+ o_comment varchar(79) not null
+ )
+ DUPLICATE KEY(o_orderkey, o_custkey)
+ PARTITION BY RANGE(o_orderdate)(
+ FROM ('2023-10-17') TO ('2023-10-20') INTERVAL 1 DAY)
+ DISTRIBUTED BY HASH(o_orderkey) BUCKETS 3
+ PROPERTIES ("replication_num" = "1");
+```
+
+```sql
+ CREATE TABLE IF NOT EXISTS partsupp (
+ ps_partkey INTEGER NOT NULL,
+ ps_suppkey INTEGER NOT NULL,
+ ps_availqty INTEGER NOT NULL,
+ ps_supplycost DECIMALV3(15,2) NOT NULL,
+ ps_comment VARCHAR(199) NOT NULL
+ )
+ DUPLICATE KEY(ps_partkey, ps_suppkey)
+ DISTRIBUTED BY HASH(ps_partkey) BUCKETS 3
+ PROPERTIES (
+ "replication_num" = "1"
+ );
+```
+
+## 直查物化视图
+物化视图可以看作是表，可以像正常的表一样直接查询。
+
+**用例1:**
+
+物化视图的定义语法，详情见
[CREATE-ASYNC-MATERIALIZED-VIEW](../../sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-ASYNC-MATERIALIZED-VIEW.md)
+
+mv 定义:
+```sql
+CREATE MATERIALIZED VIEW mv1
+BUILD IMMEDIATE REFRESH AUTO ON SCHEDULE EVERY 1 hour
+DISTRIBUTED BY RANDOM BUCKETS 12
+PROPERTIES ('replication_num' = '1')
+AS
+SELECT t1.l_linenumber,
+ o_custkey,
+ o_orderdate
+FROM (SELECT * FROM lineitem WHERE l_linenumber > 1) t1
+LEFT OUTER JOIN orders
+ON l_orderkey = o_orderkey;
+```
+查询语句:
+
+可以对物化视图添加过滤条件和聚合等，进行直接查询。
+
+```sql
+SELECT l_linenumber,
+ o_custkey
+FROM mv1
+WHERE l_linenumber > 1 and o_orderdate = '2023-12-31';
+```
+
+## 透明改写能力
+### JOIN 改写
+JOIN 改写指的是查询和物化使用的表相同，可以在物化视图和查询 JOIN 的内部输入或者 JOIN 的外部写 WHERE，可以进行改写。
+
+当查询和物化视图的 Join 的类型不同时，满足一定条件时，也可以进行改写。
+
+**用例1:**
+
+如下查询可进行透明改写，条件 `l_linenumber > 1`可以上拉，从而进行透明改写，使用物化视图的预计算结果来表达查询。
+
+mv 定义:
+```sql
+SELECT t1.l_linenumber,
+ o_custkey,
+ o_orderdate
+FROM (SELECT * FROM lineitem WHERE l_linenumber > 1) t1
+LEFT OUTER JOIN orders
+ON l_orderkey = o_orderkey;
+```
+查询语句:
+```sql
+SELECT l_linenumber,
+ o_custkey
+FROM lineitem
+LEFT OUTER JOIN orders
+ON l_orderkey = o_orderkey
+WHERE l_linenumber > 1 and o_orderdate = '2023-12-31';
+```
+
+**用例2:**
+
+JOIN衍生（Coming soon）
+当查询和物化视图的 JOIN 的类型不一致时，但物化可以提供查询所需的所有数据时，通过在 JOIN 的外部补偿谓词，也可以进行透明改写，
+举例如下，待支持。
+
+mv 定义:
+```sql
+SELECT
+ l_shipdate, l_suppkey, o_orderdate
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS bitmap_union_basic
+FROM lineitem
+LEFT OUTER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND
l_shipdate = o_orderdate
+GROUP BY
+l_shipdate,
+l_suppkey,
+o_orderdate;
+```
+
+查询语句:
+```sql
+SELECT
+ l_shipdate, l_suppkey, o_orderdate
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS bitmap_union_basic
+FROM lineitem
+INNER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND l_shipdate =
o_orderdate
+WHERE o_orderdate = '2023-12-11' AND l_suppkey = 3
+GROUP BY
+l_shipdate,
+l_suppkey,
+o_orderdate;
+```
+
+### 聚合改写
+
+**用例1**
+
+如下查询可以进行透明改写，查询和物化使用聚合的维度一致，可以使用维度中的字段进行过滤结果，并且查询会尝试使用物化视图 SELECT 后的表达式。
+
+mv 定义:
+```sql
+SELECT
+ o_shippriority, o_comment,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS cnt_1,
+ count(distinct CASE WHEN O_SHIPPRIORITY > 2 AND o_orderkey IN (2) THEN
o_custkey ELSE null END) AS cnt_2,
+ sum(o_totalprice),
+ max(o_totalprice),
+ min(o_totalprice),
+ count(*)
+FROM orders
+GROUP BY
+o_shippriority,
+o_comment;
+```
+
+查询语句:
+
+```sql
+SELECT
+ o_shippriority, o_comment,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS cnt_1,
+ count(distinct CASE WHEN O_SHIPPRIORITY > 2 AND o_orderkey IN (2) THEN
o_custkey ELSE null END) AS cnt_2,
+ sum(o_totalprice),
+ max(o_totalprice),
+ min(o_totalprice),
+ count(*)
+FROM orders
+WHERE o_shippriority in (1, 2)
+GROUP BY
+o_shippriority,
+o_comment;
+```
+
+**用例2**
+
+如下查询可以进行透明改写，查询和物化使用聚合的维度不一致，物化视图使用的维度包含查询的维度。 可以使用维度中的字段进行过滤结果，
+
+查询会尝试使用物化视图 SELECT 后的函数进行上卷，如物化视图的 `bitmap_union` 最后会上卷成
`bitmap_union_count`，和查询中
+
+`count(distinct)` 的语义 保持一致。
+
+mv 定义:
+```sql
+SELECT
+ l_shipdate, o_orderdate, l_partkey, l_suppkey,
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ bitmap_union(to_bitmap(CASE WHEN o_shippriority > 1 AND o_orderkey IN (1,
3) THEN o_custkey ELSE null END)) AS bitmap_union_basic
+FROM lineitem
+LEFT OUTER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND
l_shipdate = o_orderdate
+GROUP BY
+l_shipdate,
+o_orderdate,
+l_partkey,
+l_suppkey;
+```
+
+查询语句:
+```sql
+SELECT
+ l_shipdate, l_suppkey,
+ sum(o_totalprice) AS sum_total,
+ max(o_totalprice) AS max_total,
+ min(o_totalprice) AS min_total,
+ count(*) AS count_all,
+ count(distinct CASE WHEN o_shippriority > 1 AND o_orderkey IN (1, 3) THEN
o_custkey ELSE null END) AS bitmap_union_basic
+FROM lineitem
+LEFT OUTER JOIN orders ON lineitem.l_orderkey = orders.o_orderkey AND
l_shipdate = o_orderdate
+WHERE o_orderdate = '2023-12-11' AND l_partkey = 3
+GROUP BY
+l_shipdate,
+l_suppkey;
+```
+
+暂时目前支持的聚合上卷函数列表如下：
+
+| 查询中函数 | 物化视图中函数 | 函数上卷后 |
+|--------------------|---------------|---------------------|
+| max | max | max |
+| min | min | min |
+| sum | sum | sum |
+| count | count | sum |
+| count(distinct ) | bitmap_union | bitmap_union_count |
+| bitmap_union | bitmap_union | bitmap_union |
+| bitmap_union_count | bitmap_union | bitmap_union_count |
+
+## Query partial 透明改写（Coming soon）
+当物化视图的表比查询多时，如果物化视图比查询多的表满足 JOIN 消除的条件，那么也可以进行透明改写，如下可以进行透明改写，待支持。
+
+**用例1**
+
+mv 定义:
+```sql
+ SELECT
+ l_linenumber,
+ o_custkey,
+ ps_availqty
+ FROM lineitem
+ LEFT OUTER JOIN orders ON L_ORDERKEY = O_ORDERKEY
+ LEFT OUTER JOIN partsupp ON l_partkey = ps_partkey
+ AND l_suppkey = ps_suppkey;
+```
+
+查询语句：
+```sql
+ SELECT
+ l_linenumber,
+ o_custkey,
+ ps_availqty
+ FROM lineitem
+ LEFT OUTER JOIN orders ON L_ORDERKEY = O_ORDERKEY;
+```
+
+## Union 改写（Coming soon）
+当物化视图不足以提供查询的所有数据时，可以通过 Union 的方式，将查询原表和物化视图 Union 起来返回数据，如下可以进行透明改写，待支持。
+
+**用例1**
+
+mv 定义:
+```sql
+SELECT
+ o_orderkey,
+ o_custkey,
+ o_orderstatus,
+ o_totalprice
+FROM orders
+WHERE o_orderkey > 10;
+```
+
+查询语句：
+```sql
+SELECT
+ o_orderkey,
+ o_custkey,
+ o_orderstatus,
+ o_totalprice
+FROM orders
+WHERE o_orderkey > 5;
+```
+
+改写结果示意：
+```sql
+SELECT *
+FROM mv
+UNION ALL
+SELECT
+ o_orderkey,
+ o_custkey,
+ o_orderstatus,
+ o_totalprice
+FROM orders
+WHERE o_orderkey > 5 AND o_orderkey <= 10;
+```
+
+## 辅助功能
+**透明改写后数据一致性问题**
+
+对于物化视图中的内表，可以通过设定 `grace_period`属性来控制透明改写使用的物化视图所允许数据最大的延迟时间。
+可查看
[CREATE-ASYNC-MATERIALIZED-VIEW](../../sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-ASYNC-MATERIALIZED-VIEW.md)
+
+**查询透明改写命中情况查看和调试**
+
+可通过如下语句查看物化视图的透明改写命中情况，会展示查询透明改写简要过程信息。
+
+`explain <query_sql>`
+
+如果想知道物化视图候选，改写和最终选择情况的过程详细信息，可以执行如下语句，会展示透明改写过程详细的信息。
+
+`explain memo plan <query_sql>`
+
+## 相关环境变量
+
+| 开关 | 说明
|
+|------------------------------------------------------------------------|----------------------------------------|
+| SET enable_nereids_planner = true; |
异步物化视图只有在新优化器下才支持，所以需要开启新优化器 |
+| SET enable_materialized_view_rewrite = true; |
开启或者关闭查询透明改写，默认关闭 |
+| SET materialized_view_rewrite_enable_contain_external_table = true; |
参与透明改写的物化视图是否允许包含外表，默认不允许 |
+| SET disable_nereids_rules = 'ELIMINATE_OUTER_JOIN'; | 目前
outer join 消除会对透明改写有影响，暂时需要关闭，后面会优化 |
+
+
+## 限制
+- 物化视图定义语句中只允许包含 SELECT、FROM、WHERE、JOIN、GROUP BY 语句，并且 JOIN 的输入不能包含 GROUP
BY，其中JOIN的支持的类型为
+INNER 和 LEFT OUTER JOIN 其他类型的 JOIN 操作逐步支持。
+- 基于 External Table 的物化视图不保证查询结果强一致。
+- 不支持非确定性函数的改写，包括 rand、now、current_time、current_date、random、uuid等。
+- 不支持窗口函数的改写。
+- 物化视图的定义暂时不能使用视图和物化视图。
+- 目前 WHERE 条件补偿，支持物化视图没有 WHERE，查询有 WHERE情况的条件补偿；或者物化视图有 WHERE 且查询的 WHERE
条件是物化视图的超集。
+目前暂时还不支持，范围的条件补偿，比如物化视图定义是 a > 5，查询是 a > 10。
\ No newline at end of file
diff --git a/fe/fe-core/src/main/java/org/apache/doris/mtmv/MTMVUtil.java
b/fe/fe-core/src/main/java/org/apache/doris/mtmv/MTMVUtil.java
index 06f4c1c0330..d0f002d6ada 100644
--- a/fe/fe-core/src/main/java/org/apache/doris/mtmv/MTMVUtil.java
+++ b/fe/fe-core/src/main/java/org/apache/doris/mtmv/MTMVUtil.java
@@ -258,7 +258,7 @@ public class MTMVUtil {
return res;
}
if (mtmvContainsExternalTable(mtmv) && !ctx.getSessionVariable()
- .isMaterializedViewRewriteEnableContainForeignTable()) {
+ .isMaterializedViewRewriteEnableContainExternalTable()) {
return res;
}
MTMVRelation mtmvRelation = mtmv.getRelation();
diff --git a/fe/fe-core/src/main/java/org/apache/doris/qe/SessionVariable.java
b/fe/fe-core/src/main/java/org/apache/doris/qe/SessionVariable.java
index bbe5eddaa29..9931f708db1 100644
--- a/fe/fe-core/src/main/java/org/apache/doris/qe/SessionVariable.java
+++ b/fe/fe-core/src/main/java/org/apache/doris/qe/SessionVariable.java
@@ -477,8 +477,8 @@ public class SessionVariable implements Serializable,
Writable {
public static final String ENABLE_MATERIALIZED_VIEW_REWRITE
= "enable_materialized_view_rewrite";
- public static final String
MATERIALIZED_VIEW_REWRITE_ENABLE_CONTAIN_FOREIGN_TABLE
- = "materialized_view_rewrite_enable_contain_foreign_table";
+ public static final String
MATERIALIZED_VIEW_REWRITE_ENABLE_CONTAIN_EXTERNAL_TABLE
+ = "materialized_view_rewrite_enable_contain_external_table";
public static final String ENABLE_PUSHDOWN_MINMAX_ON_UNIQUE =
"enable_pushdown_minmax_on_unique";
@@ -1480,11 +1480,11 @@ public class SessionVariable implements Serializable,
Writable {
"Whether to enable materialized view rewriting based on
struct info"})
public boolean enableMaterializedViewRewrite = false;
- @VariableMgr.VarAttr(name =
MATERIALIZED_VIEW_REWRITE_ENABLE_CONTAIN_FOREIGN_TABLE, needForward = true,
+ @VariableMgr.VarAttr(name =
MATERIALIZED_VIEW_REWRITE_ENABLE_CONTAIN_EXTERNAL_TABLE, needForward = true,
description = {"基于结构信息的透明改写，是否使用包含外表的物化视图",
"whether to use a materialized view that contains the
foreign table "
+ "when using rewriting based on struct info"})
- public boolean materializedViewRewriteEnableContainForeignTable = false;
+ public boolean materializedViewRewriteEnableContainExternalTable = false;
public static final String IGNORE_RUNTIME_FILTER_IDS =
"ignore_runtime_filter_ids";
@@ -3208,8 +3208,8 @@ public class SessionVariable implements Serializable,
Writable {
return enableMaterializedViewRewrite;
}
- public boolean isMaterializedViewRewriteEnableContainForeignTable() {
- return materializedViewRewriteEnableContainForeignTable;
+ public boolean isMaterializedViewRewriteEnableContainExternalTable() {
+ return materializedViewRewriteEnableContainExternalTable;
}
public boolean isIgnoreStorageDataDistribution() {
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
