@grepr/cli 1.8.8-78a5368 → 1.8.9-f3f8d18

package/build/dist/docs-index/{987dbf76-cf5f-4460-8fc7-a2cd64d8c827.txt → 5ffe5496-bcee-450c-bfbd-e9fcdfea7ac1.txt}

@@ -353,44 +353,44 @@ For a complete list of available functions, see [System (Built-in) Functions](ht
 
 * **`VARIANT_BUILD(path1, value1, path2, value2, ...)`**: Constructs a nested `VARIANT` value from one or more JSON path and value pairs.
 
-You can use this function to add or update attributes on a log event. When the resulting `VARIANT` is selected as a column in your `SELECT` clause that isn't one of the standard LogEvent fields, its nested structure is automatically merged into the output event's `attributes` field. Values passed to `VARIANT_BUILD` are merged into any existing attributes at the same paths. To learn more about how nonstandard computed columns are automatically added to the event's `attributes` map, see [LogEvent fields](#fields).
+  You can use this function to add or update attributes on a log event. When the resulting `VARIANT` is selected as a column in your `SELECT` clause that isn't one of the standard LogEvent fields, its nested structure is automatically merged into the output event's `attributes` field. Values passed to `VARIANT_BUILD` are merged into any existing attributes at the same paths. To learn more about how nonstandard computed columns are automatically added to the event's `attributes` map, see [LogEvent fields](#fields).
 
-* The function requires an even number of arguments greater than or equal to 2, where each pair consists of a path followed by a value.
-* Each path must be a literal string constant in JSON path syntax. The path must start with a property, for example, $.body`and not just`$`., or start with an array index, such as `$\[0]\`.
-* Values can be dynamic expressions, such as column references or function results.
-* To specify nested fields, use dot notation, such as `$.body.message`, or bracket notation, such as `$["body"]["message"]`.
-* To target array elements, include array index steps in the path, such as `$.items[0]`. Sparse indices, such as `$.items[0]` and `$.items[2]`, produce arrays with `null` values in any unfilled positions.
-* When multiple pairs share an intermediate path, they're combined into a single nested structure. If two pairs specify the same terminal path, the last value provided is used.
-* A `null` value produces an explicit `null` at the corresponding path.
+  * The function requires an even number of arguments greater than or equal to 2, where each pair consists of a path followed by a value.
+  * Each path must be a literal string constant in JSON path syntax. The path must start with a property, for example, $.body`and not just`$`., or start with an array index, such as `$\[0]\`.
+  * Values can be dynamic expressions, such as column references or function results.
+  * To specify nested fields, use dot notation, such as `$.body.message`, or bracket notation, such as `$["body"]["message"]`.
+  * To target array elements, include array index steps in the path, such as `$.items[0]`. Sparse indices, such as `$.items[0]` and `$.items[2]`, produce arrays with `null` values in any unfilled positions.
+  * When multiple pairs share an intermediate path, they're combined into a single nested structure. If two pairs specify the same terminal path, the last value provided is used.
+  * A `null` value produces an explicit `null` at the corresponding path.
 
-```sql
--- Add a single nested attribute by injecting the message column at $.body.message
-SELECT *, VARIANT_BUILD('$.body.message', message) AS merged_attrs FROM logs;
-
--- Build a nested object with multiple properties under a shared path
-SELECT *, VARIANT_BUILD('$.status.code', 200, '$.status.message', 'OK') AS merged_attrs
-FROM logs;
-
--- Build an array using indexed paths
-SELECT *, VARIANT_BUILD('$.items[0]', 'first', '$.items[1]', 'second') AS merged_attrs
-FROM logs;
-
--- Build an array of objects by combining indexed paths and nested properties
-SELECT *, VARIANT_BUILD(
-  '$.entries[0].key', 'a',
-  '$.entries[0].val', 1,
-  '$.entries[1].key', 'b'
-) AS merged_attrs FROM logs;
-
--- Use a path with special characters by using bracket notation
-SELECT *, VARIANT_BUILD('$["app.kubernetes.io/name"]', 'my-app') AS merged_attrs FROM logs;
-
--- Inject a value extracted from another VARIANT into a new path
-SELECT *, VARIANT_BUILD(
-  '$.grepr.host',
-  VARIANT_VALUE(attributes, '$["datadog.trace_payload.hostname"]', 'STRING')
-) AS merged_attrs FROM logs;
-```
+  ```sql
+  -- Add a single nested attribute by injecting the message column at $.body.message
+  SELECT *, VARIANT_BUILD('$.body.message', message) AS merged_attrs FROM logs;
+
+  -- Build a nested object with multiple properties under a shared path
+  SELECT *, VARIANT_BUILD('$.status.code', 200, '$.status.message', 'OK') AS merged_attrs
+  FROM logs;
+
+  -- Build an array using indexed paths
+  SELECT *, VARIANT_BUILD('$.items[0]', 'first', '$.items[1]', 'second') AS merged_attrs
+  FROM logs;
+
+  -- Build an array of objects by combining indexed paths and nested properties
+  SELECT *, VARIANT_BUILD(
+    '$.entries[0].key', 'a',
+    '$.entries[0].val', 1,
+    '$.entries[1].key', 'b'
+  ) AS merged_attrs FROM logs;
+
+  -- Use a path with special characters by using bracket notation
+  SELECT *, VARIANT_BUILD('$["app.kubernetes.io/name"]', 'my-app') AS merged_attrs FROM logs;
+
+  -- Inject a value extracted from another VARIANT into a new path
+  SELECT *, VARIANT_BUILD(
+    '$.grepr.host',
+    VARIANT_VALUE(attributes, '$["datadog.trace_payload.hostname"]', 'STRING')
+  ) AS merged_attrs FROM logs;
+  ```
 
 ### Numeric functions