Sdílet prostřednictvím

Rozhraní API pro dotazy JavaScriptu ve službě Azure Cosmos DB

  • Platí pro: ✅ NoSQL

Kromě vydávání dotazů pomocí rozhraní API pro NoSQL ve službě Azure Cosmos DB poskytuje sada SDK na straně serveru Azure Cosmos DB rozhraní JavaScript pro provádění optimalizovaných dotazů v uložených procedurách a triggerech služby Azure Cosmos DB. Abyste mohli toto rozhraní JavaScriptu používat, nemusíte si být vědomi jazyka SQL. Rozhraní API pro dotazy JavaScriptu umožňuje programově sestavovat dotazy předáváním predikátových funkcí do posloupnosti volání funkcí se syntaxí podobnou předdefinovaným polím ECMAScript5 a oblíbeným javascriptovým knihovnám, jako je Lodash. Dotazy se analyzují modulem runtime JavaScriptu a efektivně se spouštějí pomocí indexů Azure Cosmos DB.

Podporované javascriptové funkce

Function Description
chain() ... .value([callback] [, options]) Spustí zřetězené volání, které musí být ukončeno hodnotou().
filter(predicateFunction [, options] [, callback]) Filtruje vstup pomocí predikátové funkce, která vrací hodnotu true/false, aby se vstupní dokumenty vyfiltrovály do výsledné sady. Tato funkce se chová podobně jako klauzule WHERE v SQL.
flatten([isShallow] [, options] [, callback]) Kombinuje a zplošťuje pole z každé vstupní položky do jediného pole. Tato funkce se chová podobně jako SelectMany v LINQ.
map(transformationFunction [, options] [, callback]) Na transformační funkci, která mapuje každou vstupní položku na objekt nebo hodnotu JavaScriptu, aplikuje projekci. Tato funkce se chová podobně jako klauzule SELECT v SQL.
pluck([propertyName] [, options] [, callback]) Tato funkce je zkratka pro mapu, která extrahuje hodnotu jedné vlastnosti z každé vstupní položky.
sortBy([predicate] [, options] [, callback]) Vytvoří novou sadu dokumentů seřazením dokumentů ve vstupním datovém proudu dokumentu ve vzestupném pořadí pomocí daného predikátu. Tato funkce se chová podobně jako klauzule ORDER BY v SQL.
sortByDescending([predicate] [, options] [, callback]) Vytvoří novou sadu dokumentů seřazením dokumentů ve vstupním datovém proudu dokumentu v sestupném pořadí pomocí daného predikátu. Tato funkce se chová podobně jako klauzule ORDER BY x DESC v SQL.
unwind(collectionSelector, [resultSelector], [options], [callback]) Provede samostatné spojení s vnitřním polem a přidá výsledky z obou stran jako řazené kolekce členů do projekce výsledku. Například spojením dokumentu osoby s osoba.pets by vznikly dvojice [osoba, zvíře]. To se podobá selectMany v .NET LINQ.

Pokud jsou součástí funkcí predikátu nebo selektoru, následující javascriptové konstruktory se automaticky optimalizují tak, aby běžely přímo na indexech Azure Cosmos DB:

  • Jednoduché operátory: =+-*/%|^&==!====!==<><=>=||&&<<>>>>>~
  • Literály, včetně literálu objektu: {}
  • var, return

Následující konstrukty JavaScriptu se neoptimalizovaly pro indexy Azure Cosmos DB:

  • Tok řízení: ifforwhile
  • Volání funkcí

Další informace najdete v dokumentaci k JavaScriptu na straně serveru služby Azure Cosmos DB.

Tahák SQL do JavaScriptu

Následující tabulka obsahuje různé dotazy SQL a odpovídající javascriptové dotazy. Stejně jako u dotazů SQL rozlišují vlastnosti (například item.id) malá a velká písmena.

Poznámka:

__ (dvojité podtržítko) je alias pro getContext().getCollection() při použití API pro dotazy v JavaScriptu.

SQL JavaScript Query API Description
Vyberte *
Z dokumentace		 __.map(function(doc) {
    vrátit dokument;
});		 Výsledkem jsou všechny dokumenty, které jsou stránkované s tokenem pokračování.
VYBERTE
   dokumenty.id
   docs.message AS msg,
   dokumenty.akcí
Z dokumentace		 __.map(function(doc) {
    return {
        ID: doc.id,
        msg: doc.message,
        akce:dokument. akce
    };
});		 Zobrazí ID, zprávu (označený jako msg) a akci ze všech dokumentů.
VYBERTE*
Z dokumentace
WHERE
   docs.id="X998_Y998"		 __.filter(function(doc) {
    return doc.id ==="X998_Y998";
});		 Dotazy na dokumenty s predikátem: id = "X998_Y998".
Vyberte *
Z dokumentace
WHERE
   ARRAY_CONTAINS(dokumentace). Značky, 123)		 __.filter(function(x) {
    return x.Tags && x.Tags.indexOf(123) > -1;
});		 Dotazy na dokumenty, které mají vlastnost Tagy, přičemž Tagy jsou polem obsahujícím hodnotu 123.
SELECT
   dokumenty.id
   docs.message AS zpráva
Z dokumentace
WHERE
   docs.id="X998_Y998"		 __.chain()
    .filter(function(doc) {
        return doc.id ==="X998_Y998";
    })
    .map(function(doc) {
       return {
            ID: doc.id,
            Zpráva: doc.message
       };
    })
.Value();		 Dotazuje se na dokumenty s predikátem, ID = "X998_Y998" a pak projektuje ID a zprávu (alias pro msg).
SELECT VALUE tag
Z dokumentace
JOIN tag IN docs.Tags
ORDER BY docs._ts		 __.chain()
    .filter(function(doc) {
        return doc.Tags && Array.isArray(doc.Tags);
    })
    .sortBy(function(doc) {
        vrátit doc._ts;
    })
    .pluck("Tags")
    .flatten()
    .Value()		 Filtry pro dokumenty, které obsahují pole Značky, a seřadí výsledné dokumenty podle vlastnosti systému časového razítka _ts, poté projektuje a zplošťuje pole Značky.

Další kroky

Přečtěte si další koncepty a postupy pro zápis a používání uložených procedur, triggerů a uživatelem definovaných funkcí ve službě Azure Cosmos DB:

  • Last updated on