TOP (Entity SQL)

  • Makale

SELECT yan tümcesi, isteğe bağlı ALL/DISTINCT değiştiricisini izleyen isteğe bağlı bir TOP alt yan tümcesine sahip olabilir. TOP alt yan tümcesi, sorgu sonucundan yalnızca ilk satır kümesinin döndürüleceğini belirtir.

Söz dizimi

[ TOP (n) ]

Bağımsız değişkenler

n Döndürülecek satır sayısını belirten sayısal ifade. n tek bir sayısal değişmez değer veya tek bir parametre olabilir.

Açıklamalar

TOP ifadesi tek bir sayısal değişmez değer veya tek bir parametre olmalıdır. Sabit değişmez değer kullanılırsa, değişmez değer türü örtük olarak Edm.Int64'e (bayt, int16, int32 veya int64 veya Edm.Int64'e tanıtılabilir bir türle eşlenen herhangi bir sağlayıcı türü) tanıtılabilir olmalıdır ve değeri sıfırdan büyük veya sıfıra eşit olmalıdır. Aksi takdirde bir özel durum oluşturulur. Parametre bir ifade olarak kullanılıyorsa, parametre türü örtük olarak Edm.Int64'e de tanıtılabilir olmalıdır, ancak parametre değerleri geç sınırlandığından derleme sırasında gerçek parametre değeri doğrulanmayacak.

Sabit TOP ifadesi örneği aşağıda verilmiştir:

select distinct top(10) c.a1, c.a2 from T as a

Aşağıda parametreli TOP ifadesi örneği verilmiştir:

select distinct top(@topParam) c.a1, c.a2 from T as a

Sorgu sıralanmadığı sürece TOP belirlenemez. Belirleyici bir sonuç gerekiyorsa ORDER BY yan tümcesindeki SKIP ve LIMIT alt yan tümcelerini kullanın. TOP ve SKIP/LIMIT birbirini dışlar.

Örnek

Aşağıdaki Entity SQL sorgusu, sorgu sonucundan döndürülecek ilk satırı belirtmek için TOP değerini kullanır. Sorgu AdventureWorks Satış Modeli'ni temel alır. Bu sorguyu derlemek ve çalıştırmak için şu adımları izleyin:

  1. Nasıl yapılır: StructuralType Sonuçları Döndüren Bir Sorgu Yürütme bölümündeki yordamı izleyin.

  2. Aşağıdaki sorguyu yöntemine ExecuteStructuralTypeQuery bağımsız değişken olarak geçirin:

    SELECT VALUE TOP(1) contact FROM AdventureWorksEntities.Contacts AS contact

Ayrıca bkz.