Lekérdezési táblák

Cikk
06/27/2023

A Query Tables művelet a megadott fiók alatti táblák listáját adja vissza.

Kérés

A kérést az Query Tables alábbiak szerint hozhatja létre. A HTTPS használatát javasoljuk. Cserélje le a myaccount kifejezést a tárfiók nevére.

Metódus	Kérés URI-ja	HTTP-verzió
`GET`	`https://myaccount.table.core.windows.net/Tables`	HTTP/1.1

Emulált tárolási szolgáltatás URI-ja

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és a table szolgáltatás portját a következőként: 127.0.0.1:10002. Kövesse ezeket az információkat az emulált tárfiók nevével.

Metódus	Kérés URI-ja	HTTP-verzió
`GET`	`http://127.0.0.1:10002/devstoreaccount1/Tables`	HTTP/1.1

A Storage Emulator Table szolgáltatása többféleképpen különbözik az Azure Table Storage-tól. További információ: A storage emulátor és az Azure Storage-szolgáltatások közötti különbségek.

URI-paraméterek

A Query Tables művelet támogatja az OData protokoll specifikációja által meghatározott lekérdezési beállításokat.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti:

Kérelem fejléce	Leírás
`Authorization`	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba.
`Date` vagy `x-ms-date`	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba.
`x-ms-version`	Választható. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`Accept`	Választható. Megadja a válasz hasznos adatának elfogadott tartalomtípusát. Lehetséges értékek: - `application/atom+xml` (csak 2015-12-11 előtti verziók) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` További információ: A Table Storage-műveletek hasznos adatformátuma.
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Állapotkód

A sikeres művelet a 200 -os állapotkódot adja vissza (OK).

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok és Table Storage-hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Description
`x-ms-continuation-NextTableName`	A folytatási jogkivonat értékét adja vissza. Ha a visszaadandó táblák száma meghaladja az 1000-et, vagy a lekérdezés nem fejeződik be az időtúllépési időszakon belül, a válaszfejléc tartalmazza a `x-ms-continuation-NextTableName` folytatás fejlécét. További információ a folytatási jogkivonat használatáról: Lekérdezési időtúllépés és tördelés.
`x-ms-request-id`	Egyedileg azonosítja a végrehajtott kérést. Segítségével elháríthatja a kérést. További információ: API-műveletek hibaelhárítása.
`x-ms-version`	A Table Storage azon verzióját jelzi, amely a kérés végrehajtásához használatos. Ez a fejléc lesz visszaadva a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
`Date`	UTC dátum/idő érték, amely azt az időpontot jelzi, amikor a szolgáltatás elküldte a választ.
`Content-Type`	A hasznos adat tartalomtípusát jelzi. Az érték a kérelem fejlécétől `Accept` függ. Lehetséges értékek: - `application/atom+xml` - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Az érvényes tartalomtípusokkal kapcsolatos további információkért lásd: Payload format for Table Storage operations (Hasznos adatformátum a Table Storage-műveletekhez).
`x-ms-client-request-id`	A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a `x-ms-client-request-id` fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karakterből áll. Ha a `x-ms-client-request-id` fejléc nincs jelen a kérelemben, ez a fejléc nem lesz jelen a válaszban.

Választörzs

A Query Tables művelet A fiók tábláinak listáját adja vissza OData-entitáskészletként. A fejléc értéke Accept szerint a tartalom JSON vagy Atom-hírcsatorna.

Megjegyzés

Hasznos adatformátumként a JSON-t javasoljuk. Ez az egyetlen támogatott formátum a 2015-12-11-es és újabb verziókhoz.

JSON (2013-08-15-es és újabb verziók)

Íme egy minta JSON-választörzs egy Query Tables teljes metaadatokat tartalmazó művelethez:

{  
   "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
   "value":[  
      {  
         "odata.type":"myaccount.Tables",  
         "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",  
         "odata.editLink":"Tables('mytable')",  
         "TableName":"mytable"  
      }  
}

Íme egy JSON-minta választörzs egy Query Tables minimális metaadatokat tartalmazó művelethez:

{  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
    "value":[{  
        "TableName":"mytable"  
    }]  
}

Íme egy JSON-mintaválasz törzse egy Query Tables metaadatok nélküli művelethez:

{  
   "value":[{  
       "TableName":"mytable"  
   },  
}

Atom-hírcsatorna (2015-12-11 előtti verziók)

Íme egy minta Atom-választörzs a Query Tables művelethez:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<feed xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">  
  <title type="text">Tables</title>  
  <id>https://myaccount.table.core.windows.net/Tables</id>  
  <updated>2009-01-04T17:18:54.7062347Z</updated>  
  <link rel="self" title="Tables" href="Tables" />  
  <entry>  
    <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
    <title type="text"></title>  
    <updated>2009-01-04T17:18:54.7062347Z</updated>  
    <author>  
      <name />  
    </author>  
    <link rel="edit" title="Tables" href="Tables('mytable')" />  
    <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
    <content type="application/xml">  
      <m:properties>  
        <d:TableName>mytable</d:TableName>  
      </m:properties>  
    </content>  
  </entry>  
</feed>

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

A Table Storage-lekérdezések egyszerre legfeljebb 1000 táblát adhatnak vissza, és legfeljebb öt másodpercig futtathatók. A válasz tartalmaz egy egyéni fejlécet, amely a x-ms-continuation-NextTableName folytatási jogkivonatot tartalmazza az alábbi esetekben:

Az eredményhalmaz több mint 1000 táblát tartalmaz.
A lekérdezés nem fejeződött be öt másodpercen belül.
A lekérdezés átlépi a partíció határát.

A folytatással létrehozhat egy későbbi kérést a következő adatoldalra. További információ a folytatási jogkivonatokról: Lekérdezés időtúllépése és tördelése.

Megjegyzés

Ha folytatási jogkivonatokat tartalmazó további kéréseket küld, mindenképpen adja át az eredeti URI-t a kérésen. Ha például egy , $selectvagy $top lekérdezési lehetőséget adott meg $filteraz eredeti kérés részeként, adja meg ezt a beállítást a későbbi kérésekhez. Ellenkező esetben előfordulhat, hogy a későbbi kérések váratlan eredményeket adnak vissza.

Ebben $top az esetben a lekérdezési beállítás határozza meg az oldalankénti eredmények maximális számát. Nem adja meg az eredmények maximális számát a teljes válaszkészletben.

További információ: Táblák és entitások lekérdezése.

A lekérdezés ütemezésére és feldolgozására vonatkozó kérelem teljes időtartama 30 másodperc. Ez az összeg tartalmazza a lekérdezés végrehajtásához szükséges öt másodpercet.

A Table Storage LINQ-n keresztüli támogatott lekérdezési műveleteiről további információt a Table Storage-hoz támogatott lekérdezési operátorok és a LINQ-lekérdezések a Table Storage-on történő írása című témakörben talál.

Lásd még

Table Storage-erőforrások kezelése
Kérések engedélyezése az Azure Storage-nak
Az OData-adatszolgáltatás verziófejléceinek beállítása
Állapot- és hibakódok
Table Storage-hibakódok