Tüm Ürünler
Search

Bu Ürün

    :GetQueryOptimizeDataStats

    Belge Merkezi

    :GetQueryOptimizeDataStats

    Son Güncelleme:Sep 30, 2026

    Sorgu yönetimi verilerinden SQL şablonu istatistiklerini getirir.

    Operation description

    • Bir Alibaba Cloud SDK'sı kullanıyorsanız, aliyun-sdk-core sürümünün V2.1.8'den sonraki bir sürüm olduğundan emin olun. En son sürümü kullanmanızı öneririz.

    • Database Autonomy Service (DAS) SDK'nızın sürümü V2.1.8 veya sonraki bir sürüm olmalıdır.

    • DAS API işlemlerini çağırmak için bir SDK kullanıyorsanız, bölge kimliğini cn-shanghai olarak ayarlamanız gerekir.

    • Bu işlem aşağıdaki veritabanı motorlarını destekler:

      • ApsaraDB RDS for MySQL.

      • PolarDB for MySQL.

      • ApsaraDB RDS for PostgreSQL.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    hdm:GetQueryOptimizeDataStats

    get

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Engine

    string

    Yes

    Veritabanı motoru. Geçerli değerler:

    • MySQL

    • PolarDBMySQL

    • PostgreSQL

    MySQL
    InstanceIds

    string

    No

    Örnek kimlikleri. Birden fazla kimliği virgül (,) ile ayırın.

    rm-2ze8g2am97624****
    TagNames

    string

    No

    Ayrılmış parametre.

    None
    Keywords

    string

    No

    SQL şablonunun anahtar kelimeleri. Birden fazla anahtar kelimeyi boşluklarla ayırın.

    select update
    LogicalOperator

    string

    No

    Birden fazla anahtar kelime arasındaki mantıksal ilişki. Geçerli değerler:

    • or

    • and

    or
    Rules

    string

    No

    SQL şablonlarını filtrelemek için kullanılan etiketler. Birden fazla etiketi virgül (,) ile ayırın. Daha fazla bilgi için bkz. Sorgu yönetimi.

    DAS_NOT_IMPORTANT
    DbNames

    string

    No

    Sorgulanacak veritabanının adı.

    testdb01
    Time

    string

    Yes

    Sorgulanacak zaman aralığı. Zamanı UNIX zaman damgası biçiminde belirtin. Birim: milisaniye.

    1642953600000
    PageSize

    string

    No

    Sayfa başına giriş sayısı. Varsayılan değer: 10.

    10
    PageNo

    string

    No

    Sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1.

    1
    OrderBy

    string

    No

    Döndürülen girişlerin sıralanacağı alan. Varsayılan değer: count. Geçerli değerler:

    • count: yürütme sayısı.

    • maxQueryTime: en uzun yürütme süresi.

    • avgQueryTime: ortalama yürütme süresi.

    • maxLockTime: en uzun kilit bekleme süresi.

    • avgLockTime: ortalama kilit bekleme süresi.

    • maxRowsExamined: taranan en büyük satır sayısı.

    • avgRowsExamined: taranan ortalama satır sayısı.

    • maxRowsSent: döndürülen en büyük satır sayısı.

    • avgRowsSent: döndürülen ortalama satır sayısı.

    count
    Asc

    string

    No

    Döndürülen girişlerin artan düzende sıralanıp sıralanmayacağını belirtir. Varsayılan değer: true. Geçerli değerler:

    • true: Döndürülen girişleri artan düzende sıralar.

    • false: Döndürülen girişleri artan düzende sıralamaz.

    true
    OnlyOptimizedSql

    string

    No

    Yalnızca optimize edilmesi gereken SQL şablonlarının sorgulanıp sorgulanmayacağını belirtir. Varsayılan değer: false. Geçerli değerler:

    • true: Yalnızca optimize edilmesi gereken SQL şablonlarını sorgular.

    • false: Yalnızca optimize edilmesi gereken SQL şablonlarını sorgulamaz.

    false
    SqlIds

    string

    No

    SQL şablonu kimliği. GetQueryOptimizeExecErrorStats işlemini çağırarak bir şablonun kimliğini sorgulayabilirsiniz.

    2e8147b5ca2dfc640dfd5e43d96a****
    Region

    string

    No

    Örneğin bulunduğu bölge. Geçerli değerler:

    • cn-china: Çin anakarası

    • cn-hongkong: Çin (Hong Kong)

    • ap-southeast-1: Singapur

    Bu parametre yalnızca InstanceIds boş bırakıldığında geçerli olur. InstanceIds alanını boş bırakırsanız, sistem verileri Region tarafından belirlenen bölgeden alır. Varsayılan olarak Region, cn-china olarak ayarlanır. InstanceIds belirtirseniz, Region geçerli olmaz ve sistem verileri belirtilen ilk örneğin bulunduğu bölgeden alır.****

    Not

    Çin anakarasındaki bölgelerde oluşturulan örnekler için bu parametreyi cn-china olarak ayarlayın.

    cn-china
    User

    string

    No

    Sorgulanacak veritabanının hesabı.

    testUser

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt parametreleri.

    Code

    string

    Döndürülen HTTP durum kodu.

    200
    Message

    string

    Döndürülen mesaj.

    Successful
    Data

    object

    Döndürülen veriler.

    Total

    integer

    Döndürülen toplam giriş sayısı.

    10
    PageNo

    integer

    Ayrılmış parametre.

    None
    PageSize

    integer

    Ayrılmış parametre.

    None
    Extra

    string

    Ayrılmış parametre.

    None
    List

    array<object>

    SQL şablonları hakkındaki bilgiler.

    array<object>

    InstanceId

    string

    Örnek kimliği.

    rm-2ze8g2am97624****
    Dbname

    string

    SQL şablonunun ait olduğu veritabanının adı.

    testdb01
    SqlId

    string

    SQL şablonu kimliği.

    2e8147b5ca2dfc640dfd5e43d96a****
    SqlType

    string

    SQL ifadesinin türü.

    INSERT
    Psql

    string

    SQL şablonu.

    select 1
    SqlSample

    string

    Yürütülmesi en uzun süren örnek sorgu.

    select 2
    Count

    integer

    SQL şablonunun yürütülme sayısı.

    100
    MaxQueryTime

    number

    En uzun sorgu yürütme süresi. Birim: saniye.

    1.1
    AvgQueryTime

    number

    Ortalama sorgu yürütme süresi. Birim: saniye.

    1.1
    MaxLockTime

    number

    En uzun kilit bekleme süresi. Birim: saniye.

    0.1
    AvgLockTime

    number

    Ortalama kilit bekleme süresi. Birim: saniye.

    0.1
    MaxRowsExamined

    integer

    Taranan en büyük satır sayısı.

    100000
    AvgRowsExamined

    number

    Taranan ortalama satır sayısı.

    100.1
    MaxRowsSent

    integer

    Döndürülen en büyük satır sayısı.

    10000
    AvgRowsSent

    number

    Döndürülen ortalama satır sayısı.

    100.1
    MaxRowsAffected

    integer

    SQL şablonundan etkilenen en büyük satır sayısı.

    Not

    -1 değeri, bu parametrenin toplanmadığını gösterir.

    10000
    AvgRowsAffected

    number

    SQL şablonundan etkilenen ortalama satır sayısı.

    Not

    -1 değeri, bu parametrenin toplanmadığını gösterir.

    100.1
    RuleList

    array<object>

    Kurallar hakkındaki bilgiler.

    object

    Name

    string

    Kural adı.

    DAS_NOT_IMPORTANT
    Type

    string

    Kuralın türü. Geçerli değerler:

    • Predefined

    • UserDefined

    Predefined
    User

    string

    Veritabanının hesabı.

    testUser
    RequestId

    string

    İstek kimliği.

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

    string

    İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:

    • true: İstek başarılı oldu.

    • false: İstek başarısız oldu.

    true

    Examples

    Success response

    JSON format

    {
  "Code": "200",
  "Message": "Successful",
  "Data": {
    "Total": 10,
    "PageNo": 0,
    "PageSize": 0,
    "Extra": "None",
    "List": [
      {
        "InstanceId": "rm-2ze8g2am97624****",
        "Dbname": "testdb01",
        "SqlId": "2e8147b5ca2dfc640dfd5e43d96a****",
        "SqlType": "INSERT",
        "Psql": "select 1",
        "SqlSample": "select 2",
        "Count": 100,
        "MaxQueryTime": 1.1,
        "AvgQueryTime": 1.1,
        "MaxLockTime": 0.1,
        "AvgLockTime": 0.1,
        "MaxRowsExamined": 100000,
        "AvgRowsExamined": 100.1,
        "MaxRowsSent": 10000,
        "AvgRowsSent": 100.1,
        "MaxRowsAffected": 10000,
        "AvgRowsAffected": 100.1,
        "RuleList": [
          {
            "Name": "DAS_NOT_IMPORTANT",
            "Type": "Predefined"
          }
        ],
        "User": "testUser"
      }
    ]
  },
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParams The request parameters are invalid.
    403 NoPermission You are not authorized to do this action.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.