Consultar

PIPE proporciona métodos en español para acceder a los datos de las tablas interpretando las cláusulas y palabras reservadas del gestor de base de datos.

PIPE tiene tres formas de retornar los datos en las consultas, como un objeto, como un arreglo y como un json, por medio de las constantes PIPE::OBJETO, PIPE::ARREGLO y PIPE::JSON. La forma por defecto del retorno de datos es como un objeto.

A continuación, se muestra un listado de las 36 palabras reservadas del ORM PIPE y su equivalente en el lenguaje SQL de la base de datos para realizar consultas en español con el método consulta.

Veamos algunos ejemplos utilizando la base de datos mundo.

El método encontrar nos permite obtener una instancia del constructor de consultas PIPE con los datos asociados a la llave primaria.

Podemos obtener los datos de la siguiente manera.

El método encontrar también permite enviar un arreglo de llaves primarias.

#1 Obtener todos los datos - *.

Obtener todos los datos de la tabla paises por medio del modelo.

Obtener todos los datos de la tabla paises por medio del constructor de consultas PIPE.

Obtener todos los datos de la tabla paises por medio de consulta en español.

Obtener todos los datos de la tabla paises por medio de consulta nativa.

#2 Seleccionar campos - select.

Obtener codigo y nombre de la tabla paises por medio del modelo.

Obtener codigo y nombre de la tabla paises por medio del constructor de consultas PIPE.

Obtener codigo y nombre de la tabla paises por medio de consulta en español.

Obtener codigo y nombre de la tabla paises por medio de consulta nativa.

#3 Condicionales - where.

PIPE permite dos formas de realizar condicionales con el método donde, de forma tradicional y de forma segura. PIPE también permite escribir los comandos en español dentro de las condicionales.

Obtener todos los datos de la tabla paises donde la cantidad de población esté entre 50.000.000 y 100.000.000 por medio del modelo.

Obtener todos los datos de la tabla paises donde la cantidad de población esté entre 50.000.000 y 100.000.000 por medio del constructor de consultas PIPE.

Obtener todos los datos de la tabla paises donde la cantidad de población esté entre 50.000.000 y 100.000.000 por medio de consulta en español.

#4 Uniones - inner join, right join, left join.

inner join

Cuando el método unir no detecta el operador de comparación este incluye por defecto el operador =.

Obtener nombre e idioma de la tabla paises.

right join

Cuando el método unirDerecha no detecta el operador de comparación este incluye por defecto el operador =.

Obtener todos los datos de la tabla paises que no tengan idiomas asociados.

left join

Cuando el método unirIzquierda no detecta el operador de comparación este incluye por defecto el operador =.

Obtener todos los datos de la tabla paises que no tengan idiomas asociados.

#5 Agrupaciones - group by.

Obtener la cantidad de paises de cada continente.

El método agruparPor también permite enviar un arreglo definiendo varias agrupaciones.

#6 Condicionales - having.

Obtener los continentes que tengan más de 40 paises.

#7 Ordenar - order by.

Cuando el método ordenarPor no detecta el tipo de orden este incluye por defecto el tipo asc.

Obtener todos los datos de la tabla paises ordenados por nombre ascendentemente.

Obtener todos los datos de la tabla paises ordenados por nombre descendentemente.

El método ordenarPor también permite enviar un arreglo definiendo varias ordenaciones.

#8 Límite - limit.

Cuando el método limite no detecta el segundo parámetro este incluye por defecto un límite simple.

Obtener los dos primeros registros de la tabla paises.

Obtener todos los datos de la tabla paises desde la posición 5 hasta la posición 10.

#9 Distinto - distinct.

Obtener todos los continentes de la tabla paises.

#10 Alias - as.

Obtener todos los países que tengan menos de 5 ciudades por medio de subconsulta.

Consultas básicas por medio de métodos.

#11 Obtener el primer registro - primero.

Obtener el primer registro de la tabla paises por medio del modelo.

Obtener el primer registro de la tabla paises por medio del constructor de consultas PIPE.

Obtener los diez primeros registros de la tabla paises por medio del modelo.

Obtener los diez primeros registros de la tabla paises por medio del constructor de consultas PIPE.

#12 Obtener el último registro - ultimo.

Debido a que en el constructor de consultas PIPE no disponemos de un modelo que nos permita omitir las convenciones, debemos indicarle al método ultimo cual es la lleve primaria.

Obtener el último registro de la tabla paises por medio del modelo.

Obtener el último registro de la tabla paises por medio del constructor de consultas PIPE.

Obtener los diez últimos registros de la tabla paises por medio del modelo.

Obtener los diez últimos registros de la tabla paises por medio del constructor de consultas PIPE.

#13 Contar resultados de consulta SQL - contar.

Contar la cantidad de registros en la tabla paises.

#14 Obtener el valor máximo del campo especificado - maximo.

Obtener la población máxima en la tabla paises.

#15 Obtener el valor mínimo del campo especificado - minimo.

Obtener la población mínima en la tabla paises.

#16 Obtener el valor promedio del campo especificado - promedio.

Obtener el promedio de población en la tabla paises.

#17 Obtener la suma del campo especificado - suma.

Obtener la suma de la población en la tabla paises.

#18 Verificar que la consulta SQL ha retornado un resultado. - existe.

El método existe retorna true cuando encuentra resultados.

#19 Verificar que la consulta SQL no ha retornado un resultado. - noExiste.

El método noExiste retorna true cuando no encuentra resultados.

#20 Incrementar el valor del campo especificado. - incrementar.

Incrementar la población en la tabla paises.

#21 Decrementar el valor del campo especificado. - decrementar.

Decrementar la población en la tabla paises.

Si utilizas el Modelo para interactuar con los datos de la base de datos, tendrás la ventaja de poder omitir las convenciones que tiene el ORM PIPE y adaptarse a la estructura que tenga tu tabla en la base de datos, ya que el Constructor de Consultas se adapta por defecto a las convenciones.