Sorgu Tabloları

Makale
08/05/2023

İş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 Depolamaya karşı 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ı

Aracılığıyla paylaş