Creación y ejecución de consultas

El módulo cds.ql proporciona una API similar a SQL para construir tales consultas de base de datos. Las consultas necesarias para nuestro escenario se muestran en la siguiente figura.

La API está disponible mediante los objetos globales SELECT, INSERT, UPSERT, UPDATE y DELETE.

12
const cds = require('@sap/cds');
const { SELECT, INSERT, UPSERT, UPDATE, DELETE } = cds.ql;

La API disponible a través de los objetos CRUD enumerados está diseñada como una API fluida. Esto significa que los métodos disponibles en estos objetos devuelven objetos del mismo tipo. Las propiedades disponibles (como la propiedad .one del objeto SELECT utilizado en el ejemplo mostrado) también tienen objetos del mismo tipo que su valor. Esto permite encadenar, lo que hace que la codificación sea intuitiva y legible.

Para identificar la tabla de base de datos a la que se va a acceder, utilizamos la definición CSN de la entidad Libros en el ejemplo que se muestra. Este es el enfoque recomendado.

Como alternativa a las llamadas de método clásicas mostradas anteriormente, la API fluida también se puede utilizar con plantillas etiquetadas. La siguiente figura muestra cómo se pueden crear las consultas construidas anteriormente utilizando llamadas de método clásicas utilizando plantillas etiquetadas. El resultado es el mismo en ambos casos.

En la sección anterior, hemos analizado cómo se crean los objetos query. Sin embargo, las consultas creadas no se ejecutan automáticamente. Aún deben enviarse explícitamente a la base de datos para su ejecución. Ahora exploraremos cómo se logra.

A continuación, examinaremos cómo se pueden ejecutar las consultas en la base de datos. En este contexto, no importa si los objetos query se han creado mediante llamadas de método clásicas o mediante modelos etiquetados. En los siguientes ejemplos, utilizaremos llamadas de método clásicas para la construcción de consultas.

Las consultas se ejecutan en la base de datos pasándolas al método cds.db.run() (véase la siguiente figura). Esto se aplica no solo a las consultas SELECT, como se muestra en el ejemplo, sino también a la escritura de consultas de base de datos como una UPDATE.

En el ejemplo, el operador await se utiliza para esperar el resultado de la consulta SELECT.one. Este resultado se asigna a la constante b. En tiempo de ejecución, la constante es, por lo tanto, un objeto con una propiedad llamada stock. El valor de esta propiedad es el stock seleccionado en la base de datos para el libro que se especificó mediante el método where() . Si no se encuentra un libro con el ID especificado en la tabla de base de datos, a la constante b se le asigna el valor undefined.

Como alternativa al enfoque anterior, también puede simplemente await una consulta construida. Esto pasa la consulta al método cds.db.run() por defecto. Esto significa que lo siguiente y el ejemplo anterior son equivalentes con respecto a la consulta SELECT:

El ejemplo también muestra cómo se ejecuta la actualización en la base de datos.

Después de la actualización, se devuelve un objeto al programa de llamada de acuerdo con el tipo de respuesta de la acción envOrder. Este objeto tiene un stock de propiedad cuyo valor es el stock actualizado para el libro pedido.

En la parte del ejercicio de esta lección, encontrará la implementación completa del método reduceStock(). En esta implementación, se emite un mensaje de error si el ID de libro transferido no existe en la base de datos (es decir, si la constante b tiene el valor undefined). También se emite un mensaje de error si el stock del libro es menor que la cantidad pedida.

Vea el vídeo para ver cómo utilizar las consultas en la implementación de CAP Services.