Udostępnij za pośrednictwem

Tłumaczenie LINQ to NoSQL w usłudze Azure Cosmos DB for NoSQL

  • Artykuł

DOTYCZY: NoSQL

Dostawca zapytań usługi Azure Cosmos DB wykonuje najlepsze mapowanie na podstawie zapytania LINQ do zapytania usługi Azure Cosmos DB for NoSQL. Jeśli chcesz uzyskać zapytanie NoSQL przetłumaczone z LINQ, użyj ToString() metody wygenerowanego IQueryable obiektu. W poniższym opisie przyjęto założenie, że podstawowa znajomość linQ. Oprócz LINQ usługa Azure Cosmos DB obsługuje również platformę Entity Framework Core, która współpracuje z interfejsem API dla noSQL.

Uwaga

Zalecamy używanie najnowszej wersji zestawu .NET SDK (Microsoft.Azure.Cosmos)

System typu dostawcy zapytań obsługuje tylko typy pierwotne JSON: numeric, Boolean, stringi null.

Dostawca zapytań obsługuje następujące wyrażenia skalarne:

  • Stałe wartości, w tym stałe wartości typów danych pierwotnych w czasie oceny zapytania.

  • Wyrażenia indeksu właściwości/tablicy odwołujące się do właściwości obiektu lub elementu tablicy. Na przykład:

    family.Id;
family.children[0].familyName;
family.children[0].grade;

    int n = 1;

family.children[n].grade;

  • Wyrażenia arytmetyczne, w tym typowe wyrażenia arytmetyczne dla wartości liczbowych i logicznych.

    2 * family.children[0].grade;
x + y;

  • Wyrażenia porównania ciągów, które obejmują porównanie wartości ciągu z pewną stałą wartością ciągu.

    mother.familyName.StringEquals("Wakefield");

    string s = "Rob";
string e = "in";
string c = "obi";

child.givenName.StartsWith(s);
child.givenName.EndsWith(e);
child.givenName.Contains(c);

  • Wyrażenia tworzenia obiektów/tablic, które zwracają obiekt typu wartości złożonej lub typu anonimowego albo tablicę takich obiektów. Te wartości można zagnieżdżać.

    new Parent { familyName = "Wakefield", givenName = "Robin" };
new { first = 1, second = 2 }; //an anonymous type with two fields  
new int[] { 3, child.grade, 5 };

Korzystanie z LINQ

Zapytanie LINQ można utworzyć za pomocą polecenia GetItemLinqQueryable. W tym przykładzie pokazano generowanie zapytań LINQ i wykonywanie asynchroniczne z elementem FeedIterator:

using FeedIterator<Book> setIterator = container.GetItemLinqQueryable<Book>()
    .Where(b => b.Title == "War and Peace")
    .ToFeedIterator<Book>());

//Asynchronous query execution
while (setIterator.HasMoreResults)
{
    foreach(var item in await setIterator.ReadNextAsync()){
    {
        Console.WriteLine(item.cost);
    }
}

Obsługiwane operatory LINQ

Dostawca LINQ dołączony do zestawu SDK platformy .NET noSQL obsługuje następujące operatory:

  • Wybierz: projekcje przekładają się na select, w tym konstrukcję obiektu.
  • Gdzie: filtry tłumaczą się na where i obsługują tłumaczenie między operatorami &&, ||i ! noSQL
  • SelectMany: umożliwia odwijanie tablic do klauzuli JOIN . Służy do tworzenia łańcuchów lub zagnieżdżania wyrażeń do filtrowania elementów tablicy.
  • OrderBy i OrderByDescending: przetłumacz na ORDER BY za pomocą usługi ASC lub DESC.
  • Operatory Count, Sum, Min, Max i Average na potrzeby agregacji oraz ich asynchroniczne odpowiedniki CountAsync, SumAsync, MinAsync, MaxAsync i AverageAsync.
  • CompareTo: operator tłumaczony na porównania zakresu. Ten operator jest często używany w przypadku ciągów, ponieważ nie są one porównywalne na platformie .NET.
  • Pomiń i przejmij: przekłada się na przesunięcie i limit w celu ograniczenia wyników z zapytania i wykonywania stronicowania.
  • Funkcje matematyczne: obsługuje tłumaczenie z platformy .NET Abs, CeilingSinCosAtanExpAsinFloorLogPowSignSqrtTanRoundAcosLog10i Truncate do równoważnych wbudowanych funkcji matematycznych.
  • Funkcje ciągów: obsługuje tłumaczenie z funkcji ciągów wbudowanych na platformie .NETConcat, ToLowerTrimEndSubStringStartsWithToUpperTrimStart ContainsEndsWithCountIndexOfReplaceReversei .
  • Funkcje tablicy: obsługuje tłumaczenie z platformy .NET Concat, Containsi Count do równoważnych wbudowanych funkcji tablicy.
  • Funkcje rozszerzenia geoprzestrzennego: obsługuje tłumaczenie z metod wycinków Distance, IsValid, IsValidDetailedi Within do równoważnych wbudowanych funkcji geoprzestrzennych.
  • Funkcja rozszerzenia funkcji zdefiniowanej przez użytkownika: obsługuje tłumaczenie z metody wycinkowej CosmosLinq.InvokeUserDefinedFunction do odpowiedniej funkcji zdefiniowanej przez użytkownika.
  • Różne: obsługuje tłumaczenie operatorów Coalescei warunkowych. Można przetłumaczyć Contains na ciąg CONTAINS, ARRAY_CONTAINS lub IN, w zależności od kontekstu.

Przykłady

W poniższych przykładach pokazano, jak niektóre standardowe operatory zapytań LINQ tłumaczą się na zapytania w usłudze Azure Cosmos DB.

Wybierz operator

Składnia to input.Select(x => f(x)), gdzie f jest wyrażeniem skalarnym. W inputtym przypadku obiektem będzie IQueryable obiekt .

Wybierz operator, przykład 1:

  • Wyrażenie lambda składni LINQ

    input.Select(family => family.parents[0].familyName);

  • NoSQL

    SELECT VALUE f.parents[0].familyName
FROM Families f

Wybierz operator, przykład 2:

  • Wyrażenie lambda składni LINQ

    input.Select(family => family.children[0].grade + c); // c is an int variable

  • NoSQL

    SELECT VALUE f.children[0].grade + c
FROM Families f

Wybierz operator, przykład 3:

  • Wyrażenie lambda składni LINQ

    input.Select(family => new
{
    name = family.children[0].familyName,
    grade = family.children[0].grade + 3
});

  • NoSQL

    SELECT VALUE {
    "name":f.children[0].familyName,
    "grade": f.children[0].grade + 3 
}
FROM Families f

Operator SelectMany

Składnia to input.SelectMany(x => f(x)), gdzie f jest wyrażeniem skalarnym, które zwraca typ kontenera.

  • Wyrażenie lambda składni LINQ

    input.SelectMany(family => family.children);

  • NoSQL

    SELECT VALUE child
FROM child IN Families.children

Operator Where

Składnia to input.Where(x => f(x)), gdzie f jest wyrażenie skalarnym, które zwraca wartość logiczną.

Gdzie operator, przykład 1:

  • Wyrażenie lambda składni LINQ

    input.Where(family=> family.parents[0].familyName == "Wakefield");

  • NoSQL

    SELECT *
FROM Families f
WHERE f.parents[0].familyName = "Wakefield"

Gdzie operator, przykład 2:

  • Wyrażenie lambda składni LINQ

    input.Where(
    family => family.parents[0].familyName == "Wakefield" &&
    family.children[0].grade < 3);

  • NoSQL

    SELECT *
FROM Families f
WHERE f.parents[0].familyName = "Wakefield"
AND f.children[0].grade < 3

Złożone zapytania NoSQL

Możesz utworzyć powyższe operatory, aby tworzyć bardziej zaawansowane zapytania. Ponieważ usługa Azure Cosmos DB obsługuje kontenery zagnieżdżone, możesz połączyć lub zagnieżdżać kompozycję.

Łączenie

Składnia jest następująca: input(.|.SelectMany())(.Select()|.Where())* Połączona kwerenda może rozpoczynać się od opcjonalnego SelectMany zapytania, po którym następuje wiele Select operatorów lub Where .

Łączenie, przykład 1:

  • Wyrażenie lambda składni LINQ

    input.Select(family => family.parents[0])
    .Where(parent => parent.familyName == "Wakefield");

  • NoSQL

    SELECT *
FROM Families f
WHERE f.parents[0].familyName = "Wakefield"

Łączenie, przykład 2:

  • Wyrażenie lambda składni LINQ

    input.Where(family => family.children[0].grade > 3)
    .Select(family => family.parents[0].familyName);

  • NoSQL

    SELECT VALUE f.parents[0].familyName
FROM Families f
WHERE f.children[0].grade > 3

Łączenie, przykład 3:

  • Wyrażenie lambda składni LINQ

    input.Select(family => new { grade=family.children[0].grade}).
    Where(anon=> anon.grade < 3);

  • NoSQL

    SELECT *
FROM Families f
WHERE ({grade: f.children[0].grade}.grade > 3)

Łączenie, przykład 4:

  • Wyrażenie lambda składni LINQ

    input.SelectMany(family => family.parents)
    .Where(parent => parents.familyName == "Wakefield");

  • NoSQL

    SELECT *
FROM p IN Families.parents
WHERE p.familyName = "Wakefield"

Zagnieżdżanie

Składnia to input.SelectMany(x=>x.Q()) gdzie Q jest operatorem Select, SelectManylub Where .

Zapytanie zagnieżdżone stosuje zapytanie wewnętrzne do każdego elementu kontenera zewnętrznego. Jedną z ważnych funkcji jest to, że zapytanie wewnętrzne może odwoływać się do pól elementów w kontenerze zewnętrznym, takich jak samosprzężenie.

Zagnieżdżanie, przykład 1:

  • Wyrażenie lambda składni LINQ

    input.SelectMany(family=>
    family.parents.Select(p => p.familyName));

  • NoSQL

    SELECT VALUE p.familyName
FROM Families f
JOIN p IN f.parents

Zagnieżdżanie, przykład 2:

  • Wyrażenie lambda składni LINQ

    input.SelectMany(family =>
    family.children.Where(child => child.familyName == "Jeff"));

  • NoSQL

    SELECT *
FROM Families f
JOIN c IN f.children
WHERE c.familyName = "Jeff"

Zagnieżdżanie, przykład 3:

  • Wyrażenie lambda składni LINQ

    input.SelectMany(family => family.children.Where(
    child => child.familyName == family.parents[0].familyName));

  • NoSQL

    SELECT *
FROM Families f
JOIN c IN f.children
WHERE c.familyName = f.parents[0].familyName

Powiązana zawartość