All Products
Search
Document Center

Database Autonomy Service:DescribeHotBigKeys

Last Updated:Jul 10, 2026

Memanggil operasi DescribeHotBigKeys untuk mengambil kunci panas dan kunci besar dalam memori saat ini secara real pengatur waktu.

Deskripsi operasi

Untuk kunci dengan struktur data List, Hash, Set, atau Zset, 3 kunci teratas diurutkan dan ditampilkan berdasarkan jumlah elemen dalam kunci, dan dicatat sebagai kunci besar. Jika QPS suatu kunci melebihi 5.000, kunci tersebut dicatat sebagai kunci panas. Untuk informasi lebih lanjut tentang definisi kunci besar dan kunci panas, lihat Statistik Kunci Teratas.

Catatan
  • Untuk instans yang Berjalan Redis Community Edition versi 7.0.18, 6.0.2.9, 5.5.2.9, atau versi sebelumnya, atau instans in-memory Tair (Edisi Enhanced) yang Berjalan versi 5.0.50, 25.2.0.0, atau versi sebelumnya, kunci dengan QPS lebih besar dari 3.000 dicatat sebagai kunci panas. Ambang batas ini tidak dapat disesuaikan.

  • Saat menggunakan Alibaba Cloud SDK, pastikan versi aliyun-sdk-core lebih baru dari 4.3.3. Kami menyarankan Anda menggunakan versi terbaru.

  • Gunakan DAS SDK versi 1.0.2 atau lebih baru.

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

  • Operasi ini hanya berlaku untuk instans Redis berikut:
    • Instans adalah Redis Community Edition atau Tair (Kompatibel dengan Redis® OSS) in-memory.

    • Versi minor instans adalah yang terbaru.

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:DescribeHotBigKeys

get

*Semua resource.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ConsoleContext

string

No

Parameter yang dipesan.

None

InstanceId

string

Yes

ID instans dari instans Redis.

r-bp18ff4a195d****

NodeId

string

No

ID shard data dalam instans Redis.

r-****-db-0

Elemen respons

Element

Type

Description

Example

object

Message

string

Paket yang dikembalikan.

Successful

RequestId

string

ID permintaan.

B6D17591-B48B-4D31-9CD6-9B9796B2****

Data

object

Detail.

HotKeys

object

HotKey

array<object>

Daftar hot key yang diurutkan berdasarkan QPS.

object

Daftar hot key yang diurutkan berdasarkan QPS.

Key

string

Key.

abc:def:eng

Db

integer

Database (DB) tempat key disimpan.

0

Hot

string

Frekuensi akses key, diukur dalam akses per detik.

5500~6000

KeyType

string

Tipe key.

zset

Lfu

integer

Nilai statistik dari algoritma Least Frequently Used (LFU).

253

NodeId

string

ID shard data untuk instance Redis.

r-x****-db-0

Size

integer

2

BigKeys

object

BigKey

array<object>

Daftar big key yang diurutkan berdasarkan jumlah elemen.

object

Daftar big key yang diurutkan berdasarkan jumlah elemen.

Db

integer

DB tempat key disimpan.

0

Key

string

Key.

abc:def:eng

KeyType

string

Tipe key.

zset

Size

integer

Jumlah elemen.

2

NodeId

string

ID shard data untuk instance Redis.

r-x****-db-0

HotKeyMsg

string

Alasan mengapa kunci panas yang diurutkan berdasarkan QPS gagal diambil.

current version doesn't support

BigKeyMsg

string

Alasan mengapa kunci besar yang diurutkan berdasarkan jumlah elemen anak gagal diambil.

current version doesn't support

HighTrafficKeyMsg

string

Alasan mengapa kunci panas yang diurutkan berdasarkan trafik gagal diambil.

current version doesn't support

HighTrafficKeys

object

HighTrafficKey

array<object>

Daftar hot key yang diurutkan berdasarkan traffic.

object

Daftar hot key yang diurutkan berdasarkan traffic.

Key

string

Key.

abc:def:eng

Db

integer

DB tempat key disimpan.

0

Hot

string

Frekuensi akses key, diukur dalam akses per detik.

1988

KeyType

string

Tipe key.

string

NodeId

string

ID node.

r-x****-db-0

inBytes

integer

Traffic masuk dalam bytes.

85767

outBytes

integer

Traffic keluar dalam bytes.

1054684

Size

integer

2

LargeKeys

object

LargeKey

array<object>

Daftar big key yang diurutkan berdasarkan penggunaan memori.

object

Daftar big key yang diurutkan berdasarkan penggunaan memori.

Db

string

DB tempat key disimpan.

0

Key

string

Key.

abc:def:eng

KeyType

string

Tipe key.

string

DataSize

string

Penggunaan memori key dalam bytes.

33554439

NodeId

string

ID node.

r-x****-db-0

LargeKeyMsg

string

Alasan mengapa kunci besar yang diurutkan berdasarkan penggunaan memori gagal diambil.

current version doesn't support

Code

string

Kode status yang dikembalikan.

200

Success

string

Apakah permintaan berhasil. Nilai valid:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

Contoh

Respons sukses

JSONformat

{
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data": {
    "HotKeys": {
      "HotKey": [
        {
          "Key": "abc:def:eng",
          "Db": 0,
          "Hot": "5500~6000",
          "KeyType": "zset",
          "Lfu": 253,
          "NodeId": "r-x****-db-0",
          "Size": 2
        }
      ]
    },
    "BigKeys": {
      "BigKey": [
        {
          "Db": 0,
          "Key": "abc:def:eng",
          "KeyType": "zset",
          "Size": 2,
          "NodeId": "r-x****-db-0"
        }
      ]
    },
    "HotKeyMsg": "current version doesn't support",
    "BigKeyMsg": "current version doesn't support",
    "HighTrafficKeyMsg": "current version doesn't support",
    "HighTrafficKeys": {
      "HighTrafficKey": [
        {
          "Key": "abc:def:eng",
          "Db": 0,
          "Hot": "1988",
          "KeyType": "string",
          "NodeId": "r-x****-db-0\n",
          "inBytes": 85767,
          "outBytes": 1054684,
          "Size": 2
        }
      ]
    },
    "LargeKeys": {
      "LargeKey": [
        {
          "Db": "0",
          "Key": "abc:def:eng",
          "KeyType": "string",
          "DataSize": "33554439",
          "NodeId": "r-x****-db-0"
        }
      ]
    },
    "LargeKeyMsg": "current version doesn't support"
  },
  "Code": "200",
  "Success": "true"
}

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.