Snabbstart: Skapa ett Azure Cosmos-konto, en databas, en container och objekt från Azure Portal

  • Artikel
  • 7 minuter för att läsa

GÄLLER FÖR: SQL API

Azure Cosmos DB är Microsofts globalt distribuerade databastjänst för flera datamodeller. Du kan använda Azure Cosmos DB för att snabbt skapa och fråga efter nyckel-/värdedatabaser, dokumentdatabaser och grafdatabaser, som alla kan dra nytta av den globala distributionen och horisontella skalningsfunktioner som ligger i grunden Azure Cosmos DB.

Den här snabbstarten visar hur du använder Azure Portal för att skapa ett Azure Cosmos DB SQL API-konto, skapa en dokumentdatabas och container och lägga till data i containern.

Förutsättningar

En Azure-prenumeration eller ett kostnadsfritt Azure Cosmos DB utvärderingskonto

Skapa ett Azure Cosmos DB-konto

  1. På Azure Portal eller på sidan Start väljer du Skapa en resurs.

  2. På sidan Nytt söker du efter och väljer Azure Cosmos DB.

  3. På sidan Azure Cosmos DB väljer du Skapa.

  4. På sidan Skapa Azure Cosmos DB-konto anger du de grundläggande inställningarna för det nya Azure Cosmos-kontot.

    Inställning Värde Beskrivning
    Prenumeration Prenumerationens namn Välj den Azure-prenumeration som ska användas för det här Azure Cosmos-kontot.
    Resursgrupp Namn på resursgrupp Välj en resursgrupp eller välj Skapa ny och ange sedan ett unikt namn för den nya resursgruppen.
    Account Name Ett unikt namn Ange ett namn som identifierar ditt Azure Cosmos-konto. Eftersom documents.azure.com läggs till det namn du anger för att skapa din URI måste du använda ett unikt namn.

    Namnet får endast innehålla gemener, siffror och bindestreck (-). Det måste vara mellan 3 och 44 tecken långt.
    API Typ av konto som skapas Välj Core (SQL) för att skapa en dokumentdatabas och kör frågor med hjälp av SQL-syntax.

    API:et avgör vilken typ av konto som skapas. Azure Cosmos DB innehåller fem API:er: Core (SQL) och MongoDB för dokumentdata, Gremlin för grafdata, Azure Table och Cassandra. För närvarande måste du skapa ett separat konto för varje API.

    Läs mer om SQL API.
    Location Den region som är närmast dina användare Välj en geografisk plats som värd för ditt Azure Cosmos DB-konto. Använd den plats som är närmast dina användare för att ge dem så snabb åtkomst till data som möjligt.
    Kapacitetsläge Etablerat dataflöde eller serverlöst Välj Etablerat dataflöde för att skapa ett konto i etablerat dataflödesläge. Välj Serverlös för att skapa ett konto i serverlöst läge.
    Tillämpa Azure Cosmos DB rabatt på kostnadsfri nivå Tillämpa eller Tillämpa inte Med Azure Cosmos DB kostnadsfri nivå får du de första 1 000 RU/s och 25 GB lagringsutrymme kostnadsfritt i ett konto. Läs mer om den kostnadsfria nivån.

    Anteckning

    Du kan ha upp till en kostnadsfri nivå Azure Cosmos DB per Azure-prenumeration och måste välja när du skapar kontot. Om du inte ser alternativet för att tillämpa rabatten på den kostnadsfria nivån innebär det att ett annat konto i prenumerationen redan har aktiverats med den kostnadsfria nivån.

    Den nya kontosidan för Azure Cosmos DB

  5. Konfigurera följande information på fliken Global distribution. Du kan lämna standardvärdena i den här snabbstarten:

    Inställning Värde Beskrivning
    Geo-redundans Inaktivera Aktivera eller inaktivera global distribution på ditt konto genom att koppla ihop din region med en parregion. Du kan lägga till fler regioner i ditt konto senare.
    Skrivåtgärder för flera regioner Inaktivera Med skrivfunktioner för flera regioner kan du dra nytta av det etablerade dataflödet för dina databaser och containrar över hela världen.

    Anteckning

    Följande alternativ är inte tillgängliga om du väljer Serverlös som Kapacitetsläge:

    • Tillämpa rabatt för kostnadsfri nivå
    • Geo-redundans
    • Skrivåtgärder för flera regioner

  6. Du kan också konfigurera ytterligare information på följande flikar:

    • Nätverk – Konfigurera åtkomst från ett virtuellt nätverk.
    • Säkerhetskopieringspolicy – Konfigurera princip för regelbunden eller kontinuerlig säkerhetskopiering.
    • Kryptering – Använd antingen en tjänst hanterad nyckel eller en kund hanterad nyckel.
    • Taggar – Taggar är namn-/värdepar som gör att du kan kategorisera resurser och visa konsoliderad fakturering genom att tillämpa samma tagg på flera resurser och resursgrupper.

  7. Välj Granska + skapa.

  8. Granska kontoinställningarna och välj sedan Skapa. Det tar några minuter att skapa kontot. Vänta tills portalsidan visar meddelandet Distributionen är klar.

    Meddelandefönstret på Azure-portalen

  9. Välj Gå till resurs för att gå till sidan för Azure Cosmos DB-kontot.

    Sidan för Azure Cosmos DB-kontot

Lägga till en databas och en container

Du kan använda Datautforskaren i Azure Portal för att skapa en databas och container.

  1. Välj Datautforskaren navigeringsfältet i det vänstra Azure Cosmos DB på kontosidan och välj sedan Ny container.

    Du kan behöva rulla åt höger för att se fönstret Lägg till container.

    Datautforskaren på Azure-portalen, fönstret Lägg till container

  2. I fönstret Lägg till container anger du inställningarna för den nya containern.

    Inställning Föreslaget värde Beskrivning
    Databas-ID ToDoList Ange ToDoList som namn på den nya databasen. Databasnamn måste innehålla 1–255 tecken och får inte innehålla /, \\, #, ?, eller avslutande blanksteg. Markera alternativet Dela dataflöde mellan containrar. Med det kan du dela dataflödet som etablerats på databasen över alla containrar i databasen. Det här alternativet hjälper också till med kostnadsbesparingar.
    Databasdataflöde Du kan etablera autoskalning eller manuellt dataflöde. Med manuellt dataflöde kan du skala RU/s själv, medan dataflödet för automatisk skalning gör att systemet kan skala RU/s baserat på användning. Välj Manuell för det här exemplet.

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

    Obs! Den här inställningen är inte tillgänglig när du skapar en ny container i ett serverlöst konto.
    Container-ID Poster Ange Objekt som namn på den nya containern. För container-ID:n gäller samma teckenkrav som för databasnamn.
    Partitionsnyckel /category Exemplet som beskrivs i den här artikeln använder /category som partitionsnyckel.

    Lägg inte till unika nycklar eller aktivera analysarkiv för det här exemplet. Med unika nycklar kan du lägga till ett lager av dataintegritet i databasen genom att se till att ett eller flera värden per partitionsnyckel är unika. Mer information finns i Unika nycklar i Azure Cosmos DB. Analysarkiv används för att möjliggöra storskalig analys mot driftdata utan att påverka dina transaktionsarbetsbelastningar.

  3. Välj OK. I Datautforskaren den nya databasen och containern som du skapade.

Lägga till data i databasen

Lägg till data i den nya databasen med Datautforskaren.

  1. I Datautforskaren expanderar du ToDoList-databasen och containern Items. Välj objekt och välj sedan Nytt objekt.

    Skapa nya dokument i datautforskaren i Azure Portal

  2. Lägg till följande struktur i dokumentet till höger i fönstret Dokument:

    {
    "id": "1",
    "category": "personal",
    "name": "groceries",
    "description": "Pick up apples and strawberries.",
    "isComplete": false
}

  3. Välj Spara.

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

  4. Välj Nytt dokument igen och skapa och spara ett annat dokument med ett unikt och eventuella andra egenskaper och värden som du vill id ha. Dina dokument kan ha valfri struktur eftersom Azure Cosmos DB inte inför något schema för dina data.

Fråga dina data

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

  1. Granska standardfrågan längst upp på Datautforskaren fliken SELECT * FROM c Objekt. Den här frågan hämtar och visar alla dokument från containern sorterade 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 ORDER BY c._ts DESC och väljer sedan Använd filter.

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

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

    Frågan har ändrats till ORDER BY c._ts DESC och klicka på Använd filter

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

Datautforskaren ger enkel Azure Portal åtkomst till alla inbyggda funktioner för programmatisk dataåtkomst som är tillgängliga i API:erna. Du kan också använda portalen för att skala dataflöde, hämta nycklar och anslutningssträngar samt granska mått och serviceavtal för ditt Azure Cosmos DB konto.

Rensa resurser

När du är klar med din app och Azure Cosmos DB-konto kan du ta bort de Azure-resurser som du skapade så att du inte debiteras mer. Ta bort resurser:

  1. I sökfältet Azure Portal du efter och väljer Resursgrupper.

  2. I listan väljer du den resursgrupp som du skapade för den här snabbstarten.

    Välj den resursgrupp som ska tas bort

  3. På sidan Översikt för resursgruppen väljer du Ta bort resursgrupp.

    Ta bort resursgruppen

  4. I nästa fönster anger du namnet på den resursgrupp som ska tas bort och väljer sedan Ta bort.

Om du bara vill ta bort databasen och använda Azure Cosmos-kontot i framtiden kan du ta bort databasen med följande steg:

  • Kom till ditt Azure Cosmos-konto.
  • Öppna Datautforskaren, högerklicka på den databas som du vill ta bort och välj Ta bort databas.
  • Ange databas-ID/databasnamn för att bekräfta borttagningsåtgärden.

Nästa steg

I den här snabbstarten har du lärt dig hur du skapar ett Azure Cosmos DB-konto, skapar en databas och container med hjälp av Datautforskaren. Du kan nu importera ytterligare data till ditt Azure Cosmos DB-konto.

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

  • Om allt du vet är antalet virtuella kärnor och servrar i ditt befintliga databaskluster kan du läsa om att uppskatta enheter för programbegäran med hjälp av virtuella kärnor eller virtuella processorer
  • Om du känner till vanliga begärandefrekvenser för din aktuella databasarbetsbelastning kan du läsa om att uppskatta enheter för programbegäran med Azure Cosmos DB kapacitetsplaneraren

Importera data till Azure Cosmos DB