Tabele zapytań

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

Żądanie

Żądanie Query Tables może być skonstruowane w następujący sposób. Zalecane jest 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 emulowanej Storage

Podczas wykonywania żądania względem usługi emulowanego magazynu określ nazwę hosta emulatora i port usługi Table Service jako 127.0.0.1:10002, a następnie nazwę 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 emulowanej usłudze magazynu różni się od usługi Windows ® Azure™ Table Service na kilka sposobów. Aby uzyskać więcej informacji, zobacz Różnice między usługami 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 Protokół 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 dla usług Azure Storage Services.
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 Payload Format for Table Service Operations (Format ładunku dla operacji usługi Table Service).
x-ms-client-request-id Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem 1 znaków KiB rejestrowanym w dziennikach analitycznych po włączeniu rejestrowania 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 analityka magazynu Logging and Windows Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu analityka magazynu i rejestrowaniu platformy Azure: używanie dzienników do śledzenia żądań Storage).

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 stanów i błędów oraz Kody błędów usługi Table Service.

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 zwracanych tabel przekracza 1000 lub zapytanie nie zostanie ukończone w przedziale 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 korzystania z tokenu kontynuacji, zobacz Limit czasu zapytania i Stronicowanie.
x-ms-request-id Ten nagłówek jednoznacznie 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 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ń wysyłanych w wersji 2009-09-19 lub nowszej.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, o której zainicjowano odpowiedź.
Content-Type Wskazuje typ zawartości ładunku. Wartość zależy od nagłówka żądania Accept . 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 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 x-ms-client-request-id nagłówka, jeśli jest obecna w żądaniu, a wartość jest najwyżej 1024 widocznymi znakami ASCII. x-ms-client-request-id Jeśli nagłówek nie istnieje 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 źródłem danych JSON lub Atom.

Uwaga

Format JSON jest zalecanym formatem ładunku i jest jedynym obsługiwanym formatem dla wersji 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 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 Service może zwrócić maksymalnie 1000 tabel jednocześnie i może zostać wykonane 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 przekroczy 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 Limit czasu zapytań i Stronicowanie.

Uwaga

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

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

Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań o tabele i jednostki .

Należy pamiętać, że łączny czas przydzielony do żądania planowania i przetwarzania zapytania wynosi 30 sekund, w tym pięć sekund na potrzeby wykonywania 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 przez usługę Table Service i Pisanie zapytań LINQ względem usługi Table Service.

Zobacz też

Rozwiązywanie problemów z zasobami 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