{"id":12479,"date":"2021-12-21T08:00:29","date_gmt":"2021-12-21T16:00:29","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=12479"},"modified":"2025-06-13T22:40:20","modified_gmt":"2025-06-14T05:40:20","slug":"migrating-buckets-to-collections-scopes-via-eventing-part-2","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/migrating-buckets-to-collections-scopes-via-eventing-part-2\/","title":{"rendered":"Migraci\u00f3n de cubos a colecciones y \u00e1mbitos mediante eventos: Parte 2"},"content":{"rendered":"

Migraci\u00f3n de cubos a colecciones y \u00e1mbitos mediante eventos: Parte 2<\/h2>\n

Una vez m\u00e1s (como ya hice en la primera parte) quiero destacar un excelente blog escrito por Shivani Gupta, C\u00f3mo migrar a \u00e1mbitos y colecciones en Couchbase 7.0<\/a>que cubre en gran detalle otros m\u00e9todos para migrar documentos basados en buckets a Scopes y Collections en Couchbase. Te animo a leer tambi\u00e9n sobre los m\u00faltiples m\u00e9todos no-Eventing que Shivani toca.<\/p>\n

Tanto si eres nuevo en Couchbase o<\/strong> veterinario experimentado, es probable que haya o\u00eddo hablar de los Scopes y Collections. Si est\u00e1s listo para probarlos, este art\u00edculo te ayuda a hacerlo realidad.<\/p>\n

Los \u00e1mbitos y las colecciones son una nueva funci\u00f3n introducida en Servidor Couchbase 7.0<\/a>\u00a0que te permite organizar l\u00f3gicamente los datos dentro de Couchbase. Para saber m\u00e1s,\u00a0lea esta introducci\u00f3n a \u00c1mbitos y colecciones<\/a>.<\/p>\n

Deber\u00edas aprovechar Scopes y Collections si quieres mapear tu RDBMS heredado a una base de datos de documentos o si est\u00e1s intentando consolidar cientos de microservicios y\/o tenants en un \u00fanico\u00a0Couchbase<\/a>\u00a0(lo que se traduce en un coste total de propiedad mucho menor).<\/p><\/blockquote>\n

\n

Uso de eventos para la migraci\u00f3n de \u00e1mbitos y colecciones<\/h2>\n

En el art\u00edculo anterior (Parte 1), discut\u00ed la mec\u00e1nica de un m\u00e9todo de alto rendimiento para migrar desde una versi\u00f3n anterior de Couchbase a Scopes y Collections en Couchbase 7.0 basado en Eventos<\/a>.<\/span><\/p>\n

S\u00f3lo se necesita el Servicio de Datos (o KV) y el Servicio de Eventos para migrar de buckets a colecciones. En un cluster de Couchbase grande y bien ajustado, puedes migrar m\u00e1s de 1 mill\u00f3n de documentos por segundo. S\u00ed, sin N1QL, y sin necesidad de \u00edndices.<\/span><\/p>\n

En este art\u00edculo de seguimiento, proporcionar\u00e9 una metodolog\u00eda sencilla totalmente automatizada para realizar grandes migraciones con docenas (o incluso cientos) de tipos de datos a trav\u00e9s de un simple <\/span>Perl<\/span><\/i> gui\u00f3n.<\/span><\/p>\n

Recapitulaci\u00f3n de la funci\u00f3n final de Eventing: ConvertBucketToCollections<\/h3>\n

En la Parte 1 ten\u00edamos los siguientes ajustes para la Funci\u00f3n de Eventos. Nota para cada tipo \u00fanico, \"cerveza<\/strong>\" y \"cervecer\u00eda<\/strong>\"tuvimos que a\u00f1adir un alias de Bucket binding a la colecci\u00f3n destino en modo \"lectura+escritura\". Adem\u00e1s tuvimos que crear las colecciones de destino, en este caso \"datos.masivos.cerveza<\/strong>\" y \"datos.masivos.cervecer\u00eda<\/strong>“<\/span><\/p>\n

\"\"<\/p>\n

En la Parte 1 ten\u00edamos el siguiente c\u00f3digo JavaScript en nuestra Funci\u00f3n Eventing. Nota a cada tipo \u00fanico, \"cerveza<\/strong>\" y \"cervecer\u00eda<\/strong>\"Tuvimos que replicar un bloque de c\u00f3digo JavaScript y actualizar la referencia del alias de enlace correspondiente o la colecci\u00f3n de destino en el servicio de datos de Couchbase.<\/span><\/p>\n

function OnUpdate(doc, meta) {\r\n    if (!doc.type) return;\r\n  \r\n    var type = doc.type;\r\n    if (DROP_TYPE) delete doc.type;\r\n  \r\n    if (type === 'beer') {\r\n        if (DO_COPY) beer_col[meta.id] = doc;\r\n        if (DO_DELETE) {\r\n            if(!beer_col[meta.id]) { \/\/ safety check \r\n                log(\"skip delete copy not found type=\" + doc.type + \", meta.id=\" + meta.id);\r\n            } else {\r\n                delete src_col[meta.id];\r\n            }\r\n        }\r\n    }\r\n    if (type === 'brewery') {\r\n        if (DO_COPY) brewery_col[meta.id] = doc;\r\n        if (DO_DELETE) {\r\n            if(!brewery_col[meta.id]) { \/\/ safety check\r\n                log(\"skip delete copy not found type=\" + doc.type + \", meta.id=\" + meta.id);\r\n            } else {\r\n                delete src_col[meta.id];\r\n            }\r\n        }\r\n    }\r\n}<\/pre>\n
La t\u00e9cnica de la Parte 1 funciona, pero \u00bfy si tengo muchos tipos?<\/h2>\n
Usando Eventing se pueden hacer migraciones como se muestra en la Parte 1, pero parece un poco de trabajo para configurar las cosas.<\/p>\n
Si tiene 80 tipos diferentes, utilizar esta t\u00e9cnica (tanto para crear la funci\u00f3n de eventos como para crear los espacios clave necesarios) supondr\u00eda una cantidad incre\u00edble de esfuerzo propenso a errores. Si tuviera 80 tipos en un cubo para migrar y dividir, no me gustar\u00eda hacer todo el trabajo descrito anteriormente a mano para cada tipo.<\/p>\n
Automatizar mediante CustomConvertBucketToCollections.pl<\/h2>\n
Para resolver este problema, escrib\u00ed un peque\u00f1o Perl<\/em> gui\u00f3n, CustomConvertBucketToCollections.pl<\/em>que genera dos archivos:<\/p>\n