Skip to content

Commit 3697ddb

Browse files
committed
[7.2][DOCS] Adds more validation details for data frame transforms (#44714) (#44727)
1 parent 27cfe78 commit 3697ddb

File tree

2 files changed

+12
-0
lines changed

2 files changed

+12
-0
lines changed

docs/reference/data-frames/apis/put-transform.asciidoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,11 @@ structure (known as a {dataframe}). The ID for each document in the
4040
per entity. For more information, see
4141
{stack-ov}/ml-dataframes.html[{dataframe-transforms-cap}].
4242

43+
When the {dataframe-transform} is created, a series of validations occur to
44+
ensure its success. For example, there is a check for the existence of the
45+
source indices and a check that the destination index is not part of the source
46+
index pattern.
47+
4348
IMPORTANT: You must use {kib} or this API to create a {dataframe-transform}.
4449
Do not put a {dataframe-transform} directly into any
4550
`.data-frame-internal*` indices using the Elasticsearch index API.

docs/reference/data-frames/apis/start-transform.asciidoc

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,13 @@ aggregations, the transform uses dynamic mappings unless a template exists or
4141
the destination index already exists. Mapping definitions in the destination
4242
index take precedence over dynamic mappings and templates.
4343

44+
When a {dataframe-transform} starts, a series of validations occur to ensure its
45+
success. However, there are no initial privilege checks. When {es}
46+
{security-features} are enabled, the {dataframe-transform} remembers which roles
47+
the user that created it had at the time of creation and uses those same roles.
48+
If those roles do not have the required privileges on the source and destination
49+
indices, the {dataframe-transform} fails when it attempts unauthorized operations.
50+
4451
[[start-data-frame-transform-path-parms]]
4552
==== {api-path-parms-title}
4653

0 commit comments

Comments
 (0)