DocumentDB - Ograniczanie rekordów

Firma Microsoft niedawno dodała szereg ulepszeń dotyczących sposobu wykonywania zapytań w Azure DocumentDB, takich jak słowo kluczowe TOP do gramatyki SQL, dzięki czemu zapytania działają szybciej i zużywają mniej zasobów, zwiększono limity operatorów zapytań i dodano obsługę dodatkowych operatorów LINQ w zestaw .NET SDK.

Spójrzmy na prosty przykład, w którym pobierzemy tylko pierwsze dwa rekordy. Jeśli masz kilka rekordów i chcesz pobrać tylko niektóre z nich, możesz użyć słowa kluczowego Top. W tym przykładzie mamy wiele zapisów dotyczących trzęsień ziemi.

Teraz chcemy pokazać tylko pierwsze dwa rekordy

Step 1 - Przejdź do eksploratora zapytań i uruchom to zapytanie.

SELECT * FROM c 
WHERE c.magnitude > 2.5

Zobaczysz, że pobrał cztery rekordy, ponieważ nie określiliśmy jeszcze słowa kluczowego TOP.

Step 2- Teraz użyj słowa kluczowego TOP z tym samym zapytaniem. Tutaj określiliśmy słowo kluczowe TOP, a „2” oznacza, że ​​chcemy tylko dwóch rekordów.

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

Step 3 - Teraz uruchom to zapytanie, a zobaczysz, że zostały pobrane tylko dwa rekordy.

Podobnie możesz użyć słowa kluczowego TOP w kodzie za pomocą .Net SDK. Poniżej znajduje się realizacja.

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

Poniżej przedstawiono zadanie CreateDocumentClient, w którym tworzone są wystąpienia bazy danych DocumentClient i trzęsienia ziemi.

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

Kiedy powyższy kod zostanie skompilowany i wykonany, zobaczysz, że pobierane są tylko trzy rekordy.

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