{"id":3968,"date":"2017-08-25T01:09:33","date_gmt":"2017-08-25T08:09:33","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=3968"},"modified":"2025-06-13T17:23:17","modified_gmt":"2025-06-14T00:23:17","slug":"paging-data-queries-with-n1ql","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/paging-data-queries-with-n1ql\/","title":{"rendered":"Consultas de datos por paginaci\u00f3n con N1QL"},"content":{"rendered":"

M. David Allen es un ingeniero de software y emprendedor que lleva m\u00e1s de una d\u00e9cada trabajando con casi todos los lenguajes de programaci\u00f3n y tipos de sistemas de bases de datos a su alcance. David ha trabajado anteriormente en muchos sectores, como las finanzas, la sanidad y la administraci\u00f3n p\u00fablica, centr\u00e1ndose normalmente en retos de integraci\u00f3n de datos a gran escala, la transici\u00f3n de la investigaci\u00f3n aplicada y la innovaci\u00f3n de nuevas tecnolog\u00edas. Tiene un m\u00e1ster por la Virginia Commonwealth University, pero desde que abandon\u00f3 la educaci\u00f3n formal sigue siendo un estudiante permanente de tecnolog\u00eda.<\/em><\/p>\n

\"\"<\/p>\n

Configurar<\/h2>\n

En este tutorial, utilizaremos la funci\u00f3n conjunto de datos de la muestra de cerveza<\/a><\/u>\u00a0que viene con Couchbase para que sea f\u00e1cil seguirlo. Si todav\u00eda no tienes Couchbase instalado, puedes ponerte en marcha muy r\u00e1pidamente teniendo docker y siguiendo las sencillas instrucciones de la p\u00e1gina de im\u00e1genes docker de couchbase<\/a><\/u>\u00a0para configurar una instancia r\u00e1pida de Couchbase para pruebas. Simplemente ejecutando el comando docker run -d -name db -p 8091-8094:8091-8094 -p 11210:11210 Couchbase con Couchbase instalado podemos empezar. Despu\u00e9s de seguir algunas instrucciones de configuraci\u00f3n descritas en esa p\u00e1gina, estamos listos para rodar con algunos datos.<\/p>\n

Casos pr\u00e1cticos - \u00bfQu\u00e9 es el paginado y por qu\u00e9 hacerlo?<\/h2>\n

Consideremos una necesidad muy com\u00fan; en nuestra hipot\u00e9tica aplicaci\u00f3n front-end de cerveza, queremos mostrar a nuestros usuarios una tabla de cervezas y dejar que valoren cada una de ellas. El problema es que la base de datos contiene m\u00e1s de 5.000 cervezas. Ser\u00eda un desperdicio enviar todo el conjunto de datos al navegador cada vez, y ralentizar\u00eda mucho la carga de la p\u00e1gina de tu aplicaci\u00f3n web.<\/p>\n

Mucho mejor ser\u00eda mostrar al usuario s\u00f3lo las 10 primeras cervezas. Entonces, haciendo clic en un bot\u00f3n \"Siguiente\" para ir a la p\u00e1gina siguiente, o incluso mejor utilizando un plugin de desplazamiento infinito (como ngInfiniteScroll<\/a><\/u>\u00a0para \u00e1ngulos o\u00a0react-infinite<\/a><\/u>\u00a0para reaccionar) se pueden mostrar al usuario progresivamente m\u00e1s registros de la base de datos.<\/p>\n

\u00a1Ens\u00e9\u00f1ame el C\u00f3digo!<\/h2>\n
SELECT name, category, abv from `beer-sample`\r\n\r\nWHERE brewery_id is not missing\r\n\r\nORDER BY name\r\n\r\nOFFSET 0\r\n\r\nLIMIT 10;<\/pre>\n
Esto devuelve los datos que cabr\u00eda esperar:<\/p>\n
[\r\n\r\n\u00a0 {\r\n\r\n\u00a0 \u00a0 \"abv\": 0,\r\n\r\n\u00a0 \u00a0 \"category\": \"North American Lager\",\r\n\r\n\u00a0 \u00a0 \"name\": \"#17 Cream Ale\"\r\n\r\n\u00a0 },\r\n\r\n\u00a0 {\r\n\r\n\u00a0 \u00a0 \"abv\": 0,\r\n\r\n\u00a0 \u00a0 \"name\": \"#40 Golden Lager\"\r\n\r\n\u00a0 },\r\n\r\n\u00a0 {\r\n\r\n\u00a0 \u00a0 \"abv\": 0,\r\n\r\n\u00a0 \u00a0 \"category\": \"Other Style\",\r\n\r\n\u00a0 \u00a0 \"name\": \"#42 Cream Ale\"\r\n\r\n\u00a0 },\r\n\r\n\u00a0 \/* (...) *\/\r\n\r\n<\/pre>\n
Para obtener la segunda p\u00e1gina de resultados, s\u00f3lo tiene que a\u00f1adir el L\u00cdMITE al OFFSET.    Por ejemplo, OFFSET 10 LIMIT 10 ser\u00eda la segunda p\u00e1gina.   Para generalizar, \u00bfcu\u00e1ntos registros debe omitir con OFFSET para llegar a la en\u00e9sima p\u00e1gina?    Siempre ser\u00e1 n * tama\u00f1o de p\u00e1gina.<\/p>\n
Utilizando esta sencilla matem\u00e1tica, podemos generalizarlo a cualquier escenario.  \u00bfQu\u00e9 pasar\u00eda si quisi\u00e9ramos mostrar 20 resultados a la vez, y el usuario quisiera saltar directamente a la p\u00e1gina 11?   No hay problema, basta con LIMIT 20 OFFSET 20 * 11.   As\u00ed, los extremos de la aplicaci\u00f3n, ya est\u00e9n buscando en la base de datos o simplemente listando cervezas por nombre, pueden utilizar exactamente la misma l\u00f3gica de consulta cada vez.  No importa lo compleja que sea la consulta, basta con ajustar LIMIT y OFFSET y todos estaremos en la misma p\u00e1gina.<\/p>\n
\u00bfC\u00f3mo funciona?<\/h2>\n
La magia aqu\u00ed es la combinaci\u00f3n de tres cl\u00e1usulas N1QL: \u00a0L\u00cdMITE<\/strong>, OFFSET<\/strong>y ORDENAR POR<\/strong>.   Echemos un vistazo r\u00e1pido a cada uno de ellos, porque todos son necesarios para hacer el trabajo.<\/p>\n