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:10002
belirtin. Ö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 Tables
OData 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
, $select
veya $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ı