Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/TaurusDB/Referência de API/APIs (recomendadas)/Controle de concorrência de instruções SQL/Configuração de regras de controle de simultaneidade de instruções SQL
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Configuração de regras de controle de simultaneidade de instruções SQL

Função

Essa API é usada para configurar regras de controle de simultaneidade de instruções SQL. Antes de chamar essa API:

URI

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

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário numa região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

instance_id

Sim

String

ID da instância, que é compatível com o formato UUID.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Para obter esse valor, chame a API do IAM para obter um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us.

Valores:

  • en-us
  • zh-cn
Tabela 3 Parâmetro do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

sql_filter_rules

Sim

Array of NodeSqlFilterRuleInfo objects

Regras de controle de simultaneidade de instruções SQL para nós.

Tabela 4 NodeSqlFilterRuleInfo

Parâmetro

Obrigatório

Tipo

Descrição

node_id

Sim

String

ID do nó.

rules

Sim

Array of NodeSqlFilterRule objects

Regras de controle de simultaneidade de instruções SQL. O valor sql_type deve ser exclusivo.

Tabela 5 NodeSqlFilterRule

Parâmetro

Obrigatório

Tipo

Descrição

sql_type

Sim

String

Tipo de instrução SQL.

Valores:

  • SELECT
  • UPDATE
  • DELETE

patterns

Sim

Array of NodeSqlFilterRulePattern objects

Regras de controle de simultaneidade de instruções SQL.

Tabela 6 NodeSqlFilterRulePattern

Parâmetro

Obrigatório

Tipo

Descrição

pattern

Sim

String

Uma regra de controle de simultaneidade de instruções SQL. Uma regra pode consistir em até 128 palavras-chave. As palavras-chave são separadas por tis (~), por exemplo, select~from~t1. A regra não pode conter barras invertidas (\), virgulas (,) ou dois tis (~~). Não pode terminar com tis (~).

max_concurrency

Sim

Integer

Número máximo de instruções SQL simultâneas.

Valor: um número inteiro não negativo.

Parâmetros de resposta

Código de status: 200

Tabela 7 Parâmetro do corpo da resposta

Parâmetro

Tipo

Descrição

job_id

String

ID da tarefa para configurar regras de controle de simultaneidade de instruções SQL.

Código de status: 400

Tabela 8 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 9 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Configuração de regras de controle de simultaneidade de instruções SQL (os tipos de instruções SQL incluem SELECT, UPDATE e 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
      } ]
    } ]
  } ]
}

Exemplo de resposta

Código de status: 200

Bem-sucedido.

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

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.