All Products
Search

This Product

    Data Management:GetOnlineDDLProgress

    Document Center

    Data Management:GetOnlineDDLProgress

    Last Updated:Jun 11, 2026

    Memanggil antarmuka GetOnlineDDLProgress untuk mendapatkan detail kemajuan eksekusi tugas OnlineDDL.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dms:GetOnlineDDLProgress

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Tid

    integer

    No

    ID Penyewa.

    Catatan

    Diambil dari informasi ID penyewa yang ditampilkan saat mengarahkan kursor ke avatar di sudut kanan atas sistem. Untuk detailnya, lihat Lihat Informasi Penyewa.

    3***
    JobDetailId

    integer

    Yes

    ID detail tugas SQL OnlineDDL. Anda dapat memperoleh nilai parameter ini dengan memanggil antarmuka ListDBTaskSQLJobDetail.

    15***

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Schema of Response

    RequestId

    string

    ID permintaan.

    34E01EDD-6A16-4CF0-9541-C644D1BE01AA
    Success

    boolean

    Apakah permintaan berhasil. Nilai yang dikembalikan adalah sebagai berikut:

    • true: Permintaan berhasil

    • false: Permintaan gagal

    true
    ErrorMessage

    string

    Pesan kesalahan.

    UnknownError
    ErrorCode

    string

    Kode kesalahan.

    403
    OnlineDDLTaskDetail

    object

    Informasi detail tugas.

    JobStatus

    string

    Status tugas. Nilai yang dikembalikan adalah sebagai berikut:

    • INIT: Inisialisasi.

    • SUCCESS: Selesai.

    • RUNNING: Sedang berjalan.

    • WAITING_CUTOVER: Menunggu cut-over.

    • RESTARTING: Sedang dimulai ulang.

    • PAUSE: Dijeda.

    • UNSUPPORTED: Tidak didukung.

    • CANCELED: Dibatalkan.

    • FAIL: Gagal.

    • INTERRUPT: Terhenti.

    SUCCESS
    StatusDesc

    string

    Informasi deskripsi status tugas.

    Success
    DelaySeconds

    integer

    Penundaan replay DMS, yaitu waktu penundaan replay Binlog tabel asli ke tabel sementara (satuan: detik), tidak terkait dengan primer/sekunder basis data.

    0
    CopyTotal

    integer

    Estimasi jumlah total baris data, diambil dari data statistik basis data information_schema, biasanya lebih kecil dari jumlah data sebenarnya di tabel.

    10
    CopyCount

    integer

    Jumlah data tabel asli yang sebenarnya disalin oleh perubahan tanpa kunci (lock-free) DMS.

    9
    ProgressRatio

    string

    Estimasi kemajuan eksekusi. Detailnya bergantung pada status tugas.

    90%
    CutoverLockTimeSeconds

    integer

    Waktu habis (timeout) kunci tabel saat beralih tabel.

    2
    CutoverFailRetryTimes

    integer

    Jumlah percobaan ulang ketika peralihan tabel gagal.

    3
    CleanStrategy

    string

    Strategi pembersihan tabel asli setelah operasi peralihan tabel selesai. Nilai yang dikembalikan adalah sebagai berikut:

    • DROP: Sistem secara otomatis menghapus tabel asli yang tidak valid.

    • MOVE: Memindahkan tabel asli yang tidak valid ke basis data test, lalu melakukan pembersihan secara manual.

    • NOTHING: Mempertahankan tabel asli yang tidak valid di basis data asal, lalu melakukan pembersihan secara manual.

    DROP
    CopyChunkSize

    integer

    Ukuran salinan penuh. Parameter ini digunakan untuk menentukan ukuran setiap potongan kecil. Semakin besar potongan salinan tunggal, semakin pendek waktu salinan penuh, namun semakin besar pula dampaknya terhadap bisnis.

    Catatan

    Pada tahap salinan penuh, tabel asli dibagi menjadi N potongan kecil dan disalin satu per satu ke tabel sementara. Secara default, DMS menyesuaikan ukuran setiap potongan secara dinamis.

    1000
    CopyChunkMode

    string

    Strategi salinan penuh. Nilai yang dikembalikan adalah sebagai berikut:

    • AUTO: DMS menyesuaikan secara dinamis berdasarkan kinerja basis data, waktu kunci tabel untuk salinan tunggal dikontrol dalam 1,5 detik.

    • RUNNING: DMS menyalin data tabel asli sesuai ukuran CopyChunkSize yang Anda tentukan (1-60000). Dalam mode ini, CopyChunkSize wajib diatur.

    AUTO
    CutoverWindowStartTime

    string

    Waktu mulai jendela waktu peralihan tabel. Defaultnya adalah 00:00:00. Parameter ini dapat mengontrol jendela waktu peralihan tabel, menentukan bahwa peralihan hanya dapat dilakukan ketika kondisi peralihan tabel terpenuhi dan berada dalam jendela waktu; jika tidak berada dalam jendela, akan terus menunggu hingga jendela tiba.

    12:00:00
    CutoverWindowEndTime

    string

    Waktu akhir jendela waktu peralihan tabel, dengan jarak minimal 30 menit dari CutoverWindowStartTime. Defaultnya adalah 23:59:59.

    13:00:00

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "34E01EDD-6A16-4CF0-9541-C644D1BE01AA",
  "Success": true,
  "ErrorMessage": "UnknownError",
  "ErrorCode": "403",
  "OnlineDDLTaskDetail": {
    "JobStatus": "SUCCESS",
    "StatusDesc": "Success",
    "DelaySeconds": 0,
    "CopyTotal": 10,
    "CopyCount": 9,
    "ProgressRatio": "90%",
    "CutoverLockTimeSeconds": 2,
    "CutoverFailRetryTimes": 3,
    "CleanStrategy": "DROP",
    "CopyChunkSize": 1000,
    "CopyChunkMode": "AUTO",
    "CutoverWindowStartTime": "12:00:00",
    "CutoverWindowEndTime": "13:00:00"
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.