Självstudie: Fråga Azure Cosmos DB med hjälp av SQL APITutorial: Query Azure Cosmos DB by using the SQL API

GÄLLER för: SQL API

Azure Cosmos DB SQL API stöder frågedokument med hjälp av SQL.The Azure Cosmos DB SQL API supports querying documents using SQL. Den här artikeln innehåller ett dokumentexempel och två exempel på SQL-frågor och resultat.This article provides a sample document and two sample SQL queries and results.

Den här artikeln beskriver följande uppgifter:This article covers the following tasks:

  • Fråga efter data med SQLQuerying data with SQL

ExempeldokumentSample document

SQL-frågorna i artikeln använder följande exempeldokument.The SQL queries in this article use the following sample document.

{
  "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
}

Var kan jag köra SQL-frågor?Where can I run SQL queries?

Du kan köra frågor med Datautforskaren i Azure-portalen via REST-API och SDK, och även Query Playground som kör frågor på en befintlig uppsättning exempeldata.You can run queries using the Data Explorer in the Azure portal, via the REST API and SDKs, and even the Query playground, which runs queries on an existing set of sample data.

Mer information om SQL-frågor finns i:For more information about SQL queries, see:

KravPrerequisites

Den här självstudien förutsätter att du har ett konto för Azure Cosmos DB och en samling.This tutorial assumes you have an Azure Cosmos DB account and collection. Har du inga av dessa resurser?Don't have any of those resources? Slutför Snabbstart på 5 minuter.Complete the 5-minute quickstart.

Exempelfråga 1Example query 1

Med exempel seriens dokument ovan returnerar följande SQL-fråga dokument där ID-fältet matchar WakefieldFamily .Given the sample family document above, following SQL query returns the documents where the ID field matches WakefieldFamily. Eftersom det är en SELECT *-instruktion är utdatan från frågan ett komplett JSON-dokument:Since it's a SELECT * statement, the output of the query is the complete JSON document:

QueryQuery

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

ResultatResults

{
  "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
}

Exempelfråga 2Example query 2

Nästa fråga returnerar alla namn på underordnade objekt i den familj vars ID matchar WakefieldFamily .The next query returns all the given names of children in the family whose ID matches WakefieldFamily.

QueryQuery

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

ResultatResults

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

Nästa stegNext steps

I den här självstudien har du gjort följande:In this tutorial, you've done the following tasks:

  • Lärt dig hur man frågar med SQLLearned how to query using SQL

Du kan nu fortsätta till nästa självstudie för att lära dig hur du distribuerar dina data globalt.You can now proceed to the next tutorial to learn how to distribute your data globally.