Tabulky dotazů

Článek
06/27/2023

Operace Query Tables vrátí seznam tabulek v rámci zadaného účtu.

Žádost

Požadavek můžete sestavit Query Tables následujícím způsobem. Doporučujeme HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
`GET`	`https://myaccount.table.core.windows.net/Tables`	HTTP/1.1

Identifikátor URI služby emulovaného úložiště

Při vytváření požadavku na službu emulovaného úložiště zadejte název hostitele emulátoru a port služby Table Service jako 127.0.0.1:10002. Postupujte podle těchto informací s názvem emulovaného účtu úložiště.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
`GET`	`http://127.0.0.1:10002/devstoreaccount1/Tables`	HTTP/1.1

Služba Table Service v emulátoru úložiště se od Azure Table Storage liší několika způsoby. Další informace najdete v tématu Rozdíly mezi emulátorem úložiště a službami Azure Storage.

Parametry identifikátoru URI

Operace Query Tables podporuje možnosti dotazu, které definuje specifikace protokolu OData .

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků:

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date` nebo `x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`x-ms-version`	Nepovinný parametr. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`Accept`	Nepovinný parametr. Určuje akceptované typy obsahu datové části odpovědi. Možné hodnoty: - `application/atom+xml` (pouze verze před 11. 12. 2015) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Další informace najdete v tématu Formát datové části pro operace služby Table Storage.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématech Kódy stavů a chyb a Kódy chyb služby Table Storage.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
`x-ms-continuation-NextTableName`	Vrátí hodnotu pokračovacího tokenu. Pokud počet vrácených tabulek překročí 1 000 nebo pokud dotaz nedokončí v intervalu časového limitu, hlavička odpovědi obsahuje hlavičku `x-ms-continuation-NextTableName` pokračování. Další informace o použití tokenu pro pokračování najdete v tématu Vypršení časového limitu dotazu a stránkování.
`x-ms-request-id`	Jednoznačně identifikuje požadavek, který byl proveden. Můžete ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
`x-ms-version`	Označuje verzi služby Table Storage, která se používá ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené proti verzi 2009-09-19 a novější.
`Date`	Hodnota data a času UTC, která určuje čas, kdy služba odeslala odpověď.
`Content-Type`	Označuje typ obsahu datové části. Hodnota závisí na hlavičce požadavku `Accept` . Možné hodnoty: - `application/atom+xml` - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Další informace o platných typech obsahu najdete v tématu Formát datové části pro operace služby Table Storage.
`x-ms-client-request-id`	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud se nachází v požadavku a hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička `x-ms-client-request-id` v požadavku nenachází, nebude tato hlavička v odpovědi.

Text odpovědi

Operace Query Tables vrátí seznam tabulek v účtu jako sadu entit OData. Podle hodnoty hlavičky Accept je obsah buď JSON, nebo informační kanál Atom.

Poznámka

Jako formát datové části doporučujeme JSON. Je to jediný podporovaný formát pro verzi 2015-12-11 a novější.

JSON (verze 2013-08-15 a novější)

Tady je ukázkový text odpovědi JSON pro Query Tables operaci s úplnými metadaty:

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

Tady je ukázkový text odpovědi JSON pro Query Tables operaci s minimálními metadaty:

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

Tady je ukázkový text odpovědi JSON pro Query Tables operaci bez metadat:

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

Informační kanál Atom (verze před 11. 12. 2015)

Tady je ukázkový text odpovědi Atom pro Query Tables operaci:

<?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>

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Dotaz na službu Table Storage může najednou vrátit maximálně 1 000 tabulek a běžet maximálně pět sekund. Odpověď obsahuje vlastní hlavičku x-ms-continuation-NextTableName , která obsahuje pokračovací token v některém z následujících případů:

Sada výsledků dotazu obsahuje více než 1 000 tabulek.
Dotaz se nedokončil během pěti sekund.
Dotaz překročí hranici oddílu.

Pokračování můžete použít k vytvoření dalšího požadavku na další stránku dat. Další informace o tokenech pro pokračování najdete v tématu Vypršení časového limitu dotazu a stránkování.

Poznámka

Při vytváření následných požadavků, které obsahují pokračovací tokeny, nezapomeňte do požadavku předat původní identifikátor URI. Pokud jste například jako součást původního požadavku zadali $filtermožnost dotazu , $selectnebo $top , zahrňte tuto možnost do následných požadavků. V opačném případě by vaše následné požadavky mohly vrátit neočekávané výsledky.

Možnost $top dotazu v tomto případě určuje maximální počet výsledků na stránku. Neurčí maximální počet výsledků v celé sadě odpovědí.

Další informace najdete v tématu Dotazování tabulek a entit.

Celková doba přidělená požadavku na plánování a zpracování dotazu je 30 sekund. Tento součet zahrnuje pět sekund pro spuštění dotazu.

Další informace o podporovaných operacích dotazů se službou Table Storage prostřednictvím LINQ najdete v tématech Podporované operátory dotazů pro Table Storage a Zápis dotazů LINQ pro Table Storage.

Viz také

Adresování prostředků služby Table Storage
Autorizace žádostí do Služby Azure Storage
Nastavení hlaviček verze datové služby OData
Stavové kódy a kódy chyb
Kódy chyb Table Storage