Todos los productos
Search
Centro de documentos

:DescribeTablePartitionDiagnose

Última actualización: Sep 01, 2026

Consulta la información sobre el diagnóstico de particiones.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

adb:DescribeTablePartitionDiagnose

get

DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

DBClusterId

string

Sí

El ID del clúster.

am-bp1xxxxxxxx47

PageSize

integer

No

El número de entradas por página. Valores válidos:

  • 30

  • 50

  • 100

Valor predeterminado: 30.

30

PageNumber

integer

No

El número de página. Las páginas comienzan desde la página 1. Valor predeterminado: 1.

1

Order

string

No

El criterio por el que se ordenan los resultados de la consulta. Especifique el valor del parámetro en formato de cadena JSON. Ejemplo: [{"Field":"TotalSize","Type":"Desc"}].

  • Field especifica el campo por el que se ordenan los resultados de la consulta. Valores válidos:

    • SchemaName: el nombre de la base de datos a la que pertenece la tabla.

    • TableName: el nombre de la tabla.

    • TotalSize: el tamaño total de datos de la tabla.

    • SpaceRatio: el porcentaje de almacenamiento de la tabla.

  • Type especifica el orden de clasificación. Valores válidos:

    • Asc: orden ascendente.

    • Desc: orden descendente.

Nota

Si no especifica este parámetro, los resultados de la consulta se ordenan por el campo TotalSize en orden descendente.

[{\"Field\":\"TotalSize\",\"Type\":\"Desc\"}]

RegionId

string

No

El ID de la región.

cn-hangzhou

Lang

string

No

El idioma del contenido dentro de la solicitud y la respuesta. Valor predeterminado: zh. Valores válidos:

  • zh: chino.

  • en: inglés.

zh

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los parámetros de respuesta.

TotalCount

integer

El número total de entradas.

1

RequestId

string

El ID de la solicitud.

1AD222E9-E606-4A42-BF6D-8A4442913CEF

PageSize

integer

El número de entradas devueltas por página.

30

PageNumber

integer

El número de la página devuelta.

1

DBClusterId

string

El ID del clúster.

am-bp1xxxxxxxx47

SuggestMaxRecordsPerPartition

integer

El número máximo recomendado de filas en cada partición de lista.

640000000

SuggestMinRecordsPerPartition

integer

El número mínimo recomendado de filas en cada partición de lista.

64000000

Items

array<object>

Las estadísticas de la tabla.

object

TableName

string

El nombre de la tabla.

test_table

PartitionDetail

string

La información sobre las particiones inadecuadas.

202005,202006

SchemaName

string

El nombre de la base de datos.

test_db

PartitionNumber

integer

El número de particiones.

2

SpaceRatio

number

El porcentaje de almacenamiento de la tabla. Unidad: %.

Nota

Fórmula: Porcentaje de almacenamiento de la tabla = Tamaño total de datos de una tabla / Tamaño total de datos del clúster × 100%.

66.23

TotalSize

integer

El tamaño total de datos de la tabla. Unidad: bytes.

42949672960

DetectionItems

array<object>

Los elementos de detección consultados y los resultados de la detección.

object

Name

string

El nombre del elemento de detección.

Improper Partition Field Diagnosis

Message

string

El resultado de la detección.

A total of 10 tables have an improper partition field

Status

string

El nivel de gravedad del resultado de la detección. Valores válidos:

  • NORMAL

  • WARNING

  • CRITICAL

WARNING

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TotalCount": 1,
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "PageSize": 123,
  "PageNumber": 34,
  "DBClusterId": "rm-uf6wjk5xxxxxxxxxx",
  "SuggestMaxRecordsPerPartition": 640000000,
  "SuggestMinRecordsPerPartition": 64000000,
  "Items": [
    {
      "TableName": "user",
      "PartitionDetail": "[20210110, 20210113,20210123]",
      "SchemaName": "test_db",
      "PartitionNumber": 34,
      "SpaceRatio": 66.23,
      "TotalSize": 42949672960
    }
  ],
  "DetectionItems": [
    {
      "Name": "Table partition rationality check",
      "Message": "A total of 10 tables have an improper partition field.",
      "Status": "WARNING"
    }
  ]
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.