Tabele zapytań

Artykuł
06/27/2023

Operacja Query Tables zwraca listę tabel w ramach określonego konta.

Żądanie

Żądanie można skonstruować Query Tables w następujący sposób. Zalecamy użycie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
`GET`	`https://myaccount.table.core.windows.net/Tables`	HTTP/1.1

Identyfikator URI usługi magazynu emulowanego

Gdy wysyłasz żądanie względem emulowanej usługi magazynu, określ nazwę hosta emulatora i port usługi tabeli jako 127.0.0.1:10002. Postępuj zgodnie z informacjami o nazwie emulowanego konta magazynu.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
`GET`	`http://127.0.0.1:10002/devstoreaccount1/Tables`	HTTP/1.1

Usługa Table Service w emulatorze magazynu różni się od usługi Azure Table Storage na kilka sposobów. Aby uzyskać więcej informacji, zobacz Różnice między emulatorem magazynu a usługami Azure Storage.

Parametry identyfikatora URI

Operacja Query Tables obsługuje opcje zapytania zdefiniowane przez specyfikację protokołu OData .

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań:

Nagłówek żądania	Opis
`Authorization`	Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
`Date` lub `x-ms-date`	Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
`x-ms-version`	Opcjonalny. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage.
`Accept`	Opcjonalny. Określa akceptowany typ zawartości ładunku odpowiedzi. Możliwe wartości: - `application/atom+xml` (wersje wcześniejsze niż 2015-12-11) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table Storage.
`x-ms-client-request-id`	Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów oraz Kody błędów usługi Table Storage.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
`x-ms-continuation-NextTableName`	Zwraca wartość tokenu kontynuacji. Jeśli liczba zwracanych tabel przekracza 1000 lub zapytanie nie zostanie zakończone w przedziale czasu, nagłówek odpowiedzi zawiera `x-ms-continuation-NextTableName` nagłówek kontynuacji. Aby uzyskać więcej informacji na temat korzystania z tokenu kontynuacji, zobacz Limit czasu zapytania i stronicowanie.
`x-ms-request-id`	Jednoznacznie identyfikuje wykonane żądanie. Można go użyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
`x-ms-version`	Wskazuje wersję usługi Table Storage, która jest używana do wykonania żądania. Ten nagłówek jest zwracany dla żądań wysyłanych w wersji 2009-09-19 lub nowszej.
`Date`	Wartość daty/godziny UTC wskazująca godzinę, w której usługa wysłała odpowiedź.
`Content-Type`	Wskazuje typ zawartości ładunku. Wartość zależy od nagłówka `Accept` żądania. Możliwe wartości: - `application/atom+xml` - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Aby uzyskać więcej informacji na temat prawidłowych typów zawartości, zobacz Format ładunku dla operacji usługi Table Storage.
`x-ms-client-request-id`	Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości `x-ms-client-request-id` nagłówka, jeśli znajduje się w żądaniu, a wartość wynosi co najwyżej 1024 widoczne znaki ASCII. `x-ms-client-request-id` Jeśli nagłówek nie znajduje się w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

Operacja Query Tables zwraca listę tabel na koncie jako zestaw jednostek OData. Zgodnie z wartością nagłówka Accept zawartość jest plikiem JSON lub kanałem informacyjnym Atom.

Uwaga

Zalecamy użycie formatu JSON jako formatu ładunku. Jest to jedyny obsługiwany format dla wersji 2015-12-11 lub nowszej.

JSON (wersja 2013-08-15 lub nowsza)

Oto przykładowa treść odpowiedzi JSON dla Query Tables operacji z pełnymi metadanymi:

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

Oto przykładowa treść odpowiedzi JSON dla Query Tables operacji z minimalnymi metadanymi:

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

Oto przykładowa treść odpowiedzi JSON dla Query Tables operacji bez metadanych:

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

Kanał informacyjny atomów (wersje przed 2015-12-11)

Oto przykładowa treść odpowiedzi Atom dla Query Tables operacji:

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

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Uwagi

Zapytanie względem usługi Table Storage może zwrócić maksymalnie 1000 tabel jednocześnie i uruchomić maksymalnie pięć sekund. Odpowiedź zawiera niestandardowy nagłówek, który zawiera token kontynuacji x-ms-continuation-NextTableName w dowolnym z następujących przypadków:

Zestaw wyników zawiera więcej niż 1000 tabel.
Zapytanie nie zostało zakończone w ciągu pięciu sekund.
Zapytanie przekracza granicę partycji.

Możesz użyć kontynuacji, aby utworzyć kolejne żądanie dla następnej strony danych. Aby uzyskać więcej informacji na temat tokenów kontynuacji, zobacz Limit czasu zapytania i stronicowanie.

Uwaga

Podczas wykonywania kolejnych żądań zawierających tokeny kontynuacji pamiętaj o przekazaniu oryginalnego identyfikatora URI w żądaniu. Jeśli na przykład określono $filteropcję , $selectlub $top kwerendy w ramach oryginalnego żądania, dołącz tę opcję do kolejnych żądań. W przeciwnym razie kolejne żądania mogą zwracać nieoczekiwane wyniki.

Opcja $top zapytania w tym przypadku określa maksymalną liczbę wyników na stronę. Nie określa maksymalnej liczby wyników w całym zestawie odpowiedzi.

Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań dotyczących tabel i jednostek.

Łączny czas przydzielony do żądania planowania i przetwarzania zapytania wynosi 30 sekund. Ta suma obejmuje pięć sekund wykonywania zapytań.

Aby uzyskać więcej informacji na temat obsługiwanych operacji zapytań w usłudze Table Storage za pośrednictwem LINQ, zobacz Operatory zapytań obsługiwanych dla usługi Table Storage i zapisu zapytań LINQ w usłudze Table Storage.

Zobacz też

Adresowanie zasobów usługi Table Storage
Autoryzowanie żądań do usługi Azure Storage
Ustawianie nagłówków wersji usługi danych OData
Kody stanu i błędów
Kody błędów usługi Table Storage