Migrasi dari Couchbase Server ke Couchbase Capella di AWS - AWS Prescriptive Guidance
RingkasanPrasyarat dan batasanArsitekturAlatEpikSumber daya terkaitInformasi tambahan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Migrasi dari Couchbase Server ke Couchbase Capella di AWS

Battulga Purevragchaa dan Saurabh Shanbhag, Amazon Web Services

Mark Gamble, Tidak Ada

Ringkasan

Couchbase Capella adalah database NoSQL yang dikelola sepenuhnya sebagai layanan (DBaaS) untuk aplikasi mission-critical (misalnya, profil pengguna atau katalog online dan manajemen inventaris). Couchbase Capella mengelola beban kerja DBaa S Anda di akun Amazon Web Services (AWS) yang dikelola Couchbase. Capella memudahkan untuk menjalankan dan mengelola replikasi multi-cluster, Multiple—AWS Region, multicloud, dan hybrid-cloud dalam satu antarmuka.

Couchbase Capella membantu Anda secara instan menskalakan aplikasi Server Couchbase Anda, membantu Anda membuat klaster multi-node dalam hitungan menit. Couchbase Capella mendukung semua fitur Server Couchbase, termasuk SQL++, Pencarian Teks Lengkap, Layanan Eventing, dan Layanan Analytics. Ini juga menghilangkan kebutuhan untuk mengelola instalasi, upgrade, backup, dan pemeliharaan database umum. 

Pola ini menjelaskan langkah-langkah dan praktik terbaik untuk memigrasikan lingkungan Server Couchbase yang dikelola sendiri ke AWS Cloud. Pola ini menyediakan proses berulang untuk memigrasikan data dan indeks dari kluster Couchbase Server, berjalan baik di tempat atau di cloud, ke Couchbase Capella. Menggunakan langkah-langkah ini membantu Anda menghindari masalah selama migrasi dan mempercepat proses migrasi secara keseluruhan.

Pola ini menyediakan dua opsi migrasi berikut:

  • Opsi 1 sesuai jika Anda memiliki kurang dari 50 indeks untuk dimigrasi. 

  • Opsi 2 sesuai jika Anda memiliki lebih dari 50 indeks untuk dimigrasi. 

Anda juga dapat mengatur data sampel di Server Couchbase yang dikelola sendiri untuk mengikuti panduan migrasi.

Jika Anda memilih opsi migrasi 2, atau jika Anda menggunakan cakupan atau koleksi selain nilai default, Anda harus menggunakan contoh file konfigurasi, yang ada di bagian Informasi tambahan.

Prasyarat dan batasan

Prasyarat

  • Akun berbayar Couchbase Capella yang ada. Anda juga dapat membuat akun Couchbase Capella di AWS dan menggunakan uji coba gratis Couchbase Capella, lalu memutakhirkan ke akun berbayar untuk mengonfigurasi kluster Anda untuk migrasi.. Untuk memulai dengan versi uji coba, ikuti petunjuk di Memulai dengan Couchbase Capella.

  • Lingkungan Server Couchbase yang dikelola sendiri yang ada baik di tempat atau digunakan di penyedia layanan cloud. 

  • Untuk opsi migrasi 2, Couchbase Shell dan file konfigurasi. Untuk membuat file konfigurasi, Anda dapat menggunakan file contoh yang ada di bagian Informasi tambahan.

  • Keakraban dengan mengelola Couchbase Server dan Couchbase Capella.

  • Keakraban dengan membuka port TCP dan menjalankan perintah dalam antarmuka baris perintah (CLI).

Proses migrasi juga membutuhkan peran dan keahlian yang dijelaskan dalam tabel berikut.

Peran

Keahlian

Tanggung Jawab

Administrator Couchbase

  • Keakraban dengan Couchbase Server dan Couchbase Capella

  • Pengetahuan baris perintah dasar sangat membantu tetapi tidak diperlukan

  • Server Couchbase dan tugas khusus Capella

Administrator sistem, administrator TI

  • Keakraban dengan lingkungan dan administrasi sistem Couchbase Server yang dikelola sendiri

  • Membuka port dan menentukan alamat IP pada node cluster Couchbase Server yang dikelola sendiri

Batasan

Versi produk

Arsitektur

Tumpukan teknologi sumber

  • Server Couchbase

Tumpukan teknologi target

  • Couchbase Capella

Arsitektur target

Migrasi Couchbase Capella ke cluster Couchbase di bidang data Capella di AWS dalam empat langkah.

  1. Anda mengakses Couchbase Capella dengan menggunakan Capella Control Plane. Anda dapat menggunakan Capella Control Plane untuk melakukan hal berikut:

    • Kontrol dan pantau akun Anda.

    • Kelola cluster dan data, indeks, pengguna dan grup, izin akses, pemantauan, dan acara.

  2. Cluster dibuat.

  3. Capella Data Plane ada di akun AWS yang dikelola Couchbase. Setelah Anda membuat klaster baru, Couchbase Capella menerapkannya di beberapa Availability Zone di Wilayah AWS yang dipilih.

  4. Anda dapat mengembangkan dan menerapkan aplikasi Couchbase di VPC di akun AWS Anda. Biasanya, VPC ini mengakses Capella Data Plane melalui VPC peering.

Alat

  • Couchbase Cross Data Center Replication (XDCR) membantu mereplikasi data di seluruh cluster yang terletak di penyedia cloud yang berbeda dan pusat data yang berbeda. Ini digunakan untuk memigrasikan data ke Couchbase Capella dari cluster Server Couchbase yang dikelola sendiri.

    catatan

    XDCR tidak dapat digunakan dengan Couchbase Server Community Edition untuk bermigrasi ke Couchbase Capella. Sebagai gantinya, Anda dapat menggunakan cbexport. Untuk informasi selengkapnya, lihat epik Migrasi data dari Edisi Komunitas.

  • Couchbase Shell adalah shell baris perintah untuk Couchbase Server dan Couchbase Capella untuk mengakses cluster Couchbase lokal dan jarak jauh. Dalam pola ini, Couchbase Shell digunakan untuk memigrasikan indeks.

  • cbexport adalah utilitas Couchbase untuk mengekspor data dari cluster Couchbase. Termasuk dalam alat CLI Server Couchbase.

Epik

TugasDeskripsiKeterampilan yang dibutuhkan

Evaluasi ukuran cluster Couchbase Server yang dikelola sendiri.

Masuk ke Konsol Web Couchbase untuk Server Couchbase, dan nilai node dan bucket cluster yang dikelola sendiri. 

  1. Untuk menampilkan daftar node cluster, pilih tab Server di bilah navigasi. 

  2. Catat jumlah node, lalu pilih setiap node pada daftar untuk menampilkan propertinya. 

  3. Rekam memori dan penyimpanan untuk setiap node individu.

  4. Pilih tab Bucket di bilah navigasi, lalu pilih setiap bucket dalam daftar untuk menampilkan propertinya. Catat kuota RAM dan pengaturan resolusi konflik untuk setiap bucket.

Anda akan menggunakan konfigurasi cluster Couchbase Server yang dikelola sendiri sebagai panduan umum untuk mengukur dan mengonfigurasi cluster target di Couchbase Capella.

Untuk bantuan dengan latihan ukuran Couchbase Capella yang lebih detail, hubungi Couchbase.

Administrator Couchbase

Rekam distribusi Layanan Couchbase di cluster Couchbase Server yang dikelola sendiri.

  1. Pada Couchbase Web Console, pilih tab Server untuk menampilkan daftar node cluster. 

  2. Pilih setiap node untuk menampilkan propertinya dan kemudian rekam distribusi Layanan Couchbase untuk setiap node (Layanan Data, Layanan Kueri, Layanan Indeks, Layanan Pencarian, Layanan Analisis, dan Layanan Eventing).

Administrator Couchbase

Rekam alamat IP node cluster Couchbase Server yang dikelola sendiri.

(Abaikan langkah ini jika Anda menggunakan Edisi Komunitas.) Catat alamat IP untuk setiap node di cluster Anda. Mereka akan ditambahkan ke daftar izinkan di cluster Couchbase Capella Anda nanti.

Administrator Couchbase, Administrator sistem
TugasDeskripsiKeterampilan yang dibutuhkan

Pilih templat.

  1. Masuk ke Couchbase Capella Control Plane Anda, pilih tab Dashboard atau tab Clusters di navigasi utama, lalu pilih Create Cluster. 

  2. Menggunakan informasi yang Anda rekam dari evaluasi cluster Couchbase Server yang dikelola sendiri, pilih template cluster yang memenuhi persyaratan konfigurasi. Jika Anda tidak menemukan template yang sesuai, pilih Template Kustom di editor Ukuran Cluster.

Administrator Couchbase

Pilih dan konfigurasikan node.

Pilih dan konfigurasikan node agar sesuai dengan lingkungan cluster Couchbase Server yang dikelola sendiri, termasuk jumlah node, distribusi layanan, komputasi atau RAM, dan penyimpanan.

Couchbase Capella menggunakan praktik terbaik penskalaan multidimensi. Layanan dan node hanya dapat dipilih sesuai dengan praktik terbaik penerapan. Ini mungkin berarti bahwa Anda tidak dapat sama persis dengan konfigurasi cluster Couchbase Server yang dikelola sendiri.

Administrator Couchbase

Menyebarkan cluster.

Pilih zona dukungan dan paket dukungan, lalu gunakan cluster. Untuk langkah dan petunjuk mendetail, lihat Membuat klaster di dokumentasi Couchbase.

penting

Jika Anda menggunakan uji coba gratis Couchbase Capella, Anda harus mengonversinya menjadi akun berbayar sebelum memulai migrasi. Untuk mengonversi akun Anda, buka bagian Penagihan pada Couchbase Capella Control Plane, lalu pilih Tambahkan ID Aktivasi. ID Aktivasi dikirim ke alamat email kontak penagihan Anda setelah Anda menyelesaikan perjanjian pembelian dengan Couchbase Sales, atau setelah Anda melakukan pembelian melalui AWS Marketplace.

Administrator Couchbase

Buat pengguna kredenal basis data.

Pengguna kredenal basis data khusus untuk klaster dan terdiri dari nama pengguna, kata sandi, dan sekumpulan hak istimewa bucket. Pengguna ini diperlukan untuk membuat bucket dan mengakses data bucket. 

Di Couchbase Capella Control Plane, buat kredensi database untuk cluster baru dengan mengikuti petunjuk di Configure database credentials dalam dokumentasi Couchbase Capella.

catatan

Pengguna organisasi memerlukan kredensi peran organisasi yang ditetapkan kepada mereka jika mereka ingin mengakses data bucket pada klaster tertentu, baik dari jarak jauh atau melalui UI Couchbase Capella. Ini terpisah dari kredensi database, yang biasanya digunakan oleh aplikasi dan integrasi. Membuat pengguna organisasi memungkinkan Anda membuat dan mengelola bucket target di cluster Couchbase Capella Anda.

Administrator Couchbase

Jika menggunakan opsi migrasi 2, instal Couchbase Shell.

Anda dapat menginstal Couchbase Shell pada sistem apa pun yang memiliki akses jaringan ke Server Couchbase yang dikelola sendiri dan cluster Couchbase Capella. Untuk informasi selengkapnya, lihat Menginstal Couchbase Shell versi 1.0.0-beta.5 di dokumentasi Couchbase Shell.

Konfirmasikan bahwa Couchbase Shell diinstal dengan menguji koneksi ke cluster yang dikelola sendiri di terminal baris perintah.

Administrator Couchbase, Administrator sistem

Izinkan alamat IP.

  1. Di Couchbase Capella Control Plane, pilih Clusters, lalu pilih cluster target Anda. 

  2. Pilih tab Connect untuk klaster, dan rekam titik akhir koneksi untuk klaster Anda yang tercantum di bawah Kelola IP yang Diizinkan.

  3. Untuk menambahkan alamat IP untuk sistem tempat Anda menginstal Couchbase Shell dan alamat IP instance cluster Couchbase Server yang dikelola sendiri sebagai alamat IP yang diizinkan, lakukan hal berikut: 

    1. Di bawah Jaringan Area Luas, pilih Kelola IP yang Diizinkan. 

    2. Pilih Add Allowed IP, masukkan alamat IP untuk sistem tempat Anda menginstal Couchbase Shell, lalu pilih Add IP. 

    3. Ulangi langkah sebelumnya untuk menambahkan alamat IP instance cluster Couchbase Server yang dikelola sendiri. 

Untuk informasi selengkapnya tentang alamat IP yang diizinkan, lihat Mengonfigurasi alamat IP yang diizinkan dalam dokumentasi Couchbase.

Administrator Couchbase, Administrator sistem

Konfigurasikan sertifikat.

  1. Untuk mengunduh sertifikat root untuk klaster Anda, di bawah Root Certificate, pilih Unduh. 

  2. Simpan sertifikat root menggunakan ekstensi file.pem di folder pada sistem yang akan menjalankan Couchbase Shell.

  3. Selanjutnya, masuk ke Konsol Web Server Couchbase yang dikelola sendiri, pilih Keamanan di bilah navigasi kiri, lalu pilih tab Sertifikat.

  4. Salin sertifikat root untuk cluster Couchbase Server yang dikelola sendiri dan simpan sebagai file.pem ke folder yang sama tempat Anda menyimpan file sertifikat root untuk cluster Couchbase Capella Anda. Untuk informasi selengkapnya tentang sertifikat root, lihat sertifikat Root di dokumentasi Couchbase Server.

Administrator Couchbase, Administrator sistem

Buat file konfigurasi untuk Couchbase Shell.

Buat dotfile konfigurasi di direktori home instalasi Couchbase Shell (misalnya,). /<HOME_DIRECTORY>/.cbsh/config Untuk informasi selengkapnya, lihat Config dotfiles dalam dokumentasi Couchbase.

Tambahkan properti koneksi untuk cluster sumber dan target ke file konfigurasi. Anda dapat menggunakan contoh file konfigurasi yang ada di bagian Informasi tambahan dan mengedit pengaturan untuk cluster Anda. 

Simpan file konfigurasi dengan pengaturan yang diperbarui ke .cbsh folder (misalnya,/<HOME_DIRECTORY>/.cbsh/config).

Administrator Couchbase, Administrator sistem

Buat ember target.

Untuk setiap bucket sumber, buat satu bucket target di cluster Couchbase Capella Anda dengan mengikuti petunjuk di Buat bucket dalam dokumentasi Couchbase.

Konfigurasi bucket target Anda harus sesuai dengan nama bucket, pengaturan memori, dan pengaturan resolusi konflik bucket di cluster Couchbase Server yang dikelola sendiri.

Administrator Couchbase

Buat cakupan dan koleksi.

Setiap bucket berisi cakupan dan koleksi default dengan keyspace_default._default. Jika Anda menggunakan ruang kunci lain untuk cakupan dan koleksi Anda, Anda harus membuat ruang kunci yang identik di cluster Capella target.

  1. Buka terminal baris perintah pada sistem tempat Anda menginstal Couchbase Shell. 

  2. Untuk memulai Couchbase Shell, jalankan perintah berikut.

    ./cbsh

  3. Untuk setiap bucket yang ingin dimigrasikan, buat cakupan dan koleksi di cluster Capella dengan menjalankan perintah berikut. Pastikan Anda mengganti <BUCKET_NAME>dengan nama bucket yang ingin dimigrasikan.

scopes --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" }
collections --clusters "On-Prem-Cluster" --bucket <BUCKET_NAME> | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket <BUCKET_NAME> --scope $it.scope }
Administrator Couchbase
TugasDeskripsiKeterampilan yang dibutuhkan

Buka port TCP pada node cluster Couchbase Server yang dikelola sendiri.

Pastikan port yang sesuai terbuka untuk komunikasi XDCR pada node cluster Couchbase Server yang dikelola sendiri. Untuk informasi selengkapnya, lihat dokumentasi port Server Couchbase.

Administrator Couchbase, Administrator sistem

Jika Anda menggunakan Couchbase Server Enterprise Edition, siapkan Couchbase XDCR.

  1. Di navigasi utama Couchbase Capella Control Plane, pilih Clusters, lalu pilih cluster target untuk migrasi. 

  2. Di bawah Root Certificate, pilih Salin.

  3. Masuk ke Konsol Web Server Couchbase yang dikelola sendiri, dan di navigasi utama, pilih XDCR. Kemudian pilih Add Remote. 

  4. Masukkan setelan berikut: 

    • Nama Cluster — Nama untuk koneksi cluster Capella

    • IP/HostName - Titik akhir koneksi untuk cluster Couchbase Capella Anda

    • Nama pengguna untuk Remote Cluster - Pengguna database untuk cluster Couchbase Capella Anda

    • Kata sandi — Kata sandi pengguna database untuk cluster Couchbase Capella Anda

    • Aktifkan Koneksi Aman — Dipilih

    • Lengkap (TLS mengenkripsi kata sandi dan data) - Dipilih

  5. Rekatkan sertifikat root cluster Capella yang Anda salin sebelumnya, lalu pilih Simpan.

Administrator Couchbase

Mulai Couchbase XDCR.

  1. Di Konsol Web Server Couchbase yang dikelola sendiri, pilih XDCR di navigasi utama, lalu pilih Tambah Replikasi.

  2. Masukkan setelan berikut:

    • Replikasi Dari Bucket — Pilih keranjang sumber untuk migrasi.

    • Remote Bucket — Masukkan nama bucket target.

    • Cluster Jarak Jauh — Pilih cluster target yang Anda buat sebelumnya.

  3. Pilih Simpan Replikasi. Proses replikasi akan dimulai dalam beberapa detik.

Administrator Couchbase
TugasDeskripsiKeterampilan yang dibutuhkan

Migrasikan indeks cluster yang dikelola sendiri ke Couchbase Capella.

penting

Kami merekomendasikan proses ini jika Anda memiliki kurang dari 50 indeks untuk dimigrasi. Jika Anda memiliki lebih dari 50 indeks untuk dimigrasi, sebaiknya gunakan opsi migrasi 2.

  1. Di Konsol Web Couchbase, pilih Indeks.

  2. Dalam daftar indeks, pilih indeks pertama yang ingin Anda migrasi. Definisi indeks kemudian ditampilkan.

  3. Salin definisi indeks dengan menggunakan CREATE pernyataan, tetapi jangan salinWITH { "defer_build":true }.

    Misalnya, dari definisi indeks contoh berikut, Anda hanya akan menyalinCREATE INDEX `cityindex` ON `travel-sample`(`city`). 

    CREATE INDEX `cityindex` ON `travel-sample`(`city`) WITH { "defer_build":true }

  4. Di Couchbase Capella Control Plane, pilih Clusters, lalu pilih cluster target. 

  5. Pada daftar dropdown Tools, pilih Query Workbench. Tempelkan CREATE pernyataan yang Anda salin sebelumnya ke Editor Kueri, lalu pilih Jalankan. Ini membuat dan membangun indeks.

  6. Untuk mengonfirmasi bahwa indeks dibuat, pilih Indeks dari daftar dropdown Alat. Daftar menunjukkan bahwa indeks dibuat dan dibangun.

  7. Ulangi proses ini untuk setiap indeks yang harus dimigrasikan.

Administrator Couchbase, Administrator sistem
TugasDeskripsiKeterampilan yang dibutuhkan

Migrasikan definisi indeks.

penting

Kami merekomendasikan proses ini jika Anda memiliki lebih dari 50 indeks untuk dimigrasi. Jika Anda memiliki kurang dari 50 indeks untuk dimigrasi, sebaiknya gunakan opsi migrasi 1.

  1. Buka terminal baris perintah pada sistem tempat Anda menginstal Couchbase Shell. 

  2. Untuk memulai Couchbase Shell, jalankan perintah berikut.

    ./cbsh

  3. Untuk menyambung ke cluster Couchbase Server yang dikelola sendiri, jalankan perintah berikut.

    cb-env cluster On-Prem-Cluster

  4. Untuk memigrasikan definisi indeks dari cluster Couchbase Server yang dikelola sendiri ke cluster Couchbase Capella, jalankan perintah berikut untuk setiap bucket yang ingin Anda migrasikan. Pastikan Anda mengganti <BUCKET_NAME> dengan nama bucket yang sesuai dengan indeks yang ingin dimigrasikan. Opsi migrasi ini mengharuskan nama bucket target Anda identik dengan nama bucket sumber.

    query indexes --definitions | where bucket =~ <BUCKET_NAME>| get definition | each { |it| query $it --clusters Capella-Cluster }
Administrator Couchbase, Administrator sistem

Membangun definisi indeks.

  1. Untuk mengalihkan konteks ke cluster Couchbase Capella, jalankan perintah berikut:

    cb-env cluster Capella-Cluster

  2. Untuk membuat definisi indeks yang dimigrasikan ke cluster Couchbase Capella, jalankan perintah berikut, ganti <BUCKET_NAME> dengan nama bucket yang sesuai dengan indeks yang ingin Anda buat.

    query 'SELECT RAW CONCAT("BUILD INDEX ON ", k , "(['", CONCAT2 ("','", inames), "']);") FROM system:indexes AS s LET bid = CONCAT("`",s.bucket_id, "`"), sid = CONCAT("`", s.scope_id, "`"), kid = CONCAT("`", s.keyspace_id, "`"), k = NVL2(bid, CONCAT2(".", bid, sid, kid), kid) WHERE s.namespace_id = "default" AND s.bucket_id = "" GROUP BY k LETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred') HAVING ARRAY_LENGTH(inames) > 0;' | each { |it| query $it }

  3. Ulangi untuk setiap ember.

Administrator Couchbase, Administrator sistem
TugasDeskripsiKeterampilan yang dibutuhkan

Migrasikan indeks pencarian teks lengkap klaster yang dikelola sendiri ke Couchbase Capella.

  1. Di Konsol Web Couchbase, pilih Cari. 

  2. Dalam daftar indeks pencarian teks lengkap (FTS), pilih indeks FTS pertama yang ingin Anda migrasi, pilih Tampilkan definisi indeks JSON, dan pilih Salin ke Papan Klip. Catat nama indeks dan ember miliknya.

  3. Di Couchbase Capella Control Plane, pilih Clusters dan kemudian pilih cluster target. 

  4. Pada daftar dropdown Alat, pilih Pencarian Teks Lengkap. 

  5. Pilih Indeks Impor, dan tempel definisi indeks FTS. 

  6. Masukkan Nama Indeks, pilih Bucket yang benar, seperti yang tercantum pada klaster yang dikelola sendiri, lalu pilih Buat.

  7. Ulangi proses ini untuk setiap indeks FTS yang harus dimigrasikan.

Administrator Couchbase
TugasDeskripsiKeterampilan yang dibutuhkan

Ekspor data dari Edisi Komunitas Server Couchbase yang dikelola sendiri.

XDCR terenkripsi tidak tersedia di Couchbase Community Edition. Anda dapat mengekspor data dari Couchbase Community Edition dan kemudian mengimpor data secara manual ke Couchbase Capella.

Untuk mengekspor data dari bucket sumber, gunakan cbexport pada baris perintah.

Perintah berikut diberikan sebagai contoh.

cbexport json \
--cluster localhost \
--bucket <SOURCE BUCKET NAME> \
--format lines \
--username <USERNAME> \
--password <PASSWORD> \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json

Perhatikan bahwacbkey,, cbscopecbcoll, dan cbexported_data.json merupakan label sewenang-wenang. Mereka akan direferensikan nanti dalam proses, jadi jika Anda memilih untuk menamainya secara berbeda, catat itu.

Administrator Couchbase

Impor data ke Couchbase Capella.

  1. Di Couchbase Capella Control Plane, pilih Clusters, lalu pilih cluster target.

  2. Dalam daftar dropdown Tools, pilih Impor. Ini akan membuka wizard dengan enam langkah berikut:

    1. Bucket — Pilih ember target.

    2. File — Pilih JSON, pilih Garis, lalu pilih Menggunakan browser web Anda. Jika Anda memiliki sejumlah besar data, Anda dapat menjelajahi opsi Manual. Pilih file yang dibuat olehcbexport.  

    3. Koleksi — Pilih Pemetaan Koleksi Kustom. 

      Jika database Edisi Komunitas Anda tidak menggunakan cakupan atau koleksi, atau hanya menggunakan _default, Anda dapat memilih opsi Pilih Koleksi Tunggal sebagai gantinya.

      Untuk Ekspresi Pemetaan Koleksi, masukkan%cbscope%.%cbcoll%. Untuk memverifikasi bahwa ekspresi ini berfungsi dengan benar, Anda dapat menempelkan data contoh, seperti berikut ini.

      { "cbscope":"inventory", "cbcoll":"landmark", "cbkey":"landmark_3991" }

    4. Kunci - Pilih Generasi Pelanggan. (Jika Anda tidak peduli tentang mempertahankan kunci data yang Anda impor, Anda dapat memilih UUID yang Dihasilkan Secara Otomatis sebagai gantinya dan melanjutkan ke langkah 5.) Untuk Ekspresi Generator Nama Kunci, masukkan %cbkey%. Untuk memverifikasi bahwa ekspresi ini berfungsi dengan benar, tempel beberapa contoh data.

    5. Konfigurasi - Pilih Abaikan bidang, dan masukkan cbscope, cbcoll, cbkey. Bidang ini berisi informasi sementara yang tidak perlu ada di bucket target setelah impor. Biarkan pengaturan lainnya tetap default.

    6. Impor - Tinjau, dan pilih Impor saat Anda siap. Tunggu unggahan dan impor data.

Untuk file besar, Couchbase Capella mendukung impor baris perintah menggunakan cURL. Anda dapat menjelajahi opsi Impor secara lebih rinci di Impor data dalam dokumentasi Couchbase Capella.

Administrator Couchbase
TugasDeskripsiKeterampilan yang dibutuhkan

Verifikasi migrasi data.

  1. Di Couchbase Capella Control Plane, pilih Clusters, lalu pilih cluster target dalam daftar cluster Anda. 

  2. Pilih tab Bucket untuk kluster target Anda. Verifikasi bahwa jumlah Item (dokumen) di bucket target cocok dengan jumlah item di bucket sumber.

  3. Di cluster target, di daftar dropdown Tools, pilih Documents. Verifikasi bahwa semua dokumen telah dimigrasikan.

  4. (Opsional) Setelah semua data dimigrasikan, Anda dapat mematikan replikasi dengan menghapusnya. Untuk informasi selengkapnya, lihat Menghapus replikasi dalam dokumentasi Couchbase.

Administrator Couchbase

Verifikasi migrasi indeks.

Di Couchbase Capella Control Plane, di daftar dropdown Tools untuk cluster target Anda, pilih Indexes. Verifikasi bahwa indeks dimigrasikan dan dibuat.

Administrator Couchbase

Verifikasi hasil kueri.

  1. Di Couchbase Capella Control Plane, di daftar dropdown Tools untuk cluster target Anda, pilih Query Workbench. 

  2. Jalankan contoh kueri N1QL atau kueri yang digunakan dalam aplikasi Anda. Pastikan Anda menerima hasil yang sama seperti saat menjalankan kueri di cluster Couchbase Server yang dikelola sendiri.

Administrator Couchbase

Verifikasi hasil pencarian teks lengkap (berlaku jika Anda memigrasikan indeks FTS).

  1. Di Couchbase Capella Control Plane, di daftar dropdown Tools untuk cluster target Anda, pilih Pencarian Teks Lengkap. 

  2. Pilih indeks FTS dengan memilih namanya. 

  3. Pilih Cari. 

  4. Masukkan contoh permintaan pencarian, dan pilih Cari. 

  5. Verifikasi bahwa hasilnya sama seperti saat Anda menjalankan pencarian di klaster yang dikelola sendiri.

Administrator Couchbase

Sumber daya terkait

Siapkan migrasi

Migrasi data dan indeks

Couchbase SLAs Capella dan dukungan

Informasi tambahan

Kode berikut adalah contoh file konfigurasi untuk Couchbase Shell. 

Version = 1
 
[[clusters]]
identifier = "On-Prem-Cluster"
hostnames = ["<SELF_MANAGED_COUCHBASE_CLUSTER>"]
default-bucket = "travel-sample"
username = "<SELF_MANAGED_ADMIN>"
password = "<SELF_MANAGED_ADMIN_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
 
[[clusters]]
identifier = "Capella-Cluster"
hostnames = ["<COUCHBASE_CAPELLA_ENDPOINT>"]
default-bucket = "travel-sample"
username = "<CAPELLA_DATABASE_USER>"
password = "<CAPELLA_DATABASE_USER_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"

Sebelum Anda menyimpan file konfigurasi, gunakan tabel berikut untuk memastikan bahwa Anda menambahkan sumber dan informasi cluster target Anda sendiri.

 

<SELF_MANAGED_COUCHBASE_CLUSTER>

Gunakan alamat IP untuk cluster Couchbase Server yang dikelola sendiri.

<SELF_MANAGED_ADMIN>

Gunakan pengguna administrator untuk cluster Couchbase Server yang dikelola sendiri.

<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>

Gunakan jalur absolut ke file sertifikat root yang disimpan untuk cluster Couchbase Server yang dikelola sendiri.

<COUCHBASE_CAPELLA_ENDPOINT>

Gunakan titik akhir koneksi untuk cluster Couchbase Capella Anda.

<CAPELLA_DATABASE_USER>

Gunakan pengguna database untuk cluster Couchbase Capella Anda.

<CAPELLA_DATABASE_USER_PWD>

Gunakan kata sandi pengguna database untuk cluster Couchbase Capella Anda.

<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>

Gunakan jalur absolut ke file sertifikat root yang disimpan untuk cluster Couchbase Capella Anda.