Consultar

!

Atención: Estás visualizando una versión desactualizada de la documentación. Te recomendamos utilizar la última versión (8.x) para acceder a las últimas características y correcciones.

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 32 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.

Palabra Reservada en el ORM PIPE Equivalente en el Lenguaje SQL
actualizar update
agrupar group
alias as
asignar set
como like
concatenar concat
contar count
de from
dentro into
derecha right
distinto distinct
donde where
eliminar delete
en on
entre between
es is
Palabra Reservada en el ORM PIPE Equivalente en el Lenguaje SQL
existe exists
insertar insert
izquierda left
limite limit
no not
nulo null
o or
ordenar order
por by
seleccionar select
teniendo having
todo *
unir join
valores values
xo xor
y and

Veamos algunos ejemplos utilizando la base de datos mundo.

#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.

#11 Contar resultados de consulta SQL - contar.

Contar la cantidad de registros en la tabla paises.

Consultas básicas por medio de métodos.

#12 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.

#13 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.

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.