Todos os produtos
Search
Central de documentação

:GetTableDBTopology

Última atualização: Jul 08, 2026

Chame a operação GetTableDBTopology para obter o grafo de topologia de uma tabela de dados.

Depuração

Teste esta operação no OpenAPI Explorer. Isso elimina a necessidade de calcular assinaturas. Após a execução bem-sucedida, o OpenAPI Explorer gera automaticamente um código de exemplo para o kit de desenvolvimento de software (SDK).

Parâmetros da solicitação

Nome Tipo Obrigatório Exemplo Descrição
Action String Sim GetTableDBTopology

Parâmetro obrigatório. Defina o valor como GetTableDBTopology.

Tid Long Não 3***

O ID do locatário.

Nota Para obter o ID do locatário, passe o ponteiro do mouse sobre a foto do perfil no canto superior direito do console DMS. Para mais informações, consulte Visualizar informações do locatário.
TableGuid String Sim IDB_L_9032.db-test.yuyang_test

O identificador globalmente exclusivo (GUID) da tabela no DMS.

Nota
  • Para tabela lógica, chame a operação ListLogicTables e defina o parâmetro ReturnGuid como true.
  • Para tabela física, chame a operação ListTables e defina o parâmetro ReturnGuid como true.

Dados retornados

Nome Tipo Exemplo Descrição
RequestId String 853F7FD4-D922-4EFB-931C-D253EF159E06

O ID da solicitação.

DBTopology Object

A topologia do banco de dados.

TableName String yuyang_test

O nome da tabela.

Nota
  • Em consultas a tabelas lógicas, retorna o nome da tabela lógica.
  • Em consultas a tabelas físicas, retorna o nome da tabela física.
DataSourceList Array of DataSource

Lista de source de dados.

Sid String def

O ID do sistema (SID) da source de dados.

Host String xxx.mysql.polardb.rds.aliyuncs.com

O endereço de conexão da source de dados.

DbType String MySQL

O tipo do banco de dados. Para mais informações sobre valores válidos, consulte descrição do parâmetro dbType.

DatabaseList Array of Database

Lista de bancos de dados físicos para fragmentação de banco de dados.

DbId String 489347

O ID do banco de dados.

DbName String db-test

O nome do banco de dados físico.

DbType String MySQL

O tipo do banco de dados. Para mais informações sobre valores válidos, consulte descrição do parâmetro dbType.

TableList Array of Table

Lista de tabelas físicas para fragmentação de tabela.

TableName String 151977812

O nome da tabela física.

TableType String yuyang_test_0000

O tipo da tabela. Campo reservado.

TableId String NORMAL

O ID da tabela.

EnvType String pre

O tipo de ambiente. Valores válidos:

  • product: produção
  • dev: desenvolvimento
  • pre: homologação
  • test: testes
  • sit: SIT
  • uat: UAT
  • pet: teste de estresse
  • stag: STAG
Nota Para mais informações, consulte Ambientes de instância.
Port Integer 3306

A porta de conexão da source de dados.

TableGuid String IDB_L_9032.db-test.yuyang_test

O identificador globalmente exclusivo (GUID) da tabela no DMS.

ErrorCode String UnknownError

O código de erro.

ErrorMessage String UnknownError

A mensagem de erro.

Success Boolean true

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

Exemplos

Solicitação de exemplo

http(s)://dms-enterprise.aliyuncs.com/?Action=GetTableDBTopology
&Tid=3***
&TableGuid=IDB_L_9032.db-test.yuyang_test
&<Common request parameters>

Respostas de exemplo

Formato XML

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

<GetTableDBTopologyResponse>
    <RequestId>78F78156-2BBE-414A-8A9D-BE61CF6FA60F</RequestId>
    <DBTopology>
        <TableName>big_table</TableName>
        <TableGuid>IDB_270000001.film.big_table</TableGuid>
        <DataSourceList>
            <DatabaseList>
                <DbId>4000000</DbId>
                <DbName>film</DbName>
                <TableList>
                    <TableId>200000000</TableId>
                    <TableName>big_table</TableName>
                    <TableType>NORMAL</TableType>
                </TableList>
                <EnvType>product</EnvType>
                <DbType>mysql</DbType>
            </DatabaseList>
            <Port>3306</Port>
            <Host>rm-uf000000z0000002l.mysql.rds.aliyuncs.com</Host>
            <DbType>mysql</DbType>
        </DataSourceList>
    </DBTopology>
    <Success>true</Success>    
</GetTableDBTopologyResponse>

Formato JSON

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

{
  "RequestId" : "78F78156-2BBE-414A-8A9D-BE61CF6FA60F",
  "DBTopology" : {
    "TableName" : "big_table",
    "TableGuid" : "IDB_270000001.film.big_table",
    "DataSourceList" : [ {
      "DatabaseList" : [ {
        "DbId" : 4000000,
        "DbName" : "film",
        "TableList" : [ {
          "TableId" : 200000000,
          "TableName" : "big_table",
          "TableType" : "NORMAL"
        } ],
        "EnvType" : "product",
        "DbType" : "mysql"
      } ],
      "Port" : 3306,
      "Host" : "rm-uf000000z0000002l.mysql.rds.aliyuncs.com",
      "DbType" : "mysql"
    } ]
  },
  "Success" : true
}

Códigos de erro

Para mais informações sobre códigos de erro, consulte a Central de Erros.