Todos os produtos
Search
Central de documentação

:ListLogicTables

Última atualização: Jul 08, 2026

Use a API ListLogicTables para consultar informações detalhadas das tabelas lógicas em um banco de dados lógico específico.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação. Você pode usar o OpenAPI Explorer para pesquisar operações de API, chamá-las e gerar dinamicamente códigos de exemplo do SDK.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ListLogicTables

Operação a ser executada. Defina o valor como ListLogicTables.

DatabaseId String Sim 1

ID do banco de dados lógico.

PageNumber Integer Sim 1

Número da página retornada.

Tid Long Sim -1

ID do locatário.

Nota O ID do locatário é obtido ao passar o ponteiro do mouse sobre sua foto de perfil. Para mais informações, consulte Visualizar informações do locatário .
PageSize Integer Não 10

Número de entradas a serem retornadas por página.

SearchName String Não test

Palavra-chave para consultar tabelas lógicas. A correspondência ocorre pelo prefixo.

ReturnGuid Boolean Não true

Especifica se o GUID da tabela deve ser retornado.

Parâmetros de resposta

**

Parâmetro

**

**

Tipo

**

**

Resposta de exemplo

**

**

Descrição

**

ErrorCode

String

UnknownError

Códigos de erro.

ErrorMessage

String

UnknownError

Mensagem de erro da falha.

LogicTableList

Array of LogicTable

Detalhes da tabela lógica.

LogicTable

DatabaseId

String

1

ID do banco de dados lógico.

Logic

Boolean

true

Indica se a tabela é uma tabela lógica. O valor é fixo como true.

OwnerIdList

List

1

ID do proprietário da tabela lógica.

OwnerNameList

List

owner_name

Apelido do proprietário da tabela lógica.

SchemaName

String

yuyang_test

Nome do banco de dados lógico correspondente à tabela lógica atual.

TableCount

String

4

Número de shards da tabela.

TableExpr

String

test[1-4]

Expressão da tabela lógica.

TableGuid

String

IDB_L_308302.yuyang_test.test_ch

GUID da tabela lógica.

TableId

String

1

ID da tabela lógica.

TableName

String

test

Nome da tabela lógica.

RequestId

String

F1E6484F-9DF1-4406-9BDE-0861C4629B69

ID da solicitação.

Success

Boolean

true

Indica se a chamada foi bem-sucedida.

TotalCount

Long

1

Número de registros que atenderam à condição.

Exemplos

Exemplo de solicitação


     http(s)://[Endpoint]/? Action=ListLogicTables &<common request parameters> 
   

Exemplos de respostas de sucesso

Formato XML


     <TotalCount>1</TotalCount> <RequestId>F1E6484F-9DF1-4406-9BDE-0861C4629B69</RequestId> <LogicTableList> <LogicTable> <Logic>true</Logic> <OwnerNameList> <OwnerNames>xxx</OwnerNames> <OwnerNames>xxx</OwnerNames> </OwnerNameList> <TableExpr>t[1-4]</TableExpr> <DatabaseId>267</DatabaseId> <SchemaName>yuyang_test</SchemaName> <TableName>t</TableName> <TableGuid>IDB_L_3057.yuyang_test.t</TableGuid> <TableCount>4</TableCount> <OwnerIdList> <OwnerIds>88653</OwnerIds> <OwnerIds>104442</OwnerIds> </OwnerIdList> <TableId>3057</TableId> </LogicTable> </LogicTableList> <Success>true</Success> 
   

JSON


     { "TotalCount": 1, "RequestId": "F1E6484F-9DF1-4406-9BDE-0861C4629B69", "LogicTableList": { "LogicTable": [ { "Logic": true, "OwnerNameList": { "OwnerNames": [ "xxx", "xxx" ] }, "TableExpr": "t[1-4]", "DatabaseId": 267, "SchemaName": "yuyang_test", "TableName": "t", "TableGuid": "IDB_L_3057.yuyang_test.t", "TableCount": 4, "OwnerIdList": { "OwnerIds": [ 88653, 104442 ] }, "TableId": 3057 } ] }, "Success": true } 
   

Códigos de erro

Para obter mais informações sobre códigos de erro, consulte o error center.