Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/TaurusDB/Referencia de la API/Las API (recomendadas)/Control de simultaneidad de sentencia SQL/Configuración de reglas de control de simultaneidad de sentencias SQL
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Configuración de reglas de control de simultaneidad de sentencias SQL

Función

Esta API se utiliza para configurar reglas de control de simultaneidad de sentencias SQL. Antes de invocar a esta API:

URI

PUT /v3/{project_id}/instances/{instance_id}/sql-filter/rules

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia, que es compatible con el formato UUID.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us.

Valores:

  • en-us
  • zh-cn
Tabla 3 Parámetro del cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

sql_filter_rules

Sí

Array of NodeSqlFilterRuleInfo objects

Reglas de control de simultaneidad de sentencias SQL para nodos.

Tabla 4 NodeSqlFilterRuleInfo

Parámetro

Obligatorio

Tipo

Descripción

node_id

Sí

String

ID del nodo.

rules

Sí

Array of NodeSqlFilterRule objects

Reglas de control de simultaneidad de sentencias SQL. El valor sql_type debe ser único.

Tabla 5 NodeSqlFilterRule

Parámetro

Obligatorio

Tipo

Descripción

sql_type

Sí

String

Tipo de sentencia SQL.

Valores:

  • SELECT
  • UPDATE
  • DELETE

patterns

Sí

Array of NodeSqlFilterRulePattern objects

Reglas de control de simultaneidad de sentencias SQL.

Tabla 6 NodeSqlFilterRulePattern

Parámetro

Obligatorio

Tipo

Descripción

pattern

Sí

String

Una regla de control de simultaneidad de sentencias SQL. Una regla puede consistir en hasta 128 palabras clave. Las palabras clave están separadas por tildes (~), por ejemplo, select~from~t1. La regla no puede contener barras invertidas (\), comas (,), o tildes dobles (~~). No puede terminar con tildes (~).

max_concurrency

Sí

Integer

Número máximo de sentencias SQL simultáneas.

Valor: un entero no negativo.

Parámetros de respuesta

Código de estado: 200

Tabla 7 Parámetro del cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de la tarea para configurar reglas de control de simultaneidad de sentencias SQL.

Código de estado: 400

Tabla 8 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 9 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Configuración de reglas de control de simultaneidad de sentencias SQL (los tipos de sentencias SQL son SELECT, UPDATE y DELETE)

PUT https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instance/af315b8e6aaa41799bd9a31f2de15abcin07/sql-filter/rules
{
  "sql_filter_rules" : [ {
    "node_id" : "c01a5645eb2c4fb6a9373542f5366e50no07",
    "rules" : [ {
      "sql_type" : "SELECT",
      "patterns" : [ {
        "pattern" : "select~from~t1",
        "max_concurrency" : 0
      }, {
        "pattern" : "select~from~t3~where~id",
        "max_concurrency" : 10
      } ]
    }, {
      "sql_type" : "UPDATE",
      "patterns" : [ {
        "pattern" : "update~t3~where~id",
        "max_concurrency" : 10
      } ]
    } ]
  }, {
    "node_id" : "b234a5645eb2c4ji3b9372342f5362397no07",
    "rules" : [ {
      "sql_type" : "SELECT",
      "patterns" : [ {
        "pattern" : "select~from~t3~where~id",
        "max_concurrency" : 10
      } ]
    }, {
      "sql_type" : "DELETE",
      "patterns" : [ {
        "pattern" : "delete~t3~where~id",
        "max_concurrency" : 10
      } ]
    } ]
  } ]
}

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "job_id" : "aef6a470-fb63-4d5b-b644-12ead7e019b3"
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.