Quickstart: Een Azure Cosmos-account, -database, -container en -items maken vanuit de Azure-portal

VAN TOEPASSING OP: SQL-API

Azure Cosmos DB is de wereldwijd gedistribueerde multimodel-databaseservice van Microsoft. Met Azure Cosmos DB kunt u snel databases maken van sleutel/waarde-paren, documenten en grafieken en hier query’s op uitvoeren. Deze databases hebben allemaal het voordeel van de globale distributie en horizontale schaalmogelijkheden die ten grondslag liggen aan Azure Cosmos DB.

In deze quickstart ziet u hoe u met de Microsoft Azure-portal een SQL API-account van Azure Cosmos DB, een documentdatabase en een container kunt maken en gegevens kunt toevoegen aan de container.

Vereisten

Een Azure-abonnement of gratis Azure Cosmos DB-proefaccount

Maak een Azure Cosmos DB-account

  1. Selecteer vanuit het menu van Azure Portal of op de startpagina de optie Een resource maken.

  2. Zoek op de pagina Nieuw naar Azure Cosmos DB en selecteer dit.

  3. Selecteer op de pagina API-optie selecteren de optie Maken in de sectie Core (SQL) - Aanbeveling. Azure Cosmos DB heeft vijf API's: Core (SQL) en MongoDB voor documentgegevens, Gremlin voor grafiekgegevens, Azure Table en Cassandra. Op dit moment moet u voor elke API een afzonderlijk account maken. Meer informatie over de SQL-API.

  4. Voer op de pagina Azure Cosmos DB-account maken de basisinstellingen voor het nieuwe Azure Cosmos-account in.

    Instelling Waarde Beschrijving
    Abonnement Abonnementsnaam Selecteer het Azure-abonnement dat u voor dit Azure Cosmos-account wilt gebruiken.
    Resourcegroep Naam van de resourcegroep Selecteer een resourcegroep of selecteer Nieuwe maken en voer vervolgens een unieke naam in voor de nieuwe resourcegroep.
    Accountnaam Een unieke naam Voer een naam in om uw Azure Cosmos-account te identificeren. Gebruik een unieke naam omdat documents.azure.com is toegevoegd aan de naam die u hebt opgegeven om uw URI te maken.

    De naam mag alleen kleine letters, cijfers en het koppelteken (-) bevatten. De naam moet tussen de 3 en 44 tekens lang zijn.
    Locatie De regio het dichtst bij uw gebruikers Selecteer een geografische locatie waar u het Azure Cosmos DB-account wilt hosten. Gebruik de locatie die zich het dichtst bij uw gebruikers bevindt, zodat ze de snelst mogelijke toegang tot de gegevens hebben.
    Capaciteitsmodus Ingerichte doorvoer of serverloos Selecteer Ingerichte doorvoer om een account te maken in de modus Ingerichte doorvoer. Selecteer Serverloos om een account te maken in de modus serverloos.
    Niveaukorting op gratis laag van Azure Cosmos DB toepassen Toepassen of niet toepassen Met de gratis laag van Azure Cosmos DB krijgt u de eerste 1000 RU/s en 25 GB opslagruimte gratis in een account. Meer informatie over de gratis laag.

    Notitie

    U kunt per Azure-abonnement maximaal één gratis laag voor het Azure Cosmos DB-account hebben, en u moet zich aanmelden wanneer u het account maakt. Als u de optie voor het toepassen van de korting voor gratis lagen niet ziet, betekent dit dat er al een ander account in het abonnement is ingeschakeld met een gratis laag.

    The new account page for Azure Cosmos DB

  5. Configureer op het tabblad Globale distributie de volgende details. U kunt de standaardwaarden voor deze quickstart laten staan:

    Instelling Waarde Beschrijving
    Georedundantie Uitschakelen Schakel globale distributie voor uw account in of uit door uw regio te koppelen met een koppelingsregio. U kunt later meer regio's aan uw account toevoegen.
    Schrijven voor meerdere regio's Uitschakelen Dankzij de mogelijkheid voor schrijfbewerkingen in meerdere regio's kunt over de hele wereld profiteren van de ingerichte doorvoer voor uw databases en containers.

    Notitie

    De volgende opties zijn niet beschikbaar als u Serverloos als Capaciteitsmodus selecteert:

    • Korting voor gratis lagen toepassen
    • Geografische redundantie
    • Schrijven voor meerdere regio's
  6. U kunt desgewenst meer details configureren op de volgende tabbladen:

  7. Selecteer Controleren + maken.

  8. Controleer de accountinstellingen en selecteer vervolgens Maken. Het duurt een paar minuten om het account te maken. Wacht tot de portal-pagina Uw implementatie is voltooid weergeeft.

    The Azure portal Notifications pane

  9. Selecteer Ga naar resource om naar de Azure Cosmos DB-accountpagina te gaan.

    The Azure Cosmos DB account page

Een database en een container toevoegen

U kunt Data Explorer in de Azure-portal gebruiken om een database en een container te maken.

  1. Selecteer Data Explorer op de linkernavigatiebalk op uw accountpagina van Azure Cosmos DB en selecteer Nieuwe container.

    Mogelijk moet u naar rechts schuiven om het venster Container toevoegen te zien.

    The Azure portal Data Explorer, Add Container pane

  2. Geef in het deelvenster Container toevoegen de instellingen voor de nieuwe container op.

    Instelling Voorgestelde waarde Beschrijving
    Database-id Takenlijst Voer Takenlijst in als de naam voor de nieuwe database. Databasenamen moeten tussen de 1 en 255 tekens zijn en mogen geen /, \\, #, ? bevatten en mogen niet eindigen met een spatie. Controleer de optie Doorvoer delen tussen containers , zodat u de doorvoer die is ingericht voor de database, kunt delen in alle containers in de database. Met deze optie bespaart u bovendien op de kosten.
    Databasedoorvoer U kunt automatische schaalaanpassing of handmatige doorvoer inrichten. Met handmatige doorvoer kunt u RU/s zelf schalen, terwijl met automatische schaalaanpassing van doorvoer RU/s kan worden geschaald op basis van gebruik. Selecteer Handmatig voor dit voorbeeld.

    Wijzig de doorvoer in 400 aanvraageenheden per seconde (RU/s). Als u de latentie wilt verminderen, kunt u de doorvoer later omhoog schalen door de vereiste RU/s te schatten met de capaciteitscalculator.

    Opmerking: Deze instelling is niet beschikbaar bij het maken van een nieuwe container in een serverloos account.
    Container-id Items Voer Items in als de naam voor de nieuwe container. Voor id's van containers gelden dezelfde tekenvereisten als voor databasenamen.
    Partitiesleutel /category In het voorbeeld dat in dit artikel wordt beschreven, wordt /category als de partitiesleutel gebruikt.

    Voeg geen unieke sleutels toe of schakel analytische opslag in voor dit voorbeeld. Met unieke sleutels kunt u een laag van gegevensintegriteit toevoegen aan de database door de uniekheid van een of meer waarden per partitiesleutel te garanderen. Zie Unieke sleutels in Azure Cosmos DB voor meer informatie. Analytische opslag wordt gebruikt om grootschalige analyses mogelijk te maken voor operationele gegevens zonder dat dit gevolgen heeft voor uw transactionele workloads.

  3. Selecteer OK. In Data Explorer worden de nieuwe database en container weergegeven die u hebt gemaakt.

Gegevens toevoegen aan uw database

Voeg gegevens aan uw nieuwe database toe met behulp van Data Explorer.

  1. Vouw in Data Explorer de database Takenlijst uit en vouw de container Items uit. Selecteer vervolgens Items en selecteer Nieuw item.

    Create new documents in Data Explorer in the Azure portal

  2. Voeg de volgende structuur toe aan het document aan de rechterkant van het deelvenster Documenten:

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

    Copy in json data and select Save in Data Explorer in the Azure portal

  4. Selecteer opnieuw Nieuw item en maak en sla een ander document op met een unieke iden eventuele andere eigenschappen en waarden die u wilt. De documenten kunnen elke gewenste structuur hebben, omdat in Azure Cosmos DB uw gegevens geen schema krijgen opgelegd.

Uw gegevens opvragen

U kunt query's in Data Explorer gebruiken om uw gegevens op te halen en te filteren.

  1. Controleer bovenaan het tabblad Items in Data Explorer de standaardquery SELECT * FROM c. Met deze query worden alle documenten opgehaald uit de container en weergegeven op volgorde van id.

    Default query in Data Explorer is SELECT * FROM c

  2. Als u de query wilt wijzigen, selecteert u Filter bewerken, vervangt u de standaardquery door ORDER BY c._ts DESC en selecteert u Filter toepassen.

    Change the default query by adding ORDER BY c._ts DESC and clicking Apply Filter

    De gewijzigde query sorteert de documenten in aflopende volgorde op basis van hun tijdstempel. Uw tweede document wordt nu dus als eerste weergegeven.

    Changed query to ORDER BY c._ts DESC and clicking Apply Filter

Als u bekend bent met SQL-syntaxis, kunt u een van de ondersteunde SQL-query's in het vak Querypredicaat invoeren. U kunt Data Explorer ook gebruiken voor het maken van opgeslagen procedures, UDF's en triggers om bedrijfslogica aan de serverzijde uit te voeren.

Data Explorer biedt eenvoudige toegang via Azure Portal tot alle ingebouwde programmatische datatoegangsfuncties die in de API's beschikbaar zijn. U gebruikt de portal ook om de doorvoer te schalen, sleutels en verbindingsreeksen op te halen en metrische gegevens en SLA's voor uw Azure Cosmos DB-account te bekijken.

Resources opschonen

Wanneer u uw app en Azure Cosmos DB-account niet meer nodig hebt, kunt u de Azure-resources die u hebt gemaakt, verwijderen zodat er geen kosten meer voor in rekening worden gebracht. Om de resources te verwijderen:

  1. Zoek en selecteer Resourcegroepen in de zoekbalk op Azure Portal.

  2. Selecteer de resourcegroep die u eerder voor deze quickstart hebt gemaakt uit de lijst.

    Select the resource group to delete

  3. Selecteer Resourcegroep verwijderen op de pagina Overzicht van de resourcegroep.

    Delete the resource group

  4. Selecteer in het volgende venster de naam van de resourcegroep die u wilt verwijderen en selecteer vervolgens Verwijderen.

Als u alleen de database wilt verwijderen en het Azure Cosmos-account in de toekomst wilt gebruiken, kunt u de database verwijderen door de volgende stappen uit te voeren:

  • Ga naar uw Azure Cosmos-account.
  • Open Data Explorer, klik met de rechtermuisknop op de database die u wilt verwijderen en selecteer Database verwijderen.
  • Voer de database-id/databasenaam in om de verwijderbewerking te bevestigen.

Volgende stappen

In deze quickstart hebt u geleerd hoe u een Azure Cosmos DB-account maakt en een database en container maakt met Data Explorer. Nu kunt u aanvullende gegevens in uw Azure Cosmos DB-account importeren.

Wilt u capaciteitsplanning uitvoeren voor een migratie naar Azure Cosmos DB? U kunt informatie over uw bestaande databasecluster gebruiken voor capaciteitsplanning.