Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola profil koneksi menggunakan API

MySQL | PostgreSQL | PostgreSQL ke AlloyDB

Ringkasan

Di halaman ini, Anda akan mempelajari cara menggunakan Database Migration Service API untuk mengelola profil koneksi untuk database sumber PostgreSQL dan tujuan AlloyDB.

Ada dua cara untuk menggunakan Database Migration Service API. Anda dapat melakukan panggilan REST API atau menggunakan Google Cloud CLI (CLI).

Untuk melihat informasi umum tentang penggunaan gcloud untuk mengelola profil koneksi Database Migration Service, klik di sini.

Membuat profil koneksi untuk database sumber PostgreSQL

Berikut adalah permintaan untuk membuat profil koneksi untuk database sumber PostgreSQL.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi
connection-profile-display-name: Nama tampilan profil koneksi
host-ip-address: Alamat IP sumber
username: Nama pengguna database
password: Sandi pengguna database

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Meminta isi JSON:

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk melihat informasi umum tentang penggunaan gcloud untuk membuat profil koneksi Database Migration Service, klik di sini.

Setelah pembuatan, Anda dapat melihat informasi tentang profil koneksi dengan memanggil metode connectionProfiles/get.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi

Metode HTTP dan URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang profil koneksi Anda, klik di sini.

Membuat profil koneksi untuk database sumber Cloud SQL untuk PostgreSQL

Berikut adalah permintaan untuk membuat profil koneksi untuk database sumber Cloud SQL untuk PostgreSQL. Contoh ini menggunakan profil koneksi PostgreSQL karena terhubung ke mesin database PostgreSQL, bukan lapisan pengelolaan Cloud SQL.

Untuk membuat penyambungan antara sumber dan replika menggunakan Cloud SQL, Anda harus memberikan ID instance untuk database Cloud SQL. Anda dapat menemukan nilai ID instance menggunakan metode databases/list Cloud SQL Admin API.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi
connection-profile-display-name: Nama tampilan profil koneksi
host-ip-address: Alamat IP sumber
username: Nama pengguna database
password: Sandi pengguna database
cloud-sql-instance-id: ID instance Cloud SQL

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Meminta isi JSON:

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk melihat informasi umum tentang penggunaan gcloud untuk membuat profil koneksi Database Migration Service, klik di sini.

Membuat profil koneksi untuk tujuan AlloyDB untuk PostgreSQL

Berikut adalah permintaan untuk membuat profil koneksi untuk tujuan AlloyDB untuk PostgreSQL. Database Migration Service menggunakan informasi dalam permintaan ini untuk membuat instance AlloyDB baru.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi
connection-profile-display-name: Nama tampilan profil koneksi
cluster-id: ID cluster AlloyDB yang akan dibuat
user: Nama pengguna yang akan diberikan kepada pengguna awal
password: Sandi yang akan diberikan kepada pengguna awal
vpc-network: Jaringan VPC yang akan dihubungkan dengan cluster AlloyDB
instance-id: ID instance AlloyDB yang akan dibuat
cpu-count: Jumlah CPU yang akan mengonfigurasi instance

Semua data yang disimpan dalam Google Cloud dienkripsi dalam penyimpanan menggunakan sistem pengelolaan kunci yang telah melalui proses hardening yang sama dengan yang kami gunakan untuk data terenkripsi milik kami. Sistem pengelolaan kunci ini menyediakan pengauditan dan kontrol akses kunci yang ketat, serta mengenkripsi data pengguna dalam penyimpanan menggunakan standar enkripsi AES-256. Tidak diperlukan penyiapan, konfigurasi, atau pengelolaan.Enkripsi dalam penyimpanan default Google Cloudadalah pilihan terbaik bagi pengguna yang tidak memiliki persyaratan khusus terkait kepatuhan atau lokalitas materi kriptografis.

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id

Meminta isi JSON:

{
  "displayName": "connection-profile-display-name",
  "alloydb": {
    "cluster_id": "cluster-id"
    "settings": {
      "initial_user": {
        "user": "user",
        "password": "password",
      }
      "vpc_network": "vpc-network",
      "primary_instance_settings": {
        "id": "instance-id",
        "machine_config": {
          "cpu_count": cpu-count
        }
      }
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk melihat informasi umum tentang penggunaan gcloud untuk membuat profil koneksi Database Migration Service, klik di sini.

Mendapatkan informasi tentang profil koneksi

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi

Metode HTTP dan URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang profil koneksi Anda, klik di sini.

Mencantumkan profil koneksi

Berikut adalah permintaan untuk mengambil informasi tentang semua profil koneksi Anda.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project

Anda juga dapat memfilter daftar profil koneksi yang diambil Database Migration Service, sebagai berikut:

orderBy: Gunakan filter ini untuk mengambil listingan semua profil koneksi untuk wilayah tertentu dalam urutan abjad. Misalnya, filter orderBy=name menampilkan semua profil koneksi, menurut abjad, berdasarkan nama.
pageSize: Gunakan filter ini untuk menentukan jumlah maksimum profil koneksi yang diambil dan ditampilkan Database Migration Service di halaman. Misalnya, dengan menetapkan pageSize=10, Database Migration Service akan menampilkan hingga 10 profil koneksi untuk satu halaman.

Jika ada lebih dari 10 profil koneksi, profil tersebut akan muncul di halaman lain. Di akhir setiap halaman, parameter nextPageToken dan ID unik akan muncul. Gunakan ID untuk mengambil listingan profil koneksi untuk halaman berikut.

Metode HTTP dan URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang semua profil koneksi Anda, klik di sini.

Memperbarui profil koneksi

Berikut ini menunjukkan permintaan untuk memperbarui kolom nama pengguna dan sandi profil koneksi yang ada. Dengan menggunakan parameter updateMask dalam permintaan, hanya kolom ini yang perlu disertakan dalam isi permintaan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi
username: Nama pengguna database
password: Sandi pengguna database

Metode HTTP dan URL:

PATCH

Meminta isi JSON:

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     ""

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk mengetahui informasi selengkapnya tentang penggunaan gcloud untuk memperbarui profil koneksi, klik di sini.

Menghapus profil koneksi

Penting: Anda hanya dapat menghapus profil koneksi jika tidak ada tugas migrasi aktif yang terkait dengan profil tersebut. Jika profil koneksi memiliki tugas migrasi yang aktif, promosikan atau hapus tugas tersebut.

Untuk melihat apakah profil koneksi memiliki tugas migrasi aktif yang terkait dengannya, jalankan perintah berikut:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?filter=state:STATE_NAME OR state:STATE_NAME AND source:projects/project-id/locations/region/connectionProfiles/connection-profile-id

Contoh:

GET https://datamigration.googleapis.com/v1/projects/myproject/locations/myregion/migrationJobs?filter=state:RUNNING OR state:FAILED AND source:projects/myproject/locations/myregion/connectionProfiles/postgresql-to-alloydb-src1

Berbagai status tugas migrasi adalah:

NOT STARTED: Tugas migrasi dibuat, tetapi belum dimulai.
STARTING: Tugas migrasi sedang dalam proses dimulai.
RUNNING: Tugas migrasi sedang berjalan dan dapat digunakan untuk memigrasikan data dari database sumber ke database tujuan.
STOPPING: Tugas migrasi sedang dalam proses dihentikan.
STOPPED: Tugas migrasi dijeda, dan tidak lagi memigrasikan data ke database tujuan.
RESUMING: Tugas migrasi yang dijeda sedang berjalan.
FAILED: Terjadi masalah saat tugas migrasi berjalan.
RESTARTING: Database Migration Service mengambil snapshot baru dari database sumber, memuat dump awal ke database tujuan, dan memproses perubahan data yang sedang berlangsung dari database sumber ke database tujuan.

Jika pengguna memiliki tugas migrasi dalam salah satu status ini, dan jika pengguna mencoba menghapus profil koneksi, tugas tersebut akan gagal.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi

Metode HTTP dan URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk menghapus profil koneksi, klik di sini.

Menghapus profil koneksi dan instance AlloyDB terkait

Berikut adalah permintaan untuk menghapus profil koneksi tujuan, serta menghapus instance AlloyDB terkait secara berantai.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
connection-profile-id: ID profil koneksi

Metode HTTP dan URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?force=true" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk menghapus profil koneksi dan instance AlloyDB terkait, klik di sini.