This is an automated email from the ASF dual-hosted git repository.
kfaraz pushed a commit to branch 25.0.0
in repository https://gitbox.apache.org/repos/asf/druid.git
The following commit(s) were added to refs/heads/25.0.0 by this push:
new 38e5fad989 Experimental features backport (#13443) (#13348)
38e5fad989 is described below
commit 38e5fad98989f31a55201c160ab9e456beda8886
Author: Jill Osborne <[email protected]>
AuthorDate: Tue Nov 29 02:29:42 2022 +0000
Experimental features backport (#13443) (#13348)
* Update and document experimental features
(cherry picked from commit ccbf3abee9a341d8f5c80f37e7506088f10252bf)
* Updated
(cherry picked from commit d7b8fae15fc389ddbac1a57121ff965adb63f2af)
* Update experimental-features.md
* Updated after review
(cherry picked from commit 975ae240ca2c1e008cd0ef7ad968beb6edd3413c)
* Updated
(cherry picked from commit eb8268ec44490134c16656245b8f73a8fcb550f6)
* Update materialized-view.md
(cherry picked from commit 53c3bde505abc861d22896b46204b65ec1e7851f)
* Update experimental-features.md
(cherry picked from commit 77148f7e97f5e1bef6a3474ee698ce37e6213307)
---
docs/configuration/index.md | 4 +-
docs/development/experimental-features.md | 68 ++++++++++++++++++++++
docs/development/extensions-core/druid-lookups.md | 3 -
.../extensions-core/kafka-supervisor-reference.md | 2 -
.../extensions-core/kinesis-ingestion.md | 2 -
docs/querying/lookups.md | 4 +-
6 files changed, 72 insertions(+), 11 deletions(-)
diff --git a/docs/configuration/index.md b/docs/configuration/index.md
index 6fb3201d98..8ac9382b7e 100644
--- a/docs/configuration/index.md
+++ b/docs/configuration/index.md
@@ -1375,7 +1375,7 @@ For GCE's properties, please refer to the
[gce-extensions](../development/extens
This section contains the configuration options for the processes that reside
on Data servers (MiddleManagers/Peons and Historicals) in the suggested
[three-server configuration](../design/processes.md#server-types).
-Configuration options for the experimental [Indexer
process](../design/indexer.md) are also provided here.
+Configuration options for the [Indexer process](../design/indexer.md) are also
provided here.
### MiddleManager and Peons
@@ -2188,7 +2188,7 @@ Supported query contexts:
|Key|Description|Default|
|---|-----------|-------|
|`druid.expressions.useStrictBooleans`|Controls the behavior of Druid boolean
operators and functions, if set to `true` all boolean values will be either a
`1` or `0`. See [expression
documentation](../misc/math-expr.md#logical-operator-modes)|false|
-|`druid.expressions.allowNestedArrays`|If enabled, Druid array expressions can
create nested arrays. This is experimental and should be used with
caution.|false|
+|`druid.expressions.allowNestedArrays`|If enabled, Druid array expressions can
create nested arrays.|false|
### Router
#### Router Process Configs
diff --git a/docs/development/experimental-features.md
b/docs/development/experimental-features.md
new file mode 100644
index 0000000000..a68fc47411
--- /dev/null
+++ b/docs/development/experimental-features.md
@@ -0,0 +1,68 @@
+---
+id: experimental-features
+title: "Experimental features"
+---
+
+<!--
+ ~ 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.
+ -->
+
+The following features are marked [experimental](./experimental.md) in the
Druid docs.
+
+This document includes each page that mentions an experimental feature. To
graduate a feature, remove all mentions of its experimental status on all
relevant pages.
+
+Note that this document does not track the status of contrib extensions, some
of which are experimental.
+
+## SQL-based ingestion
+
+- [SQL-based ingestion](../multi-stage-query/index.md)
+- [SQL-based ingestion concepts](../multi-stage-query/concepts.md)
+- [SQL-based ingestion and multi-stage query task
API](../multi-stage-query/api.md)
+
+## Nested columns
+
+- [Nested columns](../querying/nested-columns.md)
+
+## Indexer process
+
+- [Indexer process](../design/indexer.md)
+- [Processes and servers](../design/processes.md#indexer-process-optional)
+
+## Kubernetes
+
+- [Kubernetes](../development/extensions-core/kubernetes.md)
+
+## Segment locking
+
+- [Configuration reference](../configuration/index.md#overlord-operations)
+- [Task reference](../ingestion/tasks.md#locking)
+- [Design](../design/architecture.md#availability-and-consistency)
+
+## Moments sketch
+
+- [Aggregations](../querying/aggregations.md#moments-sketch-experimental)
+
+## Front coding
+
+- [Ingestion spec reference](../ingestion/ingestion-spec.md#front-coding)
+
+## Other configuration properties
+
+- [Configuration reference](../configuration/index.md)
+ - `CLOSED_SEGMENTS_SINKS` mode
+ - Expression processing configuration `druid.expressions.allowNestedArrays`
diff --git a/docs/development/extensions-core/druid-lookups.md
b/docs/development/extensions-core/druid-lookups.md
index b44f9620bd..5b19508c23 100644
--- a/docs/development/extensions-core/druid-lookups.md
+++ b/docs/development/extensions-core/druid-lookups.md
@@ -22,9 +22,6 @@ title: "Cached Lookup Module"
~ under the License.
-->
-
-> Please note that this is an experimental module and the development/testing
still at early stage. Feel free to try it and give us your feedback.
-
## Description
This Apache Druid module provides a per-lookup caching mechanism for JDBC data
sources.
The main goal of this cache is to speed up the access to a high latency lookup
sources and to provide a caching isolation for every lookup source.
diff --git a/docs/development/extensions-core/kafka-supervisor-reference.md
b/docs/development/extensions-core/kafka-supervisor-reference.md
index 210207302f..9dc80d0c65 100644
--- a/docs/development/extensions-core/kafka-supervisor-reference.md
+++ b/docs/development/extensions-core/kafka-supervisor-reference.md
@@ -56,8 +56,6 @@ This topic contains configuration reference information for
the Apache Kafka sup
## Task Autoscaler Properties
-> Note that Task AutoScaler is currently designated as experimental.
-
| Property | Description | Required |
| ------------- | ------------- | ------------- |
| `enableTaskAutoScaler` | Enable or disable autoscaling. `false` or blank
disables the `autoScaler` even when `autoScalerConfig` is not null| no (default
== false) |
diff --git a/docs/development/extensions-core/kinesis-ingestion.md
b/docs/development/extensions-core/kinesis-ingestion.md
index 84036665ec..31682b54a2 100644
--- a/docs/development/extensions-core/kinesis-ingestion.md
+++ b/docs/development/extensions-core/kinesis-ingestion.md
@@ -149,8 +149,6 @@ Where the file `supervisor-spec.json` contains a Kinesis
supervisor spec:
#### Task Autoscaler Properties
-> Note that Task AutoScaler is currently designated as experimental.
-
| Property | Description | Required |
| ------------- | ------------- | ------------- |
| `enableTaskAutoScaler` | Enable or disable the auto scaler. When false or
absent, Druid disables the `autoScaler` even when `autoScalerConfig` is not
null.| no (default == false) |
diff --git a/docs/querying/lookups.md b/docs/querying/lookups.md
index 57b406afb1..860a3ed2e2 100644
--- a/docs/querying/lookups.md
+++ b/docs/querying/lookups.md
@@ -115,8 +115,8 @@ will not detect this automatically.
Dynamic Configuration
---------------------
-> Dynamic lookup configuration is an
[experimental](../development/experimental.md) feature. Static
-> configuration is no longer supported.
+> Static configuration is no longer supported.
+
The following documents the behavior of the cluster-wide config which is
accessible through the Coordinator.
The configuration is propagated through the concept of "tier" of servers.
A "tier" is defined as a group of services which should receive a set of
lookups.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]