Tüm Ürünler
Search
Belge Merkezi

:ListTables

Son Güncelleme:Oct 04, 2026

Fiziksel bir veritabanındaki tabloların ayrıntılarını sorgular.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodu dinamik olarak oluşturur.

İstek Parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet ListTables

Gerçekleştirmek istediğiniz işlem. Değeri ListTables olarak ayarlayın.

Tid Long Evet 3***

Kiracı ID'si. Kiracı ID'sini almak için GetUserActiveTenant veya ListUserTenants işlemini çağırabilirsiniz.

DatabaseId String Evet 1860****

Fiziksel veritabanının ID'si. Fiziksel veritabanı ID'sini almak için ListDatabases veya SearchDatabase işlemini çağırabilirsiniz.

PageNumber Integer Evet 1

Döndürülecek sayfanın numarası.

PageSize Integer Hayır 10

Her sayfada döndürülecek kayıt sayısı.

SearchName String Hayır test

Tabloları aramak için kullanılan ad. Bulanık arama desteklenir.

ReturnGuid Boolean Hayır true

Bir tablonun GUID'sinin döndürülüp döndürülmeyeceğini belirtir. Geçerli değerler:

  • true: Tablonun GUID'sini döndürür.
  • false: Tablonun GUID'sini döndürmez.
RegionId String Hayır cn-hangzhou

Data Management (DMS) hizmetinin etkinleştirildiği bölgenin ID'si. Daha fazla bilgi için bkz. RegionID parametresi.

Yanıt Parametreleri

Parametre Tür Örnek Açıklama
TotalCount Long 1

Sorgu koşullarını karşılayan toplam tablo sayısı.

RequestId String B16FB618-5E96-4FFD-BB0D-490C890A4030

İsteğin ID'si.

ErrorCode String UnknownError

İstek başarısız olursa döndürülen hata kodu.

TableList Array of Table

Tabloların ayrıntıları.

Table
DatabaseId String 1860****

Fiziksel veritabanının ID'si.

TableName String consumption_records

Tablonun adı.

StoreCapacity Long 1024

Tablonun kapladığı depolama alanı. Bu istatistiksel bir değerdir ve kesin depolama alanını göstermez. Birim: MB.

OwnerIdList Array of String 51****

Tablo sahiplerinin ID'leri.

Description String test

Tablonun açıklaması.

Encoding String utf8

Tablonun kodlama biçimi.

OwnerNameList Array of String owner_name

Tablo sahiplerinin takma adları.

TableSchemaName String qntest

Tablonun bulunduğu veritabanı.

TableType String NORMAL

Tablonun türü. Varsayılan değer: NORMAL.

TableGuid String IDB_44743****.qntest.consumption_records

DMS'deki tablonun GUID'si.

Engine String InnoDB

Tablonun motoru.

NumRows Long 10085

Tablodaki satır sayısı. Bu istatistiksel bir değerdir ve gerçek satır sayısını göstermez.

TableId String 44743****

Tablonun ID'si.

ErrorMessage String UnknownError

İstek başarısız olursa döndürülen hata mesajı.

Success Boolean true

İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:

  • true: İstek başarılı oldu.
  • false: İstek başarısız oldu.

Örnekler

Örnek istekler

http(s)://dms-enterprise.aliyuncs.com/?Action=ListTables
&Tid=3***
&DatabaseId=1860****
&PageNumber=1
&PageSize=10
&SearchName=test
&ReturnGuid=true
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

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

<ListTablesResponse>
    <TotalCount>1</TotalCount>
    <RequestId>B16FB618-5E96-4FFD-BB0D-490C890A4030</RequestId>
    <TableList>
        <DatabaseId>1860****</DatabaseId>
        <TableName>consumption_records</TableName>
        <StoreCapacity>1024</StoreCapacity>
        <OwnerIdList>51****</OwnerIdList>
        <Description>test</Description>
        <Encoding>utf8</Encoding>
        <OwnerNameList>owner_name</OwnerNameList>
        <TableSchemaName>qntest</TableSchemaName>
        <TableType>NORMAL</TableType>
        <TableGuid>IDB_44743****.qntest.consumption_records</TableGuid>
        <Engine>InnoDB</Engine>
        <NumRows>10085</NumRows>
        <TableId>44743****</TableId>
    </TableList>
    <Success>true</Success>
</ListTablesResponse>

JSON biçimi

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

{
  "TotalCount" : 1,
  "RequestId" : "B16FB618-5E96-4FFD-BB0D-490C890A4030",
  "TableList" : [ {
    "DatabaseId" : "1860****",
    "TableName" : "consumption_records",
    "StoreCapacity" : 1024,
    "OwnerIdList" : [ "51****" ],
    "Description" : "test",
    "Encoding" : "utf8",
    "OwnerNameList" : [ "owner_name" ],
    "TableSchemaName" : "qntest",
    "TableType" : "NORMAL",
    "TableGuid" : "IDB_44743****.qntest.consumption_records",
    "Engine" : "InnoDB",
    "NumRows" : 10085,
    "TableId" : "44743****"
  } ],
  "Success" : true
}

Hata Kodu

Hata kodlarının listesi için Hata Merkezi adresini ziyaret edin.