{"id":9884,"date":"2021-09-03T00:00:50","date_gmt":"2021-09-03T07:00:50","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=9884"},"modified":"2025-06-13T20:45:58","modified_gmt":"2025-06-14T03:45:58","slug":"how-to-migrate-to-scopes-and-collections-in-couchbase-7-0","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-to-scopes-and-collections-in-couchbase-7-0\/","title":{"rendered":"How to Migrate to Scopes & Collections in Couchbase 7.0"},"content":{"rendered":"

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

Scopes and Collections are a new feature introduced in the Couchbase Server 7.0 release<\/a> that allows you to logically organize data within Couchbase. To learn more, read the following 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’re trying to consolidate hundreds of microservices and\/or tenants into a single Couchbase<\/a> cluster (resulting in much lower TCO).<\/p>\n

In this article, I’ll go over how you can plan your migration from an older Couchbase version to using Scopes and Collections in Couchbase 7.0.<\/p>\n

High-Level Migration Steps<\/h2>\n

The following are the high level steps of migrating to Scopes and Collections in Couchbase 7.0.<\/p>\n

Not all steps are essential: it all depends on your use case and particular technology requirements. I’ll walk you through the details of each of these steps in subsequent sections.<\/p>\n

    \n
  1. Upgrade to Couchbase Server 7.0<\/strong><\/li>\n
  2. Plan your Scopes and Collections strategy<\/strong>: Determine what Buckets, Scopes, Collections and indexes you need. Determine the mapping from old Bucket(s) to new Bucket(s)\/Scope(s)\/Collections. Write scripts to create Scopes, Collections and indexes.<\/li>\n
  3. Migrate your application code:<\/strong> This application code is your Couchbase SDK code including N1QL queries.<\/li>\n
  4. Data migration:<\/strong> Determine if an offline strategy works for your deployment or if you need an online migration. Take action accordingly.<\/li>\n
  5. Plan and implement your database security strategy:<\/strong> Determine what Users and Role assignments you need. Create scripts to manage these assignments.<\/li>\n
  6. Go live with your new Collections-aware application<\/strong><\/li>\n
  7. Setup XDCR and setup Backup for your Couchbase database<\/strong><\/li>\n<\/ol>\n
    <\/div>\n

    Upgrade to Couchbase 7<\/h2>\n

    Here’s what you need to know about upgrading to Couchbase Server<\/a> 7.0:<\/p>\n