Lekérdezéstáblák

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

Kérés

A Query Tables kérelem a következőképpen hozható létre. A HTTPS használata ajánlott. A myaccount helyére írja be a tárfiók nevét:

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

Emulált Storage 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 Service-portot 127.0.0.1:10002, majd az emulált tárfiók nevét:

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

Az emulált tárolási szolgáltatás Table szolgáltatása többféleképpen különbözik az Windows ® Azure™ Table szolgáltatástól. További információ: Különbségek a Storage Emulator és az Azure Storage Services között.

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. További információ: OData Protocol.

Kérelemfejlé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.
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.
x-ms-version Választható. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage Services 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ó: Table Service-műveletek hasznos adatformátuma.
x-ms-client-request-id Választható. Ügyfél által generált, átlátszatlan értéket biztosít 1 KiB karakterkorláttal, amely akkor lesz rögzítve az elemzési naplókban, ha engedélyezve van a tárolóelemzés naplózása. A fejléc használata erősen ajánlott az ügyféloldali tevékenységek és a kiszolgáló által kapott kérések összevetéséhez. További információ: A Storage Analytics naplózás és az Azure-naplózás Windows: Naplók használata Storage kérések nyomon követéséhez.

Kérelem 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-ás állapotkódot adja vissza (OK).

Az állapotkódokkal kapcsolatos információkért lásd az Állapot- és hibakódok , valamint a Table Service hibakódjait.

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 Ha a visszaadandó táblák száma meghaladja az 1000-et, vagy a lekérdezés nem fejeződik be az időkorláton belül, a válaszfejléc tartalmazza a x-ms-continuation-NextTableName folytatás fejlécét. Ez a fejléc a folytatási jogkivonat értékét adja vissza. További információ a folytatási jogkivonat használatáról: Lekérdezés időtúllépése és tördelése.
x-ms-request-id Ez a fejléc egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version A kérés végrehajtásához használt Table szolgáltatás verzióját jelzi. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
Date A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
Content-Type A hasznos adat tartalomtípusát jelzi. Az érték a kérelem Accept fejlécétől 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 a Table Service-műveletek hasznosadat-formátumát.
x-ms-client-request-id Ez a fejléc a kérések és a megfelelő válaszok hibaelhárítására használható. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, é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álasz törzse

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

Megjegyzés

A JSON az ajánlott hasznos adatformátum, és ez az egyetlen támogatott formátum a 2015-12-11-s és újabb verziókban.

JSON (2013.08.15-i és újabb verziók)

Íme egy minta JSON-választörzs a Query Tables műveletekhez.

Teljes metaadatok

{  
   "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"  
      }  
}  

Minimális metaadatok

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

Nincsenek metaadatok

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

Atom feed (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 service-hez tartozó lekérdezések egyszerre legfeljebb 1000 táblát adhatnak vissza, és legfeljebb öt másodpercig hajthatók végre. Ha az eredményhalmaz több mint 1000 táblát tartalmaz, ha a lekérdezés öt másodpercen belül nem fejeződött be, vagy ha a lekérdezés átlépi a partíció határát, a válasz tartalmaz egy egyéni fejlécet, amely tartalmazza a x-ms-continuation-NextTableName folytatási jogkivonatot. A folytatási jogkivonat felhasználható a következő adatoldalra vonatkozó későbbi kérés létrehozásához. További információ a folytatási jogkivonatokról: Lekérdezés időtúllépése és tördelése.

Megjegyzés

A folytatási jogkivonatokat tartalmazó későbbi kérések során mindenképpen adja át az eredeti URI-t a kérésen. Ha például egy $filter, $selectvagy $top lekérdezési beállítást adott meg az eredeti kérés részeként, akkor ezt a beállítást a későbbi kérésekhez is használnia kell. Ellenkező esetben a későbbi kérések váratlan eredményeket adhatnak vissza.

Vegye figyelembe, hogy ebben az esetben a $top lekérdezési beállítás az eredmények maximális számát határozza meg oldalanként, nem pedig a teljes válaszkészletben található találatok maximális számát.

További részletekért lásd: Táblák és entitások lekérdezése .

Vegye figyelembe, hogy a lekérdezés ütemezésére és feldolgozására vonatkozó kérelemhez tartozó teljes idő 30 másodperc, beleértve a lekérdezés végrehajtásához szükséges öt másodpercet is.

A Table Service-ben a LINQ-n keresztül támogatott lekérdezési műveletekről további információt a Table Service-ben támogatott lekérdezési operátorokkal és aLINQ-lekérdezések Table Service-beli írásával foglalkozó témakörben talál.

Lásd még:

A Table Service erőforrásainak kezelése
Kérelmek engedélyezése az Azure Storage
Az OData Data Service verziófejléceinek beállítása
Állapot- és hibakódok
A Table Service hibakódjai