Frågetabeller

Artikel
08/05/2023

Åtgärden Query Tables returnerar en lista med tabeller under det angivna kontot.

Förfrågan

Du kan skapa begäran på Query Tables följande sätt. Vi rekommenderar HTTPS. Ersätt myaccount med namnet på ditt lagringskonto.

Metod	URI för förfrågan	HTTP-version
`GET`	`https://myaccount.table.core.windows.net/Tables`	HTTP/1.1

Emulerad lagringstjänst-URI

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och tabelltjänstens port som 127.0.0.1:10002. Följ den informationen med namnet på det emulerade lagringskontot.

Metod	URI för förfrågan	HTTP-version
`GET`	`http://127.0.0.1:10002/devstoreaccount1/Tables`	HTTP/1.1

Tabelltjänsten i lagringsemulatorn skiljer sig från Azure Table Storage på flera sätt. Mer information finns i Skillnader mellan lagringsemulatorn och Azure Storage-tjänster.

URI-parametrar

Åtgärden Query Tables stöder de frågealternativ som OData-protokollspecifikationen definierar.

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden:

Begärandehuvud	Beskrivning
`Authorization`	Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
`Date` eller `x-ms-date`	Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
`x-ms-version`	Valfritt. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`Accept`	Valfritt. Anger den godkända innehållstypen för svarsnyttolasten. Möjliga värden: - `application/atom+xml` (versioner före 2015-12-11 endast) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Mer information finns i Nyttolastformat för Table Storage-åtgärder.
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskoden 200 (OK).

Information om statuskoder finns i Status- och felkoder och Tabelllagringsfelkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik	Description
`x-ms-continuation-NextTableName`	Returnerar fortsättningstokenvärdet. Om antalet tabeller som ska returneras överskrider 1 000 eller om frågan inte slutförs inom tidsgränsintervallet innehåller svarshuvudet fortsättningsrubriken `x-ms-continuation-NextTableName` . Mer information om hur du använder fortsättningstoken finns i Tidsgräns för frågor och sidnumrering.
`x-ms-request-id`	Identifierar unikt den begäran som gjordes. Du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
`x-ms-version`	Anger vilken version av Table Storage som används för att köra begäran. Det här huvudet returneras för begäranden mot version 2009-09-19 och senare.
`Date`	Ett UTC-datum/tid-värde som anger den tid då tjänsten skickade svaret.
`Content-Type`	Anger nyttolastens innehållstyp. Värdet beror på begärans `Accept` huvud. Möjliga värden: - `application/atom+xml` - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` Mer information om giltiga innehållstyper finns i Nyttolastformat för Table Storage-åtgärder.
`x-ms-client-request-id`	Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet `x-ms-client-request-id` för huvudet, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken. `x-ms-client-request-id` Om rubriken inte finns i begäran visas inte det här huvudet i svaret.

Själva svaret

Åtgärden Query Tables returnerar listan över tabeller i kontot som en OData-entitetsuppsättning. Enligt värdet för Accept rubriken är innehållet antingen JSON eller en Atom-feed.

Anteckning

Vi rekommenderar JSON som nyttolastformat. Det är det enda format som stöds för version 2015-12-11 och senare.

JSON (version 2013-08-15 och senare)

Här är ett exempel på JSON-svarstext för en Query Tables åtgärd med fullständiga metadata:

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

Här är ett exempel på JSON-svarstext för en Query Tables åtgärd med minimala metadata:

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

Här är ett exempel på JSON-svarstext för en Query Tables åtgärd utan metadata:

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

Atomfeed (versioner före 2015-12-11)

Här är ett exempel på Atom-svarstext för Query Tables åtgärden:

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

Auktorisering

Endast kontoägaren kan anropa den här åtgärden.

Kommentarer

En fråga mot Table Storage kan returnera högst 1 000 tabeller samtidigt och köras i högst fem sekunder. Svaret innehåller en anpassad rubrik som innehåller fortsättningstoken x-ms-continuation-NextTableName i något av följande fall:

Resultatuppsättningen innehåller mer än 1 000 tabeller.
Frågan avslutades inte inom fem sekunder.
Frågan korsar partitionsgränsen.

Du kan använda fortsättningen för att skapa en efterföljande begäran för nästa sida med data. Mer information om fortsättningstoken finns i Tidsgräns för frågor och sidnumrering.

Anteckning

När du gör efterföljande begäranden som innehåller fortsättningstoken måste du skicka den ursprungliga URI:n på begäran. Om du till exempel har angett ett $filter, $selecteller $top frågealternativ som en del av den ursprungliga begäran, inkluderar du det alternativet för efterföljande begäranden. Annars kan dina efterföljande begäranden returnera oväntade resultat.

Frågealternativet $top i det här fallet anger det maximala antalet resultat per sida. Den anger inte det maximala antalet resultat i hela svarsuppsättningen.

Mer information finns i Frågetabeller och entiteter.

Den totala tid som tilldelats begäran för schemaläggning och bearbetning av frågan är 30 sekunder. Den summan inkluderar de fem sekunderna för frågekörning.

Mer information om frågeåtgärder som stöds mot Table Storage via LINQ finns i Frågeoperatorer som stöds för Table Storage och Write LINQ querys against Table Storage (Frågeoperatorer som stöds för Table Storage och Write LINQ querys against Table Storage).

Se även

Hantera Table Storage-resurser
Auktorisera begäranden till Azure Storage
Ange versionshuvuden för OData-datatjänsten
Status- och felkoder
Felkoder för Table Storage