Snabbstart: Använd Node.js för att ansluta och fråga data från Azure Azure Azure DB SQL API-konto

GÄLLER FÖR: SQL API

I den här snabbstarten kan du skapa och hantera ett Azure Azures DB SQL API-konto från Azure-portalen och genom att använda en Node.js-app klonad från GitHub. Azure Azure Azures DB är en databastjänst med flera modeller som gör att du snabbt kan skapa och frågedokument, tabeller, nyckelvärden och grafdatabaser med globala distributionsfunktioner och vågräta skalfunktioner.

Genomgångsvideo

I den här videon får du en fullständig genomgång av innehållet i den här artikeln.

Krav

Skapa ett Azure Azure Azures-konto

För det här snabbstartsändamål kan du använda prova Azure Azure Azures DB som kostnadsfritt alternativ för att skapa ett Azure Azures-konto.

  1. Gå till den kostnadsfria sidan Azure Azures DB.

  2. Välj SQL API-konto och välj Skapa. Logga in med ditt Microsoft-konto.

  3. När inloggningen är klar ska ditt Azure Azure AzureS-konto vara klart. Välj Öppna i Azure Portal för att öppna det nya kontot.

Alternativet "prova Azure Azure Azures DB kostnadsfritt" kräver inte en Azure-prenumeration och det ger dig ett Azure Azures-konto under en begränsad period på 30 dagar. Om du vill använda Azure Azure Azures-kontot under en längre tid bör du i stället skapa kontot i din Azure-prenumeration.

Lägga till en behållare

Nu kan du använda verktyget Datautforskaren i Azure-portalen för att skapa en databas och behållare.

  1. Välj Ny behållare iDatautforskaren.

    Området Lägg till behållare visas längst till höger och du kan behöva rulla till höger för att se det.

    Azure Portal Data Explorer, fönstret Lägg till behållare

  2. På sidan Lägg till behållare anger du inställningarna för den nya behållaren.

    Inställning Föreslaget värde Beskrivning
    Databas-ID ToDoList Ange Uppgifter som namn på den nya databasen. Databasnamn måste innehålla mellan 1 och 255 tecken och får inte innehålla /, \\, #, ? , eller ett avslutande blanksteg. Kontrollera alternativet Dela dataflöde mellan behållare så kan du dela dataflödet som är etablerat i databasen över alla behållare i databasen. Det här alternativet hjälper också till med kostnadsbesparingar.
    Dataflöde för databas Du kan tillhandahålla automatisk skalningeller manuellt dataflöde. Med manuellt dataflöde kan du skala RU/s själv medan automatiskt skalningsflöde gör att systemet kan skala RU/s baserat på användning. Välj Manuellt för det här exemplet.

    Lämna dataflödet på 400 begärandeenheter per sekund (RU/s). Om du vill minska svarstiden kan du skala upp dataflödet senare genom att uppskatta nödvändiga RU/s med kapacitetskalkylatorn.

    Obs!Den här inställningen är inte tillgänglig när du skapar en ny behållare i ett serverlöst konto.
    Behållar-ID Artiklar Ange Objekt som namn på den nya behållaren. Behållar-ID har samma teckenkrav som databasnamn.
    Partitionsnyckel /kategori Exemplet som beskrivs i den här artikeln använder /kategori som partitionsnyckel.

    Lägg inte till Unika nycklar eller aktivera Analytical store för det här exemplet. Med unika nycklar kan du lägga till ett lager med dataintegritet i databasen genom att säkerställa att ett eller flera värden per partitionsnyckel är unika. Mer information finns i Unika nycklar i Azure Azure Azures DB.Analytisk lagring används för att möjliggöra omfattande analys mot driftdata utan någon inverkan på dina transaktionsarbetsbelastningar.

    Välj OK. Datautforskaren visar den nya databasen och behållaren.

Lägga till exempeldata

Nu kan du lägga till data i den nya behållaren med hjälp av Datautforskaren.

  1. Expandera uppgiftsdatabaseni Datautforskaren och expandera behållaren Objekt. Välj Objektoch välj sedan Nytt objekt.

    Skapa nya dokument i Datautforskaren i Azure-portalen

  2. Lägg till ett dokument i behållaren med följande struktur.

    {
        "id": "1",
        "category": "personal",
        "name": "groceries",
        "description": "Pick up apples and strawberries.",
        "isComplete": false
    }
    
  3. När du har lagt till json på fliken Dokument väljer du Spara.

    Kopiera i json data och välj Spara i Datautforskaren i Azure Portal

  4. Skapa och spara ett till dokument där du infogar ett unikt värde för egenskapen id och ändra de andra egenskaperna som du vill. Dina nya dokument kan ha vilken struktur du vill eftersom Azure Azures DB inte kräver något schema för dina data.

Skapa frågor för dina data

Du kan använda frågor i Datautforskaren för att hämta och filtrera data.

  1. Granska standardfrågan högst upp på fliken Objekt i Datautforskaren. Den här frågan hämtar och visar alla dokument från behållaren ordnade efter ID.

    Standardfrågan i Datautforskaren är SELECT * FROM c

  2. Om du vill ändra frågan väljer du Redigera filter, ersätter standardfrågan med och väljer sedan Använd filter.

    Ändra standardfrågan genom att lägga till ORDER BY c._ts DESC och klicka på Använd filter

    Den ändrade frågan visar dokumenten i fallande ordning baserat på deras tidsstämpel, så nu visas det andra dokumentet först.

    Ändrade frågan till ORDER BY c._ts DESC och klicka på Använd filter

Om du är bekant med SQL kan du ange alla frågor som SQL stöds i fråge predikatrutan. Du kan också använda Data Explorer för att skapa lagrade procedurer, affärsrelationer och utlösare för affärslogik på serversidan.

Data Explorer ger enkel Azure Portal åtkomst till alla inbyggda programmässiga dataåtkomstfunktioner som är tillgängliga i API:er. Du kan även använda portalen för att skala dataflöde, hämta nycklar och anslutningssträngar samt granska mätvärden och SLA:er för ditt Azure Azure Azure Db-konto.

Klona exempelprogrammet

Nu ska vi klona en Node.js app från GitHub, ange anslutningssträngen och köra den.

  1. Kör följande kommando för att klona exempelarkivet. Med det här kommandot skapas en kopia av exempelappen på datorn.

    git clone https://github.com/Azure-Samples/azure-cosmos-db-sql-api-nodejs-getting-started.git
    

Granska koden

Det här steget är valfritt. Om du vill veta hur Azure Azures-databasresurserna skapas i koden kan du läsa följande avsnitt. Annars kan du gå vidare och uppdatera anslutningssträngen.

Om du är bekant med den tidigare versionen av SQL JavaScript SDK kan du vara van att se termer för insamling och dokument. Eftersom Azure Azure Azures DB stöder flera API-modelleranvänder version 2.0+ av JavaScript SDK den allmänna termbehållaren ,som kan vara en samling, ett diagram eller en tabell och ett objekt för att beskriva innehållet i behållaren.

Db JavaScript SDK kallas "@azure/rock" och kan installeras från npm...

npm install @azure/cosmos

Följande avsnitt är alla tagna frånapp.jsfilen.

  • Importeras CosmosClient från @azure/cosmos npm-paketet.

    const CosmosClient = require("@azure/cosmos").CosmosClient;
    
  • Ett nytt CosmosClient objekt initieras.

    const client = new CosmosClient({ endpoint, key });
    
  • Markera databasen "Uppgifter".

    const database = client.database(databaseId);
    
  • Välj behållaren/samlingen "Objekt".

    const container = database.container(containerId);
    
  • Markera alla objekt i behållaren "Objekt".

    // query to return all items
    const querySpec = {
      query: "SELECT * from c"
    };
    
    const { resources: items } = await container.items
      .query(querySpec)
      .fetchAll();
    
  • Skapa ett nytt objekt

    const { resource: createdItem } = await container.items.create(newItem);
    
  • Uppdatera ett objekt

    const { id, category } = createdItem;
    
    createdItem.isComplete = true;
    const { resource: updatedItem } = await container
      .item(id, category)
      .replace(createdItem);
    
  • Ta bort ett objekt

    const { resource: result } = await container.item(id, category).delete();
    

Obs!

I både metoderna "uppdatering" och "ta bort" måste objektet väljas från databasen genom att anropa container.item() . De två parametrarna som skickas är objektets ID och objektets partitionsnyckel. I det här fallet är partitionsnyckeln värdet för kategorifältet.

Uppdatera anslutningssträngen

Gå nu tillbaka till Azure-portalen för att få information om anslutningssträngen för ditt Azure Azure Azures-konto. Kopiera anslutningssträngen till appen så att den kan ansluta till databasen.

  1. På ditt Azure Azures DB-konto i Azure-portalenväljer du Nycklar i det vänstra navigeringsfältet och sedan Läs-och skrivnycklar. Använd kopieringsknapparna till höger på skärmen för att kopiera URI och primärnyckel till app.js i nästa steg.

    Visa och kopiera en snabbtangent i Azure-portalen, nyckelbladet

  2. I Öppna config.js filen.

  3. Kopiera URI-värdet från portalen (med knappen Kopiera) och gör det till värdet för slutpunktsnyckeln i config.js.

    endpoint: "<Your Azure Cosmos account URI>"

  4. Kopiera sedan PRIMÄRNYCKEL-värdet från portalen och gör det till värdet i config.keyconfig.key Nu har du uppdaterat appen med all information som behövs för att kommunicera med Azure Azure Azures DB.

    key: "<Your Azure Cosmos account key>"

Köra appen

  1. Kör npm install i en terminal för att installera NPM-paketet "@azure/men"

  2. Kör node app.js i en terminal för att starta nodprogrammet.

  3. De två objekt som du skapade tidigare i den här snabbstarten visas. Ett nytt objekt skapas. Flaggan "isComplete" för objektet uppdateras till "true" och slutligen tas objektet bort.

Du kan fortsätta att experimentera med det här exempelprogrammet eller gå tillbaka till Datautforskaren, ändra och arbeta med dina data.

Granska SLA:er i Azure Portal

Azure Portal övervakar dataflödet för ditt Db-konto, lagring, tillgänglighet, svarstid och konsekvens. Diagram för mätvärden kopplade till azure Azures DB Service Level Agreement (SLA) visar SLA-värdet jämfört med faktiska prestanda. Den här uppsättning mätvärden gör att du kan övervaka dina SLA:er transparenta.

Så här granskar du mätvärden och SLA:er:

  1. Välj Mått i Db-kontots navigeringsmeny för ditt Db-konto.

  2. Välj en flik, till exempel Svarstid,och välj en tidsram till höger. Jämför linjerna Faktiskoch SLA i diagrammen.

    Azure Azure Azures DB metrics suite

  3. Granska måtten på de andra flikarna.

Nästa steg

I den här snabbstarten har du lärt dig att skapa ett Azure Azure AzureS DB-konto, skapa en behållare med hjälp av Data Explorer och köra en Node.js app. Nu kan du importera ytterligare data till ditt Azure Azure Azure Db-konto.

Försöker du göra kapacitetsplanering för en migrering till Azure Azure Azures DB? Du kan använda information om ditt befintliga databaskluster för kapacitetsplanering.