Aracılığıyla paylaş


Sorgu Tabloları

İşlem, Query Tables belirtilen hesap altındaki tabloların listesini döndürür.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Query Tables . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin.

Yöntem İstek URI'si HTTP sürümü
GET https://myaccount.table.core.windows.net/Tables HTTP/1.1

Öykünmüş depolama hizmeti URI'si

Öykünülen depolama hizmetine karşı istekte bulunurken öykünücünün ana bilgisayar adını ve tablo hizmetinin bağlantı noktasını olarak 127.0.0.1:10002belirtin. Öykünülen depolama hesabının adıyla bu bilgileri izleyin.

Yöntem İstek URI'si HTTP sürümü
GET http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Depolama öykünücüsü içindeki Tablo hizmeti, Azure Tablo Depolama'dan çeşitli yollarla farklıdır. Daha fazla bilgi için bkz. Depolama öykünücüsü ile Azure Depolama hizmetleri arasındaki farklar.

URI parametreleri

İşlem, Query TablesOData protokol belirtiminin tanımladığı sorgu seçeneklerini destekler.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır:

İstek üst bilgisi Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Date veya x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
x-ms-version İsteğe bağlı. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
Accept İsteğe bağlı. Yanıt yükünün kabul edilen içerik türünü belirtir. Olası değerler şunlardır:

- application/atom+xml (yalnızca 2015-12-11 öncesi sürümler)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Daha fazla bilgi için bkz. Tablo Depolama işlemleri için Yük biçimi.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum kodu

Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları ile Tablo Depolama hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Description
x-ms-continuation-NextTableName Devamlılık belirteci değerini döndürür. Döndürülecek tablo sayısı 1.000'i aşarsa veya sorgu zaman aşımı aralığı içinde tamamlanmazsa yanıt üst bilgisi devamlılık üst bilgisini içerir x-ms-continuation-NextTableName . Devamlılık belirtecini kullanma hakkında daha fazla bilgi için bkz . Sorgu zaman aşımı ve sayfalandırma.
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar. İsteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
x-ms-version İsteği yürütmek için kullanılan Tablo Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
Date Hizmetin yanıtı gönderdiği saati gösteren utc tarih/saat değeri.
Content-Type Yükün içerik türünü gösterir. Değer, isteğin Accept üst bilgisine bağlıdır. Olası değerler şunlardır:

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

Geçerli içerik türleri hakkında daha fazla oluşum için bkz. Tablo Depolama işlemleri için Yük biçimi.
x-ms-client-request-id İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer en fazla 1.024 görünür ASCII karakteriyse üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi mevcut olmaz.

Yanıt gövdesi

İşlem, Query Tables hesaptaki tabloların listesini OData varlık kümesi olarak döndürür. Üst bilginin değerine Accept göre içerik JSON veya Atom akışıdır.

Not

Yük biçimi olarak JSON kullanmanızı öneririz. Sürüm 2015-12-11 ve üzeri için desteklenen tek biçimdir.

JSON (sürüm 2013-08-15 ve üzeri)

Tam meta veri içeren bir işlem için örnek bir Query Tables JSON yanıt gövdesi aşağıda verilmiştır:

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

Aşağıda, en az meta veri içeren bir işlem için örnek bir Query Tables JSON yanıt gövdesi verilmiştir:

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

Meta veri içermeyen bir işlem için örnek JSON Query Tables yanıt gövdesi aşağıda verilmiştır:

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

Atom akışı (2015-12-11 öncesi sürümler)

İşlem için örnek bir Atom yanıt gövdesi aşağıda verilmiştır Query Tables :

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

Yetkilendirme

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Tablo Depolama'ya yönelik bir sorgu bir kerede en fazla 1.000 tablo döndürebilir ve en fazla beş saniye çalışabilir. Yanıt, aşağıdaki durumlardan herhangi birinde devamlılık belirtecini x-ms-continuation-NextTableName içeren özel bir üst bilgi içerir:

  • Sonuç kümesi 1.000'den fazla tablo içerir.
  • Sorgu beş saniye içinde tamamlanmadı.
  • Sorgu bölüm sınırını geçer.

Sonraki veri sayfası için sonraki bir istek oluşturmak için devamlılığı kullanabilirsiniz. Devam belirteçleri hakkında daha fazla bilgi için bkz . Sorgu zaman aşımı ve sayfalandırma.

Not

Devamlılık belirteçleri içeren sonraki istekleri yaparken, istekte özgün URI'yi geçirmeyi unutmayın. Örneğin, özgün isteğin bir parçası olarak bir $filter, $selectveya $top sorgu seçeneği belirttiyseniz, sonraki isteklere bu seçeneği ekleyin. Aksi takdirde, sonraki istekleriniz beklenmeyen sonuçlar döndürebilir.

$top Bu durumda sorgu seçeneği, sayfa başına en fazla sonuç sayısını belirtir. Yanıt kümesinin tamamında en fazla sonuç sayısını belirtmez.

Daha fazla bilgi için bkz . Sorgu tabloları ve varlıkları.

Sorguyu zamanlama ve işleme isteğine ayrılan toplam süre 30 saniyedir. Bu toplam, sorgu yürütme için beş saniyeyi içerir.

LINQ aracılığıyla Tablo Depolama'da desteklenen sorgu işlemleri hakkında daha fazla bilgi için bkz. Tablo Depolama için desteklenen sorgu işleçleri ve Tablo Depolamayakarşı LINQ sorguları yazma.

Ayrıca bkz.

Tablo Depolama kaynaklarını ele alma
Azure Depolama'ya yönelik istekleri yetkilendirme
OData veri hizmeti sürüm üst bilgilerini ayarlama
Durum ve hata kodları
Tablo Depolama hata kodları