¿Odias los anuncios? Ir Sin publicidad Hoy 

Formateador y validador de esquema de Apache Avro

DatosDesarrolladorTexto

[iotools_apache_avro_schema_formatter_validator]

Guía

Formulador y validador de esquemas de Apache Avro

Pega un esquema JSON de Apache Avro y obtén una versión bien formateada y validada contra la especificación oficial de Avro en tu navegador. Esta herramienta detecta problemas que un linter de JSON simple o un modelo de lenguaje (LLM) omitiría: uniones de tipos inválidas, valores por defecto que no coinciden con la primera rama de la unión, nombres de campos duplicados, referencias a tipos nombrados no resueltas, símbolos de enumeración que violan las reglas de nomenclatura, y más.

También produce el Formato de análisis definido por la especificación de Avro, que es la representación determinista utilizada para la huella digital de esquemas y para comprobaciones de compatibilidad entre productores y consumidores.

Cómo Usar

Pega tu .avsc el esquema (un documento JSON) en el área de entrada, o arrastra un archivo al subida.
Elige el estilo de sangría que deseas para la salida formateada: 2 espacios, 4 espacios, una tabulación o completamente minimizado.
Opcionalmente marca Ordenar las claves del objeto alfabéticamente para diferencias deterministas entre revisiones de esquema.
Marcar Salida en Formato de análisis cuando necesitas la entrada de huella digital definida por la especificación. Las opciones de sangría y ordenación se ignoran en este modo.
Lee la barra de estado verde/roja que está encima de la salida — muestra si es válido o no, así como el número de registros, campos, enumeraciones, uniones y fijos. Las advertencias (como un valor por defecto no nulo que no coincide con la primera rama de la unión) aparecen debajo.
Utiliza el botón de copiar o descargar en la salida para exportar el esquema formateado.

Características

Validación estricta según la especificación de Avro — verifica los tipos primitivos y complejos, la sintaxis de nombres y espacios de nombres, las reglas de las ramas de unión y la detección de tipos nombrados duplicados.
Compatibilidad de valores por defecto — verifica cada valor por defecto de campo contra su tipo declarado, con manejo especial de la regla de la primera rama de la unión.
Resolución de tipos nombrados — resuelve referencias como com.example.User contra definiciones anteriores en el mismo documento.
Formato de análisis — emite el JSON determinista definido por la especificación, utilizado para huellas digitales de esquemas.
Opciones de formateo — salida con 2/4 espacios, tabulación o minimizada, con orden alfabético opcional de claves para diferencias estables.
Estadísticas en línea — los conteos de registros, campos, enumeraciones, uniones y fijos se muestran después de cada validación.
Funciona completamente en tu navegador — no se sube ningún esquema a un servidor, por lo que esta herramienta es segura para esquemas propietarios o internos.

ANUNCIO · ¿ELIMINAR?

 Preguntas frecuentes

¿Qué es Apache Avro?

Apache Avro es un sistema de serialización de datos basado en filas que se utiliza ampliamente en los ecosistemas de Hadoop y Kafka. Describe los datos con un esquema en formato JSON y serializa los payloads a un formato binario compacto. El esquema viaja con (o se referencia) los datos, lo que hace que Avro sea popular en pipelines de datos en evolución.
¿Por qué los valores por defecto de Avro deben coincidir con la primera rama de una unión?

Los lectores de Avro resuelven una unión comparando el índice de la rama del escritor con el índice compatible del lector. Cuando un campo no está presente en los datos, el lector no tiene índice para consultar, por lo que la especificación exige que el valor por defecto sea representable como la primera rama de la unión del lector. Por eso, los campos nulos se escriben convencionalmente como ['null', T] con un valor por defecto nulo.
¿Qué es el Formato de análisis?

Es una serialización normalizada en formato JSON definida por la especificación de Avro. Los nombres cortos se reemplazan por nombres completamente calificados, se eliminan atributos no esenciales como doc y aliases, se fija el orden de las claves y se eliminan todos los espacios en blanco. Dos esquemas producen el mismo formato analítico (y la misma huella digital) cuando son semanticamente equivalentes, incluso si sus JSON originales difieren.
¿Cómo se resuelven los espacios de nombres?

Un nombre sin punto se califica con el espacio de nombres más cercano y más estrecho. Un nombre que contiene un punto se trata como un nombre completo y se utiliza tal cual. Cada registro, enumeración y fijo debe tener un nombre completo único dentro del documento de esquema.
¿Se soportan tipos lógicos?

Los tipos lógicos como decimal, fecha, tiempo-milisegundos y marca de tiempo-milisegundos son tipos primitivos de Avro con anotaciones adicionales. Esta herramienta valida el tipo primitivo subyacente y conserva los metadatos del tipo lógico en la salida formateada, pero no enforces las restricciones específicas de tipo lógico (por ejemplo, precisión y escala de decimal).