DocumentDB - 限制记录



微软最近在如何查询 Azure DocumentDB 方面增加了一些改进,例如 SQL 语法的 TOP 关键字,这使得查询运行速度更快,并消耗更少的资源,增加了查询操作符的限制,并在 .NET SDK 中增加了对其他 LINQ 操作符的支持。

让我们来看一个简单的例子,我们将只检索前两条记录。如果您有很多记录,并且只想检索其中的一些,那么您可以使用 Top 关键字。在这个例子中,我们有很多地震记录。

Limiting Records

现在我们只想显示前两条记录

步骤 1 - 转到查询资源管理器并运行此查询。

SELECT * FROM c 
WHERE c.magnitude > 2.5 

您将看到它检索了四条记录,因为我们还没有指定 TOP 关键字。

Retrieved Records

步骤 2 - 现在使用带有相同查询的 TOP 关键字。这里我们指定了 TOP 关键字,'2' 表示我们只需要两条记录。

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

步骤 3 - 现在运行此查询,您将看到只检索了两条记录。

Two records retrieved

类似地,您也可以使用 .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;
广告