El tipo de datos dynamic
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
El dynamic tipo de datos escalar puede ser cualquiera de los siguientes valores:
- Una matriz de valores de
dynamic, que contienen cero o más valores con una indización de base cero. - Un contenedor de propiedades que asigna valores
stringúnicos a valoresdynamic. El contenedor de propiedades tiene cero o más asignaciones de este tipo (denominadas "ranuras"), indizadas según los valoresstringúnicos. Las ranuras no están ordenadas. - Un valor de cualquiera de los tipos de datos escalares primitivos:
bool,datetime,guid,int,long,real,stringytimespan. - NULL. Para obtener más información, vea Valores NULL.
Nota:
- Los valores de tipo
dynamicse limitan a 1 MB (2^20), sin comprimir. Si un valor de celda de un registro supera los 1 MB, el valor se quita y la ingesta se realiza correctamente. Puede aumentar elMaxValueSizede la columna cambiando su directiva de codificación. - Aunque el
dynamictipo aparece similar a JSON, puede contener valores que el modelo JSON no representa porque no existen en JSON (por ejemplolong, ,real,datetime,timespanyguid). Por lo tanto, al serializar valoresdynamicen una representación JSON, los valores que JSON no puede representar se serializan como valoresstring. Por el contrario, Kusto analizará las cadenas como valores fuertemente tipados si se pueden analizar de ese modo. Esto se aplica adatetimelos tipos ,real,longyguid. Para obtener más información sobre el modelo de objetos JSON, consulte json.org. - Kusto no intenta conservar el orden de las asignaciones de partes nombre-valor en un contenedor de propiedades, por lo que no se puede asumir que el orden se conservará. Por lo tanto, es posible que dos contenedores de propiedades con el mismo conjunto de asignaciones produzcan resultados diferentes cuando se representan como valores
string, por ejemplo.
Literales dinámicos
Para especificar un dynamic literal, use una de las siguientes opciones de sintaxis:
| Sintaxis | Descripción | Ejemplo |
|---|---|---|
dynamic([value [, ...]]) |
Matriz de literales dinámicos u otros literales escalares. | dynamic([1, 2, "hello"]) |
dynamic({key = value [, ...]}) |
Contenedor de propiedades o objeto. El valor de una clave puede ser un contenedor de propiedades anidado. | dynamic({"a":1, "b":{"a":2}}) |
dynamic(value) |
Valor dinámico que contiene el valor del tipo de datos escalar interno. | dynamic(4) |
dynamic(null) |
Representa el valor NULL. |
Obtenga más información sobre las convenciones de sintaxis.
Descriptores de acceso del objeto dinámico
Para genera el subíndice de un diccionario, use la notación de puntos (dict.key) o la notación de corchetes (dict["key"]). Cuando el subíndice es una constante de cadena, ambas opciones son intercambiables.
Nota:
Para usar una expresión como subíndice, use la notación de corchetes. Al usar expresiones aritméticas, la expresión dentro de los corchetes se debe incluir entre paréntesis.
En los ejemplos siguientes, dict y arr son columnas de tipo dynamic:
| Expression | Tipo de expresión del descriptor de acceso | Significado | Comentarios |
|---|---|---|---|
| dict[col] | Nombre de entidad (columna) | Genera el subíndice de un diccionario usando los valores de la columna col como clave. |
La columna debe ser de tipo cadena. |
| arr[index] | Índice de entidad (columna) | Genera el subíndice de una matriz usando los valores de la columna index como índice. |
La columna debe ser de tipo entero o booleano. |
| arr[-index] | Índice de entidad (columna) | Recupera el valor en la posición "index" a partir del final de la matriz. | La columna debe ser de tipo entero o booleano. |
| arr[(-1)] | Índice de entidad | Recupera el último valor de la matriz. | |
| arr[toint(indexAsString)] | Llamada a función | Convierte los valores de la columna indexAsString en int y los usa para generar el subíndice de una matriz. |
|
| dict[['where']] | Palabra clave usada como nombre de entidad (columna) | Genera el subíndice de un diccionario usando los valores de la columna where como clave. |
Los nombres de entidad que sean idénticos a algunas palabras clave del lenguaje de consulta deben ir entre comillas. |
| dict.['where'] o dict['where'] | Constante | Genera el subíndice de un diccionario que usa la cadena where como clave. |
Sugerencia
Se recomienda usar subíndices constantes siempre que sea posible.
El acceso al subobjeto de un valor dynamic produce otro valor dynamic, incluso si el subobjeto tiene un tipo subyacente diferente. Use la función gettype para detectar el tipo subyacente real del valor y cualquiera de las funciones de conversión que se enumeran a continuación para convertirlo al tipo real.
Conversión de objetos dinámicos
Después de generar el subíndice de un objeto dinámico, debe convertir el valor en un tipo simple.
| Expression | Valor | Tipo |
|---|---|---|
| X | parse_json('[100,101,102]') | array |
| X[0] | parse_json('100') | dynamic |
| toint(X[1]) | 101 | int |
| Y | parse_json('{"a1":100, "a b c":"2015-01-01"}') | diccionario |
| Y.a1 | parse_json('100') | dynamic |
| Y["a b c"] | parse_json("2015-01-01") | dynamic |
| todate(Y["a b c"]) | datetime(2015-01-01) | datetime |
Las funciones de conversión son:
tolong()todouble()todatetime()totimespan()tostring()toguid()parse_json()
Creación de objetos dinámicos
Varias funciones permiten crear nuevos objetos dynamic:
- bag_pack() crea un contenedor de propiedades a partir de pares nombre-valor.
- pack_array() crea una matriz a partir de la lista de valores (puede ser una lista de columnas, para cada fila que creará una matriz a partir de las columnas especificadas).
- range() crea una matriz con una serie aritmética de números.
- zip() empareja valores "paralelos" de dos matrices en una sola matriz.
- repeat() crea una matriz con un valor repetido.
Además, hay varias funciones de agregado que crean matrices de tipo dynamic para contener valores agregados:
- buildschema() devuelve el esquema de agregado de varios valores
dynamic. - make_bag() devuelve un contenedor de propiedades de los valores dinámicos dentro del grupo.
- make_bag_if() devuelve un contenedor de propiedades de los valores dinámicos dentro del grupo (con un predicado).
- make_list() devuelve una matriz que contiene todos los valores, en secuencia.
- make_list_if() devuelve una matriz que contiene todos los valores, en secuencia (con un predicado).
- make_list_if() devuelve una matriz que contiene todos los valores, en secuencia (con un predicado).
- make_set() devuelve una matriz que contiene todos los valores únicos.
- make_set_if() devuelve una matriz que contiene todos los valores únicos (con un predicado).
Operadores y funciones en tipos dinámicos
Para obtener una lista completa de las funciones escalares dinámicas o matriciales, vea funciones dinámicas o matrices.
| Operador o función | Uso con tipos de datos dinámicos |
|---|---|
matriz de valores in |
True si hay un elemento de matriz que == value where City in ('London', 'Paris', 'Rome') |
matriz de valores !in |
True si no hay ningún elemento de la matriz que == value |
array_length(array) |
Es null si no es una matriz |
bag_has_key(llave de bolsa,) |
Comprueba si una columna de contenedor dinámico contiene una clave determinada. |
bag_keys(bag) |
Enumera todas las claves raíz de un objeto de contenedor de propiedades dinámicas. |
bag_merge(bag1,...,bagN) |
Combina contenedores de propiedades dinámicas en un contenedor de propiedades dinámicas con todas las propiedades combinadas. |
bag_set_key(bag,key,value) |
Establece una clave determinada en un valor determinado en un contenedor de propiedades dinámico. |
extract_json(path,object), extract_json(path,object) |
Use la ruta de acceso para navegar al objeto . |
parse_json(source) |
Convierte una cadena JSON en un objeto dinámico. |
range(from,to,step) |
Matriz de valores . |
mv-expand listColumn |
Replica una fila para cada valor de una lista en una celda especificada. |
summarize buildschema(column) |
Deduce el esquema de tipo del contenido de columna. |
summarize make_bag(column) |
Combina los valores del contenedor de propiedades (diccionario) de la columna en un solo contenedor de propiedades, sin claves duplicadas. |
summarize make_bag_if(column,predicate) |
Combina los valores del contenedor de propiedades (diccionario) de la columna en un solo contenedor de propiedades, sin claves duplicadas (con un predicado). |
summarize make_list(column) |
Acopla grupos de filas y coloca los valores de la columna en una matriz. |
summarize make_list_if(column,predicate) |
Aplana grupos de filas y coloca los valores de la columna en una matriz (con un predicado). |
summarize make_list_with_nulls(column) |
Aplana grupos de filas y coloca los valores de la columna en una matriz, incluidos los valores NULL. |
summarize make_set(column) |
Acopla grupos de filas y coloca los valores de la columna en una matriz, sin duplicación. |
Indexación de datos dinámicos
Cada campo se indexa durante la ingesta de datos. El ámbito del índice es una sola partición de datos.
Para indexar columnas dinámicas, el proceso de ingesta enumera todos los elementos "atomic" dentro del valor dinámico (nombres de propiedad, valores, elementos de matriz) y los reenvía al generador de índices. De lo contrario, los campos dinámicos tienen el mismo índice de término invertido que los campos de cadena.
Ejemplos
Contenedor de propiedades dinámicas
La consulta siguiente crea un contenedor de propiedades dinámicos.
print o=dynamic({"a":123, "b":"hello", "c":[1,2,3], "d":{}})
| extend a=o.a, b=o.b, c=o.c, d=o.d
Para mayor comodidad, los literales dynamic que aparecen en el propio texto de la consulta también pueden incluir otros literales de Kusto de los siguientes tipos: datetime, timespan, real, long, guid, bool y dynamic.
Esta extensión a través de JSON no está disponible cuando se analizan cadenas (como cuando se usa la función parse_json o se ingieren datos), pero se puede hacer lo siguiente:
print d=dynamic({"a": datetime(1970-05-11)})
Para analizar un valor string que sigue las reglas de codificación JSON en un valor dynamic, use la función parse_json. Por ejemplo:
parse_json('[43, 21, 65]'): Una matriz de números.parse_json('{"name":"Alan", "age":21, "address":{"street":432,"postcode":"JLK32P"}}'): un diccionario.parse_json('21'): Un valor único de tipo dinámico que contiene un número.parse_json('"21"'): Un valor único de tipo dinámico que contiene una cadena.parse_json('{"a":123, "b":"hello", "c":[1,2,3], "d":{}}'): proporciona el mismo valor queoen el ejemplo anterior.
Nota:
A diferencia de JavaScript, JSON requiere el uso de caracteres entre comillas dobles (") alrededor de cadenas y nombres de propiedad de contenedor de propiedades. Por lo tanto, generalmente es más fácil citar literales de cadena codificados en JSON con el carácter de comillas simples (').
Ingesta de datos en columnas dinámicas
En el ejemplo siguiente se muestra cómo se puede definir una tabla que contiene una dynamic columna (así como una datetime columna) y, a continuación, ingerir un único registro en ella. También muestra cómo puede codificar cadenas JSON en archivos CSV.
// dynamic is just like any other type:
.create table Logs (Timestamp:datetime, Trace:dynamic)
// Everything between the "[" and "]" is parsed as a CSV line would be:
// 1. Since the JSON string includes double-quotes and commas (two characters
// that have a special meaning in CSV), we must CSV-quote the entire second field.
// 2. CSV-quoting means adding double-quotes (") at the immediate beginning and end
// of the field (no spaces allowed before the first double-quote or after the second
// double-quote!)
// 3. CSV-quoting also means doubling-up every instance of a double-quotes within
// the contents.
.ingest inline into table Logs
[2015-01-01,"{""EventType"":""Demo"", ""EventValue"":""Double-quote love!""}"]
Salida
| Marca de tiempo | Seguimiento |
|---|---|
| 2015-01-01 00:00:00.0000000 | {"EventType":"Demo","EventValue":"Double-quote love!"} |
Contenido relacionado
- Para obtener un ejemplo sobre cómo consultar mediante objetos dinámicos y descriptores de acceso de objetos, vea Asignar valores de un conjunto a otro.