Rychlý Start: Vytvoření aplikace Java pro správu Azure Cosmos DB dat rozhraní SQL APIQuickstart: Build a Java app to manage Azure Cosmos DB SQL API data

V tomto rychlém startu vytvoříte a spravujete Azure Cosmos DB účet rozhraní SQL API z Azure Portal a pomocí aplikace Java naklonované z GitHubu.In this quickstart, you create and manage an Azure Cosmos DB SQL API account from the Azure portal, and by using a Java app cloned from GitHub. Nejdřív vytvoříte Azure Cosmos DB účet rozhraní SQL API pomocí Azure Portal a pak vytvoříte aplikaci Java pomocí SQL Java SDK a potom do svého účtu Cosmos DB přidáte prostředky pomocí aplikace Java.First, you create an Azure Cosmos DB SQL API account using the Azure portal, then create a Java app using the SQL Java SDK, and then add resources to your Cosmos DB account by using the Java application. Azure Cosmos DB je databázová služba pro více modelů, která umožňuje rychle vytvářet a dotazovat databáze dokumentů, tabulek, klíčových hodnot a grafů s funkcemi globální distribuce a horizontálního škálování.Azure Cosmos DB is a multi-model database service that lets you quickly create and query document, table, key-value, and graph databases with global distribution and horizontal scale capabilities.

Důležité

Tento rychlý Start je určen pouze pro Azure Cosmos DB Java SDK v4.This quickstart is for Azure Cosmos DB Java SDK v4 only. Další informace najdete v Azure Cosmos DB zpráva k vydání verzeJava SDK v4, úložiště pro Maven, Azure Cosmos DB tipy pro výkonJava SDK v4 a Azure Cosmos DB Průvodce řešením potíží se sadou Java SDK v4.Please view the Azure Cosmos DB Java SDK v4 Release notes, Maven repository, Azure Cosmos DB Java SDK v4 performance tips, and Azure Cosmos DB Java SDK v4 troubleshooting guide for more information. Pokud aktuálně používáte starší verzi než v4, přečtěte si článek průvodce migrací do Azure Cosmos DB Java SDK v4 , který vám pomůže s upgradem na V4.If you are currently using an older version than v4, see the Migrate to Azure Cosmos DB Java SDK v4 guide for help upgrading to v4.

PožadavkyPrerequisites

Úvodní poznámkyIntroductory notes

Struktura Cosmos DB účtuThe structure of a Cosmos DB account. Bez ohledu na rozhraní API nebo programovací jazyk, Cosmos DB účet obsahuje nula nebo více databází, databáze (DB) obsahuje nula nebo více kontejnerůa kontejner obsahuje nula nebo více položek, jak je znázorněno na následujícím obrázku:Irrespective of API or programming language, a Cosmos DB account contains zero or more databases, a database (DB) contains zero or more containers, and a container contains zero or more items, as shown in the diagram below:

Entity účtu Azure Cosmos

Další informace o databázích, kontejnerech a položkách si můžete přečíst tady.You may read more about databases, containers and items here. Na úrovni kontejneru je definováno několik důležitých vlastností, mezi kterými je zřízena propustnost a klíč oddílu.A few important properties are defined at the level of the container, among them provisioned throughput and partition key.

Zřízená propustnost se měří v jednotkách žádosti (ru), které mají peněžní cenu, a jsou zásadním rozhodujícím faktorem za provozní náklady na účet.The provisioned throughput is measured in Request Units (RUs) which have a monetary price and are a substantial determining factor in the operating cost of the account. Zřízenou propustnost lze vybrat v členitosti podle kontejneru nebo členitosti na databázi, ale obvykle je upřednostňována specifikace propustnosti na úrovni kontejneru.Provisioned throughput can be selected at per-container granularity or per-database granularity, however container-level throughput specification is typically preferred. Další informace o zřizování propustnosti si můžete přečíst tady.You may read more about throughput provisioning here.

Když jsou položky vloženy do kontejneru Cosmos DB, databáze se poroste vodorovně přidáním dalšího úložiště a výpočetních prostředků pro zpracování požadavků.As items are inserted into a Cosmos DB container, the database grows horizontally by adding more storage and compute to handle requests. Kapacita úložiště a výpočetní kapacity se přidávají do diskrétních jednotek označovaných jako oddílya Vy musíte zvolit jedno pole v dokumentu, které bude mít klíč oddílu, který mapuje jednotlivé dokumenty na oddíl.Storage and compute capacity are added in discrete units known as partitions, and you must choose one field in your documents to be the partition key which maps each document to a partition. Způsob správy oddílů je, že každý oddíl má přiřazený zhruba stejný řez mimo rozsah hodnot klíče oddílu; Proto doporučujeme zvolit klíč oddílu, který je relativně náhodný nebo rovnoměrně distribuovaný.The way partitions are managed is that each partition is assigned a roughly equal slice out of the range of partition key values; therefore you are advised to choose a partition key which is relatively random or evenly-distributed. V opačném případě některé oddíly uvidí podstatně více požadavků (aktivní oddíl), zatímco ostatní oddíly jsou v podstatě méně požadavků (studený oddíl) a že se to vyhne.Otherwise, some partitions will see substantially more requests (hot partition) while other partitions see substantially fewer requests (cold partition), and this is to be avoided. Tadyse můžete dozvědět víc o vytváření oddílů.You may learn more about partitioning here.

Vytvoření účtu databázeCreate a database account

Než budete moci vytvořit databázi dokumentů, je potřeba pomocí služby Azure Cosmos DB vytvořit účet rozhraní SQL API.Before you can create a document database, you need to create a SQL API account with Azure Cosmos DB.

  1. V nabídce Azure Portal nebo na domovské stráncevyberte vytvořit prostředek.From the Azure portal menu or the Home page, select Create a resource.

  2. Na nové stránce vyhledejte a vyberte Azure Cosmos DB.On the New page, search for and select Azure Cosmos DB.

  3. Na stránce Azure Cosmos DB vyberte vytvořit.On the Azure Cosmos DB page, select Create.

  4. Na stránce vytvořit Azure Cosmos DB účet zadejte základní nastavení pro nový účet Azure Cosmos.On the Create Azure Cosmos DB Account page, enter the basic settings for the new Azure Cosmos account.

    NastaveníSetting HodnotaValue PopisDescription
    PředplatnéSubscription Název předplatnéhoSubscription name Vyberte předplatné Azure, které chcete použít pro tento účet Azure Cosmos.Select the Azure subscription that you want to use for this Azure Cosmos account.
    Skupina prostředkůResource Group Název skupiny prostředkůResource group name Vyberte skupinu prostředků nebo vyberte vytvořit novéa zadejte jedinečný název nové skupiny prostředků.Select a resource group, or select Create new, then enter a unique name for the new resource group.
    Account NameAccount Name Jedinečný názevA unique name Zadejte název, který identifikuje váš účet Azure Cosmos.Enter a name to identify your Azure Cosmos account. Vzhledem k tomu, že Documents.Azure.com je připojen k názvu, který zadáte k vytvoření identifikátoru URI, použijte jedinečný název.Because documents.azure.com is appended to the name that you provide to create your URI, use a unique name.

    Název může obsahovat jenom malá písmena, číslice a znak spojovníku (-).The name can only contain lowercase letters, numbers, and the hyphen (-) character. Musí mít délku 3-44 znaků.It must be between 3-44 characters in length.
    Rozhraní APIAPI Typ účtu, který se má vytvořitThe type of account to create Vyberte Core (SQL) pro vytvoření databáze dokumentů a dotaz pomocí syntaxe SQL.Select Core (SQL) to create a document database and query by using SQL syntax.

    Rozhraní API určuje typ účtu, který se má vytvořit.The API determines the type of account to create. Azure Cosmos DB poskytuje pět rozhraní API: Core (SQL) a MongoDB pro data dokumentů, Gremlin pro data grafu, tabulku Azure a Cassandra.Azure Cosmos DB provides five APIs: Core (SQL) and MongoDB for document data, Gremlin for graph data, Azure Table, and Cassandra. V současné době musíte pro každé rozhraní API vytvořit samostatný účet.Currently, you must create a separate account for each API.
    Použít slevu úrovně FreeApply Free Tier Discount Použít nebo nepoužítApply or Do not apply U Azure Cosmos DB úrovně Free získáte v účtu první 400 RU/s a 5 GB úložiště zdarma.With Azure Cosmos DB free tier, you will get the first 400 RU/s and 5 GB of storage for free in an account. Přečtěte si další informace o bezplatné úrovni.Learn more about free tier.
    UmístěníLocation Oblast nejbližší vašim uživatelůmThe region closest to your users Vyberte zeměpisné umístění, ve kterém chcete účet služby Azure Cosmos DB hostovat.Select a geographic location to host your Azure Cosmos DB account. Použijte umístění, které je nejblíže vašim uživatelům, a poskytněte jim tak nejrychlejší přístup k datům.Use the location that is closest to your users to give them the fastest access to the data.
    Typ účtuAccount Type Produkční nebo neprodukčníProduction or Non-Production Vyberte možnost produkce , pokud se účet bude používat pro produkční úlohy.Select Production if the account will be used for a production workload. Vyberte neprodukční , pokud se účet bude používat pro neprodukční, třeba pro vývoj, testování, kontrolu kvality nebo přípravu.Select Non-Production if the account will be used for non-production, e.g. development, testing, QA, or staging. Toto je nastavení značky prostředku Azure, které vystavuje možnosti portálu, ale nemá vliv na příslušný účet Azure Cosmos DB.This is an Azure resource tag setting that tunes the Portal experience but does not affect the underlying Azure Cosmos DB account. Tuto hodnotu můžete kdykoli změnit.You can change this value anytime.

    Poznámka

    V rámci předplatného Azure můžete mít až jednu úroveň bezplatného Azure Cosmos DB účtu a při vytváření účtu musíte souhlasit.You can have up to one free tier Azure Cosmos DB account per Azure subscription and must opt-in when creating the account. Pokud nevidíte možnost použít slevu úrovně Free, znamená to, že v předplatném už je povolený jiný účet s úrovní Free.If you do not see the option to apply the free tier discount, this means another account in the subscription has already been enabled with free tier.

    Stránka nového účtu pro službu Azure Cosmos DB

  5. Vyberte Zkontrolovat a vytvořit.Select Review + create. Můžete přeskočit oddíly síť a značky .You can skip the Network and Tags sections.

  6. Zkontrolujte nastavení účtu a pak vyberte vytvořit.Review the account settings, and then select Create. Vytvoření účtu trvá několik minut.It takes a few minutes to create the account. Počkejte, než se na stránce portálu zobrazí dokončené vaše nasazení.Wait for the portal page to display Your deployment is complete.

    Podokno Oznámení portálu Azure Portal

  7. Vyberte Přejít k prostředku a přejdete na stránku Azure Cosmos DB účet.Select Go to resource to go to the Azure Cosmos DB account page.

    Stránka Azure Cosmos DB účtu

Přidání kontejneruAdd a container

Nyní můžete použít nástroj Průzkumník dat v Azure Portal k vytvoření databáze a kontejneru.You can now use the Data Explorer tool in the Azure portal to create a database and container.

  1. Vyberte Průzkumník dat > Nový kontejner.Select Data Explorer > New Container.

    Úplně vpravo se zobrazí oblast Přidat kontejner , možná se budete muset posunout doprava, aby se zobrazila.The Add Container area is displayed on the far right, you may need to scroll right to see it.

    Průzkumník dat na portálu Azure Portal – podokno Přidat kontejner

  2. Na stránce Přidat kontejner zadejte nastavení pro nový kontejner.In the Add container page, enter the settings for the new container.

    NastaveníSetting Navrhovaná hodnotaSuggested value PopisDescription
    ID databázeDatabase ID ÚlohyTasks Jako název nové databáze zadejte Tasks.Enter Tasks as the name for the new database. Názvy databází musí obsahovat 1 až 255 znaků a nesmí obsahovat ani mezeru /, \\, #, ? .Database names must contain from 1 through 255 characters, and they cannot contain /, \\, #, ?, or a trailing space. Ověřte možnost zřízení propustnosti databáze , která umožňuje sdílení propustnosti zřízené do databáze napříč všemi kontejnery v rámci databáze.Check the Provision database throughput option, it allows you to share the throughput provisioned to the database across all the containers within the database. Tato možnost také pomáhá při úsporách nákladů.This option also helps with cost savings.
    PropustnostThroughput 400400 Nechte propustnost na 400 jednotek žádostí za sekundu (RU/s).Leave the throughput at 400 request units per second (RU/s). Pokud budete chtít snížit latenci, můžete propustnost později navýšit.If you want to reduce latency, you can scale up the throughput later.
    ID kontejneruContainer ID Items (Položky)Items Jako název nového kontejneru zadejte položky .Enter Items as the name for your new container. Pro ID kontejnerů platí stejné požadavky týkající se použitých znaků jako pro názvy databází.Container IDs have the same character requirements as database names.
    Klíč oddíluPartition key /kategorie/category Ukázka popsaná v tomto článku používá jako klíč oddílu /Category .The sample described in this article uses /category as the partition key.

    Kromě předchozích nastavení můžete volitelně přidat jedinečné klíče pro kontejner.In addition to the preceding settings, you can optionally add Unique keys for the container. V tomto příkladu ponecháme toto pole prázdné.Let's leave the field empty in this example. Jedinečné klíče umožňují vývojářům přidat do databáze vrstvu integrity dat.Unique keys provide developers with the ability to add a layer of data integrity to the database. Vytvořením jedinečné zásady klíčů při vytváření kontejneru zajistíte jedinečnost jedné nebo více hodnot na klíč oddílu.By creating a unique key policy while creating a container, you ensure the uniqueness of one or more values per partition key. Další informace najdete v článku Jedinečné klíče ve službě Azure Cosmos DB.To learn more, refer to the Unique keys in Azure Cosmos DB article.

    Vyberte OK.Select OK. Průzkumník dat zobrazí novou databázi a kontejner.The Data Explorer displays the new database and container.

Přidání ukázkových datAdd sample data

Nyní můžete přidat data do nového kontejneru pomocí Průzkumník dat.You can now add data to your new container using Data Explorer.

  1. Z Průzkumník datrozbalte databázi Tasks , rozbalte kontejner položky .From the Data Explorer, expand the Tasks database, expand the Items container. Vyberte položku a pakvyberte možnost Nová položka.Select Items, and then select New Item.

    Vytváření nových dokumentů v Průzkumníku dat na webu Azure Portal

  2. Nyní do kontejneru přidejte dokument s následující strukturou.Now add a document to the container with the following structure.

    {
        "id": "1",
        "category": "personal",
        "name": "groceries",
        "description": "Pick up apples and strawberries.",
        "isComplete": false
    }
    
  3. Po přidání JSON na kartu dokumenty vyberte Save (Uložit).Once you've added the json to the Documents tab, select Save.

    Zkopírujte data JSON a vyberte Uložit v Průzkumník dat Azure Portal

  4. Vytvořte a uložte ještě jeden dokument, ve kterém vložíte jedinečnou hodnotu pro vlastnost id a změníte ostatní vlastnosti podle svých potřeb.Create and save one more document where you insert a unique value for the id property, and change the other properties as you see fit. Nové dokumenty můžou mít jakoukoli strukturu, protože Azure Cosmos DB neuplatňuje pro data žádné schéma.Your new documents can have any structure you want as Azure Cosmos DB doesn't impose any schema on your data.

Dotazování datQuery your data

K načtení a filtrování dat můžete použít dotazy v Průzkumník dat.You can use queries in Data Explorer to retrieve and filter your data.

  1. V horní části karty položky v Průzkumník dat zkontrolujte výchozí dotaz SELECT * FROM c .At the top of the Items tab in Data Explorer, review the default query SELECT * FROM c. Tento dotaz načte a zobrazí všechny dokumenty z kontejneru seřazené podle ID.This query retrieves and displays all documents from the container ordered by ID.

    Výchozí dotaz v Průzkumník dat je SELECT * FROM c

  2. Chcete-li změnit dotaz, vyberte možnost Upravit filtr, nahraďte výchozí dotaz hodnotou ORDER BY c._ts DESC a potom vyberte možnost použít filtr.To change the query, select Edit Filter, replace the default query with ORDER BY c._ts DESC, and then select Apply Filter.

    Změna výchozího dotazu přidáním „ORDER BY c._ts DESC“ a kliknutím na Použít filtr

    Upravený dotaz zobrazuje dokumenty v sestupném pořadí podle jejich časového razítka, takže teď je druhý dokument uvedený jako první.The modified query displays the documents in descending order based on their time stamp, so now your second document is listed first.

    Dotaz se změnil na ORDER BY c. _ts DESC a klikněte na použít filtr.

Pokud jste obeznámeni se syntaxí SQL, můžete do pole predikátu dotazu zadat všechny podporované dotazy SQL .If you're familiar with SQL syntax, you can enter any supported SQL queries in the query predicate box. Průzkumník dat můžete použít také k vytváření uložených procedur, UDF a triggerů pro serverovou obchodní logiku.You can also use Data Explorer to create stored procedures, UDFs, and triggers for server-side business logic.

Průzkumník dat poskytuje snadný Azure Portal přístup ke všem integrovaným funkcím pro přístup k programovým datům dostupným v rozhraních API.Data Explorer provides easy Azure portal access to all of the built-in programmatic data access features available in the APIs. Portál se používá také ke škálování propustnosti, získání klíčů a připojovacích řetězců a ke kontrole metrik a SLA pro váš účet Azure Cosmos DB.You also use the portal to scale throughput, get keys and connection strings, and review metrics and SLAs for your Azure Cosmos DB account.

Klonování ukázkové aplikaceClone the sample application

Teď přejděme k práci s kódem.Now let's switch to working with code. Naklonujeme aplikaci SQL API z GitHubu, nastavíme připojovací řetězec a spustíme ji.Let's clone a SQL API app from GitHub, set the connection string, and run it. Přesvědčíte se, jak snadno se pracuje s daty prostřednictvím kódu programu.You'll see how easy it is to work with data programmatically.

Ukázkové úložiště naklonujete spuštěním následujícího příkazu.Run the following command to clone the sample repository. Tento příkaz vytvoří na vašem počítači kopii ukázkové aplikace.This command creates a copy of the sample app on your computer.

git clone https://github.com/Azure-Samples/azure-cosmos-java-getting-started.git

Kontrola kóduReview the code

Tento krok je volitelný.This step is optional. Pokud chcete zjistit, jak se v kódu vytvářejí prostředky databáze, můžete si prohlédnout následující fragmenty kódu.If you're interested in learning how the database resources are created in the code, you can review the following snippets. Jinak můžete přeskočit přímo k části Spuštění aplikace.Otherwise, you can skip ahead to Run the app .

Správa databázových prostředků pomocí synchronního (synchronizačního) rozhraní APIManaging database resources using the synchronous (sync) API

  • Inicializace klienta CosmosClient.CosmosClient initialization. CosmosClientPoskytuje logickou reprezentaci na straně klienta pro službu Azure Cosmos Database.The CosmosClient provides client-side logical representation for the Azure Cosmos database service. Tento klient slouží ke konfiguraci a provádění požadavků na službu.This client is used to configure and execute requests against the service.

    client = new CosmosClientBuilder()
        .endpoint(AccountSettings.HOST)
        .key(AccountSettings.MASTER_KEY)
        //  Setting the preferred location to Cosmos DB Account region
        //  West US is just an example. User should set preferred location to the Cosmos DB region closest to the application
        .preferredRegions(Collections.singletonList("West US"))
        .consistencyLevel(ConsistencyLevel.EVENTUAL)
        .buildClient();
    
    
  • CosmosDatabasevytvořena.CosmosDatabase creation.

    CosmosDatabaseResponse cosmosDatabaseResponse = client.createDatabaseIfNotExists(databaseName);
    database = client.getDatabase(cosmosDatabaseResponse.getProperties().getId());
    
  • CosmosContainervytvořena.CosmosContainer creation.

    CosmosContainerProperties containerProperties =
        new CosmosContainerProperties(containerName, "/lastName");
    
    //  Create container with 400 RU/s
    CosmosContainerResponse cosmosContainerResponse =
        database.createContainerIfNotExists(containerProperties, ThroughputProperties.createManualThroughput(400));
    container = database.getContainer(cosmosContainerResponse.getProperties().getId());
    
  • Vytvoření položky pomocí createItem metody.Item creation by using the createItem method.

    //  Create item using container that we created using sync client
    
    //  Use lastName as partitionKey for cosmos item
    //  Using appropriate partition key improves the performance of database operations
    CosmosItemRequestOptions cosmosItemRequestOptions = new CosmosItemRequestOptions();
    CosmosItemResponse<Family> item = container.createItem(family, new PartitionKey(family.getLastName()), cosmosItemRequestOptions);
    
  • Čtení bodů se provádí pomocí readItem metody.Point reads are performed using readItem method.

    try {
        CosmosItemResponse<Family> item = container.readItem(family.getId(), new PartitionKey(family.getLastName()), Family.class);
        double requestCharge = item.getRequestCharge();
        Duration requestLatency = item.getDuration();
        System.out.println(String.format("Item successfully read with id %s with a charge of %.2f and within duration %s",
            item.getItem().getId(), requestCharge, requestLatency));
    } catch (CosmosException e) {
        e.printStackTrace();
        System.err.println(String.format("Read Item failed with %s", e));
    }
    
  • Dotazy SQL přes JSON se provádějí pomocí queryItems metody.SQL queries over JSON are performed using the queryItems method.

    // Set some common query options
    CosmosQueryRequestOptions queryOptions = new CosmosQueryRequestOptions();
    //queryOptions.setEnableCrossPartitionQuery(true); //No longer necessary in SDK v4
    //  Set query metrics enabled to get metrics around query executions
    queryOptions.setQueryMetricsEnabled(true);
    
    CosmosPagedIterable<Family> familiesPagedIterable = container.queryItems(
        "SELECT * FROM Family WHERE Family.lastName IN ('Andersen', 'Wakefield', 'Johnson')", queryOptions, Family.class);
    
    familiesPagedIterable.iterableByPage(10).forEach(cosmosItemPropertiesFeedResponse -> {
        System.out.println("Got a page of query result with " +
            cosmosItemPropertiesFeedResponse.getResults().size() + " items(s)"
            + " and request charge of " + cosmosItemPropertiesFeedResponse.getRequestCharge());
    
        System.out.println("Item Ids " + cosmosItemPropertiesFeedResponse
            .getResults()
            .stream()
            .map(Family::getId)
            .collect(Collectors.toList()));
    });
    

Spuštění aplikaceRun the app

Teď se vraťte zpět na web Azure Portal, kde najdete informace o připojovacím řetězci, a spusťte aplikaci s použitím informací o vašem koncovém bodu.Now go back to the Azure portal to get your connection string information and launch the app with your endpoint information. Tím aplikaci umožníte komunikovat s hostovanou databází.This enables your app to communicate with your hosted database.

  1. V okně terminálu Git přejděte pomocí příkazu cd do složky se vzorovým kódem.In the git terminal window, cd to the sample code folder.

    cd azure-cosmos-java-getting-started
    
  2. V okně terminálu Git pomocí následujícího příkazu nainstalujte požadované balíčky Java.In the git terminal window, use the following command to install the required Java packages.

    mvn package
    
  3. V okně terminálu Git pomocí následujícího příkazu spusťte aplikaci Java (nahraďte SYNCASYNCMODE parametrem sync nebo async v závislosti na tom, který vzorový kód chcete spustit, nahraďte YOUR_COSMOS_DB_HOSTNAME hodnotou identifikátoru URI v uvozovkách z portálu a nahraďte YOUR_COSMOS_DB_MASTER_KEY za primární klíč z portálu.)In the git terminal window, use the following command to start the Java application (replace SYNCASYNCMODE with sync or async depending on which sample code you would like to run, replace YOUR_COSMOS_DB_HOSTNAME with the quoted URI value from the portal, and replace YOUR_COSMOS_DB_MASTER_KEY with the quoted primary key from portal)

    mvn exec:java@SYNCASYNCMODE -DACCOUNT_HOST=YOUR_COSMOS_DB_HOSTNAME -DACCOUNT_KEY=YOUR_COSMOS_DB_MASTER_KEY
    
    

    V okně terminálu se zobrazí oznámení o vytvoření databáze FamilyDB.The terminal window displays a notification that the FamilyDB database was created.

  4. Aplikace vytvoří databázi s názvem.AzureSampleFamilyDBThe app creates database with name AzureSampleFamilyDB

  5. Aplikace vytvoří kontejner s názvem.FamilyContainerThe app creates container with name FamilyContainer

  6. Aplikace provede čtení bodů pomocí ID objektů a hodnoty klíče oddílu (což je lastName v naší ukázce).The app will perform point reads using object IDs and partition key value (which is lastName in our sample).

  7. Aplikace se bude dotazovat na položky a načíst všechny rodiny s posledním názvem v (' Andersen ', ' Wakefieldů ', ' Johnsonem ').The app will query items to retrieve all families with last name in ('Andersen', 'Wakefield', 'Johnson')

  8. Aplikace neodstraňuje vytvořené prostředky.The app doesn't delete the created resources. Přepněte zpět na portál a vyčistěte prostředkySwitch back to the portal to clean up the resources. ze svého účtu, aby se vám za ně neúčtovaly poplatky.from your account so that you don't incur charges.

Ověření smluv SLA na webu Azure PortalReview SLAs in the Azure portal

Azure Portal sleduje propustnost účtu Cosmos DB, úložiště, dostupnost, latenci a konzistenci.The Azure portal monitors your Cosmos DB account throughput, storage, availability, latency, and consistency. Grafy pro metriky přidružené k Azure Cosmos DB smlouva SLA (SLA) ukazují hodnotu SLA v porovnání s skutečným výkonem.Charts for metrics associated with an Azure Cosmos DB Service Level Agreement (SLA) show the SLA value compared to actual performance. Tato sada metrik umožňuje monitorovat SLA transparentním způsobem.This suite of metrics makes monitoring your SLAs transparent.

Postup kontroly metrik a SLA:To review metrics and SLAs:

  1. V navigační nabídce účtu Cosmos DB vyberte metriky .Select Metrics in your Cosmos DB account's navigation menu.

  2. Vyberte kartu, jako je latence, a vyberte časový rámec na pravé straně.Select a tab such as Latency, and select a timeframe on the right. Porovnejte skutečné řádky a řádky SLA v grafech.Compare the Actual and SLA lines on the charts.

    Sada metrik Azure Cosmos DB

  3. Projděte si metriky na dalších kartách.Review the metrics on the other tabs.

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

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.When you're done with your app and Azure Cosmos DB account, you can delete the Azure resources you created so you don't incur more charges. Odstranění prostředků:To delete the resources:

  1. Na panelu hledání Azure Portal vyhledejte a vyberte skupiny prostředků.In the Azure portal Search bar, search for and select Resource groups.

  2. V seznamu vyberte skupinu prostředků, kterou jste vytvořili pro tento rychlý Start.From the list, select the resource group you created for this quickstart.

    Vyberte skupinu prostředků, kterou chcete odstranit.

  3. Na stránce Přehled skupiny prostředků vyberte Odstranit skupinu prostředků.On the resource group Overview page, select Delete resource group.

    Odstranění skupiny prostředků

  4. V dalším okně zadejte název skupiny prostředků, kterou chcete odstranit, a pak vyberte Odstranit.In the next window, enter the name of the resource group to delete, and then select Delete.

Další krokyNext steps

V tomto rychlém startu jste se naučili, jak vytvořit Azure Cosmos DB účet rozhraní SQL API, vytvořit databázi dokumentů a kontejner pomocí Průzkumník dat a spustit aplikaci Java, která provede stejné věci programově.In this quickstart, you've learned how to create an Azure Cosmos DB SQL API account, create a document database and container using the Data Explorer, and run a Java app to do the same thing programmatically. Teď můžete do svého účtu Azure Cosmos DB importovat další data.You can now import additional data into your Azure Cosmos DB account.