app.services.rule_templates¶
Asistente de reglas: convierte una regla en lenguaje común («ninguna fila con la columna X vacía») en la consulta SELECT, el tipo de validación y el resultado esperado que entiende el motor de ejecución.
Es la misma idea que las «pruebas genéricas» de dbt o las reglas de Soda (not_null, unique, accepted_values), pero generando SQL Oracle. Solo produce SELECT; el SQL generado pasa después por la política de SQL como cualquier otra sentencia.
Seguridad: la tabla y la columna deben ser identificadores simples (sin comillas, espacios ni signos) y los valores son números o textos cortos con caracteres seguros. Nada del usuario se concatena sin pasar por esas comprobaciones.
IDENTIFICADOR = re.compile('^[A-Za-z][A-Za-z0-9_$#]{0,29}$')
module-attribute
¶
NUMERO = re.compile('^-?\\d{1,18}(\\.\\d{1,9})?$')
module-attribute
¶
TEXTO_SEGURO = re.compile('^[A-Za-z0-9_ .:/-]{1,50}$')
module-attribute
¶
MAX_VALORES = 20
module-attribute
¶
P_TABLA = {'nombre': 'tabla', 'etiqueta': 'Tabla', 'ejemplo': 'FRAMEWORK_TEST_ITEMS', 'ayuda': 'Nombre de la tabla (o ESQUEMA.TABLA)'}
module-attribute
¶
P_COL = {'nombre': 'columna', 'etiqueta': 'Columna', 'ejemplo': 'NAME', 'ayuda': 'Nombre de la columna'}
module-attribute
¶
REGLAS = [{'id': 'filas_exactas', 'titulo': 'La tabla tiene exactamente N filas', 'descripcion': 'Cuenta las filas de la tabla y compara el número con el que usted espera.', 'validacion': 'SCALAR_VALUE', 'parametros': [P_TABLA, {'nombre': 'n', 'etiqueta': 'Filas esperadas', 'ejemplo': '5', 'ayuda': 'Número entero'}]}, {'id': 'tabla_con_datos', 'titulo': 'La tabla no está vacía', 'descripcion': 'Comprueba que la tabla tenga al menos una fila.', 'validacion': 'EXISTS', 'parametros': [P_TABLA]}, {'id': 'sin_nulos', 'titulo': 'Ninguna fila con la columna vacía (sin NULL)', 'descripcion': 'Cuenta las filas donde la columna está vacía; lo esperado es 0.', 'validacion': 'SCALAR_VALUE', 'parametros': [P_TABLA, P_COL]}, {'id': 'sin_repetidos', 'titulo': 'Sin valores repetidos en la columna', 'descripcion': 'Cuenta cuántos valores aparecen más de una vez; lo esperado es 0 (útil para códigos o identificadores).', 'validacion': 'SCALAR_VALUE', 'parametros': [P_TABLA, {**P_COL, 'ejemplo': 'NAME'}]}, {'id': 'solo_valores', 'titulo': 'La columna solo contiene ciertos valores', 'descripcion': 'Cuenta las filas cuyo valor NO está en su lista; lo esperado es 0. Las filas vacías (NULL) no se cuentan aquí: use la regla «sin NULL» para eso.', 'validacion': 'SCALAR_VALUE', 'parametros': [P_TABLA, {**P_COL, 'ejemplo': 'ACTIVE'}, {'nombre': 'valores', 'etiqueta': 'Valores permitidos', 'ejemplo': '0, 1', 'ayuda': 'Separados por comas'}]}, {'id': 'existe_fila', 'titulo': 'Existe una fila con cierto valor', 'descripcion': 'Comprueba que haya al menos una fila donde la columna vale lo indicado.', 'validacion': 'EXISTS', 'parametros': [P_TABLA, {**P_COL, 'ejemplo': 'ID'}, {'nombre': 'valor', 'etiqueta': 'Valor buscado', 'ejemplo': '3', 'ayuda': 'Número o texto corto'}]}, {'id': 'contar_con_valor', 'titulo': 'Cuántas filas tienen cierto valor', 'descripcion': 'Cuenta las filas donde la columna vale lo indicado y compara con el número que espera.', 'validacion': 'SCALAR_VALUE', 'parametros': [P_TABLA, {**P_COL, 'ejemplo': 'ACTIVE'}, {'nombre': 'valor', 'etiqueta': 'Valor', 'ejemplo': '1', 'ayuda': 'Número o texto corto'}, {'nombre': 'n', 'etiqueta': 'Filas esperadas', 'ejemplo': '4', 'ayuda': 'Número entero'}]}, {'id': 'rango_numerico', 'titulo': 'Los valores numéricos están dentro de un rango', 'descripcion': 'Cuenta las filas cuyo valor queda fuera del rango [mínimo, máximo]; lo esperado es 0.', 'validacion': 'SCALAR_VALUE', 'parametros': [P_TABLA, {**P_COL, 'ejemplo': 'ACTIVE'}, {'nombre': 'minimo', 'etiqueta': 'Mínimo', 'ejemplo': '0', 'ayuda': 'Número'}, {'nombre': 'maximo', 'etiqueta': 'Máximo', 'ejemplo': '1', 'ayuda': 'Número'}]}]
module-attribute
¶
ReglaInvalida
¶
Bases: ValueError
Los datos de la regla no son válidos; el mensaje está pensado para mostrarse a la persona usuaria.
listar()
¶
Catálogo para la interfaz (sin funciones; solo datos).
construir(regla_id, params)
¶
Genera el SELECT, el tipo de validación, el valor esperado y una explicación en lenguaje común.