0 / 0
Volver a la versión inglesa de la documentación
Vía de acceso JSON
Última actualización: 09 abr 2021
Vía de acceso JSON

Debe editar el esquema de salida de un operador, de modo que coincida con el nombre y el tipo de los atributos enviados por dicho operador.

La ventana Editar esquema se abre cuando pulsa en edit_schema en el panel Propiedades de estos operadores.

Puede volver a ordenar, añadir y eliminar atributos del esquema de datos a medida que fluye entre los operadores.

En la ventana Editar esquema, Vía de acceso JSON es una vía de acceso de acuerdo con la especificación de JSON Pointer. Define una sintaxis de serie para identificar un valor específico dentro de un JSON.

Vía de acceso JSON en la ventana Editar esquema

El fragmento de código siguiente es un documento JSON de ejemplo.

{
  "title": "Some Book",
  "publisher": {
    "name": "Wiki"
  },
  "authors": [
    { "names": ["Smith", "John"] },
    { "names": ["Doe", "Jane"] }
  ]
} 

La vía de acceso JSON define una sintaxis de serie que está precedida por '/'. La vía de acceso se utiliza para identificar un valor específico dentro de un documento JSON.

Utilizando el documento JSON de ejemplo, el siguiente fragmento de código muestra cuál es la vía de acceso JSON para extraer valores.

/title                  "Some Book"
/publisher/name         "Wiki"
/authors/0/names/0      "Smith"
/authors/0/names/1      "John"
/authors/1/names/1      "Jane"
/authors/1/names/42     ""  (es un valor vacío, no un error) 

Atributos predefinidos

Algunos operadores de origen tienen atributos de metadata predefinidos en su salida, además de un atributo data predefinido. El editor de esquemas los presenta junto con cualquier atributo basado en JSON, pero sus expresiones de vía de acceso identifican los atributos predefinidos en lugar de los valores de JSON. Puede cambiar el nombre de atributo de los atributos de metadatos predefinidos, pero no la vía de acceso ni el tipo.

En función del formato de análisis seleccionado, el atributo data se analiza automáticamente durante la ingestión o se envía en secuencia como datos sin formato. En la tabla siguiente se describe el impacto de la selección del formato de análisis en la detección de esquemas:

Analizar
valor
Atributos de esquema de salida detectados (predeterminado)
Atributos de metadatos predefinidos
Atributo de datos predefinidos Atributos de JSON extraídos
JSON no
Ninguno no

Para ver un ejemplo ilustrativo con el operador de origen HTTP, consulte Análisis del cuerpo de respuesta HTTP.

En la tabla siguiente se muestra la propiedad de selección de análisis y los atributos predefinidos de varios operadores de origen:

Operador de origen Propiedad de selección de análisis Atributo de datos predefinidos Atributos de metadatos predefinidos
Event Streams, Kafka Análisis del valor de registro event_message event_key
event_topic
event_offset
event_partition
event_timestamp
       
HTTP Análisis del cuerpo de la respuesta http_body http_status_code
http_reason
http_headers
MQTT Análisis de carga útil de mensajes event_message event_topic
Watson IoT Análisis de carga útil de sucesos event_jsonString event_typeId
event_deviceId
event_eventId

Más información