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

PLATÍ PRO: NoSQL

• Azure Portal
• .NET
• Java
• Node.js
• Python

Azure Cosmos DB je celosvětově rozšířená vícemodelová databázová služba společnosti Microsoft. Azure Cosmos DB můžete použít k rychlému vytváření a dotazování databází klíč/hodnota, databází dokumentů a grafových databází. Tento přístup přináší výhody globální distribuce a horizontálního škálování v jádru služby Azure Cosmos DB.

Tento rychlý start ukazuje, jak pomocí webu Azure Portal vytvořit účet rozhraní API služby Azure Cosmos DB pro NoSQL . V takovém účtu vytvoříte databázi dokumentů a kontejner a přidáte do kontejneru data. Bez platební karty nebo předplatného Azure můžete nastavit bezplatný účet Vyzkoušet službu Azure Cosmos DB.

Předpoklady

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 Azure před tím, než začnete.

• Službu Azure Cosmos DB můžete vyzkoušet zdarma bez předplatného Azure a bez nutnosti závazku. Alternativně můžete vytvořit účet úrovně Free služby Azure Cosmos DB s prvních 1 000 RU/s a 25 GB úložiště zdarma. Emulátor služby Azure Cosmos DB můžete také použít s identifikátorem URI https://localhost:8081služby . 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 nabídce webu Azure Portal nebo na domovské stránce vyberte Vytvořit prostředek.

2. Vyhledejte Službu Azure Cosmos DB. Vyberte Vytvořit>službu Azure Cosmos DB.

3. Na stránce Vytvořit účet služby Azure Cosmos DB vyberte možnost Vytvořit v části Azure Cosmos DB for NoSQL.

   Azure Cosmos DB poskytuje několik rozhraní API:

   • NoSQL pro data dokumentů
   • PostgreSQL
   • MongoDB pro data dokumentů
   • Apache Cassandra
   • Table
   • Apache Gremlin pro data grafu

   Další informace o rozhraní API pro NoSQL najdete v tématu Vítá vás Azure Cosmos DB.

4. Na stránce Vytvořit účet služby Azure Cosmos DB zadejte základní nastavení nového účtu služby Azure Cosmos DB.

   Nastavení	Hodnota	Popis
   Předplatné	Název předplatného	Vyberte předplatné Azure, které chcete pro tento účet služby Azure Cosmos DB použít.
   Skupina prostředků	Název skupiny prostředků	Vyberte skupinu prostředků nebo vyberte Vytvořit novoua zadejte jedinečný název nové skupiny prostředků.
   Název účtu	Jedinečný název	Zadejte název pro identifikaci účtu služby Azure Cosmos DB. Vzhledem k tomu, že se váš identifikátor URI vytvoří připojením řetězce documents.azure.com k názvu, který zadáte, použijte jedinečný název. Název může obsahovat pouze malá písmena, číslice a znak spojovníku (-). Musí mít 3 až 44 znaků.
   Poloha	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 nejbližší, abyste jim zajistili nejrychlejší přístup k datům.
   Režim kapacity	Zřízená propustnost nebo bezserverová	Vyberte Zřízenou propustnost a vytvořte účet v režimu zřízené propustnosti. Vyberte Bezserverový účet a vytvořte účet v bezserverovém režimu.
   Uplatnění slevy na úroveň Free služby Azure Cosmos DB	Použít nebo nepoužovat	S úrovní Free služby Azure Cosmos DB získáte prvních 1 000 RU/s a 25 GB úložiště zdarma v účtu. Další informace o úrovni Free
   Omezení celkové propustnosti účtu	Vybráno nebo ne	Omezte celkovou propustnost, kterou je možné zřídit pro tento účet. Tento limit zabraňuje neočekávaným poplatkům souvisejícím se zřízenou propustností. Tento limit můžete po vytvoření účtu aktualizovat nebo odebrat.

   Pro každé předplatné Azure můžete mít až jeden účet služby Azure Cosmos DB úrovně Free a při vytváření účtu se musíte přihlásit. Pokud nevidíte možnost použít slevu na úroveň Free, je už u úrovně Free povolen jiný účet v předplatném.

   

   Poznámka:

   Pokud jako režim kapacity vyberete bezserverový režim,nejsou k dispozici následující možnosti:

   • Použít slevu založenou na bezplatné úrovni
   • Omezení celkové propustnosti účtu

5. Na kartě Globální distribuce nakonfigurujte následující podrobnosti. V tomto rychlém 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žívat zřízenou propustnost pro databáze a kontejnery po celém světě.
   Zóny dostupnosti	Zakázat	Zóny dostupnosti vám pomohou dále zlepšit dostupnost a odolnost vaší aplikace.

   Poznámka:

   Následující možnosti nejsou k dispozici, pokud jako režim kapacity na předchozí stránce Základy vyberete bezserverovýrežim:

   • 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 dvojice název-hodnota, které umožňují kategorizovat prostředky a zobrazovat souhrnnou fakturaci. Stačí k tomu u několika prostředků a skupin prostředků použít stejnou značku.

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 portálu zobrazí stránka s textem Vaše nasazení je hotové.

   

9. Pokud chcete přejít na stránku účtu Azure Cosmos DB, vyberte Přejít k prostředku.

   

Přidání databáze a kontejneru

Pomocí Průzkumníka dat na webu Azure Portal můžete vytvořit databázi a kontejner.

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

   Možná se budete muset posunout doprava, aby se zobrazilo okno Nový kontejner .

   

2. V podokně Nový 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í obsahovat 1 až 255 znaků a nesmí obsahovat /, , \, #, ani ?koncové mezery. Zkontrolujte možnost Sdílet propustnost mezi kontejnery. Umožňuje sdílet propustnost zřízenou v databázi napříč všemi kontejnery v databázi. Tato možnost také pomáhá s úsporami nákladů.
   Propustnost databáze	Automatické škálování nebo ruční	Ruční propustnost umožňuje škálovat jednotky žádostí za sekundu (RU/s), 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í .
   Maximální počet RU/s databáze	400 RU/s	Pokud chcete snížit latenci, můžete později vertikálně navýšit kapacitu 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 bezserverovém účtu.
   ID kontejneru	Items	Jako název nového kontejneru zadejte položky . Pro ID kontejnerů platí stejné požadavky ohledně 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 nepřidávejte jedinečné klíče ani nezapínejte analytické úložiště .

   • Jedinečné klíče umožňují přidat do databáze vrstvu integrity dat tím, že zajistí jedinečnost jedné nebo více hodnot na klíč oddílu. Další informace najdete v tématu Jedinečné klíče ve službě Azure Cosmos DB.
   • Analytické úložiště se používá k povolení rozsáhlých analýz proti provozním datům bez jakéhokoli vlivu na transakční úlohy.

3. Vyberte OK. Průzkumník dat zobrazí novou databázi a kontejner, který jste vytvořili.

Přidání dat do databáze

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

1. V Průzkumníku dat rozbalte databázi ToDoList a rozbalte kontejner Items.

2. Dále vyberte Položky a pak vyberte Nová položka.

   

3. 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
   }
   

4. Zvolte Uložit.

   

5. Znovu vyberte Možnost Nová položka a vytvořte a uložte další dokument s jedinečným ida libovolnými dalšími vlastnostmi a hodnotami. Vaše dokumenty můžou mít libovolnou strukturu, protože Azure Cosmos DB neukládá žádná schémata vašich dat.

Dotazování dat

K načtení a filtrování dat můžete použít dotazy v Průzkumníku dat.

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

   

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

   

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

   

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

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

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

Až budete s aplikací a účtem služby Azure Cosmos DB hotovi, můžete odstranit vytvořené prostředky Azure, takže se vám nebudou účtovat další poplatky. Odstranění prostředků:

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

2. V seznamu vyberte skupinu prostředků, kterou jste vytvořili pro účely tohoto rychlého startu.

   

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ů, která se má odstranit, a pak vyberte Odstranit.

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

1. Přejděte ke svému účtu služby Azure Cosmos DB.
2. Otevřete Průzkumníka dat, vyberte další (...) pro databázi, kterou chcete odstranit, a vyberte Odstranit databázi.
3. Zadejte ID databáze nebo název databáze a potvrďte operaci odstranění.

Další kroky

Do účtu služby Azure Cosmos DB teď můžete importovat další data.

• Převod počtu virtuálních jader nebo virtuálních procesorů v nerelační databázi na RU/s služby Azure Cosmos DB
• Odhad RU/s pomocí plánovače kapacity služby Azure Cosmos DB – ROZHRANÍ API pro NoSQL