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

• Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

• U kunt Azure Cosmos DB gratis proberen zonder een Azure-abonnement, geheel kosteloos en zonder verplichtingen, of een gratis Azure Cosmos DB-account maken waarbij de eerste 400 RU/s en 5 GB aan opslagruimte gratis zijn. U kunt ook de Azure Cosmos DB Emulator gebruiken met een URI van https://localhost:8081. Zie Aanvragen verifiëren voor de sleutel die u nodig hebt voor de emulator.

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 Azure Cosmos DB Maken.

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

   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.
   API	Het type account dat moet worden gemaakt	Selecteer Core(SQL) om een documentdatabase en query's aan te maken met SQL-syntaxis. De API bepaalt het type te maken account. 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.
   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 Azure Cosmos DB gratis laag krijgt u de eerste 1000 RU/s en 25 GB aan 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.

   

5. Configureer de volgende gegevens op het tabblad Globale distributie. 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. Optioneel kunt u aanvullende details configureren op de volgende tabbladen:

   • Netwerken: configureer de toegang vanuit een virtueel netwerk.
   • Back-upbeleid: configureer het periodieke of continue back-upbeleid.
   • Versleuteling: gebruik een door de service beheerde sleutel of een door de klant beheerde sleutel.
   • Tags: tags zijn naam/waarde-paren waarmee u resources kunt categoriseren en geconsolideerde facturering kunt weergeven door dezelfde tag toe te passen op meerdere resources en resourcegroepen.

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.

   

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

   

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.

   

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 tussen containers delen. Hiermee kunt u de doorvoer die is ingericht op de database delen in alle containers in de database. Met deze optie bespaart u bovendien op de kosten.
   Databasedoorvoer	U kunt automatisch schalen of handmatige doorvoer inrichten. Handmatige doorvoer stelt u in staat om RU/s zelf te schalen, terwijl de doorvoer voor automatisch schalen het systeem in staat stelt RU/s te schalen 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 voor dit voorbeeld geen unieke sleutels toe of schakel Analytische opslag niet in. 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. Analytische opslag wordt gebruikt om grootschalige analyses in te stellen op basis van operationele gegevens zonder dat dit van invloed is op 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.

   

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.

   

4. Selecteer opnieuw Nieuw document, maak nog een document en sla dit op met een unieke id en andere eigenschappen en waarden die u wilt instellen. 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.

   

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.

   

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

   

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.

   

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

   

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.

Probeert u capaciteitsplanning uit te Azure Cosmos DB? U kunt informatie over uw bestaande databasecluster gebruiken voor capaciteitsplanning.

• Als u alleen het aantal vcores en servers in uw bestaande databasecluster weet, leest u over het schatten van aanvraageenheden met behulp van vCores of vCCPUs
• Als u de gebruikelijke aanvraagsnelheden voor uw huidige databaseworkload kent, leest u over het schatten van aanvraageenheden met behulp Azure Cosmos DB capacity planner