Todos os produtos
Search
Central de documentação

:GetStructSyncJobDetail

Última atualização: Jul 08, 2026

Consulta os detalhes de uma tarefa de sincronização de esquema.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
OrderId Long Sim 4324321

ID do ticket.

Tid Long Não 1

ID do locatário.

Nota O ID do locatário aparece ao passar o ponteiro sobre a foto do perfil no canto superior direito do console do Data Management (DMS). Para mais informações, consulte Informações do locatário.
RegionId String Não cn-hangzhou

ID da região onde o serviço DMS está localizado. 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 dos seus serviços.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String 48602B78-0DDF-414C-8688-70CAB6070115

ID da solicitação.

Success Boolean true

Indica se a chamada foi bem-sucedida.

ErrorMessage String UnknownError

Mensagem de erro retornada.

ErrorCode String UnknownError

Código de erro retornado.

StructSyncJobDetail object

Detalhes da tarefa de sincronização de esquema.

JobStatus String DBTASK_SUCCESS

Status da tarefa. Valores válidos:

  • NEW: Tarefa criada.
  • COMPARING: Esquemas das tabelas em comparação.
  • COMPARE_BREAK: Comparação de esquemas interrompida.
  • COMPARE_FINISH: Comparação de esquemas concluída.
  • NOT_SCRIPTS: Comparação de esquemas concluída. Nenhum script disponível.
  • SUBMITED_DBTASK: Tarefa enviada.
  • DBTASK_SUCCESS: Tarefa concluída.
  • SUBMITED_WORKFLOW: Ticket enviado para aprovação.
  • WORKFLOW_SUCCESS: Ticket aprovado.
Message String test

Descrição da tarefa.

TableAnalyzed Long 2

Número de tabelas analisadas.

TableCount Long 2

Número total de tabelas.

SqlCount Long 1

Número total de instruções SQL.

ExecuteCount Long 1

Número de instruções SQL executadas.

SecurityRule String WITHOUT_APPROVE

Tipo de regra de segurança. Valores válidos:

  • CANNOT_SYNC: Sincronização de esquema não permitida.
  • WITH_APPROVE: Sincronização de esquema permitida após aprovação do ticket. Chame a operação SubmitStructSyncOrderApproval para enviar o ticket para aprovação.
  • WITHOUT_APPROVE: Sincronização de esquema permitida sem aprovação.
DBTaskGroupId Long 12345

ID da fila de tarefas.

Exemplos

Exemplos de solicitações

http(s)://dms-enterprise.aliyuncs.com/?OrderId=4324321
&Tid=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<GetStructSyncJobDetailResponse>
    <RequestId>C29D0A5F-BB9B-4CB9-A6B7-19B5433983CA</RequestId>
    <StructSyncJobDetail>
        <JobStatus>COMPARE_FINISH</JobStatus>
        <Message>The schema comparison is complete. A script to synchronize the schemas of tables is generated.</Message>
        <TableAnalyzed>6</TableAnalyzed>
        <TableCount>6</TableCount>
        <SecurityRule>WITH_APPROVE</SecurityRule>
        <DBTaskGroupId>3000000</DBTaskGroupId>
    </StructSyncJobDetail>
    <Success>true</Success>
</GetStructSyncJobDetailResponse>

Formato JSON

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

{
  "RequestId" : "C29D0A5F-BB9B-4CB9-A6B7-19B5433983CA",
  "StructSyncJobDetail" : {
    "JobStatus" : "COMPARE_FINISH",
    "Message": "The schema comparison is complete. A script to synchronize the schemas of tables is generated.",
    "TableAnalyzed" : 6,
    "TableCount" : 6,
    "SecurityRule" : "WITH_APPROVE",
    "DBTaskGroupId" : 3000000
  },
  "Success" : true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.