Rychlý start: Vytvoření účtu azure Cosmos, databáze, kontejneru a položek z Azure Portal

PLATÍ PRO: SQL API

Azure Cosmos DB je globálně distribuovaná databázová služba Microsoftu pro více modelů. Azure Cosmos DB můžete použít k rychlému vytváření a dotazování databází typu klíč/hodnota, dokumentových databází a grafových databází, z nichž všechny těží z možností globální distribuce a horizontálního škálování v jádru Azure Cosmos DB.

Tento rychlý start ukazuje použití rozhraní Azure Portal k vytvoření účtu rozhraní SQL API služby Azure Cosmos DB, vytvoření databáze dokumentů a kontejneru a přidání dat do kontejneru.

Požadavky

Předplatné Azure nebo bezplatný zkušební účet služby Azure Cosmos DB

• Pokud ještě nemáte předplatné Azure,vytvořte si bezplatný účet před tím, než začnete.

• Můžete vyzkoušet Azure Cosmos DB zdarma bez předplatného Azure, bezplatného zpoplatnění a závazků nebo vytvořit Azure Cosmos DB účet úrovně frees prvním 400 ru/s a 5 GB úložištěm zdarma. Můžete také použít emulátor Azure Cosmos DB s identifikátorem URI https://localhost:8081 . Klíč, který se má použít s emulátorem, najdete v tématu ověřování požadavků.

Vytvoření účtu služby Azure Cosmos DB

1. V Azure Portal nebo na domovské stránce vyberte Vytvořit prostředek.

2. Na stránce Nový vyhledejte a vyberte Azure Cosmos DB.

3. Na stránce Azure Cosmos DB vyberte Vytvořit.

4. Na stránce Create Azure Cosmos DB Account (Vytvořit účet Azure Cosmos DB) zadejte základní nastavení nového účtu Azure Cosmos DB.

   Nastavení	Hodnota	Popis
   Předplatné	Název předplatného	Vyberte předplatné Azure, které chcete pro tento účet Azure Cosmos Azure.
   Skupina prostředků	Název skupiny prostředků	Vyberte skupinu prostředků nebo vyberte Vytvořit novou a pak zadejte jedinečný název nové skupiny prostředků.
   Account Name	Jedinečný název	Zadejte název pro identifikaci vašeho účtu Azure Cosmos. Protože documents.azure.com k názvu, který poskytnete pro vytvoření identifikátoru URI, použijte jedinečný název. Název může obsahovat pouze malá písmena, číslice a znak spojovníku (-). Musí mít délku 3 až 44 znaků.
   rozhraní API	Typ účtu, který se má vytvořit	Vyberte Core (SQL) a vytvořte databázi dokumentů a dotaz pomocí SQL syntaxe. Rozhraní API určuje typ účtu, který se má vytvořit. Azure Cosmos DB poskytuje pět rozhraní API: Core (SQL) a MongoDB pro data dokumentů, Gremlin pro data grafu, Azure Table a Cassandra. V současné době musíte pro každé rozhraní API vytvořit samostatný účet. Další informace o rozhraní API SQL.
   Umístění	Oblast nejbližší vašim uživatelům	Vyberte zeměpisné umístění, ve kterém chcete účet služby Azure Cosmos DB hostovat. Použijte umístění, které je vašim uživatelům nejblíže, a podejte jim nejrychlejší přístup k datům.
   Režim kapacity	Zřízená propustnost nebo bez serveru	Vyberte Zřízená propustnost a vytvořte účet v režimu zřízené propustnosti. Vyberte Bez serveru a vytvořte účet v režimu bez serveru.
   Použití slevy na bezplatnou úroveň Azure Cosmos DB	Použít nebo Neakusovat	S úrovní Free služby Azure Cosmos DB získáte v účtu prvních 1 000 RU/s a 25 GB úložiště zdarma. Přečtěte si další informace o úrovni Free.

   Poznámka

   Pro jedno předplatné Azure můžete mít až jeden účet Azure Cosmos DB úrovně Free a při vytváření účtu se musíte přihlásit. Pokud nevidíte možnost uplatnit slevu na bezplatnou úroveň, znamená to, že u jiného účtu v předplatném už je povolená úroveň Free.

   

5. Na kartě Globální distribuce nakonfigurujte následující podrobnosti. Pro účely tohoto rychlého startu můžete ponechat výchozí hodnoty:

   Nastavení	Hodnota	Popis
   Geografická redundance	Zakázat	Povolte nebo zakažte globální distribuci vašeho účtu spárováním oblasti s párovou oblastí. Další oblasti můžete do svého účtu přidat později.
   Zápisy do více oblastí	Zakázat	Funkce zápisu do více oblastí umožňuje využít zřízenou propustnost pro databáze a kontejnery po celém světě.

   Poznámka

   Pokud jako Režim kapacity vyberete Bez serveru, nejsou k dispozici následující možnosti:

   • Použít slevu založenou na bezplatné úrovni
   • Geografická redundance
   • Zápisy do více oblastí

6. Volitelně můžete nakonfigurovat další podrobnosti na následujících kartách:

   • Sítě – Nakonfigurujte přístup z virtuální sítě.
   • Zásady zálohování – Nakonfigurujte zásady pravidelného nebo průběžného zálohování.
   • Šifrování – Použijte klíč spravovaný službou nebo klíč spravovaný zákazníkem.
   • Značky – Značky jsou páry název/hodnota, které umožňují kategorizovat prostředky a zobrazit konsolidovanou fakturaci tím, že stejnou značku použijete na více prostředků a skupin prostředků.

7. Vyberte Zkontrolovat a vytvořit.

8. Zkontrolujte nastavení účtu a pak vyberte Vytvořit. Vytvoření účtu trvá několik minut. Počkejte, až se na stránce portálu zobrazí Vaše nasazení je dokončené.

   

9. Vyberte Přejít k prostředku a přejděte na stránku účtu Azure Cosmos DB.

   

Přidání databáze a kontejneru

K vytvoření databáze Průzkumník dat kontejneru můžete Azure Portal v souboru .

1. V Průzkumník dat navigačním panelu na stránce účtu Azure Cosmos DB vyberte a pak vyberte Nový kontejner.

   Možná se budete muset posunout doprava, abyste viděli okno Přidat kontejner.

   

2. V podokně Přidat kontejner zadejte nastavení pro nový kontejner.

   Nastavení	Navrhovaná hodnota	Popis
   ID databáze	ToDoList	Jako název nové databáze zadejte ToDoList. Názvy databází musí mít 1 až 255 znaků a nesmí obsahovat /, \\, #, ? ani koncovou mezeru. Zaškrtněte možnost Sdílet propustnost mezi kontejnery, která umožňuje sdílet propustnost zřízenou v databázi mezi všemi kontejnery v databázi. Tato možnost také pomáhá s úsporou nákladů.
   Propustnost databáze	Můžete zřídit automatické škálování nebo ruční propustnost. Ruční propustnost umožňuje škálovat RU/s sami, zatímco propustnost automatického škálování umožňuje systému škálovat RU/s na základě využití. V tomto příkladu vyberte Ruční. Propustnost nechte na 400 jednotkách žádostí za sekundu (RU/s). Pokud chcete snížit latenci, můžete propustnost později škálovat odhadem požadovaných RU/s pomocí kalkulačky kapacity. Poznámka: Toto nastavení není k dispozici při vytváření nového kontejneru v účtu bez serveru.
   ID kontejneru	Položky	Jako název nového kontejneru zadejte Items. Pro ID kontejnerů platí stejné požadavky týkající se použitých znaků jako pro názvy databází.
   Klíč oddílu	/kategorie	Ukázka popsaná v tomto článku používá jako klíč oddílu /category.

   V tomto příkladu neskládejte jedinečné klíče ani zapněte Analytické úložiště. Jedinečné klíče umožňují přidat do databáze vrstvu integrity dat tím, že zajišťují jedinečnost jedné nebo více hodnot na klíč oddílu. Další informace najdete v tématu Jedinečné klíče v Azure Cosmos DB. Analytické úložiště umožňuje rozsáhlé analýzy provozních dat bez jakéhokoli dopadu na vaše transakční úlohy.

3. Vyberte OK. V Průzkumník dat se zobrazí nová databáze a kontejner, který jste vytvořili.

Přidání dat do databáze

Přidejte data do nové databáze pomocí Průzkumník dat.

1. V Průzkumník dat rozbalte databázi ToDoList a rozbalte kontejner Items. Dále vyberte Items (Položky) a pak vyberte New Item (Nová položka).

   

2. Do dokumentu na pravé straně podokna Dokumenty přidejte následující strukturu:

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

3. Vyberte Uložit.

   

4. Znovu vyberte Nový dokument a vytvořte a uložte další dokument s jedinečným a libovolnými dalšími vlastnostmi a id hodnotami. Vaše dokumenty mohou mít libovolnou strukturu, protože Azure Cosmos DB neuplatní pro vaše data žádné schéma.

Dotazování dat

Pomocí dotazů v nástroji Průzkumník dat načíst a filtrovat data.

1. V horní části karty Položky v Průzkumník dat zkontrolujte výchozí dotaz SELECT * FROM c . Tento dotaz načte a zobrazí všechny dokumenty z kontejneru seřazené podle ID.

   

2. Pokud chcete dotaz změnit, vyberte Upravit filtr, nahraďte výchozí dotaz hodnotou ORDER BY c._ts DESC a pak vyberte Použít filtr.

   

   Upravený dotaz zobrazí dokumenty v sestupném pořadí na základě jejich časového razítka, takže váš druhý dokument je teď uvedený jako první.

   

Pokud znáte syntaxi SQL, můžete do pole predikátu dotazu zadat všechny podporované dotazy SQL. Můžete také použít Průzkumník dat k vytváření uložených procedur, UDF a triggerů pro obchodní logiku na straně serveru.

Průzkumník dat poskytuje Azure Portal přístup ke všem integrovaným funkcím programového přístupu k datům dostupným v rozhraních API. Pomocí portálu můžete také škálovat propustnost, získat klíče a připojovací řetězce a zkontrolovat metriky a smlouvy SLA pro Azure Cosmos DB účet.

Vyčištění prostředků

Až budete s aplikací a Azure Cosmos DB účtem hotovi, můžete odstranit prostředky Azure, které jste vytvořili, abyste se neúčtují další poplatky. Odstranění prostředků:

1. Na panelu hledání Azure Portal vyhledejte a vyberte skupiny prostředků.

2. V seznamu vyberte skupinu prostředků, kterou jste vytvořili pro tento rychlý Start.

   

3. Na stránce Přehled skupiny prostředků vyberte Odstranit skupinu prostředků.

   

4. V dalším okně zadejte název skupiny prostředků, kterou chcete odstranit, a pak vyberte Odstranit.

Pokud chcete odstranit pouze databázi a použít účet Azure Cosmos v budoucnu, můžete databázi odstranit pomocí následujících kroků:

• Máte přístup ke svému Cosmos Azure.
• Otevřete Průzkumník dat, klikněte pravým tlačítkem na databázi, kterou chcete odstranit, a vyberte Odstranit databázi.
• Zadáním ID databáze nebo názvu databáze potvrďte operaci odstranění.

Další kroky

V tomto rychlém startu jste zjistili, jak vytvořit účet Azure Cosmos DB, jak vytvořit databázi a kontejner pomocí Průzkumník dat. Teď můžete do svého účtu služby Azure Cosmos DB importovat další data.

Pokoušíte se provést plánování kapacity pro migraci do Azure Cosmos DB? Informace o existujícím databázovém clusteru můžete použít k plánování kapacity.

• Pokud víte jen počet virtuálních jadr a serverů ve stávajícím databázovém clusteru, přečtěte si o odhadování jednotek žádostí pomocí virtuálních jadr nebo virtuálních procesorů.
• Pokud znáte typickou míru požadavků pro aktuální databázové úlohy, přečtěte si o odhadování jednotek žádostí pomocí Plánovače kapacity služby Azure Cosmos DB.