@@ -28,12 +28,21 @@ PUT idx
28
28
29
29
While this on the fly reconstruction is *generally* slower than saving the source
30
30
documents verbatim and loading them at query time, it saves a lot of storage
31
- space. There are a couple of restrictions to be aware of:
31
+ space.
32
+
33
+ [[synthetic-source-restrictions]]
34
+ ===== Synthetic `_source` restrictions
35
+
36
+ There are a couple of restrictions to be aware of:
32
37
33
38
* When you retrieve synthetic `_source` content it undergoes minor
34
39
<<synthetic-source-modifications,modifications>> compared to the original JSON.
35
40
* The `params._source` is unavailable in scripts. Instead use the
36
- {painless}/painless-field-context.html[`doc`] API or the <<script-fields-api, `field`>>.
41
+ {painless}/painless-field-context.html[`doc`] API or the <<script-fields-api,`field` API>>.
42
+ * Runtime fields <<runtime-fields-scriptless,without a script>>, and runtime
43
+ fields that access `_source` are currently not supported for indices that use
44
+ synthetic `_source`. Use a scripted runtime field that accesses fields <<modules-scripting-doc-vals,using doc values>> or the
45
+ <<script-fields-api,`field` API>> instead.
37
46
* Synthetic `_source` can be used with indices that contain only these field
38
47
types:
39
48
59
68
** <<version-synthetic-source,`version`>>
60
69
** <<wildcard-synthetic-source,`wildcard`>>
61
70
62
- Runtime fields cannot, at this stage, use synthetic `_source`.
63
-
64
71
[[synthetic-source-modifications]]
65
72
===== Synthetic `_source` modifications
66
73
0 commit comments