You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@druid.apache.org by te...@apache.org on 2021/12/14 22:38:54 UTC

[druid] branch master updated: Docs updates (#12069)

This is an automated email from the ASF dual-hosted git repository.

techdocsmith pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/druid.git


The following commit(s) were added to refs/heads/master by this push:
     new 4ede3bb  Docs updates (#12069)
4ede3bb is described below

commit 4ede3bbff69a9eb1e7f3108f3a46d180d783aba7
Author: Victoria Lim <vt...@users.noreply.github.com>
AuthorDate: Tue Dec 14 14:38:18 2021 -0800

    Docs updates (#12069)
    
    * minor updates to docs
    
    * remove en.json
---
 .../development/extensions-core/kafka-supervisor-operations.md |  2 +-
 docs/development/extensions-core/kafka-supervisor-reference.md |  2 +-
 docs/misc/math-expr.md                                         |  6 +++---
 docs/querying/aggregations.md                                  | 10 ++++++----
 4 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/docs/development/extensions-core/kafka-supervisor-operations.md b/docs/development/extensions-core/kafka-supervisor-operations.md
index fad3aa6..ffd4135 100644
--- a/docs/development/extensions-core/kafka-supervisor-operations.md
+++ b/docs/development/extensions-core/kafka-supervisor-operations.md
@@ -2,7 +2,7 @@
 id: kafka-supervisor-operations
 title: "Apache Kafka supervisor operations reference"
 sidebar_label: "Apache Kafka operations"
-description: "Refrence topic for running and maintaining Apache Kafka supervisors"
+description: "Reference topic for running and maintaining Apache Kafka supervisors"
 ---
 
 <!--
diff --git a/docs/development/extensions-core/kafka-supervisor-reference.md b/docs/development/extensions-core/kafka-supervisor-reference.md
index af6de03..a59177a 100644
--- a/docs/development/extensions-core/kafka-supervisor-reference.md
+++ b/docs/development/extensions-core/kafka-supervisor-reference.md
@@ -2,7 +2,7 @@
 id: kafka-supervisor-reference
 title: "Apache Kafka supervisor reference"
 sidebar_label: "Apache Kafka supervisor"
-description: "Refrence topic for Apache Kafka supervisors"
+description: "Reference topic for Apache Kafka supervisors"
 ---
 
 <!--
diff --git a/docs/misc/math-expr.md b/docs/misc/math-expr.md
index 14cbc03..97b800b 100644
--- a/docs/misc/math-expr.md
+++ b/docs/misc/math-expr.md
@@ -243,13 +243,13 @@ type of the result:
 
 ## IP address functions
 
-For the IPv4 address functions, the `address` argument can either be an IPv4 dotted-decimal string (e.g., "192.168.0.1") or an IP address represented as a long (e.g., 3232235521). The `subnet` argument should be a string formatted as an IPv4 address subnet in CIDR notation (e.g., "192.168.0.0/16").
+For the IPv4 address functions, the `address` argument accepts either an IPv4 dotted-decimal string (e.g., "192.168.0.1") or an IP address represented as a long (e.g., 3232235521). Format the `subnet` argument as an IPv4 address subnet in CIDR notation (e.g., "192.168.0.0/16").
 
 | function | description |
 | --- | --- |
 | ipv4_match(address, subnet) | Returns 1 if the `address` belongs to the `subnet` literal, else 0. If `address` is not a valid IPv4 address, then 0 is returned. This function is more efficient if `address` is a long instead of a string.|
-| ipv4_parse(address) | Parses `address` into an IPv4 address stored as a long. If `address` is a long that is a valid IPv4 address, then it is passed through. Returns null if `address` cannot be represented as an IPv4 address. |
-| ipv4_stringify(address) | Converts `address` into an IPv4 address dotted-decimal string. If `address` is a string that is a valid IPv4 address, then it is passed through. Returns null if `address` cannot be represented as an IPv4 address.|
+| ipv4_parse(address) | Parses `address` into an IPv4 address stored as a long. Returns `address` if it is already a valid IPv4 integer address.  Returns null if `address` cannot be represented as an IPv4 address. |
+| ipv4_stringify(address) | Converts `address` into an IPv4 address dotted-decimal string. Returns `address` if it is already a valid IPv4 dotted-decimal string. Returns null if `address` cannot be represented as an IPv4 address.|
 
 ## Other functions
 
diff --git a/docs/querying/aggregations.md b/docs/querying/aggregations.md
index 7057ed9..5286e79 100644
--- a/docs/querying/aggregations.md
+++ b/docs/querying/aggregations.md
@@ -33,6 +33,8 @@ You can use aggregations:
 
 The following sections list the available aggregate functions. Unless otherwise noted, aggregations are available at both ingestion and query time.
 
+## Exact aggregations
+
 ### Count aggregator
 
 `count` computes the count of Druid rows that match the filters.
@@ -339,7 +341,7 @@ JavaScript functions are expected to return floating-point values.
 
 <a name="approx"></a>
 
-## Approximate Aggregations
+## Approximate aggregations
 
 ### Count distinct
 
@@ -416,9 +418,9 @@ It is not possible to determine a priori how well this aggregator will behave fo
 
 For these reasons, we have deprecated this aggregator and recommend using the DataSketches Quantiles aggregator instead for new and existing use cases, although we will continue to support Approximate Histogram for backwards compatibility.
 
-## Miscellaneous Aggregations
+## Miscellaneous aggregations
 
-### Filtered Aggregator
+### Filtered aggregator
 
 A filtered aggregator wraps any given aggregator, but only aggregates the values for which the given dimension filter matches.
 
@@ -438,7 +440,7 @@ This makes it possible to compute the results of a filtered and an unfiltered ag
 }
 ```
 
-### Grouping Aggregator
+### Grouping aggregator
 
 A grouping aggregator can only be used as part of GroupBy queries which have a subtotal spec. It returns a number for
 each output row that lets you infer whether a particular dimension is included in the sub-grouping used for that row. You can pass

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@druid.apache.org
For additional commands, e-mail: commits-help@druid.apache.org