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 yang dapat Anda gunakan untuk 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 menunjukkan 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 menggunakan 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 menggunakan 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 mengetahui informasi selengkapnya tentang penggunaan gcloud untuk mengambil informasi tentang profil koneksi Anda, klik di sini.

Membuat profil koneksi untuk database sumber Cloud SQL for PostgreSQL

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

Untuk membuat penyandingan 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 for PostgreSQL

Berikut menunjukkan permintaan untuk membuat profil koneksi untuk tujuan AlloyDB for 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 untuk memberikan pengguna awal
vpc-network: Jaringan VPC yang akan terhubung dengan cluster AlloyDB
instance-id: ID instance AlloyDB yang akan dibuat
cpu-count: Jumlah CPU untuk 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 memberikan kontrol akses kunci dan audit yang ketat, serta mengenkripsi data pengguna dalam penyimpanan menggunakan standar enkripsi AES-256. Tidak diperlukan penyiapan, konfigurasi, atau pengelolaan.Enkripsi saat istirahat default Google Cloudadalah pilihan terbaik bagi pengguna yang tidak memiliki persyaratan khusus terkait kepatuhan atau lokalitas materi kriptografi.

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 mengetahui informasi selengkapnya tentang penggunaan gcloud untuk mengambil informasi tentang profil koneksi Anda, klik di sini.

Mencantumkan profil koneksi

Berikut ini menunjukkan 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 oleh Database Migration Service, sebagai berikut:

orderBy: Gunakan filter ini untuk mengambil daftar 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 oleh Database Migration Service di halaman. Misalnya, dengan menyetel 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 berikutnya.

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 mengetahui informasi selengkapnya tentang penggunaan 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 dari 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 Anda, 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.

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 sedang berjalan.
RESTARTING: Database Migration Service mengambil snapshot baru dari database sumber, memuat dump awal ke dalam 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, maka tindakan 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 mengetahui informasi selengkapnya tentang penggunaan gcloud untuk menghapus profil koneksi Anda, klik di sini.

Menghapus profil koneksi dan instance AlloyDB terkait

Berikut ini menunjukkan permintaan untuk menghapus profil koneksi tujuan, serta menghapus instance AlloyDB terkait secara bertingkat.

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 mengetahui informasi selengkapnya tentang penggunaan gcloud untuk menghapus profil koneksi dan instance AlloyDB terkait, klik di sini.

Mengelola profil koneksi menggunakan API Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan

Membuat profil koneksi untuk database sumber PostgreSQL

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Membuat profil koneksi untuk database sumber Cloud SQL for PostgreSQL

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Membuat profil koneksi untuk tujuan AlloyDB for PostgreSQL

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Mendapatkan informasi tentang profil koneksi

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Mencantumkan profil koneksi

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Memperbarui profil koneksi

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Menghapus profil koneksi

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Menghapus profil koneksi dan instance AlloyDB terkait

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

gcloud

Mengelola profil koneksi menggunakan API