Zelfstudie: Query's uitvoeren op gegevens in Azure Cosmos DB for NoSQL

Artikel
08/15/2024

VAN TOEPASSING OP: NoSQL

Azure Cosmos DB voor NoSQL biedt ondersteuning voor het uitvoeren van query's op documenten met behulp van de ingebouwde querysyntaxis. Dit artikel bevat een voorbeelddocument en twee voorbeeldquery's en resultaten.

Dit artikel behandelt de volgende taken:

NoSQL-gegevens opvragen met de ingebouwde querysyntaxis

Vereisten

In deze zelfstudie wordt ervan uitgegaan dat u een Azure Cosmos DB-account, -database en -container hebt.

Hebt u geen van deze resources? Voltooi deze quickstart: Een Azure Cosmos DB-account, -database, -container en -items maken vanuit Azure Portal.

U kunt de query's uitvoeren met behulp van Azure Cosmos DB Explorer in Azure Portal. U kunt ook query's uitvoeren met behulp van de REST API of verschillende SDK's.

Zie Aan de slag met query's voor meer informatie over query's.

Voorbeelddocument

In de query's in dit artikel wordt het volgende voorbeelddocument gebruikt.

{
  "id": "WakefieldFamily",
  "parents": [
    { "familyName": "Wakefield", "givenName": "Robin" },
    { "familyName": "Miller", "givenName": "Ben" }
  ],
  "children": [
    {
      "familyName": "Merriam", 
      "givenName": "Jesse", 
      "gender": "female", "grade": 1,
      "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
      ]
    },
    { 
      "familyName": "Miller", 
        "givenName": "Lisa", 
        "gender": "female", 
        "grade": 8 
    }
  ],
  "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
  "creationDate": 1431620462,
  "isRegistered": false
}

Alle velden selecteren en een filter toepassen

Gezien het voorbeeldfamiliedocument retourneert de volgende query de documenten waarin het id-veld overeenkomt WakefieldFamily. Omdat het een SELECT *-instructie is, is de uitvoer van de query het volledige JSON-document:

Query:

SELECT * 
FROM Families f 
WHERE f.id = "WakefieldFamily"

Resultaten:

{
  "id": "WakefieldFamily",
  "parents": [
    { "familyName": "Wakefield", "givenName": "Robin" },
    { "familyName": "Miller", "givenName": "Ben" }
  ],
  "children": [
    {
      "familyName": "Merriam", 
      "givenName": "Jesse", 
      "gender": "female", "grade": 1,
      "pets": [
          { "givenName": "Goofy" },
          { "givenName": "Shadow" }
      ]
    },
    { 
      "familyName": "Miller", 
        "givenName": "Lisa", 
        "gender": "female", 
        "grade": 8 
    }
  ],
  "address": { "state": "NY", "county": "Manhattan", "city": "NY" },
  "creationDate": 1431620462,
  "isRegistered": false
}

Een kruisproduct van een onderliggend verzamelingsveld selecteren

In de volgende query worden alle opgegeven namen geretourneerd van kinderen in de familie van wie de id overeenkomt met WakefieldFamily.

Query:

SELECT c.givenName 
FROM Families f 
JOIN c IN f.children 
WHERE f.id = 'WakefieldFamily'

Resultaten:

[
  {
    "givenName": "Jesse"
  },
  {
    "givenName": "Lisa"
  }
]

Volgende stappen

In deze zelfstudie hebt u het volgende gedaan:

Geleerd hoe u query's uitvoert met behulp van de ingebouwde querysyntaxis

U kunt nu doorgaan met de volgende zelfstudie, waarin u leert hoe u uw gegevens globaal distribueert.

Uw gegevens globaal distribueren

Delen via