Partilhar via

Tradução linq para NoSQL no Azure Cosmos DB para NoSQL

  • Artigo

APLICA-SE A: NoSQL

O fornecedor de consultas do Azure Cosmos DB realiza o melhor mapeamento de esforço de uma consulta LINQ para uma consulta do Azure Cosmos DB para NoSQL. Se quiser obter a consulta NoSQL traduzida a partir do LINQ, utilize o ToString() método no objeto gerado IQueryable . A seguinte descrição pressupõe uma familiaridade básica com o LINQ. Além do LINQ, o Azure Cosmos DB também suporta o Entity Framework Core, que funciona com a API para NoSQL.

Nota

Recomendamos que utilize a versão mais recente do SDK .NET (Microsoft.Azure.Cosmos)

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

O fornecedor de consultas suporta as 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 de um 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 cadeias, que incluem comparar um valor de cadeia com algum valor de cadeia 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 objetos/matrizes, que devolvem um objeto de tipo de valor composto ou tipo anónimo, ou uma matriz desses objetos. Pode aninhar estes valores.

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

Utilizar o LINQ

Pode criar uma consulta LINQ com GetItemLinqQueryable. 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 fornecedor linq incluído com o SDK .NET NoSQL suporta os seguintes operadores:

  • Selecione: as projeções traduzem-se em SELECT, incluindo a construção de objetos.
  • Em que: Os filtros traduzem-se para WHERE e suportam a tradução entre &&os operadores , ||e ! para os operadores NoSQL
  • SelectMany: permite descontrair matrizes para a cláusula JOIN . Utilize para encadear ou aninhar expressões para filtrar elementos de matriz.
  • OrderBy e OrderByDescending: Traduza para ORDER BY com ASC ou DESC.
  • Os operadores Count, Sum, Min, Max e Average para agregação e os respetivos equivalentes assíncrono CountAsync, SumAsync, MinAsync, MaxAsync e AverageAsync.
  • CompareTo: traduz-se em comparações de intervalos. Este operador é normalmente utilizado para cadeias, uma vez que 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 de .NET Abs, , Acos, AsinAtan, Ceiling, Cos, Exp, Floor, Log, , Log10, Pow, Round, , Sign, Sin, Sqrte TanTruncate para as funções matemáticas incorporadas equivalentes.
  • Funções de cadeia: suporta a tradução de .NET Concat, Contains, ,IndexOfCountReplaceEndsWith , Reverse, StartsWith, SubString, ToLower, ToUpper, , , TrimEnde TrimStart para as funções de cadeia incorporadas equivalentes.
  • Funções de matriz: suporta a tradução de .NET Concat, Containse Count para as funções de matriz incorporadas equivalentes.
  • Funções de Extensão Geoespacial: suporta a tradução dos métodos Distancestub , IsValid, IsValidDetailede Within para as funções geoespaciais incorporadas equivalentes.
  • Função Extensão de Função Definida pelo Utilizador: suporta a tradução do método stub CosmosLinq.InvokeUserDefinedFunction para a função definida pelo utilizador correspondente.
  • Diversos: suporta a tradução de operadores condicionais e de Coalesce tradução. Pode traduzir para Contains Cadeia CONTAINS, ARRAY_CONTAINS ou IN, consoante o contexto.

Exemplos

Os exemplos seguintes 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)), em que f é uma expressão escalar. O input, neste caso, seria um IQueryable objeto.

Selecionar operador, exemplo 1:

  • Expressão lambda LINQ

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

  • NoSQL

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

Selecionar 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

Selecionar 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

Selecionar operadorMany

A sintaxe é input.SelectMany(x => f(x)), em f que é uma expressão escalar que devolve um tipo de contentor.

  • Expressão lambda LINQ

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

  • NoSQL

    SELECT VALUE child
FROM child IN Families.children

Operador Where

A sintaxe é input.Where(x => f(x)), em que f é uma expressão escalar, que devolve um valor Booleano.

Operador Where, 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"

Operador Where, 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

Pode compor os operadores anteriores para formar consultas mais poderosas. Uma vez que o Azure Cosmos DB suporta contentores aninhados, 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 de vários Select operadores ou Where .

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 é onde está input.SelectMany(x=>x.Q()) um Selectoperador , SelectManyou Where .Q

Uma consulta aninhada aplica a consulta interna a cada elemento do contentor externo. Uma funcionalidade importante é que a consulta interna pode fazer referência aos campos dos elementos no contentor 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

Conteúdo relacionado