Las colecciones son una nueva caracter\u00edstica de Couchbase 6.5. Te permiten agrupar documentos similares dentro de cada bucket, igual que las tablas en las bases de datos relacionales agrupan registros similares dentro de cada base de datos. Las colecciones estar\u00e1n totalmente soportadas en Couchbase 7.0, pero puedes probarlas ahora mismo en la versi\u00f3n 6.5 de Couchbase como una caracter\u00edstica Developer Preview. La Aplicaci\u00f3n Demo ya las utiliza.<\/p>\n
\u00bfQu\u00e9 son las colecciones?<\/strong> En versiones anteriores de Couchbase, los datos se organizaban as\u00ed:<\/p>\n En Couchbase 6.5, hay dos capas m\u00e1s, as\u00ed:<\/p>\n \u00bfQu\u00e9 utilidad tienen las colecciones?<\/b><\/p>\n Las colecciones son el nivel m\u00e1s bajo de organizaci\u00f3n documental y contienen directamente documentos. Son \u00fatiles porque permiten agrupar los documentos con mayor precisi\u00f3n que antes. En lugar de volcar todos los tipos de documentos (productos, pedidos, clientes) en un \u00fanico bucket y distinguirlos por un campo de tipo, puede crear una colecci\u00f3n para cada tipo. Y cuando se consulta, se puede consultar la colecci\u00f3n, no s\u00f3lo todo el bucket. Tambi\u00e9n podr\u00e1 controlar el acceso a nivel de colecci\u00f3n.<\/p>\n Los \u00e1mbitos son el nivel de organizaci\u00f3n por encima de las colecciones. Los \u00e1mbitos contienen colecciones y las colecciones contienen documentos. Hay diferentes formas de usar los \u00e1mbitos, dependiendo de para qu\u00e9 se est\u00e9 usando el cluster de Couchbase. Si est\u00e1 soportando muchas aplicaciones internas diferentes para una compa\u00f1\u00eda, cada aplicaci\u00f3n deber\u00eda tener su propio \u00e1mbito. Si el cluster est\u00e1 siendo usado para servir a muchas organizaciones cliente, cada una ejecutando su propia copia de una aplicaci\u00f3n, cada copia deber\u00eda tener un scope propio. Del mismo modo, si un cl\u00faster est\u00e1 siendo utilizado por grupos de desarrollo, tal vez para pruebas, la unidad de asignaci\u00f3n debe ser un \u00e1mbito. En cada caso, el propietario puede crear las colecciones que desee en el \u00e1mbito que se le asigne.<\/p>\n Los \u00e1mbitos deben ser \u00fanicos dentro de sus cubos, y las colecciones deben ser \u00fanicas dentro de sus \u00e1mbitos. As\u00ed, el bucket \"default\" podr\u00eda contener dos \u00e1mbitos \"dev\" y \"prod\", cada uno con sus propias colecciones \"products\" y \"customers\".<\/p>\n Uso de las colecciones<\/b><\/p>\n Puedes ver colecciones y \u00e1mbitos siendo usados en la \u00faltima versi\u00f3n de la Aplicaci\u00f3n Demo de Couchbase, aqu\u00ed:<\/p>\n https:\/\/github.com\/couchbaselabs\/try-cb-java\/tree\/6.5.0-branch<\/a><\/p>\n Esta aplicaci\u00f3n utiliza un bucket \"travel-sample\" ya existente para permitir al usuario buscar vuelos y hoteles, pero almacena sus propios datos de usuario y reservas en colecciones. La estructura utilizada es la siguiente:<\/p>\n Cuando el usuario crea una cuenta, se crea un documento en la colecci\u00f3n \"usuarios\". Cuando reservan vuelos, se crean documentos en la colecci\u00f3n \"vuelos\", y se hace referencia a ellos en el documento del usuario en la colecci\u00f3n \"usuarios\".<\/p>\n Este dise\u00f1o permite que varias aplicaciones compartan el mismo bucket. Si tuvi\u00e9ramos una segunda instancia de la aplicaci\u00f3n de demostraci\u00f3n, utilizada por otra agencia de viajes, podr\u00edamos crear otro \u00e1mbito (con sus propias colecciones \"users\" y \"flights\") y dirigir la segunda instancia a este \u00e1mbito actualizando su archivo application.properties. Las dos instancias funcionar\u00edan una al lado de la otra, sin interferir entre s\u00ed.<\/p>\n C\u00f3digo de ejemplo<\/b><\/p>\n Para empezar, en el archivo application.properties se nombran el bucket y el scope que contienen la informaci\u00f3n sobre usuarios y reservas:<\/p>\n Estos valores de configuraci\u00f3n se recogen en el archivo Database.java:<\/p>\n En User.java, vemos c\u00f3mo se registra un nuevo vuelo para el usuario. Se pasa el bean scope, creado anteriormente. El nombre de usuario es el id el nombre con el que el usuario ha iniciado sesi\u00f3n.<\/p>\n El id del documento de usuario es el nombre de usuario del usuario. La aplicaci\u00f3n sabe que debe obtenerlo de la colecci\u00f3n \"users\", en la colecci\u00f3n utilizada por la aplicaci\u00f3n.<\/p>\n Los vuelos que el usuario ha reservado se almacenan en el documento de usuario, en un array llamado \"vuelos\".<\/p>\n A\u00f1adimos los nuevos vuelos a los ya existentes.<\/p>\n A continuaci\u00f3n, almacenamos la nueva versi\u00f3n del documento de usuario.<\/p>\n Justo debajo, vemos c\u00f3mo se recuperan los vuelos de un usuario.<\/p>\n Obtener el documento de usuario de la colecci\u00f3n \"usuarios\".<\/p>\n Obtiene la matriz \"flights\" del documento de usuario. Contiene una lista de identificadores de vuelo.<\/p>\n Recuperar cada documento de vuelo de la colecci\u00f3n \"vuelos\" por ID.<\/p>\n Cambios respecto al c\u00f3digo anterior<\/b><\/p>\n El c\u00f3digo para trabajar con usuarios y sus vuelos era bastante diferente en la versi\u00f3n anterior, que no utilizaba colecciones. All\u00ed, los vuelos reservados se almacenaban directamente en el documento de usuario. El documento de usuario se almacenaba directamente en la tabla \"travel-sample\". Este es el c\u00f3digo original de la funci\u00f3n registerFlightForUser().<\/p>\n F\u00edjese en el uso de un prefijo para marcar el tipo de documento. Esto no es necesario una vez que las colecciones est\u00e1n disponibles.<\/p>\n Recuperamos la matriz de vuelos, que ya est\u00e1 en el documento.<\/p>\n A\u00f1adimos los vuelos a la lista de vuelos reservados.<\/p>\n Y almacenamos el documento de usuario.<\/p>\n Obviamente, separar los vuelos reservados del usuario no es terriblemente convincente en una aplicaci\u00f3n de juguete. Pero en una aplicaci\u00f3n de producci\u00f3n, en la que estamos almacenando muchos tipos de informaci\u00f3n sobre cada usuario, tendr\u00eda sentido almacenar algunos registros fuera del documento de usuario, en particular los que fueran grandes o numerosos o propensos a cambiar con frecuencia.<\/p>\n Documentaci\u00f3n sobre \u00e1mbitos y colecciones<\/b><\/p>\n Para saber m\u00e1s sobre c\u00f3mo trabajar directamente con \u00e1mbitos y colecciones, consulte esta documentaci\u00f3n<\/a>que explica la API RESTful para trabajar con ambos, los comandos CLI pertinentes e informaci\u00f3n sobre las colecciones disponibles en cbstats<\/em>.<\/p>\n Resumen<\/b><\/p>\n Las colecciones y los \u00e1mbitos te permiten organizar documentos dentro de un bucket de Couchbase, al igual que las tablas y los esquemas te permiten organizar filas dentro de bases de datos relacionales. La versi\u00f3n actual de Couchbase 6.5 GA proporciona soporte temprano y limitado para colecciones y \u00e1mbitos como una caracter\u00edstica Developer Preview. Para empezar con colecciones y \u00e1mbitos, puedes empezar a trabajar con la Aplicaci\u00f3n Demo Java ahora mismo.<\/p>\n Descargar<\/i><\/p>\n Descargar Couchbase Server 6.5<\/a><\/span><\/p>\n \u00a0<\/i>Documentaci\u00f3n<\/i><\/p>\n Documentaci\u00f3n de Couchbase Collections 6.5<\/a><\/p>\n Notas de la versi\u00f3n de Couchbase Server 6.5<\/a><\/span><\/p>\n Novedades de Couchbase Server 6.5<\/a><\/span><\/p>\n Blogs<\/i><\/p>\n Presentaci\u00f3n de Collections - Developer Preview en Couchbase Server 6.5<\/a><\/p>\n Anuncio de Couchbase Server 6.5 - Novedades y mejoras<\/a><\/span><\/p>\n
\nSi vienes del mundo de las bases de datos relacionales, puedes pensar en las colecciones como si fueran tablas. Todos los documentos de una colecci\u00f3n couchbase deben ser del mismo tipo, del mismo modo que todos los registros de una tabla relacional son del mismo tipo. Puede haber una tabla \"cliente\" o una tabla \"producto\" en un esquema relacional; del mismo modo, puede haber una colecci\u00f3n \"cliente\" en un bucket de Couchbase.<\/p>\n\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
storage.clientorg.bucket=default\r\nstorage.clientorg.scope=larson-travel<\/pre>\n
@Configuration\r\npublic class Database {\r\n\r\n ...\r\n\r\n @Value(\"${storage.clientorg.bucket}\")\r\n private String clientOrgBucket;\r\n\r\n @Value(\"${storage.clientorg.scope}\")\r\n private String clientOrgScope;\r\n\r\n ...\r\n\r\n public Bucket clientOrgBucket() {\r\n return loginCluster().bucket(clientOrgBucket);\r\n }\r\n\r\n public @Bean Scope clientOrgScope() {\r\n return clientOrgBucket().scope(clientOrgScope);\r\n }\r\n\r\n}\r\n<\/pre>\n public Result<Map<String, Object>> registerFlightForUser(final Scope scope, \r\n final String username, final JsonArray newFlights) {\r\n<\/pre>\n String userId = username;\r\n Collection usersCollection = scope.collection(USERS_COLLECTION_NAME);\r\n Collection flightsCollection = scope.collection(FLIGHTS_COLLECTION_NAME);\r\n Optional<GetResult> userDataFetch = usersCollection.get(userId);\r\n if (!userDataFetch.isPresent()) {\r\n throw new IllegalStateException();\r\n }\r\n JsonObject userData = userDataFetch.get().contentAsObject();\r\n\r\n if (newFlights == null) {\r\n throw new IllegalArgumentException(\"No flights in payload\");\r\n }\r\n\r\n JsonArray added = JsonArray.empty();\r\n<\/pre>\n JsonArray allBookedFlights = userData.getArray(\"flights\");\r\n if(allBookedFlights == null) {\r\n allBookedFlights = JsonArray.create();\r\n }\r\n<\/pre>\n for (Object newFlight : newFlights) {\r\n checkFlight(newFlight);\r\n JsonObject t = ((JsonObject) newFlight);\r\n t.put(\"bookedon\", \"try-cb-java\");\r\n String flightId = UUID.randomUUID().toString();\r\n flightsCollection.insert(flightId, t);\r\n allBookedFlights.add(flightId);\r\n added.add(t);\r\n }\r\n\r\n userData.put(\"flights\", allBookedFlights);\r\n<\/pre>\n usersCollection.upsert(userId, userData);\r\n\r\n JsonObject responseData = JsonObject.create()\r\n .put(\"added\", added);\r\n\r\n return Result.of(responseData.toMap(), \r\n \"Booked flight in Couchbase document \" + userId);\r\n }\r\n<\/pre>\n
public List<Map<String, Object>> getFlightsForUser(final Scope scope, \r\n final String username) {\r\n<\/pre>\n Collection users = scope.collection(USERS_COLLECTION_NAME);\r\n Optional<GetResult> doc = users.get(username);\r\n if (!doc.isPresent()) {\r\n return Collections.emptyList();\r\n }\r\n JsonObject data = doc.get().contentAsObject();\r\n<\/pre>\n JsonArray flights = data.getArray(\"flights\");\r\n if (flights == null) {\r\n return Collections.emptyList();\r\n }\r\n<\/pre>\n \/\/ The \"flights\" array contains flight ids. Convert them to actual objects.\r\n Collection flightsCollection = scope.collection(FLIGHTS_COLLECTION_NAME);\r\n List<Map<String, Object>> results = new ArrayList<Map<String, Object>>();\r\n for (int i = 0; i < flights.size(); i++) {\r\n String flightId = flights.getString(i);\r\n Optional<GetResult> res = flightsCollection.get(flightId);\r\n if (!res.isPresent()) {\r\n throw new RuntimeException(\"Unable to retrieve flight id \" + flightId);\r\n }\r\n Map<String, Object> flight = res.get().contentAsObject().toMap();\r\n results.add(flight);\r\n }\r\n return results;\r\n }\r\n<\/pre>\n public Result<Map<String, Object>> registerFlightForUser(final Bucket bucket,\r\n \tfinal String username, final JsonArray newFlights) {\r\n<\/pre>\n JsonDocument userData = bucket.get(\"user::\" + username);\r\n if (userData == null) {\r\n throw new IllegalStateException();\r\n }\r\n\r\n if (newFlights == null) {\r\n throw new IllegalArgumentException(\"No flights in payload\");\r\n }\r\n\r\n JsonArray added = JsonArray.empty();\r\n<\/pre>\n JsonArray allBookedFlights = userData.content().getArray(\"flights\");\r\n if(allBookedFlights == null) {\r\n allBookedFlights = JsonArray.create();\r\n }\r\n\r\n for (Object newFlight : newFlights) {\r\n checkFlight(newFlight);\r\n JsonObject t = ((JsonObject) newFlight);\r\n t.put(\"bookedon\", \"try-cb-java\");\r\n<\/pre>\n allBookedFlights.add(t);\r\n added.add(t);\r\n }\r\n\r\n userData.content().put(\"flights\", allBookedFlights);\r\n<\/pre>\n
JsonDocument response = bucket.upsert(userData);\r\n\r\n JsonObject responseData = JsonObject.create()\r\n .put(\"added\", added);\r\n\r\n return Result.of(responseData.toMap(), \"Booked flight in Couchbase document \" + response.id());\r\n }\r\n<\/pre>\n
Recursos<\/h3>\n