{"id":12476,"date":"2021-12-20T08:00:41","date_gmt":"2021-12-20T16:00:41","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=12476"},"modified":"2025-06-13T22:40:20","modified_gmt":"2025-06-14T05:40:20","slug":"migrating-buckets-to-collections-scopes-via-eventing-part-1","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/migrating-buckets-to-collections-scopes-via-eventing-part-1\/","title":{"rendered":"Migrating Buckets to Collections & Scopes via Eventing: Part 1"},"content":{"rendered":"

Migrating Buckets to Collections & Scopes via Eventing: Part 1<\/h2>\n

First I want to point out an excellent blog written by Shivani Gupta, How to Migrate to Scopes & Collections in Couchbase 7.0<\/a>, which covers in great detail other methods of migrating bucket-based documents to Scopes and Collections in Couchbase.\u00a0 I encourage you to also read about the multiple non-Eventing methods that Shivani touches upon.<\/p>\n

Whether you\u2019re new to Couchbase or<\/strong> a seasoned vet, you\u2019ve likely heard about Scopes and Collections. If you\u2019re ready to try them, this article helps you make it happen.<\/p>\n

Scopes and Collections are a new feature introduced in Couchbase Server 7.0<\/a>\u00a0that allows you to logically organize data within Couchbase. To learn more,\u00a0read this introduction to Scopes and Collections<\/a>.<\/p>\n

You should take advantage of Scopes and Collections if you want to map your legacy RDBMS to a document database or if you\u2019re trying to consolidate hundreds of microservices and\/or tenants into a single\u00a0Couchbase<\/a>\u00a0cluster (resulting in much lower TCO).<\/p><\/blockquote>\n

\n

Using Eventing for Scopes & Collections Migration<\/h2>\n

In this article, I\u2019ll discuss the mechanics of another high performance method to migrate from an older Couchbase version to Scopes and Collections in Couchbase 7.0.<\/p>\n

You only need the Data Service (or KV) and Eventing to migrate from buckets to collections. In a well-tuned, large Couchbase cluster, you can migrate over 1 million documents a second. Yes, no N1QL, and no index needed.<\/p>\n

In the follow up post (Part 2), I will provide a simple fully automated methodology to do large migrations with dozens \u00a0(or even hundreds) <\/span>of data types via a simple Perl<\/em> script.<\/p>\n

Prerequisites: Learning about Eventing<\/h2>\n

In this article, we will use the latest version of Couchbase (7.0.2), but prior 7.0 versions work fine as well.<\/span><\/p>\n

If you are not familiar with Couchbase or the Eventing service, please walk through the following resources, including at least one Eventing example:<\/p>\n