From 199f5c4c3bbbe6b607c727b7e0ce7f987084c2a0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Istv=C3=A1n=20Zolt=C3=A1n=20Szab=C3=B3?= Date: Mon, 19 Sep 2022 15:22:48 +0200 Subject: [PATCH] [DOCS] Adds missing_bucket setting to transform APIs (#90111) --- docs/reference/rest-api/common-parms.asciidoc | 3 +++ docs/reference/transform/apis/preview-transform.asciidoc | 3 ++- docs/reference/transform/apis/put-transform.asciidoc | 4 ++-- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/reference/rest-api/common-parms.asciidoc b/docs/reference/rest-api/common-parms.asciidoc index c750abb7c3ba1..419fe1e5ad908 100644 --- a/docs/reference/rest-api/common-parms.asciidoc +++ b/docs/reference/rest-api/common-parms.asciidoc @@ -725,6 +725,9 @@ The following groupings are currently supported: * <<_histogram,Histogram>> * <<_terms,Terms>> +The grouping properties can optionally have a `missing_bucket` property. If +it's `true`, documents without a value in the respective `group_by` field are +included. Defaults to `false`. -- end::pivot-group-by[] diff --git a/docs/reference/transform/apis/preview-transform.asciidoc b/docs/reference/transform/apis/preview-transform.asciidoc index 3045e7e11cdf0..a5d3c55e7c01e 100644 --- a/docs/reference/transform/apis/preview-transform.asciidoc +++ b/docs/reference/transform/apis/preview-transform.asciidoc @@ -286,7 +286,8 @@ POST _transform/_preview "group_by": { "customer_id": { "terms": { - "field": "customer_id" + "field": "customer_id", + "missing_bucket": true } } }, diff --git a/docs/reference/transform/apis/put-transform.asciidoc b/docs/reference/transform/apis/put-transform.asciidoc index fdfe98f585f29..260bdf0c10f80 100644 --- a/docs/reference/transform/apis/put-transform.asciidoc +++ b/docs/reference/transform/apis/put-transform.asciidoc @@ -155,7 +155,6 @@ include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot-aggs] `group_by`::: (Required, object) include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=pivot-group-by] - ==== //End pivot @@ -296,7 +295,8 @@ PUT _transform/ecommerce_transform1 "group_by": { "customer_id": { "terms": { - "field": "customer_id" + "field": "customer_id", + "missing_bucket": true } } },