Querytabellen

De Query Tables bewerking retourneert een lijst met tabellen onder het opgegeven account.

Aanvraag

De Query Tables aanvraag kan als volgt worden samengesteld. HTTPS wordt aanbevolen. Vervang myaccount door de naam van uw opslagaccount:

Methode Aanvraag-URI HTTP-versie
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1

Geëmuleerde Storage Service-URI

Wanneer u een aanvraag indient voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de Table-servicepoort op als , gevolgd door de geëmuleerde naam van 127.0.0.1:10002 het opslagaccount:

Methode Aanvraag-URI HTTP-versie
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

De Tabelservice in de geëmuleerde opslagservice verschilt op verschillende manieren van Windows® Azure™ Table-service. Zie Differences Between the Storage Emulator and Azure Storage Services (Verschillen tussen de Storage Emulator en Azure Storage Services) voor meer informatie.

URI-parameters

De Query Tables bewerking ondersteunt de queryopties die zijn gedefinieerd door de OData-protocolspecificatie. Zie OData Protocol voor meer informatie.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
x-ms-version Optioneel. Hiermee geeft u de versie van de bewerking moet worden gebruikt voor deze aanvraag. Zie Versioning for the Azure Storage Services (Versie Azure Storage Services) voor meer informatie.
Accept Optioneel. Hiermee geeft u het geaccepteerde inhoudstype van de nettolading van het antwoord. Mogelijke waarden zijn:

- application/atom+xml (alleen versies vóór 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Zie Nettolading-indeling voor Tabelservicebewerkingen voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 KiB die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie van opslaganalyse is ingeschakeld. Het gebruik van deze header wordt ten zeerste aanbevolen voor het correleren van activiteiten aan clientzijde met aanvragen die door de server worden ontvangen. Zie About Storage Analytics Logging and Windows Azure Logging: Using Logs to Track Storage Requests voor meer informatie.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Zie Status- en foutcodes en Tabelservicefoutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Beschrijving
x-ms-continuation-NextTableName Als het aantal tabellen dat moet worden geretourneerd groter is dan 1000 of als de query niet binnen het time-outinterval wordt voltooid, bevat de antwoordheader de x-ms-continuation-NextTableName vervolgheader. Deze header retourneert de vervolgwaarde van het token. Zie Time-out van query's en Paginering voor meer informatie over het gebruik van het vervolg-token.
x-ms-request-id Deze header identificeert op unieke manier de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Troubleshooting API Operations (Problemen met API-bewerkingen oplossen) voor meer informatie.
x-ms-version Geeft de versie aan van de Table-service die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen voor versie 2009-09-19 en hoger.
Date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service die het tijdstip aangeeft waarop het antwoord is gestart.
Content-Type Geeft het inhoudstype van de nettolading aan. De waarde is afhankelijk van de Accept aanvraagheader. Mogelijke waarden zijn:

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Zie Nettolading-indeling voor Tabelservicebewerkingen voor meer informatie over geldige inhoudstypen.
x-ms-client-request-id Deze header kan worden gebruikt voor het oplossen van problemen met aanvragen en bijbehorende antwoorden. De waarde van deze header is gelijk aan de waarde van de header als deze aanwezig is in de aanvraag en de waarde uit x-ms-client-request-id 1024 zichtbare ASCII-tekens bestaat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Antwoord body

De Query Tables bewerking retourneert de lijst met tabellen in het account als een OData-entiteitsset. Volgens de waarde van de header is de inhoud JSON of Accept een Atom-feed.

Notitie

JSON is de aanbevolen nettoladingindeling en is de enige indeling die wordt ondersteund voor versies 2015-12-11 en hoger.

JSON (versies 2013-08-15 en hoger)

Hier is een voorbeeld van een JSON-antwoord voor de Query Tables bewerkingen.

Volledige metagegevens

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

Minimale metagegevens

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

Geen metagegevens

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

Atom-feed (versies vóór 2015-12-11)

Hier is een voorbeeld van een Atom-antwoord voor de Query Tables bewerking.

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

Autorisatie

Alleen de accounteigenaar kan deze bewerking aanroepen.

Opmerkingen

Een query op de Table-service kan maximaal 1000 tabellen tegelijk retourneren en kan maximaal vijf seconden worden uitgevoerd. Als de resultatenset meer dan 1000 tabellen bevat, als de query niet binnen vijf seconden is voltooid of als de query de partitiegrens passeert, bevat het antwoord een aangepaste header met het x-ms-continuation-NextTableName vervolg-token. Het vervolg-token kan worden gebruikt voor het maken van een volgende aanvraag voor de volgende pagina met gegevens. Zie Time-out van query's en Paginering voor meer informatie over vervolgtokens.

Notitie

Wanneer u volgende aanvragen indient die vervolgtokens bevatten, moet u de oorspronkelijke URI voor de aanvraag doorgeven. Als u bijvoorbeeld een queryoptie , of hebt opgegeven als onderdeel van de oorspronkelijke aanvraag, moet u die optie opnemen $filter $select in volgende $top aanvragen. Anders kunnen de volgende aanvragen onverwachte resultaten retourneren.

Houd er rekening mee dat met de queryoptie in dit geval het maximum aantal resultaten per pagina wordt opgegeven, niet het maximum aantal resultaten $top in de hele antwoordset.

Zie Query's uitvoeren op tabellen en entiteiten voor meer informatie.

Houd er rekening mee dat de totale tijd die is toegewezen aan de aanvraag voor het plannen en verwerken van de query 30 seconden is, inclusief de vijf seconden voor het uitvoeren van de query.

Zie Queryoperators die worden ondersteund voor de Tabelservice en LINQ-query's schrijven voor de Tabelservice voor meer informatie over ondersteunde querybewerkingen voor de tabelservice via LINQ.

Zie ook

Resources voor adresseringstabelservice
Aanvragen voor Azure Storage
De OData Data Service-versieheaders instellen
Status- en foutcodes
Tabelservicefoutcodes