DocumentDB - 限制記錄

微軟最近在如何查詢 Azure DocumentDB 方面增加了一些改進，例如 SQL 語法的 TOP 關鍵字，這使得查詢執行速度更快，並消耗更少的資源，增加了查詢運算子的限制，並在 .NET SDK 中增加了對其他 LINQ 運算子的支援。

讓我們來看一個簡單的例子，我們將只檢索前兩條記錄。如果您有很多記錄，並且只想檢索其中的一些，那麼您可以使用 Top 關鍵字。在這個例子中，我們有很多地震記錄。

現在我們只想顯示前兩條記錄

步驟 1 - 轉到查詢資源管理器並執行此查詢。

SELECT * FROM c 
WHERE c.magnitude > 2.5 

您將看到它檢索了四條記錄，因為我們還沒有指定 TOP 關鍵字。

步驟 2 - 現在使用帶有相同查詢的 TOP 關鍵字。這裡我們指定了 TOP 關鍵字，'2' 表示我們只需要兩條記錄。

SELECT TOP 2 * FROM c 
WHERE c.magnitude > 2.5

步驟 3 - 現在執行此查詢，您將看到只檢索了兩條記錄。

類似地，您也可以使用 .Net SDK 在程式碼中使用 TOP 關鍵字。以下是實現。

private async static Task QueryDocumentsWithPaging(DocumentClient client) {
   Console.WriteLine(); 
   Console.WriteLine("**** Query Documents (paged results) ****"); 
   Console.WriteLine();  
   Console.WriteLine("Quering for all documents"); 
	
   var sql = "SELECT TOP 3 * FROM c";  
   var query = client 
      .CreateDocumentQuery(collection.SelfLink, sql) 
      .AsDocumentQuery(); 
		
   while (query.HasMoreResults) {
      var documents = await query.ExecuteNextAsync(); 
		
      foreach (var document in documents) { 
         Console.WriteLine(" PublicId: {0}; Magnitude: {1};", document.publicid,
            document.magnitude); 
      } 
   } 
	
   Console.WriteLine(); 
}

以下是建立 DocumentClient 任務，其中例項化了 DocumentClient 和地震資料庫。

private static async Task CreateDocumentClient() {
   // Create a new instance of the DocumentClient 
   using (var client = new DocumentClient(new Uri(EndpointUrl), AuthorizationKey)) {
      database = client.CreateDatabaseQuery("SELECT * FROM c WHERE c.id =
         'earthquake'").AsEnumerable().First(); 
			
      collection = client.CreateDocumentCollectionQuery(database.CollectionsLink,
         "SELECT * FROM c WHERE c.id = 'earthquakedata'").AsEnumerable().First(); 
			
      await QueryDocumentsWithPaging(client); 
   } 
}

當上述程式碼編譯並執行時，您將看到只檢索了三條記錄。

**** Query Documents (paged results) **** 
 
Quering for all documents 
PublicId: 2015p947400; Magnitude: 2.515176918; 
PublicId: 2015p947373; Magnitude: 1.506774108; 
PublicId: 2015p947329; Magnitude: 1.593394461;