Tradução de LINQ to NoSQL no Azure Cosmos DB para NoSQL

Artigo
08/22/2024

APLICA-SE A: NoSQL

O provedor de consulta do Azure Cosmos DB executa um mapeamento de melhor esforço de uma consulta LINQ para uma consulta do Azure Cosmos DB para NoSQL. Se você quiser obter a consulta NoSQL que é traduzida do LINQ, use o ToString() método no objeto gerado IQueryable . A descrição a seguir pressupõe uma familiaridade básica com o LINQ. Além do LINQ, o Azure Cosmos DB também dá suporte ao Entity Framework Core, que funciona com API para NoSQL.

Nota

Recomendamos o uso da versão mais recente do SDK do .NET (Microsoft.Azure.Cosmos)

O sistema de tipo de provedor de consulta suporta apenas os tipos primitivos JSON: numeric, Boolean, stringe null.

O provedor de consulta oferece suporte às seguintes expressões escalares:

Valores constantes, incluindo valores constantes dos tipos de dados primitivos no momento da avaliação da consulta.
Expressões de índice de propriedade/matriz que se referem à propriedade de um objeto ou elemento de matriz. Por exemplo:
```
family.Id;
family.children[0].familyName;
family.children[0].grade;
```
```
int n = 1;

family.children[n].grade;
```
Expressões aritméticas, incluindo expressões aritméticas comuns em valores numéricos e booleanos.
```
2 * family.children[0].grade;
x + y;
```

Expressões de comparação de cadeia de caracteres, que incluem a comparação de um valor de cadeia de caracteres com algum valor de cadeia de caracteres constante.

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

Expressões de criação de objeto/matriz, que retornam um objeto de tipo de valor composto ou tipo anônimo, ou uma matriz de tais objetos. Você pode aninhar esses valores.
```
new Parent { familyName = "Wakefield", givenName = "Robin" };
new { first = 1, second = 2 }; //an anonymous type with two fields  
new int[] { 3, child.grade, 5 };
```

Usando o LINQ

Você pode criar uma consulta LINQ com GetItemLinqQueryableo . Este exemplo mostra a geração de consultas LINQ e a execução assíncrona com um 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);
    }
}

Operadores LINQ suportados

O provedor LINQ incluído com o NoSQL .NET SDK suporta os seguintes operadores:

Selecionar: As projeções se traduzem em SELECT, incluindo a construção de objetos.
Onde: Os filtros traduzem para WHERE e suportam a tradução entre &&, ||e ! para os operadores NoSQL
SelectMany: Permite desenrolar matrizes para a cláusula JOIN . Use para encadear ou aninhar expressões para filtrar elementos de matriz.
OrderBy e OrderByDescending: Traduza para ORDER BY com ASC ou DESC.
Operadores Count, Sum, Min, Max e Average para agregação e seus equivalentes assíncronos CountAsync, SumAsync, MinAsync, MaxAsync e AverageAsync.
CompareTo: Traduz-se para comparações de intervalo. Esse operador é comumente usado para strings, já que elas não são comparáveis no .NET.
Skip and Take: Traduz para OFFSET e LIMIT para limitar os resultados de uma consulta e fazer paginação.
Funções matemáticas: Suporta a tradução do .NET Abs, Acos, , AsinAtan, Ceiling, ExpFloorLogCosLog10PowSqrtTanSinRoundSigne Truncate para as funções matemáticas incorporadas equivalentes.
Funções de cadeia de caracteres: Suporta a tradução de .NET Concat, Contains, Count, EndsWith, ReverseSubStringReplaceToLowerIndexOfToUpperStartsWith, , e TrimStart TrimEndpara as funções de cadeia de caracteres incorporadas equivalentes.
Funções de matriz: Suporta a tradução de .NET Concat, Containse Count para as funções de matriz internas equivalentes.
Funções de extensão geoespacial: Suporta a tradução de métodos Distancede stub , IsValid, IsValidDetailed, e Within para as funções geoespaciais incorporadas equivalentes.
User-Defined Function Extension function: Suporta a conversão do método stub CosmosLinq.InvokeUserDefinedFunction para a função correspondente definida pelo usuário.
Diversos: Suporta tradução e Coalesce operadores condicionais. Pode traduzir Contains para String CONTAINS, ARRAY_CONTAINS ou IN, dependendo do contexto.

Exemplos

Os exemplos a seguir ilustram como alguns dos operadores de consulta LINQ padrão se traduzem em consultas no Azure Cosmos DB.

Selecionar operador

A sintaxe é input.Select(x => f(x)), onde f é uma expressão escalar. O input, neste caso, seria um IQueryable objeto.

Selecione o operador, exemplo 1:

Expressão lambda LINQ

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

NoSQL

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

Selecione o operador, exemplo 2:

Expressão lambda 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

Selecione o operador, exemplo 3:

Expressão lambda 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

Operador SelectMany

A sintaxe é input.SelectMany(x => f(x)), onde f é uma expressão escalar que retorna um tipo de contêiner.

Expressão lambda LINQ

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

NoSQL

SELECT VALUE child
FROM child IN Families.children

Onde operador

A sintaxe é input.Where(x => f(x)), onde f é uma expressão escalar, que retorna um valor booleano.

Onde operador, exemplo 1:

Expressão lambda LINQ

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

NoSQL

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

Onde operador, exemplo 2:

Expressão lambda 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

Consultas NoSQL compostas

Você pode compor os operadores anteriores para formar consultas mais poderosas. Como o Azure Cosmos DB dá suporte a contêineres aninhados, você pode concatenar ou aninhar a composição.

Concatenação

A sintaxe é input(.|.SelectMany())(.Select()|.Where())*. Uma consulta concatenada pode começar com uma consulta opcional SelectMany , seguida por vários Select ou Where operadores.

Concatenação, exemplo 1:

Expressão lambda LINQ

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

NoSQL

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

Concatenação, exemplo 2:

Expressão lambda 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

Concatenação, exemplo 3:

Expressão lambda 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)

Concatenação, exemplo 4:

Expressão lambda LINQ

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

NoSQL

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

Aninhamento

A sintaxe é input.SelectMany(x=>x.Q()) onde Q é um Select, SelectMany, ou Where operador.

Uma consulta aninhada aplica a consulta interna a cada elemento do contêiner externo. Uma característica importante é que a consulta interna pode se referir aos campos dos elementos no contêiner externo, como uma associação automática.

Aninhamento, exemplo 1:

Expressão lambda LINQ

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

NoSQL

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

Aninhamento, exemplo 2:

Expressão lambda 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"

Aninhamento, exemplo 3:

Expressão lambda 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

Partilhar via

Tradução de LINQ to NoSQL no Azure Cosmos DB para NoSQL

Usando o LINQ

Operadores LINQ suportados

Exemplos

Selecionar operador

Operador SelectMany

Onde operador

Consultas NoSQL compostas

Concatenação

Aninhamento

Comentários

Recursos adicionais

Partilhar via

Tradução de LINQ to NoSQL no Azure Cosmos DB para NoSQL

Usando o LINQ

Operadores LINQ suportados

Exemplos

Selecionar operador

Operador SelectMany

Onde operador

Consultas NoSQL compostas

Concatenação

Aninhamento

Conteúdos relacionados

Comentários

Recursos adicionais