{"id":9756,"date":"2021-08-16T00:00:46","date_gmt":"2021-08-16T07:00:46","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=9756"},"modified":"2025-06-13T18:43:32","modified_gmt":"2025-06-14T01:43:32","slug":"simplifying-query-index-with-collections","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/simplifying-query-index-with-collections\/","title":{"rendered":"5 pasos para agilizar sus consultas N1QL y migrar a Collections"},"content":{"rendered":"

Si desea migrar sus datos de una base de datos relacional a NoSQL,<\/strong> entonces ahora es mejor momento que nunca.<\/p>\n

El reciente lanzamiento de Couchbase 7.0<\/a> introdujo \u00c1mbitos y Colecciones - una nueva forma de organizar su Datos JSON<\/a>. M\u00e1s que cualquier otra cosa, Scopes y Collections simplifican y facilitan la migraci\u00f3n de tu actual modelo de datos relacional al modelo de datos de documentos de Couchbase. Como resultado, tu empresa se beneficia de la arquitectura distribuida \"shared-nothing\", la alta disponibilidad y la escalabilidad horizontal de Couchbase.<\/p>\n

Y si eres cliente o usuario de Couchbase desde hace tiempo... Los \u00e1mbitos y las colecciones tienen mucho que ofrecer en t\u00e9rminos de gesti\u00f3n y organizaci\u00f3n de datos<\/a>.<\/p>\n

Pero tanto si eres nuevo en NoSQL como si eres un veterano de Couchbase, tus consultas a bases de datos - utilizando el lenguaje de consulta N1QL<\/a> - beneficiarse del nuevo modelo de datos Scopes y Collections. Si quieres simplificar tus consultas N1QL, tendr\u00e1s que migrar tus datos de Couchbase del antiguo modelo Bucket al nuevo modelo Collections. Afortunadamente, la migraci\u00f3n es un proceso sencillo de cinco pasos.<\/p>\n

Empecemos con un repaso de \u00c1mbitos y Colecciones. (O pase directamente a la gu\u00eda de migraci\u00f3n si est\u00e1 preparado<\/a>.)<\/p>\n

Espera, \u00bfqu\u00e9 son los \u00e1mbitos y las colecciones?<\/h2>\n

Un Scope es equivalente a un esquema en una base de datos relacional (RDBMS). Es un contenedor l\u00f3gico para las colecciones de Couchbase. Cada Couchbase Bucket contiene un Scope por defecto. Puedes usar estos contenedores por defecto directamente - o definir los tuyos propios.<\/p>\n

Una Colecci\u00f3n es an\u00e1loga a una tabla en un RDBMS. Cada \u00e1mbito tiene una colecci\u00f3n por defecto. Mientras que una colecci\u00f3n puede<\/em> utilizarse para almacenar tipos similares de registros (como una tabla RDBMS), no hay restricciones de esquema sobre lo que se puede almacenar en una colecci\u00f3n<\/strong>. Todo depende de ti.<\/p>\n

A continuaci\u00f3n se ilustra c\u00f3mo varios conceptos de bases de datos relacionales se corresponden con estas nuevas caracter\u00edsticas de Servidor Couchbase<\/a> 7.0:<\/p>\n

<\/div>\n

\"\"<\/p>\n

<\/div>\n

Como puede ver, ahora hay un mapeo uno a uno entre los sistemas relacional y Modelos de datos NoSQL<\/a> al utilizar \u00e1mbitos y colecciones en Couchbase<\/a>.<\/p>\n

Espacios de claves del sistema en \u00c1mbitos y colecciones<\/h3>\n\n\n\n\n\n\n\n
Espacio clave<\/strong><\/td>\nDescripci\u00f3n<\/strong><\/td>\n<\/tr>\n
`system:all_scopes`<\/td>\nUna lista de todos los \u00e1mbitos, incluidos los objetos del sistema, como los \u00e1mbitos por defecto<\/td>\n<\/tr>\n
`system:scopes`<\/td>\nTodos los \u00e1mbitos disponibles excepto los \u00e1mbitos del sistema<\/td>\n<\/tr>\n
`system:all_collections`<\/td>\nUna lista de todas las Colecciones, incluidos los objetos del sistema, como las Colecciones por defecto<\/td>\n<\/tr>\n
`system:collections`<\/td>\nTodas las colecciones disponibles excepto las del sistema<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n

C\u00f3mo los \u00e1mbitos y las colecciones agilizan sus consultas N1QL<\/h2>\n

One major consequence of Scopes and Collections is that the N1QL query language is now simpler. This is because a `type` field is no longer required on every document. As a result, both the Data Definition Language (DDL) and Data Manipulation Language (DML) of N1QL statements are easier to write and understand.<\/p>\n

Las consultas N1QL son ahora m\u00e1s sencillas e intuitivas<\/h3>\n

Couchbase Collections te proporciona el equivalente de una tabla relacional. La fuerza de esta similitud -sin ninguna de sus debilidades- tiende un puente entre el mundo l\u00f3gico y el relacional. modelo f\u00edsico de datos<\/a> al que est\u00e1n acostumbrados muchos RDBMS.<\/p>\n

Take a look at these side-by-side N1QL queries below using the `travel-sample` dataset.<\/p>\n\n\n\n\n
Modelo de cubo<\/strong><\/td>\nModelo de recogida<\/strong><\/td>\n<\/tr>\n
\n
SELECT  a.name\r\n  FROM `travel-sample` a  \r\nWHERE a.type='airport'\r\n   AND a.city='London'\r\n<\/pre>\n
 <\/td>\n
\n
SELECT a.name \r\n FROM  airport a\r\nWHERE a.city='London'\r\n<\/pre>\n
 <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n
The query on the left jumps illustrates how you had to specify the document `type` field under the old Bucket model. The query on the right is simpler because the document `type` is no longer required under the new Collection model introduced in Couchbase 7.0.<\/p>\n
Las condiciones JOIN de N1QL tambi\u00e9n son m\u00e1s sencillas<\/h3>\n
Los JOINs en N1QL tambi\u00e9n se han vuelto m\u00e1s f\u00e1ciles. Eche un vistazo a esta comparaci\u00f3n de consultas antiguas y nuevas a continuaci\u00f3n.<\/p>\n\n\n\n\n
Modelo de cubo<\/strong><\/td>\nModelo de recogida<\/strong><\/td>\n<\/tr>\n
\n
SELECT h.name, \r\n       a.faa\r\n FROM `travel-sample` h\r\n   JOIN `travel-sample` a  \r\n      ON h.city=a.city AND a.type='airport'\r\n WHERE h.type='hotel'\r\n   AND a.city='London'\r\n<\/pre>\n
 <\/td>\n
\n
SELECT h.name, \r\n       a.faa\r\n FROM hotel h\r\n   JOIN airport a \r\n     ON h.city=a.city\r\n WHERE a.city='London'\r\n<\/pre>\n
 <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n
Under the new Collection model, the JOIN syntax doesn’t require you to use the `type` field to restrict your query to a specific table of documents within the Bucket.<\/p>\n
Las consultas N1QL mantienen la retrocompatibilidad con el modelo de cubo<\/h3>\n
La introducci\u00f3n del nuevo modelo Collection no significa el fin de Buckets. El Servicio de Consultas N1QL sigue soportando el modelo Bucket como hasta ahora.<\/p>\n
El \u00fanico cambio es que ahora sus datos de Bucket se almacenan en el Scope por defecto que a su vez contiene una Collection por defecto.<\/p>\n\n\n\n\n
Modelo de cubo<\/strong><\/td>\nModelo de recogida<\/strong><\/td>\n<\/tr>\n
\n
SELECT a.faa \r\n FROM `travel-sample` a\r\nWHERE a.type='airport'\r\n<\/pre>\n
 <\/td>\n
Puedes usar:<\/p>\n
SELECT a.faa\r\nFROM `travel-sample`\r\nWHERE a.type='airport'\r\n<\/pre>\n
 <\/p>\n
o<\/em><\/p>\n
SELECT a.faa\r\nFROM default:`travel-sample`._default._default a\r\nWHERE a.type='airport'\r\n<\/pre>\n
 <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n
Tenga en cuenta que el prefijo del espacio de nombres es obligatorio<\/strong> and should have the value `default:` for all references to the default Scope or default Collection.<\/p>\n
Un cambio importante en las consultas N1QL con colecciones<\/h2>\n
Con el modelo Collection, el motor de consulta debe conocer la ruta completa del nombre de la colecci\u00f3n<\/strong>. Esto se debe a que el nombre de una colecci\u00f3n no tiene que ser \u00fanico dentro de un cubo, sino s\u00f3lo dentro de su propio \u00e1mbito.<\/p>\n
Un nombre de colecci\u00f3n completo tiene el siguiente formato:<\/p>\n
Formato:<\/p>\n
namespace:bucket.scope.collection<\/pre>\n
Por ejemplo:<\/p>\n
namespace:`travel-sample`.booking.hotel<\/pre>\n
However, you can reference a Collection with its relative path by setting the `query_context`<\/p>\n
En Interfaz del Query Workbench<\/strong> permite establecer el contexto de la consulta seleccionando el Cubo y el \u00c1mbito en el cuadro desplegable (en la parte superior derecha de la captura de pantalla siguiente).<\/p>\n
<\/div>\n
\"\"<\/p>\n
<\/div>\n
El contexto de consulta tambi\u00e9n se admite en SDK de Couchbase<\/a>, la API REST<\/a> y concha cbq<\/a>.<\/p>\n
\u00bfTengo que migrar a Colecciones?<\/h2>\n
No, no tienes que migrar al modelo de Colecciones si no quieres.<\/p>\n
Esto es lo que no cambia si decide no migrar:<\/p>\n