Todos os produtos
Search
Central de documentação

:ListDataCorrectPreCheckSQL

Última atualização: Jul 08, 2026

Consulta as informações de pré-verificação de uma instrução SQL especificada em um ticket de alteração de dados.

Para obter mais informações sobre o recurso Normal Data Modify, consulte Alterar dados regulares.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimListDataCorrectPreCheckSQL

Operação a executar. Defina o valor como ListDataCorrectPreCheckSQL.

OrderIdLongSim12****

ID do ticket de alteração de dados.

PageNumberLongNão1

Número da página a retornar.

Valores válidos: número inteiro maior que 0.

Valor padrão: 1.

PageSizeLongNão10

Quantidade de entradas a retornar por página.

DbIdLongNão11****

ID do banco de dados.

TidLongNão1

ID do locatário. Chame a operação GetUserActiveTenant ou ListUserTenants para consultar esse ID.

RegionIdStringNãocn-hangzhou

ID da região onde o DMS está ativado. Para obter mais informações sobre os valores válidos deste parâmetro, consulte Parâmetro RegionID.

Nota Defina este parâmetro com o ID da região mais próxima do seu serviço.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdString4B2520C9-3005-4CCA-9C9B-944254ABEB0B

ID da solicitação.

SuccessBooleantrue

Indica se a solicitação foi bem-sucedida.

ErrorMessageStringUnknownError

Mensagem de erro retornada.

ErrorCodeStringUnknownError

Código de erro retornado.

PreCheckSQLListArray of PreCheckSQL

Informações de pré-verificação das instruções SQL.

CheckSQLStringCREATE TABLE t1 ...

Instrução SQL.

AffectRowsLong0

Número estimado de linhas afetadas.

DbIdLong431253

ID do banco de dados.

SQLReviewQueryKeyStringb9e771fc6ec247dea6d06a32c777****

Chave usada para consultar detalhes das sugestões de otimização. Chame a operação GetSQLReviewOptimizeDetail para consultar esses detalhes com base na chave.

SqlReviewStatusStringPASS

Status de revisão da instrução SQL. Valores válidos:

  • WAITING: Instrução SQL pendente de revisão.
  • RUNNING: Instrução SQL em revisão.
  • IGNORE: Revisão da instrução SQL ignorada.
  • PASS: Instrução SQL aprovada na revisão.
  • BLOCK: Instrução SQL reprovada na revisão.
SqlTypeStringCREATE_TABLE

Tipo da instrução SQL.

Exemplos

Solicitações de exemplo

http(s)://dms-enterprise.aliyuncs.com/?Action=ListDataCorrectPreCheckSQL
&OrderId=12345
&PageNumber=1
&PageSize=10
&DbId=111222
&Tid=1
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListDataCorrectPreCheckSQLResponse>
    <RequestId>B02A7F37-96D2-4712-9196-4A5C94174A75</RequestId>
    <PreCheckSQLList>
        <CheckSQL>CREATE TABLE IF NOT EXISTS `task_data_2020-10` LIKE task_data</CheckSQL>
        <SqlReviewStatus>PASS</SqlReviewStatus>
        <DbId>8050000</DbId>
        <SqlType>CREATE_TABLE</SqlType>
        <AffectRows>0</AffectRows>
        <SQLReviewQueryKey>4eb7635609c54ced8c584e926aa7****</SQLReviewQueryKey>
    </PreCheckSQLList>
    <Success>true</Success>
</ListDataCorrectPreCheckSQLResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "B02A7F37-96D2-4712-9196-4A5C94174A75",
  "PreCheckSQLList" : [ {
    "CheckSQL" : "CREATE TABLE IF NOT EXISTS `task_data_2020-10` LIKE task_data",
    "SqlReviewStatus" : "PASS",
    "DbId" : 8050000,
    "SqlType" : "CREATE_TABLE",
    "AffectRows" : 0,
    "SQLReviewQueryKey" : "4eb7635609c54ced8c584e926aa7****"
  } ],
  "Success" : true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.