Tüm Ürünler
Search

Bu Ürün

    :GetStorageAnalysisResult

    Belge Merkezi

    :GetStorageAnalysisResult

    Son Güncelleme:Sep 30, 2026

    Bir depolama analizi görevinin durumunu ve sonuçlarını sorgular.

    Operation description

    Not

    Fiziksel dosya boyutu, elde edilen bir dosyanın gerçek boyutunu gösterir. Yalnızca veritabanı örneklerinin belirli dağıtım modları fiziksel dosya boyutlarının görüntülenmesini destekler. Tablolara ilişkin istatistikler information_schema.tables tablosundan alınır. MySQL'deki istatistikler gerçek zamanlı olarak güncellenmez. Bu nedenle istatistikler fiziksel dosya boyutlarından farklı olabilir. En son verileri elde etmek istiyorsanız, yoğun olmayan saatlerde ilgili tablolar üzerinde ANALYZE TABLE ifadesini çalıştırabilirsiniz.

    • Bu işlem yalnızca ApsaraDB RDS for MySQL örnekleri, PolarDB for MySQL kümeleri ve ApsaraDB for MongoDB örnekleri için geçerlidir.

    • ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için bu işlem, önceki sürümün depolama analizi özelliğiyle aynı şekilde çalışır. Bu işlem tarafından oluşturulan görevler, Veritabanı Otonomi Hizmeti (DAS) konsolundaki yeni sürümün Depolama Analizi sayfasında görüntülenemez. Görevleri ve sonuçları görüntülemek istiyorsanız, verileri almak ve bilgisayarınıza kaydetmek için ilgili API işlemini çağırın.

    • Bu işlemi çağırmak için bir Alibaba Cloud SDK veya DAS SDK kullanıyorsanız, SDK'nın en son sürümünü kullanmanızı öneririz.

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

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

    none

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    Örnek kimliği.

    rm-bp10xxxxxxxxx
    NodeId

    string

    No

    Düğüm kimliği.

    Not

    Bu parametre ayrılmıştır.

    202****
    TaskId

    string

    Yes

    Görev kimliği. Görev kimliğini CreateStorageAnalysisTask işleminin yanıtından alabilirsiniz.

    910f83f4b96df0524ddc5749f615****

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    Code

    integer

    Döndürülen HTTP durum kodu.

    200
    Message

    string

    Döndürülen mesaj.

    Not

    İstek başarılıysa Successful döndürülür. Aksi takdirde, bir hata kodu gibi bir hata mesajı döndürülür.

    Successful
    Data

    object

    Döndürülen veriler.

    TaskId

    string

    Görev kimliği.

    910f83f4b96df0524ddc5749f615****
    TaskFinish

    boolean

    Görevin tamamlanıp tamamlanmadığını gösterir.

    true
    TaskSuccess

    boolean

    Görevin başarılı olup olmadığını gösterir.

    true
    TaskState

    string

    Depolama analizi görevinin durumu. Geçerli değerler:

    • INIT: Görev başlatılıyor.

    • PENDING: Görev çalıştırılmak üzere sıraya alınıyor.

    • RECEIVED: Görev çalıştırılmak üzere alındı.

    • RUNNING: Görev çalıştırılıyor.

    • RETRY: Görev yeniden deneniyor.

    • SUCCESS: Görev başarılı oldu.

    • FAILURE: Görev başarısız oldu.

    RUNNING
    TaskProgress

    integer

    Görev ilerleme durumu.

    Not

    Geçerli değerler 0 ile 100 arasında değişen tam sayılardır.

    50
    TotalDbCount

    integer

    Depolama analizi görevinde analiz edilmesi gereken veritabanı sayısı.

    32
    AnalyzedDbCount

    integer

    Analiz edilen veritabanı sayısı.

    2
    StorageAnalysisResult

    object

    Depolama analizinin ayrıntıları.

    TotalStorageSize

    integer

    Örnek depolama alanının toplam boyutu.

    Not

    Birim: bayt.

    214748364800
    TotalUsedStorageSize

    integer

    Kullanılan depolama alanının boyutu.

    Not

    Birim: bayt.

    68345135104
    TotalFreeStorageSize

    integer

    Kalan depolama alanının boyutu.

    Not

    Birim: bayt.

    146403229696
    DailyIncrement

    integer

    Önceki yedi gün içinde kullanılan depolama alanının tahmini ortalama günlük artışı. Birim: bayt.

    0
    EstimateAvailableDays

    integer

    Kalan depolama alanının kullanılabileceği tahmini gün sayısı.

    99
    AnalysisSuccess

    boolean

    Veritabanı ve tablo üzerindeki analizin başarılı olup olmadığını gösterir.

    true
    AnalysisErrorType

    string

    Veritabanı ve tablo üzerindeki analizin başarısız olma nedeni.

    • DB_OR_TABLE_NOT_EXIST: Belirtilen veritabanı veya tablo mevcut değil.

    • DB_NOT_EXIST: Belirtilen veritabanı mevcut değil.

    DB_NOT_EXIST
    NeedOptimizeItemList

    array<object>

    DAS varsayılan kurallarına göre oluşturulan optimize edilecek öğeler. İş gereksinimlerinize göre bu öğeleri yok sayabilir ve döndürülen diğer temel verilere dayalı olarak optimize edilecek öğeler oluşturmak için özel kurallar oluşturabilirsiniz.

    object

    DbName

    string

    Veritabanının adı.

    testdb01
    TableName

    string

    Tablonun adı.

    test_table
    OptimizeItemName

    string

    Optimize edilecek öğe. Geçerli değerler:

    • NEED_ANALYZE_TABLE: information_schema.tables tablosundan elde edilen depolama istatistikleri fiziksel dosya boyutlarından 50 GB daha büyük veya daha küçük olan tablolar. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • NEED_OPTIMIZE_TABLE: Alan parçacıkları 6 GB'den büyük ve parçalanma oranları %30'dan fazla olan tablolar. Bir tablonun parçalanma oranı genellikle aşağıdaki formüllere göre hesaplanır:

      • ApsaraDB RDS for MySQL ve PolarDB for MySQL: Fragmentation rate = DataFree/(DataSize + IndexSize + DataFree). Bu bağlamda PhyTotalSize = DataSize + IndexSize + DataFree'dir. Dolayısıyla parçalanma oranı şu formüle göre hesaplanabilir: Fragmentation rate = DataFree/PhyTotalSize.

      • ApsaraDB for MongoDB: Fragmentation rate = FragmentSize/PhyTotalSize.

    • TABLE_ENGINE: Depolama motorları InnoDB veya XEngine olmayan tablolar. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • AUTO_INCREMENT_ID_BE_TO_RUN_OUT: Otomatik artan kimlik kullanımları %80'i aşan tablolar. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • DUPLICATE_INDEX: Dizinleri gereksiz veya yinelenen olan tablolar. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • TABLE_SIZE: Boyutları 50 GB'den büyük olan tekil tablolar. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • TABLE_ROWS_AND_AVG_ROW_LENGTH: 5 milyondan fazla satır içeren ve ortalama satır uzunlukları 10 KB'yi aşan tekil tablolar. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • TOTAL_DATA_FREE: Geri kazanılabilir alanı 60 GB'den büyük ve toplam parçalanma oranı %5'ten büyük olan örnekler.

    • STORAGE_USED_PERCENT: Alan kullanımı %90'dan büyük olan örnekler.

    NEED_OPTIMIZE_TABLE
    OptimizeAdvice

    string

    Optimizasyon önerisi. Geçerli değerler:

    • NEED_ANALYZE_TABLE: Yoğun olmayan saatlerde tablo üzerinde ANALYZE TABLE ifadesini çalıştırabilirsiniz. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • NEED_OPTIMIZE_TABLE: Yoğun olmayan saatlerde parçacıkları geri kazanabilirsiniz.

    • CHANGE_TABLE_ENGINE_IF_NECESSARY: Risk değerlendirmesinden sonra bir tablonun depolama motoru türünü değiştirin. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • AUTO_INCREMENT_ID_BE_TO_RUN_OUT: Otomatik artan kimliklerin kullanımına dikkat edin. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • DUPLICATE_INDEX: Tabloların dizinlerini optimize edin. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • TABLE_SIZE: Tablo boyutuna dikkat edin. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • TABLE_ROWS_AND_AVG_ROW_LENGTH: Bir tablodaki satır sayısına ve ortalama satır uzunluğuna dikkat edin. Yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    • STORAGE_USED_PERCENT: Örnek dolduğunda kilitlenmesini önlemek için alan kullanımına dikkat edin.

    NEED_OPTIMIZE_TABLE
    AssociatedData

    string

    Optimize edilecek öğelerle ilişkili ve JSON formatında olan veriler.

    { "autoIncrementCurrentValue": 2147483647, "autoIncrementRatio": 1, "dbName": "testdb01", "maximumValue": 2147483647, "columnName": "id", "tableName": "test_table" }
    TableStats

    array<object>

    Tablo hakkındaki bilgiler.

    object

    DbName

    string

    Veritabanının adı.

    testdb01
    TableName

    string

    Tablonun adı.

    test_table
    TableType

    string

    Tablonun türü.

    Not

    Bu parametre yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    BASE TABLE
    Engine

    string

    Tablo tarafından kullanılan depolama motorunun türü.

    Not

    Bu parametre yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir.

    InnoDB
    PhysicalFileSize

    integer

    Tablonun fiziksel dosya boyutu. Birim: bayt.

    Not

    Bu parametre yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir. Dağıtım modu nedeniyle belirli veritabanı örneklerinin verileri alınamaz.

    3057655808
    PhyTotalSize

    integer

    Tablonun depolama alanı. Birim: bayt.

    Not

    ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için parametrenin değeri DataSize, IndexSize ve DataFree toplamıdır. ApsaraDB for MongoDB örnekleri için bu parametrenin değeri DataSize ve IndexSize toplamıdır.

    3012493312
    TotalSize

    integer

    • ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için bu parametre, tablo verileri ve dizinleri tarafından kullanılan alan miktarını gösterir. Birim: bayt. Değer, DataSize ve IndexSize toplamıdır.

    • ApsaraDB for MongoDB örnekleri için bu parametre, Block Manager tarafından ayrılan alanın gerçek boyutunu gösterir. Birim: bayt. Bir ApsaraDB for MongoDB örneğinin sıkıştırma oranı şu formüle göre hesaplanır: Compression ratio = TotalSize/DataSize.

    3005153280
    IndexSize

    integer

    Dizinler tarafından kullanılan depolama alanı. Birim: bayt.

    1022296064
    DataSize

    integer

    • ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için bu parametre, veriler tarafından kullanılan alan miktarını gösterir. Birim: bayt.

    • ApsaraDB for MongoDB örnekleri için bu parametre, sıkıştırılmamış verilerin boyutunu, yani veri miktarını gösterir. Birim: bayt.

    1982857216
    DataFree

    integer

    Alan parçacıklarının boyutu. Birim: bayt.

    Not

    Bu parametre yalnızca ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için geçerlidir. Bir tablonun parçalanma oranı genellikle şu formüle göre hesaplanır: Fragmentation rate = DataFree/(DataSize + IndexSize + DataFree). Bu bağlamda Fragmentation rate = DataFree/PhyTotalSize şeklindedir.

    7340032
    TableRows

    integer

    Tablodaki satır sayısı.

    12794732
    AvgRowLength

    integer

    Satırların ortalama uzunluğu. Birim: bayt.

    154
    FragmentSize

    integer

    Geri kazanılabilecek alanın boyutu. Birim: bayt.

    Not

    Bu parametre yalnızca ApsaraDB for MongoDB örnekleri için geçerlidir. Fragmentation rate = FragmentSize/PhyTotalSize.

    362221568
    RequestId

    string

    İstek kimliği.

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

    boolean

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

    • true

    • false

    true

    Examples

    Success response

    JSON format

    {
  "Code": 200,
  "Message": "Successful",
  "Data": {
    "TaskId": "910f83f4b96df0524ddc5749f615****",
    "TaskFinish": true,
    "TaskSuccess": true,
    "TaskState": "SUCCESS",
    "TaskProgress": 100,
    "TotalDbCount": 32,
    "AnalyzedDbCount": 2,
    "StorageAnalysisResult": {
      "TotalStorageSize": 214748364800,
      "TotalUsedStorageSize": 68345135104,
      "TotalFreeStorageSize": 146403229696,
      "DailyIncrement": 0,
      "EstimateAvailableDays": 99,
      "AnalysisSuccess": true,
      "AnalysisErrorType": "DB_NOT_EXIST",
      "NeedOptimizeItemList": [
        {
          "DbName": "testdb01",
          "TableName": "test_table",
          "OptimizeItemName": "NEED_OPTIMIZE_TABLE",
          "OptimizeAdvice": "NEED_OPTIMIZE_TABLE",
          "AssociatedData": "{\n    \"autoIncrementCurrentValue\": 2147483647,\n    \"autoIncrementRatio\": 1,\n    \"dbName\": \"testdb01\",\n    \"maximumValue\": 2147483647,\n    \"columnName\": \"id\",\n    \"tableName\": \"test_table\"\n}"
        }
      ],
      "TableStats": [
        {
          "DbName": "testdb01",
          "TableName": "test_table",
          "TableType": "BASE TABLE",
          "Engine": "InnoDB",
          "PhysicalFileSize": 3057655808,
          "PhyTotalSize": 3012493312,
          "TotalSize": 3005153280,
          "IndexSize": 1022296064,
          "DataSize": 1982857216,
          "DataFree": 7340032,
          "TableRows": 12794732,
          "AvgRowLength": 154,
          "FragmentSize": 362221568
        }
      ]
    }
  },
  "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.