Membuat profil koneksi
Halaman ini menjelaskan bagian persiapan dari proses migrasi tempat Anda membuat profil koneksi Datastream yang akan digunakan nanti dari mengimpor data dari database sumber yang kompatibel dengan MongoDB ke bucket Cloud Storage.
Pada tahap ini, Anda melakukan hal berikut:
- Buat profil koneksi Cloud Storage untuk bucket Cloud Storage yang telah Anda buat sebelumnya.
- Buat profil koneksi untuk database sumber yang kompatibel dengan MongoDB.
Login ke gcloud CLI
Prosedur migrasi yang dijelaskan di bagian berikutnya menggunakan gcloud CLI untuk mengonfigurasi dan mengaktifkan langkah-langkah migrasi. Mulailah dengan login ke Google Cloud dan memilih project yang akan menghosting pipeline migrasi.
gcloud auth login
gcloud config set project "$PROJECT_ID"
Membuat profil koneksi untuk database sumber
MongoDB di Compute Engine
Jalankan perintah berikut untuk membuat profil koneksi Datastream ke database MongoDB yang dihosting di Compute Engine.
Hapus flag --mongodb-replica-set dari perintah berikut saat terhubung ke cluster yang di-shard.
gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_IP_ADDRESS" \
--mongodb-replica-set="$REPLICA_SET" \
--private-connection="$PRIVATE_CONNECTION_NAME" \
--mongodb-standard-connection-format \
--type=mongodb \
--mongodb-direct-connection
MongoDB melalui SSH
Contoh ini mengasumsikan bahwa Anda telah mengonfigurasi konektivitas SSH ke jaringan pribadi, baik langsung ke mesin yang menghosting server yang kompatibel dengan MongoDB, atau melalui host Bastion.
Jalankan perintah berikut untuk membuat profil koneksi Datastream ke database MongoDB yang dihosting di Compute Engine.
Hapus flag --mongodb-replica-set dari perintah berikut saat terhubung ke cluster yang di-shard.
Jika ingin terhubung dengan sandi SSH, teruskan flag --forward-ssh-password, bukan flag --forward-ssh-private-key.
gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_IP_ADDRESS" \
--mongodb-replica-set="$REPLICA_SET" \
--forward-ssh-hostname="$BASTION_IP_ADDRESS" \
--forward-ssh-port="$BASTION_SSH_PORT" \
--forward-ssh-username="$BASTION_SSH_USERNAME" \
--forward-ssh-private-key="$BASTION_SSH_PRIVATE_KEY" \
--mongodb-standard-connection-format \
--type=mongodb \
--mongodb-direct-connection
Amazon DocumentDB
Contoh ini mengasumsikan bahwa Anda telah mendapatkan parameter dan sertifikat yang diperlukan untuk konektivitas Amazon DocumentDB.
Sebelum membuat profil koneksi, aktifkan secara eksplisit aliran perubahan di database Amazon DocumentDB. Lihat panduan Aliran Perubahan Amazon DocumentDB untuk mengetahui petunjuk tentang cara mengaktifkan fitur ini.
Jalankan perintah berikut untuk membuat profil koneksi Datastream ke database DocumentDB Anda:
gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_HOST_ADDRESS" \
--mongodb-replica-set="$REPLICA_SET" \
--forward-ssh-hostname="$BASTION_IP_ADDRESS" \
--forward-ssh-port="$BASTION_SSH_PORT" \
--forward-ssh-username="$BASTION_SSH_USERNAME" \
--forward-ssh-private-key="$BASTION_SSH_PRIVATE_KEY" \
--mongodb-ca-certificate="$DOCUMENT_DB_CA_CERTIFICATE" \
--mongodb-tls \
--mongodb-standard-connection-format \
--type=mongodb \
--mongodb-direct-connection
Azure Cosmos DB
Aktifkan secara eksplisit aliran perubahan untuk MongoDB di API Azure Cosmos DB untuk mengaktifkan aliran Datastream.
Langkah ini mengharuskan Anda menginstal Azure CLI .
az resource patch --ids "/subscriptions/subscription_id/resourceGroups/resource_group_name/providers/Microsoft.DocumentDB/mongoClusters/vCore_cluster_name" \
--api-version 2024-10-01-preview \
--properties "{\"previewFeatures\": [ \"ChangeStreams\"]}"
Ganti subscription_id, resource_group_name, dan vCore_cluster_name dengan nilai yang sesuai dengan deployment Azure Cosmos DB Anda.
Jalankan perintah berikut untuk membuat profil koneksi Datastream ke Azure Cosmos DB sumber.
Contoh ini mengasumsikan bahwa sumber dapat diakses melalui DNS publik atau alamat IP yang dapat dinyatakan dalam format koneksi MongoDB SRV. Petunjuk ini juga mengasumsikan bahwa server Azure Cosmos DB menggunakan kombinasi nama pengguna dan sandi untuk autentikasi.
gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_HOST_ADDRESS" \
--mongodb-srv-connection-format \
--type=mongodb \
--static-ip-connectivity \
--labels=skip_all_validations=true
MongoDB Atlas
Jalankan perintah berikut untuk membuat profil koneksi Datastream ke database MongoDB Atlas sumber.
Contoh ini mengasumsikan bahwa sumber dapat diakses melalui DNS publik atau alamat IP yang dapat dinyatakan dalam format koneksi MongoDB SRV. Petunjuk ini juga mengasumsikan bahwa server MongoDB Atlas menggunakan kombinasi nama pengguna dan sandi untuk autentikasi.
gcloud datastream connection-profiles create "$SRC_CONNECTION_PROFILE_NAME" \
--display-name="$SRC_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--mongodb-username="$MONGODB_USERNAME" \
--mongodb-password="$MONGODB_PASSWORD" \
--mongodb-host-addresses="$MONGODB_HOST_ADDRESS" \
--mongodb-srv-connection-format \
--type=mongodb \
--static-ip-connectivity
Untuk mengetahui informasi selengkapnya tentang cara memantau pembuatan profil koneksi, lihat Pemecahan masalah.
Membuat profil koneksi Cloud Storage
Konfigurasi profil koneksi Datastream untuk tujuan Cloud Storage, yaitu bucket yang telah Anda buat sebelumnya.
gcloud datastream connection-profiles create "$DST_CONNECTION_PROFILE_NAME" \
--display-name="$DST_CONNECTION_PROFILE_NAME" \
--location="$LOCATION" \
--type=google-cloud-storage \
--bucket="$GCS_BUCKET_NAME" \
--root-path="/$GCS_BUCKET_ROOT_PATH"
Untuk mengetahui informasi selengkapnya tentang cara memantau pembuatan profil koneksi, lihat Pemecahan masalah.
Langkah berikutnya
Lanjutkan ke Mengimpor dari database sumber.