Todos los productos
Search
Centro de documentos

Database Autonomy Service:CreateQueryOptimizeTag

Última actualización: Sep 08, 2026

Llama a la operación CreateQueryOptimizeTag para agregar etiquetas a las sentencias SQL de destino.

Descripción de la operación

  • Cuando use el SDK de Alibaba Cloud o de DAS, use la última versión.

  • Cuando llame a DAS mediante el SDK, establezca la región en cn-shanghai.

  • Esta operación admite los siguientes motores de base de datos:
    • RDS MySQL

    • PolarDB for MySQL

    • RDS PostgreSQL

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

hdm:CreateQueryOptimizeTag

update

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Engine

string

Sí

El motor de base de datos. Valores válidos:

  • MySQL: RDS MySQL

  • PolarDBMySQL: PolarDB for MySQL

  • PostgreSQL: RDS PostgreSQL

MySQL

SqlIds

string

Sí

El ID de la plantilla SQL. Para consultar los ID de plantilla SQL, llame a la operación GetQueryOptimizeDataStats. Puede especificar varios ID de plantilla SQL separados por comas (,) para agregar etiquetas por lotes.

6068ce044e3dc9b903979672fb0b69df,d12515c015fc9f41a0778a9e1de0****

Tags

string

Sí

La etiqueta SQL. Puede especificar varios valores separados por comas (,).

  • DAS_IMPORTANT: SQL importante.

  • DAS_NOT_IMPORTANT: SQL no importante.

  • USER_IGNORE: no requiere optimización.

  • DAS_IN_PLAN: programado para optimización.

DAS_IN_PLAN,DAS_NOT_IMPORTANT

Status

integer

Sí

El estado del parámetro de solicitud Tags.

  • 0: Borra todas las etiquetas de los ID de plantilla SQL especificados en SqlIds e ignora el parámetro Tags.

  • 1: Establece las etiquetas de los ID de plantilla SQL especificados en SqlIds en los valores especificados en Tags.

1

Comments

string

No

Las observaciones.

El valor debe tener una longitud de 1 a 300 caracteres.

SQL lento de sincronización sin conexión. No requiere optimización

InstanceId

string

Sí

El ID de la instancia.

rm-2ze1jdv45i7l6****

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Code

string

El código de estado devuelto.

200

Message

string

El mensaje devuelto.

Nota

Si la solicitud se realiza correctamente, se devuelve Successful. Si la solicitud falla, se devuelve un mensaje de error que contiene información como un código de error.

Successful

RequestId

string

El ID único que genera Alibaba Cloud para la solicitud.

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

Success

string

Indica si la solicitud se realiza correctamente. Valores válidos:

  • true: la solicitud se realiza correctamente.

  • false: la solicitud falla.

true

Data

boolean

Indica si la operación de etiquetado se realiza correctamente. Valores válidos:

  • true: la operación de etiquetado se realiza correctamente.

  • false: la operación de etiquetado falla.

true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": true
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

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

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.