Tablo Depolama işlevselliğinin özeti
Azure Tablo Depolama REST API'si, aşağıdaki bölümlerde açıklandığı gibi bazı farklılıklarla OData protokol belirtimi ile uyumludur.
Tablo Depolama uzantıları
Tablo Depolama, işlevini OData aşağıdaki yollarla genişletir.
Paylaşılan Anahtar, Paylaşılan Anahtar Lite ve Microsoft Entra yetkilendirme
Tablo Depolama, her isteğin yetkilendirilmiş olmasını gerektirir. Paylaşılan Anahtar, Paylaşılan Anahtar Lite ve Microsoft Entra ID yetkilendirmesi desteklenir. Microsoft Entra ID yetkilendirmesi daha güvenlidir ve REST API kullanılarak Tablo Depolama'ya yönelik istekler için önerilir.
İstekleri yetkilendirme hakkında daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
Sorgu sayfalandırma için devamlılık belirteçleri
Tablo Depolama'ya yönelik bir sorgu aynı anda en fazla 1.000 öğe döndürebilir ve en fazla beş saniye çalıştırılabilir. Sonuç kümesi 1.000'den fazla öğe içeriyorsa veya sorgu beş saniye içinde tamamlanmadıysa yanıt üst bilgileri içerir. Bu üst bilgiler geliştiriciye, sonuç kümesindeki bir sonraki öğede sorguyu sürdürmek için kullanması gereken devamlılık belirteçleri sağlar. Bir Sorgu Tabloları işlemi veya Sorgu Varlıkları işlemi için devamlılık belirteci üst bilgileri döndürülebilir.
Sorguyu zamanlama ve işleme isteğine ayrılan toplam sürenin, sorgu yürütme için beş saniye de dahil olmak üzere 30 saniye olduğunu unutmayın.
Devamlılık belirteçleri hakkında daha fazla bilgi için bkz . Sorgu zaman aşımı ve sayfalandırma.
Birincil anahtar sistemi özellikleri
Tablo Depolama'daki her varlığın PartitionKey iki temel özelliği vardır: özelliği ve RowKey özelliği. Bu özellikler tablonun birincil anahtarını oluşturur ve tablodaki her varlığı benzersiz olarak tanımlar.
Her iki özellik de dize değerleri gerektirir. Yeni bir varlık eklendiğinde bu özelliklere değer sağlamak ve bunları varlıktaki herhangi bir güncelleştirme veya silme işlemine dahil etmek geliştiricinin sorumluluğundadır.
Bu gerekli anahtar özellikleri hakkında daha fazla bilgi için bkz. Tablo Depolama veri modelini anlama.
Zaman damgası sistem özelliği
Tablo Depolama'daki her varlığın bir Timestamp sistem özelliği vardır.
Timestamp özelliği, bir DateTime varlığın son değiştirilme zamanını kaydetmek için sunucu tarafında tutulan bir değerdir. Tablo Depolama, iyimser eşzamanlılık sağlamak için özelliğini dahili olarak kullanır Timestamp . değeri Timestamp monoton olarak artan bir değerdir; başka bir deyişle varlık her değiştirildiğinde bu varlığın Timestamp değeri artar. Bu özellik ekleme veya güncelleştirme işlemlerinde ayarlanmamalıdır (değer yoksayılır).
özelliği hakkında Timestamp daha fazla bilgi için bkz. Tablo Depolama veri modelini anlama.
Batch işlemleri
Tablo Depolama, aynı tabloda yer alan ve aynı bölüm grubuna ait varlıklar üzerinde toplu işlemleri destekler ve bu da aynı PartitionKey değere sahip oldukları anlamına gelir. Bu, tek bir atomik işlemde birden çok ekleme, güncelleştirme, birleştirme ve silme işleminin desteklenmesine olanak tanır. Tablo Depolama, OData protokolü tarafından sağlanan işlevlerin bir alt kümesini destekler.
Toplu işlemler hakkında daha fazla bilgi için bkz. Varlık grubu işlemleri gerçekleştirme.
Tablo Depolama kısıtlamaları
Tablo Depolama, tarafından ODatasağlanan işlevlerle ilgili aşağıdaki kısıtlamalara sahiptir.
Credentials özelliği
Tablo Depolama, isteği yetkilendirmek için DataServiceContext sınıfının Credentials özelliğinin kullanılmasını desteklemez. Bunun yerine, isteğe üst bilgi ekleyerek Tablo Depolama'ya yönelik bir Authorization isteği yetkilendirmeniz gerekir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
Özellik türleri
tarafından OData desteklenen tüm özellik türleri desteklenmez. Desteklenen özellik türlerinin listesi için bkz. Tablo Depolama veri modelini anlama.
Bağlantılardaki işlemler
Tablo Depolama şu anda tablolar arasındaki bağlantıları desteklemez. Bağlantılar, veriler arasındaki ilişkilendirici ilişkilerdir.
Belirli özelliklerdeki işlemler
Projeksiyon , bir varlık veya varlıklar için özelliklerin bir alt kümesini sorgulamayı ifade eder. Dille tümleşik sorgularda (LINQ) sorgularken tablonun sütunlarının veya özelliklerinin bir alt kümesini seçmeye benzer.
Projeksiyon, yanıtta yalnızca belirli özelliklerin döndürüleceğini belirterek sorgu tarafından döndürülmesi gereken veri miktarını azaltır. Projeksiyon, Azure Depolama'nın 2011-08-18 sürümünün bir parçası olarak desteklenir. Daha fazla bilgi için bkz. Sorgu Varlıkları, Tablo Depolamada LINQ sorguları yazma ve OData: Sistem Sorgusu Seçeneğini ($select) seçme.
LINQ sorgu işleçleri
Tablo Depolama aşağıdaki LINQ sorgu işleçlerini destekler:
FromWhereTake
Daha fazla bilgi için bkz . Tablo Depolama için desteklenen sorgu işleçleri.
LINQ karşılaştırma işleçleri
LINQ tarafından sağlanan karşılaştırma işleçlerinin bir alt kümesini kullanabilirsiniz. Daha fazla bilgi için bkz . Tabloları ve varlıkları sorgulama veTablo Depolamada LINQ sorguları yazma.
GetMetadataURI yöntemi
DataServiceContext sınıfının GetMetadataURI yöntemini kullanabilirsiniz, ancak üç sabit şema özelliğinin ötesinde herhangi bir şema bilgisi döndürmez. Bu özellikler , RowKeyve TimestampşeklindedirPartitionKey.
Yük biçimleri
OData JSON biçiminde yük göndermeyi destekler. Tablo Depolama, API sürüm 2013-08-15 OData itibarıyla JSON biçimini destekler OData ve veri hizmeti sürümü 3.0 olarak ayarlanır. Önceki sürümler JSON biçimini desteklemez.
Atom yükleri 2015-12-11 öncesi tüm sürümlerde desteklenir. Sürüm 2015-12-11 ve üzeri yalnızca JSON yüklerini destekler.
Not
JSON önerilen yük biçimidir ve sürüm 2015-12-11 ve üzeri için desteklenen tek biçimdir.
Daha fazla bilgi için bkz. Tablo Depolama işlemleri için Yük biçimi ve OData veri hizmeti sürüm üst bilgilerini ayarlama.