CLI del schema
Saiku incluye una pequeña herramienta de schema dentro del jar del launcher. Convierte un schema de Mondrian entre XML y YAML, y lo valida antes de que lo suba. Tres subcomandos, sin servidor, y lo bastante rápida para ponerla en un hook de git.
Ejecútela directamente desde el jar que ya tiene:
java -cp saiku-<version>.jar mondrian.schema.yaml.SchemaCli <command>Eso es mucho que teclear más de una vez, así que los ejemplos de abajo asumen un alias de shell:
alias mondrian-schema='java -cp /path/to/saiku-<version>.jar mondrian.schema.yaml.SchemaCli'Comandos
to-yaml — convertir XML a YAML
mondrian-schema to-yaml <input.xml> [-o output.yaml]Lee un schema Mondrian-4 XML y escribe la representación YAML equivalente. Si se omite -o, el YAML se escribe a stdout.
Ejemplo — convertir FoodMart:
mondrian-schema to-yaml demo/FoodMart.mondrian.xml -o demo/FoodMart.yamlEjemplo — vista previa sin guardar:
mondrian-schema to-yaml demo/FoodMart.mondrian.xml | head -40to-xml — convertir YAML a XML
mondrian-schema to-xml <input.yaml> [-o output.xml]Lee un schema Mondrian-4 YAML y escribe el XML equivalente. Si se omite -o, el XML se escribe a stdout. Esta es la misma conversión que el motor de Saiku ejecuta automáticamente en tiempo de ejecución — ejecutarla manualmente es útil para inspeccionar la salida antes de desplegar o para migrar de vuelta a una toolchain nativa de XML.
Ejemplo — convertir de vuelta a XML:
mondrian-schema to-xml demo/FoodMart.yaml -o FoodMart-generated.xmlEjemplo — pipe a un diff para verificar la fidelidad del round-trip:
mondrian-schema to-xml demo/FoodMart.yaml | diff demo/FoodMart.mondrian.xml -lint — validar un archivo de schema
mondrian-schema lint <input.{yaml,xml}>Parsea y valida un archivo de schema — YAML o XML. Los errores y advertencias se escriben a stderr. En caso de éxito, el comando sale silenciosamente con código 0.
Ejemplo — validar un schema YAML:
mondrian-schema lint demo/FoodMart.yamlEjemplo — validar un schema XML:
mondrian-schema lint demo/FoodMart.mondrian.xmlCódigos de salida
| Código | Significado |
|---|---|
0 | Éxito — sin errores |
1 | Argumentos incorrectos o archivo de entrada ausente |
2 | Fallo de parseo o validación — diagnóstico escrito a stderr |
Estos códigos son adecuados para uso en pipelines CI y hooks pre-guardado.
Flujos típicos
-
Convierta su schema XML existente a YAML:
Ventana de terminal mondrian-schema to-yaml my-schema.xml -o my-schema.yaml -
Valide el YAML para confirmar que es válido:
Ventana de terminal mondrian-schema lint my-schema.yaml -
Revise y anote
my-schema.yamlcon comentarios, luego súbalo a Saiku mediante la página de Schemas.
-
Cree o edite su schema YAML localmente.
-
Ejecute lint para detectar errores antes de subir:
Ventana de terminal mondrian-schema lint my-schema.yamlUn código de salida
0significa que el schema se parseó limpiamente. Cualquier error aparece en stderr con una referencia de línea. -
Si necesita suministrar XML a una herramienta externa (por ejemplo, un cliente de reporting legacy), convierta bajo demanda:
Ventana de terminal mondrian-schema to-xml my-schema.yaml -o my-schema.xml
Añada un paso de lint a su pipeline CI para detectar errores de schema antes de que lleguen a producción:
# In .github/workflows/ci.yml or equivalent- name: Lint Mondrian schemas run: | for f in schemas/*.yaml; do mondrian-schema lint "$f" doneEl script sale con código 2 ante cualquier fallo de parseo o validación, lo que fallará el job de CI automáticamente.
Requisitos previos
Solo Java en su $PATH, y el jar del launcher. Ambos vienen con
cualquier instalación de Saiku; no hay repositorio que clonar ni nada
que construir.
Si es cliente de Saiku Cloud y no tiene un jar local, no necesita esta herramienta en absoluto — la página de Schemas le entrega el mismo schema como XML, YAML o JSON de canvas desde el menú de la fila, y valida al guardar.
Relacionado
- Schemas YAML — la referencia completa de elementos YAML.
- Schemas — suba y gestione schemas en el dashboard de Saiku.
- Diseñador de schemas — genere un schema a partir de una descripción en lenguaje natural.