Tabele zapytań

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

Żądanie

Żądanie Query Tables może zostać skonstruowane w następujący sposób. Protokół HTTPS jest zalecany. Zastąp myaccount nazwą konta magazynu:

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

Emulowany Storage URI usługi

Podczas tworzenia żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port usługi table jako , a następnie 127.0.0.1:10002 nazwę emulowanej 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 emulowanej usłudze magazynu różni się od usługi Windows® Azure™ Table na kilka sposobów. Aby uzyskać więcej informacji, zobacz Differences Between the Storage Emulator and Azure Storage Services (Różnice między usługami Azure Storage Emulator i Azure Storage Services).

Parametry identyfikatora URI

Operacja Query Tables obsługuje opcje zapytania zdefiniowane przez specyfikację protokołu OData. Aby uzyskać więcej informacji, zobacz OData Protocol.

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 Versioning for the Azure Storage Services(Wersje usług Azure Storage Services).
Accept Opcjonalny. Określa akceptowany typ zawartości ładunku odpowiedzi. Możliwe wartości:

- application/atom+xml (tylko 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 Service.
x-ms-client-request-id Opcjonalny. Zapewnia wygenerowaną przez klienta nieprzezroczystą wartość z limitem znaków 1 KiB, który jest rejestrowany w dziennikach analizy, gdy jest włączone rejestrowanie analizy magazynu. Używanie tego nagłówka jest wysoce zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz About Storage Analytics Logging and Windows Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu i rejestrowaniu w usłudze Azure Logging na platformie Azure: używanie dzienników do śledzenia żądań Storage danych).

Treść żądania

Brak.

Reakcja

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

Kod stanu

Pomyślna operacja 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 tabel.

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 standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
x-ms-continuation-NextTableName Jeśli liczba tabel do zwrócenia przekracza 1000 lub zapytanie nie zostanie ukończone w interwale limitu czasu, nagłówek odpowiedzi zawiera x-ms-continuation-NextTableName nagłówek kontynuacji. Ten nagłówek zwraca wartość tokenu kontynuacji. Aby uzyskać więcej informacji na temat używania tokenu kontynuacji, zobacz Query Timeout and Pagination (Limitczasu zapytania i stronicowanie).
x-ms-request-id Ten nagłówek unikatowo identyfikuje żądanie, które zostało wykonane, i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Troubleshooting API Operations (Rozwiązywanie problemów z operacjami interfejsu API).
x-ms-version Wskazuje wersję usługi Table Service używaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań względem wersji 2009-09-19 i nowszych.
Date Wartość daty/czasu UTC wygenerowana przez usługę, która wskazuje czas, o której została zainicjowana 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 o prawidłowych typach zawartości, zobacz Format ładunku dla operacji usługi Table Service.
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka, jeśli jest obecny w żądaniu, a wartość jest co najwyżej 1024 widocznych znaków x-ms-client-request-id ASCII. Jeśli nagłówek x-ms-client-request-id nie jest obecny 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ą Accept nagłówka zawartość to JSON lub źródło danych Atom.

Uwaga

Format JSON jest zalecanym formatem ładunku i jest jedynym formatem obsługiwanym w wersjach 2015-12-11 i nowszych.

JSON (wersje 2013-08-15 i nowsze)

Oto przykładowa treść odpowiedzi JSON dla Query Tables operacji.

Pełne metadane

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

Minimalne metadane

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

Brak metadanych

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

Źródło danych Atom (wersje wcześniejsze niż 2015-12-11)

Oto przykładowa treść odpowiedzi atomu 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 Service może jednocześnie zwrócić maksymalnie 1000 tabel i może być wykonywane przez maksymalnie pięć sekund. Jeśli zestaw wyników zawiera więcej niż 1000 tabel, jeśli zapytanie nie zostało ukończone w ciągu pięciu sekund lub jeśli zapytanie przekracza granicę partycji, odpowiedź zawiera niestandardowy nagłówek zawierający x-ms-continuation-NextTableName token kontynuacji. Token kontynuacji może służyć do konstruowania kolejnego żądania dla następnej strony danych. Aby uzyskać więcej informacji na temat tokenów kontynuacji, zobacz Query Timeout and Pagination (Limitczasu zapytania i stronicowanie).

Uwaga

Podczas tworzenia kolejnych żądań, które zawierają tokeny kontynuacji, należy przekazać oryginalny kod URI żądania. Jeśli na przykład w oryginalnym żądaniu określono opcję , lub , należy dołączyć tę opcję $filter $select do $top kolejnych żądań. W przeciwnym razie kolejne żądania mogą zwrócić nieoczekiwane wyniki.

Należy pamiętać, że opcja zapytania w tym przypadku określa maksymalną liczbę wyników na stronę, a nie maksymalną liczbę wyników $top w całym zestawie odpowiedzi.

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

Należy pamiętać, że łączny czas dla żądania planowania i przetwarzania zapytania wynosi 30 sekund, w tym pięć sekund na wykonanie zapytania.

Aby uzyskać więcej informacji na temat obsługiwanych operacji zapytań względem usługi Table Service za pośrednictwem LINQ, zobacz Operatory zapytań obsługiwane w usłudze Table Service i Pisanie zapytań LINQ w usłudze Table Service.

Zobacz też

Adresowanie zasobów usługi Table Service
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 Service