Учебники

DocumentDB – Ограничение записей

Недавно корпорация Майкрософт добавила ряд улучшений в способе выполнения запросов к Azure DocumentDB, таких как ключевое слово TOP к грамматике SQL, которое ускорило выполнение запросов и потребляет меньше ресурсов, увеличило ограничения для операторов запросов и добавило поддержку дополнительных операторов LINQ в. .NET SDK.

Давайте рассмотрим простой пример, в котором мы получим только первые две записи. Если у вас есть несколько записей и вы хотите получить только некоторые из них, вы можете использовать ключевое слово 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 – Теперь запустите этот запрос, и вы увидите, что извлекаются только две записи.

Две записи получены

Точно так же вы можете использовать ключевое слово TOP в коде, используя .Net SDK. Ниже приводится реализация.

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(); 
}

Ниже приводится задача CreateDocumentClient, в которой создаются экземпляры базы данных 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); 
   } 
}

Когда приведенный выше код скомпилирован и выполнен, вы увидите, что извлекаются только три записи.