All Products
Search

This Product

    Database Autonomy Service:CreateSqlLogTask

    Document Center

    Database Autonomy Service:CreateSqlLogTask

    Last Updated:Aug 21, 2026

    Membuat tugas asinkron untuk data detail.

    Deskripsi operasi

    Sebelum Anda memulai:

    • Gunakan versi terbaru dari Alibaba Cloud atau DAS SDK.

    • Saat Anda memanggil operasi DAS menggunakan SDK, atur wilayah ke cn-shanghai.

    • Hanya Instansiasi basis data dengan DAS Edisi Perusahaan yang diaktifkan mendukung pembuatan tugas batch. Untuk informasi tentang database dan wilayah yang didukung oleh setiap versi DAS Edisi Perusahaan, lihat Edisi DAS dan fitur yang didukung.

    Batas laju:

    Jumlah maksimum tugas konkuren adalah 10.

    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

    hdm:CreateSqlLogTask

    create

    *Semua resource.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    No

    ID database instans.

    pc-2ze8g2am97624****
    NodeId

    string

    No

    ID node.

    Catatan

    Parameter ini hanya berlaku untuk instans kluster. Anda dapat menentukan parameter ini untuk mengkueri tugas batch dari node tertentu. Jika Anda tidak menentukan parameter ini, tugas batch dari node utama akan dikembalikan secara default.

    pi-uf6k5f6g3912i****
    Type

    string

    No

    Tipe tugas.

    • Export: tugas ekspor.

    Catatan

    Untuk parameter filter dan nilai yang didukung oleh Export, lihat Deskripsi parameter permintaan.

    • Query: tugas kueri.

    Export
    Name

    string

    No

    Nama tugas.

    SQL audit export 1
    Filters

    array<object>

    No

    Daftar kondisi filter.

    object

    No

    Kondisi filter.

    Key

    string

    No

    Nama parameter filter.

    Catatan

    Untuk parameter filter dan nilai yang didukung, lihat Deskripsi parameter permintaan.

    KeyWords
    Value

    string

    No

    Nilai parameter filter.

    select
    StartTime

    integer

    No

    Pengatur waktu mulai tugas. Tentukan nilai sebagai stempel waktu UNIX. Unit: milidetik.

    1596177993000

    EndTime

    integer

    No

    Pengatur waktu akhir tugas. Tentukan nilai sebagai stempel waktu UNIX. Unit: milidetik.

    1608888296000

    Role

    string

    No

    Informasi node dari Instansiasi basis data PolarDB Basis Data Relasional Cloud-Native-X 2.0.

    • polarx_cn: node komputasi.

    • polarx_dn: node data.

    polarx_cn

    Parameter dan nilai yang didukung untuk Key:

    • KeyWords: kata kunci. Pisahkan beberapa kata kunci dengan spasi.

    • LogicalOperator: operator logis antara kata kunci. Nilai valid: and atau or.

    • AccountName: nama pengguna. Anda dapat menentukan beberapa nama pengguna yang dipisahkan oleh koma. Maksimum: 5.

    • DbName: nama database. Anda dapat menentukan beberapa nama database yang dipisahkan oleh koma. Maksimum: 5.

    • HostAddress: alamat IP klien. Anda dapat menentukan beberapa alamat IP yang dipisahkan oleh koma. Maksimum: 5.

    • MaxConsume: durasi eksekusi maksimum. Unit: us.

    • MinConsume: durasi eksekusi minimum. Unit: us.

    • MaxScanRows: jumlah baris yang discan maksimum.

    • MinScanRows: jumlah baris yang discan minimum.

    • SqlType: tipe SQL. Nilai valid: select, update, insert, atau delete.

    • State: hasil eksekusi. Nilai valid: 0 (berhasil) atau 1 (gagal).

    • ThreadId: ID thread.

    • SortKey: nama kolom pengurutan. Nilai valid: ScanRows (baris yang discan), UpdateRows (baris yang diperbarui), Consume (durasi eksekusi), ExecuteTime (waktu eksekusi), ReturnRows (baris yang dikembalikan), LockTime (waktu tunggu lock), Frows (baris yang diambil oleh node komputasi PolarDB Basis Data Relasional Cloud-Native-X 2.0), Scnt (permintaan DN dari node komputasi PolarDB Basis Data Relasional Cloud-Native-X 2.0), CpuTime (waktu eksekusi CPU), atau PhysicalRead (baca fisik).

    • SortMethod: metode pengurutan. Nilai valid: DESC (menurun) atau ASC (naik). Nilai default: DESC.

    • TraceId: ID trace dari instans PolarDB Basis Data Relasional Cloud-Native-X 2.0.

    • MinRows: jumlah baris yang diperbarui minimum.

    • MaxRows: jumlah baris yang diperbarui maksimum.

    • MinScnt: jumlah permintaan DN minimum dari node komputasi (CN) PolarDB Basis Data Relasional Cloud-Native-X 2.0.

    • MaxScnt: jumlah permintaan DN maksimum dari node komputasi (CN) PolarDB Basis Data Relasional Cloud-Native-X 2.0.

    • TrxId: ID transaksi.

    • Fail: kode kesalahan.

    • SqlId: ID SQL.

    • JobId: ID tugas asinkron yang digunakan untuk mengkueri lebih lanjut hasil yang dikembalikan.

    • Delimiter: pembatas. Nilai yang didukung: | , $ #.

    • Columns: ketika Type = Export (tipe tugas adalah tugas ekspor), tentukan kolom ekspor yang dipisahkan oleh spasi. Nilai valid:

      • columnDBName: database

      • columnThreadId: ID thread

      • columnAccountName: pengguna

      • columnHostAddress: IP klien

      • columnSqlType: tipe SQL

      • columnState: status

      • columnConsume: durasi eksekusi (us)

      • columnUpdateRows: baris yang diperbarui

      • columnScanRows: baris yang discan

      • columnReturnRows: baris yang dikembalikan

      • columnLockTime: waktu tunggu lock

      • columnLogicRead: baca logis

      • columnPhysicSyncRead: baca sinkron fisik

      • columnPhysicASyncRead: baca asinkron fisik

      • columnOriginTime: waktu eksekusi (us)

      • columnExecuteTime: waktu eksekusi (misalnya, 2024-07-30 11:00:00)

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    string

    Kode tanggapan.

    200
    Message

    string

    Paket yang dikembalikan.

    Catatan

    Jika permintaan berhasil, Successful dikembalikan. Jika permintaan gagal, pesan kesalahan seperti kode kesalahan dikembalikan.

    Successful
    RequestId

    string

    ID permintaan.

    83D9D59B-057A-54A9-BFF9-CF2B42F05645
    Success

    string

    Apakah permintaan berhasil.

    • true: berhasil.

    • false: gagal.

    true
    Data

    object

    Data yang dikembalikan.

    TaskId

    string

    ID tugas.

    54f8041743ca3a9ac5cb9342d050527c
    InstanceId

    string

    ID database instans.

    pc-2ze8g2am97624****
    Name

    string

    Nama tugas.

    Export_test
    Start

    integer

    Pengatur waktu mulai. Tentukan nilai sebagai stempel waktu UNIX. Unit: milidetik.

    1596177993000
    End

    integer

    Pengatur waktu akhir. Tentukan nilai sebagai stempel waktu UNIX. Unit: milidetik.

    1608888296000

    Status

    string

    Status tugas.

    • INIT: menunggu penjadwalan.

    • RUNNING: berjalan.

    • FAILED: gagal.

    • CANCELED: dibatalkan.

    • COMPLETED: selesai.

    Catatan

    Ketika tugas berada dalam status COMPLETED, Anda dapat Tampilan hasil tugas.

    COMPLETED
    CreateTime

    integer

    Pengatur waktu pembuatan tugas. Tentukan nilai sebagai stempel waktu UNIX. Unit: milidetik.

    1681363254423

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "Successful",
  "RequestId": "83D9D59B-057A-54A9-BFF9-CF2B42F05645",
  "Success": "true",
  "Data": {
    "TaskId": "54f8041743ca3a9ac5cb9342d050527c",
    "InstanceId": "pc-2ze8g2am97624****",
    "Name": "Export_test",
    "Start": 1596177993000,
    "End": 1608888296000,
    "Status": "COMPLETED",
    "CreateTime": 1681363254423
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParams The request parameters are invalid. Parameter permintaan tidak valid.
    403 NoPermission You are not authorized to do this action. Anda tidak memiliki izin untuk melakukan operasi ini.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.