Schlüsselwörter in Azure Cosmos DB for NoSQL

GILT FÜR: NoSQL

Die Abfragesprache von Azure Cosmos DB for NoSQL enthält eine Reihe reservierter Schlüsselwörter, die in Abfragen für erweiterte Funktionalitäten verwendet werden.

Zwischen

Das BETWEEN-Schlüsselwort wird zu einem booleschen Wert ausgewertet, der angibt, ob der Zielwert zwischen zwei angegebenen Werten (einschließlich) liegt.

Sie können das Schlüsselwort BETWEEN mit einer WHERE-Klausel verwenden, um Abfragen zu formulieren, die Ergebnisse nach Bereichen von Zeichenfolgen oder numerischen Werten filtern. Die folgende Abfrage gibt beispielsweise alle Elemente zurück, in denen der Preis zwischen 17.25 und 25.50 liegt, wiederum einschließlich.

SELECT VALUE
    p.price
FROM
    products p
WHERE
    p.price BETWEEN 17.25 AND 25.50

[
  20
]

Sie können auch das Schlüsselwort BETWEEN in der SELECT-Klausel verwenden, wie im folgenden Beispiel gezeigt.

SELECT 
    (p.price BETWEEN 0 AND 10) AS booleanLessThanTen,
    p.price
FROM
    products p

[
  {
    "booleanLessThanTen": false,
    "price": 20.0
  },
  {
    "booleanLessThanTen": true,
    "price": 7.5
  }
]

DISTINCT

Das Schlüsselwort DISTINCT entfernt Duplikate aus den projizierten Abfrageergebnissen.

In diesem Beispiel projiziert die Abfrage Werte für jede Produktkategorie. Wenn zwei Kategorien gleichwertig sind, wird nur ein einzelnes Vorkommen in den Ergebnissen zurückgegeben.

SELECT DISTINCT VALUE
    p.category
FROM
    products p

[
  "Accessories",
  "Tools"
]

Sie können auch Werte projizieren, auch wenn das Zielfeld nicht vorhanden ist. In diesem Fall ist das Feld in einem der Elemente nicht vorhanden, sodass die Abfrage ein leeres Objekt für diesen bestimmten eindeutigen Wert zurückgibt.

SELECT DISTINCT
    p.category
FROM
    products p

Die Ergebnisse lauten wie folgt:

[
  {},
  {
    "category": "Accessories"
  },
  {
    "category": "Tools"
  }
]

LIKE

Gibt einen booleschen Wert zurück, der davon abhängt, ob eine bestimmte Zeichenkette mit einem angegebenen Muster übereinstimmt. Ein Muster kann normale Zeichen und Platzhalterzeichen einschließen.

Sie können folgende Platzhalterzeichen mit „LIKE“ verwenden:

Das Zeichen % entspricht einer Zeichenfolge aus null oder mehr Zeichen. Wenn Sie beispielsweise ein % an den Anfang und das Ende des Musters setzen, gibt die folgende Abfrage alle Elemente zurück, in denen das angegebene Feld den Ausdruck als Teilzeichenfolge enthält:

SELECT VALUE
    p.name
FROM
    products p
WHERE
    p.name LIKE "%driver%"

Wenn Sie das Zeichen % nur am Ende des Musters verwendet hätten, würden nur Elemente mit einer Beschreibung zurückgegeben, die mit fruit beginnen:

SELECT VALUE
    p.name
FROM
    products p
WHERE
    p.name LIKE "%glove"

Ebenso gibt der Platzhalter am Anfang des Musters an, dass Sie Werte mit dem angegebenen Wert als Präfix abgleichen möchten:

SELECT VALUE
    p.name
FROM
    products p
WHERE
    p.name LIKE "Road%"

Das NOT-Schlüsselwort invertiert das Ergebnis der Ausdrucksauswertung des LIKE-Schlüsselworts. Dieses Beispiel gibt alle Elemente zurück, die nicht mit dem LIKE-Ausdruck übereinstimmen.

SELECT VALUE
    p.name
FROM
    products p
WHERE
    p.name NOT LIKE "%winter%"

Mithilfe der ESCAPE-Klausel können Sie nach Mustern suchen, die ein oder mehrere Platzhalterzeichen enthalten. Wenn Sie beispielsweise nach Beschreibungen suchen möchten, in denen die Zeichenfolge 20% enthalten ist, sollten Sie das % nicht als Platzhalterzeichen interpretieren. In diesem Beispiel wird das ^ als Escapezeichen interpretiert, sodass Sie eine bestimmte Instanz von % mit Escapezeichen versehen können.

SELECT VALUE
    p.name
FROM
    products p
WHERE
    p.description LIKE "%20^%%" ESCAPE "^"

Sie können Platzhalterzeichen in eckige Klammern einschließen, um sie als Literalzeichen zu behandeln. Wenn Sie ein Platzhalterzeichen in Klammern einschließen, entfernen Sie alle besonderen Attribute. Diese Tabelle enthält Beispiele für Literalzeichen.

IN

Verwenden Sie das Schlüsselwort IN, um zu überprüfen, ob ein angegebener Wert mit einem Wert in einer Liste übereinstimmt. Die folgende Abfrage gibt beispielsweise alle Elemente zurück, bei denen die Kategorie mindestens einem der Werte in einer Liste entspricht.

SELECT
    *
FROM
    products p
WHERE
    p.category IN ("Accessories", "Clothing")

TOP

Das Schlüsselwort TOP gibt die ersten N Abfrageergebnisse in einer nicht definierten Reihenfolge zurück. Es empfiehlt sich, TOP mit der ORDER BY-Klausel zu verwenden, um die Ergebnisse auf die ersten N geordneten Werte zu beschränken. Die Kombination dieser beiden Klauseln ist die einzige Möglichkeit, um zuverlässig anzugeben, welche Zeilen von TOP betroffen sind.

Sie können TOP mit einem konstanten Wert wie im folgenden Beispiel verwenden, oder mit einem Variablenwert mithilfe von parametrisierten Abfragen.

SELECT TOP 10
    *
FROM
    products p
ORDER BY
    p.price ASC

Zugehöriger Inhalt

• WHERE-Klausel
• Unterabfragen
• Konstanten