Browse Source

ES|QL: provide snapshot_only info for functions (Kibana) (#113544) (#113927)

Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Luigi Dell'Aquila 1 year ago
parent
commit
458dd4afe3
100 changed files with 379 additions and 95 deletions
  1. 5 0
      docs/reference/esql/functions/description/categorize.asciidoc
  2. 5 0
      docs/reference/esql/functions/description/qstr.asciidoc
  3. 13 0
      docs/reference/esql/functions/examples/qstr.asciidoc
  4. 3 1
      docs/reference/esql/functions/kibana/definition/abs.json
  5. 3 1
      docs/reference/esql/functions/kibana/definition/acos.json
  6. 3 1
      docs/reference/esql/functions/kibana/definition/add.json
  7. 3 1
      docs/reference/esql/functions/kibana/definition/asin.json
  8. 3 1
      docs/reference/esql/functions/kibana/definition/atan.json
  9. 3 1
      docs/reference/esql/functions/kibana/definition/atan2.json
  10. 3 1
      docs/reference/esql/functions/kibana/definition/avg.json
  11. 3 1
      docs/reference/esql/functions/kibana/definition/bucket.json
  12. 3 1
      docs/reference/esql/functions/kibana/definition/case.json
  13. 34 0
      docs/reference/esql/functions/kibana/definition/categorize.json
  14. 3 1
      docs/reference/esql/functions/kibana/definition/cbrt.json
  15. 3 1
      docs/reference/esql/functions/kibana/definition/ceil.json
  16. 3 1
      docs/reference/esql/functions/kibana/definition/cidr_match.json
  17. 3 1
      docs/reference/esql/functions/kibana/definition/coalesce.json
  18. 3 1
      docs/reference/esql/functions/kibana/definition/concat.json
  19. 3 1
      docs/reference/esql/functions/kibana/definition/cos.json
  20. 3 1
      docs/reference/esql/functions/kibana/definition/cosh.json
  21. 3 1
      docs/reference/esql/functions/kibana/definition/count.json
  22. 3 1
      docs/reference/esql/functions/kibana/definition/count_distinct.json
  23. 3 1
      docs/reference/esql/functions/kibana/definition/date_diff.json
  24. 3 1
      docs/reference/esql/functions/kibana/definition/date_extract.json
  25. 3 1
      docs/reference/esql/functions/kibana/definition/date_format.json
  26. 3 1
      docs/reference/esql/functions/kibana/definition/date_parse.json
  27. 3 1
      docs/reference/esql/functions/kibana/definition/date_trunc.json
  28. 3 1
      docs/reference/esql/functions/kibana/definition/div.json
  29. 3 1
      docs/reference/esql/functions/kibana/definition/e.json
  30. 3 1
      docs/reference/esql/functions/kibana/definition/ends_with.json
  31. 3 1
      docs/reference/esql/functions/kibana/definition/equals.json
  32. 3 1
      docs/reference/esql/functions/kibana/definition/exp.json
  33. 3 1
      docs/reference/esql/functions/kibana/definition/floor.json
  34. 3 1
      docs/reference/esql/functions/kibana/definition/from_base64.json
  35. 3 1
      docs/reference/esql/functions/kibana/definition/greater_than.json
  36. 3 1
      docs/reference/esql/functions/kibana/definition/greater_than_or_equal.json
  37. 3 1
      docs/reference/esql/functions/kibana/definition/greatest.json
  38. 3 1
      docs/reference/esql/functions/kibana/definition/in.json
  39. 3 1
      docs/reference/esql/functions/kibana/definition/ip_prefix.json
  40. 3 1
      docs/reference/esql/functions/kibana/definition/least.json
  41. 3 1
      docs/reference/esql/functions/kibana/definition/left.json
  42. 3 1
      docs/reference/esql/functions/kibana/definition/length.json
  43. 3 1
      docs/reference/esql/functions/kibana/definition/less_than.json
  44. 3 1
      docs/reference/esql/functions/kibana/definition/less_than_or_equal.json
  45. 3 1
      docs/reference/esql/functions/kibana/definition/like.json
  46. 3 1
      docs/reference/esql/functions/kibana/definition/locate.json
  47. 3 1
      docs/reference/esql/functions/kibana/definition/log.json
  48. 3 1
      docs/reference/esql/functions/kibana/definition/log10.json
  49. 3 1
      docs/reference/esql/functions/kibana/definition/ltrim.json
  50. 3 1
      docs/reference/esql/functions/kibana/definition/max.json
  51. 3 1
      docs/reference/esql/functions/kibana/definition/median.json
  52. 3 1
      docs/reference/esql/functions/kibana/definition/median_absolute_deviation.json
  53. 3 1
      docs/reference/esql/functions/kibana/definition/min.json
  54. 3 1
      docs/reference/esql/functions/kibana/definition/mod.json
  55. 3 1
      docs/reference/esql/functions/kibana/definition/mul.json
  56. 3 1
      docs/reference/esql/functions/kibana/definition/mv_append.json
  57. 3 1
      docs/reference/esql/functions/kibana/definition/mv_avg.json
  58. 3 1
      docs/reference/esql/functions/kibana/definition/mv_concat.json
  59. 3 1
      docs/reference/esql/functions/kibana/definition/mv_count.json
  60. 3 1
      docs/reference/esql/functions/kibana/definition/mv_dedupe.json
  61. 3 1
      docs/reference/esql/functions/kibana/definition/mv_first.json
  62. 3 1
      docs/reference/esql/functions/kibana/definition/mv_last.json
  63. 3 1
      docs/reference/esql/functions/kibana/definition/mv_max.json
  64. 3 1
      docs/reference/esql/functions/kibana/definition/mv_median.json
  65. 3 1
      docs/reference/esql/functions/kibana/definition/mv_median_absolute_deviation.json
  66. 3 1
      docs/reference/esql/functions/kibana/definition/mv_min.json
  67. 3 1
      docs/reference/esql/functions/kibana/definition/mv_percentile.json
  68. 3 1
      docs/reference/esql/functions/kibana/definition/mv_pseries_weighted_sum.json
  69. 3 1
      docs/reference/esql/functions/kibana/definition/mv_slice.json
  70. 3 1
      docs/reference/esql/functions/kibana/definition/mv_sort.json
  71. 3 1
      docs/reference/esql/functions/kibana/definition/mv_sum.json
  72. 3 1
      docs/reference/esql/functions/kibana/definition/mv_zip.json
  73. 3 1
      docs/reference/esql/functions/kibana/definition/neg.json
  74. 3 1
      docs/reference/esql/functions/kibana/definition/not_equals.json
  75. 3 1
      docs/reference/esql/functions/kibana/definition/now.json
  76. 3 1
      docs/reference/esql/functions/kibana/definition/percentile.json
  77. 3 1
      docs/reference/esql/functions/kibana/definition/pi.json
  78. 3 1
      docs/reference/esql/functions/kibana/definition/pow.json
  79. 37 0
      docs/reference/esql/functions/kibana/definition/qstr.json
  80. 3 1
      docs/reference/esql/functions/kibana/definition/repeat.json
  81. 3 1
      docs/reference/esql/functions/kibana/definition/replace.json
  82. 3 1
      docs/reference/esql/functions/kibana/definition/right.json
  83. 3 1
      docs/reference/esql/functions/kibana/definition/rlike.json
  84. 3 1
      docs/reference/esql/functions/kibana/definition/round.json
  85. 3 1
      docs/reference/esql/functions/kibana/definition/rtrim.json
  86. 3 1
      docs/reference/esql/functions/kibana/definition/signum.json
  87. 3 1
      docs/reference/esql/functions/kibana/definition/sin.json
  88. 3 1
      docs/reference/esql/functions/kibana/definition/sinh.json
  89. 3 1
      docs/reference/esql/functions/kibana/definition/space.json
  90. 3 1
      docs/reference/esql/functions/kibana/definition/split.json
  91. 3 1
      docs/reference/esql/functions/kibana/definition/sqrt.json
  92. 3 1
      docs/reference/esql/functions/kibana/definition/st_centroid_agg.json
  93. 3 1
      docs/reference/esql/functions/kibana/definition/st_contains.json
  94. 3 1
      docs/reference/esql/functions/kibana/definition/st_disjoint.json
  95. 3 1
      docs/reference/esql/functions/kibana/definition/st_distance.json
  96. 3 1
      docs/reference/esql/functions/kibana/definition/st_intersects.json
  97. 3 1
      docs/reference/esql/functions/kibana/definition/st_within.json
  98. 3 1
      docs/reference/esql/functions/kibana/definition/st_x.json
  99. 3 1
      docs/reference/esql/functions/kibana/definition/st_y.json
  100. 3 1
      docs/reference/esql/functions/kibana/definition/starts_with.json

+ 5 - 0
docs/reference/esql/functions/description/categorize.asciidoc

@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Categorizes text messages.

+ 5 - 0
docs/reference/esql/functions/description/qstr.asciidoc

@@ -0,0 +1,5 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Description*
+
+Performs a query string query. Returns true if the provided query string matches the row.

+ 13 - 0
docs/reference/esql/functions/examples/qstr.asciidoc

@@ -0,0 +1,13 @@
+// This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.
+
+*Example*
+
+[source.merge.styled,esql]
+----
+include::{esql-specs}/qstr-function.csv-spec[tag=qstr-with-field]
+----
+[%header.monospaced.styled,format=dsv,separator=|]
+|===
+include::{esql-specs}/qstr-function.csv-spec[tag=qstr-with-field-result]
+|===
+

+ 3 - 1
docs/reference/esql/functions/kibana/definition/abs.json

@@ -56,5 +56,7 @@
   "examples" : [
     "ROW number = -1.0 \n| EVAL abs_number = ABS(number)",
     "FROM employees\n| KEEP first_name, last_name, height\n| EVAL abs_height = ABS(0.0 - height)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/acos.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=.9\n| EVAL acos=ACOS(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/add.json

@@ -292,5 +292,7 @@
       "variadic" : false,
       "returnType" : "unsigned_long"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/asin.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=.9\n| EVAL asin=ASIN(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/atan.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=12.9\n| EVAL atan=ATAN(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/atan2.json

@@ -295,5 +295,7 @@
   ],
   "examples" : [
     "ROW y=12.9, x=.6\n| EVAL atan2=ATAN2(y, x)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/avg.json

@@ -44,5 +44,7 @@
   "examples" : [
     "FROM employees\n| STATS AVG(height)",
     "FROM employees\n| STATS avg_salary_change = ROUND(AVG(MV_AVG(salary_change)), 10)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/bucket.json

@@ -1293,5 +1293,7 @@
     "FROM sample_data \n| WHERE @timestamp >= NOW() - 1 day and @timestamp < NOW()\n| STATS COUNT(*) BY bucket = BUCKET(@timestamp, 25, NOW() - 1 day, NOW())",
     "FROM employees\n| WHERE hire_date >= \"1985-01-01T00:00:00Z\" AND hire_date < \"1986-01-01T00:00:00Z\"\n| STATS AVG(salary) BY bucket = BUCKET(hire_date, 20, \"1985-01-01T00:00:00Z\", \"1986-01-01T00:00:00Z\")\n| SORT bucket",
     "FROM employees\n| STATS s1 = b1 + 1, s2 = BUCKET(salary / 1000 + 999, 50.) + 2 BY b1 = BUCKET(salary / 100 + 99, 50.), b2 = BUCKET(salary / 1000 + 999, 50.)\n| SORT b1, b2\n| KEEP s1, b1, s2, b2"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/case.json

@@ -597,5 +597,7 @@
     "FROM employees\n| EVAL type = CASE(\n    languages <= 1, \"monolingual\",\n    languages <= 2, \"bilingual\",\n     \"polyglot\")\n| KEEP emp_no, languages, type",
     "FROM sample_data\n| EVAL successful = CASE(\n    STARTS_WITH(message, \"Connected to\"), 1,\n    message == \"Connection error\", 0\n  )\n| STATS success_rate = AVG(successful)",
     "FROM sample_data\n| EVAL error = CASE(message LIKE \"*error*\", 1, 0)\n| EVAL hour = DATE_TRUNC(1 hour, @timestamp)\n| STATS error_rate = AVG(error) by hour\n| SORT hour"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 34 - 0
docs/reference/esql/functions/kibana/definition/categorize.json

@@ -0,0 +1,34 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "categorize",
+  "description" : "Categorizes text messages.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "field",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Expression to categorize"
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "integer"
+    },
+    {
+      "params" : [
+        {
+          "name" : "field",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Expression to categorize"
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "integer"
+    }
+  ],
+  "preview" : false,
+  "snapshot_only" : true
+}

+ 3 - 1
docs/reference/esql/functions/kibana/definition/cbrt.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW d = 1000.0\n| EVAL c = cbrt(d)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/ceil.json

@@ -56,5 +56,7 @@
   ],
   "examples" : [
     "ROW a=1.8\n| EVAL a=CEIL(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/cidr_match.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM hosts \n| WHERE CIDR_MATCH(ip1, \"127.0.0.2/32\", \"127.0.0.3/32\") \n| KEEP card, host, ip0, ip1"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/coalesce.json

@@ -283,5 +283,7 @@
   ],
   "examples" : [
     "ROW a=null, b=\"b\"\n| EVAL COALESCE(a, b)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/concat.json

@@ -79,5 +79,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP first_name, last_name\n| EVAL fullname = CONCAT(first_name, \" \", last_name)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/cos.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=1.8 \n| EVAL cos=COS(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/cosh.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=1.8 \n| EVAL cosh=COSH(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/count.json

@@ -155,5 +155,7 @@
     "ROW words=\"foo;bar;baz;qux;quux;foo\"\n| STATS word_count = COUNT(SPLIT(words, \";\"))",
     "ROW n=1\n| WHERE n < 0\n| STATS COUNT(n)",
     "ROW n=1\n| STATS COUNT(n > 0 OR NULL), COUNT(n < 0 OR NULL)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/count_distinct.json

@@ -603,5 +603,7 @@
     "FROM hosts\n| STATS COUNT_DISTINCT(ip0), COUNT_DISTINCT(ip1)",
     "FROM hosts\n| STATS COUNT_DISTINCT(ip0, 80000), COUNT_DISTINCT(ip1, 5)",
     "ROW words=\"foo;bar;baz;qux;quux;foo\"\n| STATS distinct_word_count = COUNT_DISTINCT(SPLIT(words, \";\"))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/date_diff.json

@@ -56,5 +56,7 @@
   "examples" : [
     "ROW date1 = TO_DATETIME(\"2023-12-02T11:00:00.000Z\"), date2 = TO_DATETIME(\"2023-12-02T11:00:00.001Z\")\n| EVAL dd_ms = DATE_DIFF(\"microseconds\", date1, date2)",
     "ROW end_23=\"2023-12-31T23:59:59.999Z\"::DATETIME,\n  start_24=\"2024-01-01T00:00:00.000Z\"::DATETIME,\n    end_24=\"2024-12-31T23:59:59.999\"::DATETIME\n| EVAL end23_to_start24=DATE_DIFF(\"year\", end_23, start_24)\n| EVAL end23_to_end24=DATE_DIFF(\"year\", end_23, end_24)\n| EVAL start_to_end_24=DATE_DIFF(\"year\", start_24, end_24)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/date_extract.json

@@ -44,5 +44,7 @@
   "examples" : [
     "ROW date = DATE_PARSE(\"yyyy-MM-dd\", \"2022-05-06\")\n| EVAL year = DATE_EXTRACT(\"year\", date)",
     "FROM sample_data\n| WHERE DATE_EXTRACT(\"hour_of_day\", @timestamp) < 9 AND DATE_EXTRACT(\"hour_of_day\", @timestamp) >= 17"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/date_format.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP first_name, last_name, hire_date\n| EVAL hired = DATE_FORMAT(\"yyyy-MM-dd\", hire_date)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/date_parse.json

@@ -79,5 +79,7 @@
   ],
   "examples" : [
     "ROW date_string = \"2022-05-06\"\n| EVAL date = DATE_PARSE(\"yyyy-MM-dd\", date_string)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/date_trunc.json

@@ -45,5 +45,7 @@
     "FROM employees\n| KEEP first_name, last_name, hire_date\n| EVAL year_hired = DATE_TRUNC(1 year, hire_date)",
     "FROM employees\n| EVAL year = DATE_TRUNC(1 year, hire_date)\n| STATS hires = COUNT(emp_no) BY year\n| SORT year",
     "FROM sample_data\n| EVAL error = CASE(message LIKE \"*error*\", 1, 0)\n| EVAL hour = DATE_TRUNC(1 hour, @timestamp)\n| STATS error_rate = AVG(error) by hour\n| SORT hour"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/div.json

@@ -185,5 +185,7 @@
       "variadic" : false,
       "returnType" : "unsigned_long"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/e.json

@@ -11,5 +11,7 @@
   ],
   "examples" : [
     "ROW E()"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/ends_with.json

@@ -79,5 +79,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP last_name\n| EVAL ln_E = ENDS_WITH(last_name, \"d\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/equals.json

@@ -401,5 +401,7 @@
       "variadic" : false,
       "returnType" : "boolean"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/exp.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW d = 5.0\n| EVAL s = EXP(d)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/floor.json

@@ -56,5 +56,7 @@
   ],
   "examples" : [
     "ROW a=1.8\n| EVAL a=FLOOR(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/from_base64.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "row a = \"ZWxhc3RpYw==\" \n| eval d = from_base64(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/greater_than.json

@@ -311,5 +311,7 @@
       "variadic" : false,
       "returnType" : "boolean"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/greater_than_or_equal.json

@@ -311,5 +311,7 @@
       "variadic" : false,
       "returnType" : "boolean"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/greatest.json

@@ -212,5 +212,7 @@
   ],
   "examples" : [
     "ROW a = 10, b = 20\n| EVAL g = GREATEST(a, b)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/in.json

@@ -259,5 +259,7 @@
   ],
   "examples" : [
     "ROW a = 1, b = 4, c = 3\n| WHERE c-a IN (3, b / 2, a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/ip_prefix.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "row ip4 = to_ip(\"1.2.3.4\"), ip6 = to_ip(\"fe80::cae2:65ff:fece:feb9\")\n| eval ip4_prefix = ip_prefix(ip4, 24, 0), ip6_prefix = ip_prefix(ip6, 0, 112);"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/least.json

@@ -211,5 +211,7 @@
   ],
   "examples" : [
     "ROW a = 10, b = 20\n| EVAL l = LEAST(a, b)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/left.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP last_name\n| EVAL left = LEFT(last_name, 3)\n| SORT last_name ASC\n| LIMIT 5"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/length.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP first_name, last_name\n| EVAL fn_length = LENGTH(first_name)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/less_than.json

@@ -311,5 +311,7 @@
       "variadic" : false,
       "returnType" : "boolean"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/less_than_or_equal.json

@@ -311,5 +311,7 @@
       "variadic" : false,
       "returnType" : "boolean"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/like.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM employees\n| WHERE first_name LIKE \"?b*\"\n| KEEP first_name, last_name"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/locate.json

@@ -175,5 +175,7 @@
   ],
   "examples" : [
     "row a = \"hello\"\n| eval a_ll = locate(a, \"ll\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/log.json

@@ -344,5 +344,7 @@
   "examples" : [
     "ROW base = 2.0, value = 8.0\n| EVAL s = LOG(base, value)",
     "row value = 100\n| EVAL s = LOG(value);"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/log10.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW d = 1000.0 \n| EVAL s = LOG10(d)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/ltrim.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "ROW message = \"   some text  \",  color = \" red \"\n| EVAL message = LTRIM(message)\n| EVAL color = LTRIM(color)\n| EVAL message = CONCAT(\"'\", message, \"'\")\n| EVAL color = CONCAT(\"'\", color, \"'\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/max.json

@@ -116,5 +116,7 @@
   "examples" : [
     "FROM employees\n| STATS MAX(languages)",
     "FROM employees\n| STATS max_avg_salary_change = MAX(MV_AVG(salary_change))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/median.json

@@ -45,5 +45,7 @@
   "examples" : [
     "FROM employees\n| STATS MEDIAN(salary), PERCENTILE(salary, 50)",
     "FROM employees\n| STATS median_max_salary_change = MEDIAN(MV_MAX(salary_change))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/median_absolute_deviation.json

@@ -45,5 +45,7 @@
   "examples" : [
     "FROM employees\n| STATS MEDIAN(salary), MEDIAN_ABSOLUTE_DEVIATION(salary)",
     "FROM employees\n| STATS m_a_d_max_salary_change = MEDIAN_ABSOLUTE_DEVIATION(MV_MAX(salary_change))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/min.json

@@ -116,5 +116,7 @@
   "examples" : [
     "FROM employees\n| STATS MIN(languages)",
     "FROM employees\n| STATS min_avg_salary_change = MIN(MV_AVG(salary_change))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mod.json

@@ -184,5 +184,7 @@
       "variadic" : false,
       "returnType" : "unsigned_long"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mul.json

@@ -184,5 +184,7 @@
       "variadic" : false,
       "returnType" : "unsigned_long"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_append.json

@@ -238,5 +238,7 @@
       "variadic" : false,
       "returnType" : "version"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_avg.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=[3, 5, 1, 6]\n| EVAL avg_a = MV_AVG(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_concat.json

@@ -80,5 +80,7 @@
   "examples" : [
     "ROW a=[\"foo\", \"zoo\", \"bar\"]\n| EVAL j = MV_CONCAT(a, \", \")",
     "ROW a=[10, 9, 8]\n| EVAL j = MV_CONCAT(TO_STRING(a), \", \")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_count.json

@@ -175,5 +175,7 @@
   ],
   "examples" : [
     "ROW a=[\"foo\", \"zoo\", \"bar\"]\n| EVAL count_a = MV_COUNT(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_dedupe.json

@@ -164,5 +164,7 @@
   ],
   "examples" : [
     "ROW a=[\"foo\", \"foo\", \"bar\", \"foo\"]\n| EVAL dedupe_a = MV_DEDUPE(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_first.json

@@ -175,5 +175,7 @@
   ],
   "examples" : [
     "ROW a=\"foo;bar;baz\"\n| EVAL first_a = MV_FIRST(SPLIT(a, \";\"))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_last.json

@@ -175,5 +175,7 @@
   ],
   "examples" : [
     "ROW a=\"foo;bar;baz\"\n| EVAL last_a = MV_LAST(SPLIT(a, \";\"))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_max.json

@@ -128,5 +128,7 @@
   "examples" : [
     "ROW a=[3, 5, 1]\n| EVAL max_a = MV_MAX(a)",
     "ROW a=[\"foo\", \"zoo\", \"bar\"]\n| EVAL max_a = MV_MAX(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_median.json

@@ -56,5 +56,7 @@
   "examples" : [
     "ROW a=[3, 5, 1]\n| EVAL median_a = MV_MEDIAN(a)",
     "ROW a=[3, 7, 1, 6]\n| EVAL median_a = MV_MEDIAN(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_median_absolute_deviation.json

@@ -56,5 +56,7 @@
   ],
   "examples" : [
     "ROW values = [0, 2, 5, 6]\n| EVAL median_absolute_deviation = MV_MEDIAN_ABSOLUTE_DEVIATION(values), median = MV_MEDIAN(values)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_min.json

@@ -128,5 +128,7 @@
   "examples" : [
     "ROW a=[2, 1]\n| EVAL min_a = MV_MIN(a)",
     "ROW a=[\"foo\", \"bar\"]\n| EVAL min_a = MV_MIN(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_percentile.json

@@ -169,5 +169,7 @@
   ],
   "examples" : [
     "ROW values = [5, 5, 10, 12, 5000]\n| EVAL p50 = MV_PERCENTILE(values, 50), median = MV_MEDIAN(values)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_pseries_weighted_sum.json

@@ -25,5 +25,7 @@
   ],
   "examples" : [
     "ROW a = [70.0, 45.0, 21.0, 21.0, 21.0]\n| EVAL sum = MV_PSERIES_WEIGHTED_SUM(a, 1.5)\n| KEEP sum"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_slice.json

@@ -320,5 +320,7 @@
   "examples" : [
     "row a = [1, 2, 2, 3]\n| eval a1 = mv_slice(a, 1), a2 = mv_slice(a, 2, 3)",
     "row a = [1, 2, 2, 3]\n| eval a1 = mv_slice(a, -2), a2 = mv_slice(a, -3, -1)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_sort.json

@@ -169,5 +169,7 @@
   ],
   "examples" : [
     "ROW a = [4, 2, -3, 2]\n| EVAL sa = mv_sort(a), sd = mv_sort(a, \"DESC\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_sum.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=[3, 5, 6]\n| EVAL sum_a = MV_SUM(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/mv_zip.json

@@ -271,5 +271,7 @@
   ],
   "examples" : [
     "ROW a = [\"x\", \"y\", \"z\"], b = [\"1\", \"2\"]\n| EVAL c = mv_zip(a, b, \"-\")\n| KEEP a, b, c"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/neg.json

@@ -64,5 +64,7 @@
       "variadic" : false,
       "returnType" : "time_duration"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/not_equals.json

@@ -401,5 +401,7 @@
       "variadic" : false,
       "returnType" : "boolean"
     }
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/now.json

@@ -12,5 +12,7 @@
   "examples" : [
     "ROW current_date = NOW()",
     "FROM sample_data\n| WHERE @timestamp > NOW() - 1 hour"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/percentile.json

@@ -170,5 +170,7 @@
   "examples" : [
     "FROM employees\n| STATS p0 = PERCENTILE(salary,  0)\n     , p50 = PERCENTILE(salary, 50)\n     , p99 = PERCENTILE(salary, 99)",
     "FROM employees\n| STATS p80_max_salary_change = PERCENTILE(MV_MAX(salary_change), 80)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/pi.json

@@ -11,5 +11,7 @@
   ],
   "examples" : [
     "ROW PI()"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/pow.json

@@ -297,5 +297,7 @@
   "examples" : [
     "ROW base = 2.0, exponent = 2\n| EVAL result = POW(base, exponent)",
     "ROW base = 4, exponent = 0.5\n| EVAL s = POW(base, exponent)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 37 - 0
docs/reference/esql/functions/kibana/definition/qstr.json

@@ -0,0 +1,37 @@
+{
+  "comment" : "This is generated by ESQL's AbstractFunctionTestCase. Do no edit it. See ../README.md for how to regenerate it.",
+  "type" : "eval",
+  "name" : "qstr",
+  "description" : "Performs a query string query. Returns true if the provided query string matches the row.",
+  "signatures" : [
+    {
+      "params" : [
+        {
+          "name" : "query",
+          "type" : "keyword",
+          "optional" : false,
+          "description" : "Query string in Lucene query string format."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    },
+    {
+      "params" : [
+        {
+          "name" : "query",
+          "type" : "text",
+          "optional" : false,
+          "description" : "Query string in Lucene query string format."
+        }
+      ],
+      "variadic" : false,
+      "returnType" : "boolean"
+    }
+  ],
+  "examples" : [
+    "from books \n| where qstr(\"author: Faulkner\")\n| keep book_no, author \n| sort book_no \n| limit 5;"
+  ],
+  "preview" : true,
+  "snapshot_only" : true
+}

+ 3 - 1
docs/reference/esql/functions/kibana/definition/repeat.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "ROW a = \"Hello!\"\n| EVAL triple_a = REPEAT(a, 3);"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/replace.json

@@ -199,5 +199,7 @@
   ],
   "examples" : [
     "ROW str = \"Hello World\"\n| EVAL str = REPLACE(str, \"World\", \"Universe\")\n| KEEP str"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/right.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP last_name\n| EVAL right = RIGHT(last_name, 3)\n| SORT last_name ASC\n| LIMIT 5"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/rlike.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM employees\n| WHERE first_name RLIKE \".leja.*\"\n| KEEP first_name, last_name"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/round.json

@@ -109,5 +109,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP first_name, last_name, height\n| EVAL height_ft = ROUND(height * 3.281, 1)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/rtrim.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "ROW message = \"   some text  \",  color = \" red \"\n| EVAL message = RTRIM(message)\n| EVAL color = RTRIM(color)\n| EVAL message = CONCAT(\"'\", message, \"'\")\n| EVAL color = CONCAT(\"'\", color, \"'\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/signum.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW d = 100.0\n| EVAL s = SIGNUM(d)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/sin.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=1.8 \n| EVAL sin=SIN(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/sinh.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW a=1.8 \n| EVAL sinh=SINH(a)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/space.json

@@ -19,5 +19,7 @@
   ],
   "examples" : [
     "ROW message = CONCAT(\"Hello\", SPACE(1), \"World!\");"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/split.json

@@ -79,5 +79,7 @@
   ],
   "examples" : [
     "ROW words=\"foo;bar;baz;qux;quux;corge\"\n| EVAL word = SPLIT(words, \";\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/sqrt.json

@@ -55,5 +55,7 @@
   ],
   "examples" : [
     "ROW d = 100.0\n| EVAL s = SQRT(d)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_centroid_agg.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "FROM airports\n| STATS centroid=ST_CENTROID_AGG(location)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_contains.json

@@ -151,5 +151,7 @@
   ],
   "examples" : [
     "FROM airport_city_boundaries\n| WHERE ST_CONTAINS(city_boundary, TO_GEOSHAPE(\"POLYGON((109.35 18.3, 109.45 18.3, 109.45 18.4, 109.35 18.4, 109.35 18.3))\"))\n| KEEP abbrev, airport, region, city, city_location"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_disjoint.json

@@ -151,5 +151,7 @@
   ],
   "examples" : [
     "FROM airport_city_boundaries\n| WHERE ST_DISJOINT(city_boundary, TO_GEOSHAPE(\"POLYGON((-10 -60, 120 -60, 120 60, -10 60, -10 -60))\"))\n| KEEP abbrev, airport, region, city, city_location"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_distance.json

@@ -43,5 +43,7 @@
   ],
   "examples" : [
     "FROM airports\n| WHERE abbrev == \"CPH\"\n| EVAL distance = ST_DISTANCE(location, city_location)\n| KEEP abbrev, name, location, city_location, distance"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_intersects.json

@@ -151,5 +151,7 @@
   ],
   "examples" : [
     "FROM airports\n| WHERE ST_INTERSECTS(location, TO_GEOSHAPE(\"POLYGON((42 14, 43 14, 43 15, 42 15, 42 14))\"))"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_within.json

@@ -151,5 +151,7 @@
   ],
   "examples" : [
     "FROM airport_city_boundaries\n| WHERE ST_WITHIN(city_boundary, TO_GEOSHAPE(\"POLYGON((109.1 18.15, 109.6 18.15, 109.6 18.65, 109.1 18.65, 109.1 18.15))\"))\n| KEEP abbrev, airport, region, city, city_location"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_x.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "ROW point = TO_GEOPOINT(\"POINT(42.97109629958868 14.7552534006536)\")\n| EVAL x =  ST_X(point), y = ST_Y(point)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/st_y.json

@@ -31,5 +31,7 @@
   ],
   "examples" : [
     "ROW point = TO_GEOPOINT(\"POINT(42.97109629958868 14.7552534006536)\")\n| EVAL x =  ST_X(point), y = ST_Y(point)"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

+ 3 - 1
docs/reference/esql/functions/kibana/definition/starts_with.json

@@ -79,5 +79,7 @@
   ],
   "examples" : [
     "FROM employees\n| KEEP last_name\n| EVAL ln_S = STARTS_WITH(last_name, \"B\")"
-  ]
+  ],
+  "preview" : false,
+  "snapshot_only" : false
 }

Some files were not shown because too many files changed in this diff