unicode_codepoints_to_string

Use the unicode_codepoints_to_string function to convert an array of Unicode code points into a UTF-8 encoded string. This function is helpful when your data represents characters as numeric values—such as integer arrays from encodings, logs, or telemetry fields—and you want to decode them into readable text.

You can use unicode_codepoints_to_string to reconstruct log messages, parse encoded payloads, or normalize fragmented character sequences for visualization, comparison, or filtering.

Usage

Syntax

unicode_codepoints_to_string(array)

Parameters

Returns

A string constructed from the given Unicode code points using UTF-8 encoding.

Use case examples

['sample-http-logs']
| extend codepoints = dynamic([72, 84, 84, 80])
| extend decoded_method = unicode_codepoints_to_string(codepoints)
| project _time, decoded_method

['otel-demo-traces']
| where ['service.name'] == 'checkout'
| extend trace_label_codepoints = dynamic([67, 72, 69, 67, 75])
| extend decoded_label = unicode_codepoints_to_string(trace_label_codepoints)
| project _time, trace_id, ['service.name'], decoded_label

['sample-http-logs']
| extend obfuscated_uri = dynamic([47, 108, 111, 103, 105, 110])
| extend decoded_uri = unicode_codepoints_to_string(obfuscated_uri)
| project _time, uri, decoded_uri

List of related functions

• array_concat: Combines multiple arrays. Useful when merging code point arrays from different strings.
• array_length: Returns the number of elements in an array. Use it to check how many code points a string contains.
• parse_path: Parses a path into components. Use it with unicode_codepoints_from_string when decoding or inspecting URL paths.
• unicode_codepoints_from_string: Converts a UTF-8 string into an array of Unicode code points.

Other query languages