rychlý start: vytvoření aplikace Java pro správu dat Azure Cosmos DB rozhraní API pro tabulky

Článek
11/24/2021
7 min ke čtení

PLATÍ pro: rozhraní API pro tabulky

v tomto rychlém startu vytvoříte účet Azure Cosmos DB rozhraní API pro tabulky a pomocí Průzkumník dat a aplikace Java naklonované ze GitHub vytvoříte tabulky a entity. 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í.

Požadavky

Účet Azure s aktivním předplatným. Vytvořte si ho zdarma. nebo vyzkoušejte Azure Cosmos DB zdarma bez předplatného Azure. můžete také použít Azure Cosmos DB Emulator s identifikátorem URI https://localhost:8081 a klíčem C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw== .
Java Development Kit (JDK) 8. Najeďte JAVA_HOME proměnnou prostředí na složku, ve které je nainstalovaná JDK.
Binární archiv Maven
Git.

Vytvoření účtu databáze

Důležité

Abyste mohli pracovat s obecně dostupnými sadami Table API SDK, musíte si vytvořit nový účet Table API. Obecně dostupné sady SDK nepodporují účty Table API vytvořené během období Preview.

V novém okně prohlížeče se přihlaste k webu Azure Portal.
V nabídce vlevo vyberte vytvořit prostředek.
na stránce nový vyberte databáze > Azure Cosmos DB.

na stránce vytvořit Azure Cosmos DB účet zadejte nastavení pro nový účet Azure Cosmos DB.

Nastavení	Hodnota	Popis
Předplatné	Vaše předplatné	Vyberte předplatné Azure, které chcete pro tento účet služby Azure Cosmos DB použít.
Skupina prostředků	Vytvořit nový a potom název účtu	Vyberte, že chcete vytvořit novou IP adresu. Pak zadejte nový název skupiny prostředků pro váš účet. pro jednoduchost použijte stejný název jako název účtu Azure Cosmos DB.
Account Name	Jedinečný název	Zadejte jedinečný název, který identifikuje váš účet služby Azure Cosmos DB. Název účtu může obsahovat jenom malá písmena, číslice a spojovníky (-) a musí mít délku 3 až 44 znaků.
rozhraní API	Tabulka	Rozhraní API určuje typ účtu, který se má vytvořit. Azure Cosmos DB poskytuje pět rozhraní api: Core (SQL) pro databáze dokumentů, Gremlin pro databáze grafů, MongoDB pro databáze dokumentů, tabulku Azure a Cassandra. Pro každé rozhraní API musíte vytvořit samostatný účet. Vyberte tabulka Azure, protože v tomto rychlém startu vytváříte tabulku, která funguje s rozhraní API pro tabulky. Přečtěte si další informace o rozhraní API pro tabulky.
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 nejbližší, abyste jim zajistili nejrychlejší přístup k datům.
Režim kapacity	Zřízená propustnost nebo bez serveru	Vyberte zřízenou propustnost a vytvořte účet v režimu zřízené propustnosti . Pokud chcete vytvořit účet v režimu bez serveru , vyberte možnost bez serveru .

Můžete ponechat možnosti pro zápis geografické redundance a více oblastí na Zakázat , abyste se vyhnuli dalším poplatkům, a přeskočíte části síť a značky .

Vyberte zkontrolovat + vytvořit. Po dokončení ověření vyberte vytvořit a vytvořte účet.
Vytvoření účtu trvá několik minut. Zobrazí se zpráva s informací o tom, že probíhá vaše nasazení. Počkejte, až se nasazení dokončí, a pak vyberte Přejít k prostředku.

Přidání tabulky

Teď můžete pomocí nástroje Průzkumník dat na webu Azure Portal vytvořit databázi a tabulku.

Vyberte Průzkumník dat > New Table (Nová tabulka).

Úplně vpravo se zobrazí oblast Přidat tabulku. Pokud ji nevidíte, možná se budete muset posunout doprava.

Na stránce Přidat tabulku zadejte nastavení pro novou tabulku.

Nastavení	Navrhovaná hodnota	Popis
ID tabulky	sample-table	ID vaší nové tabulky. Názvy tabulek mají stejné požadavky na znaky jako ID databází. Názvy databází musí mít délku 1 až 255 znaků a nesmí obsahovat znaky `/ \ # ?` ani koncové mezery.
Propustnost	400 RU/s	Změňte propustnost na 400 jednotek žádostí za sekundu (RU/s). Pokud budete chtít snížit latenci, můžete propustnost později navýšit.

Vyberte OK.
Průzkumník dat zobrazí novou databázi a tabulku.

Přidání ukázkových dat

Teď můžete přidávat do nové tabulky data pomocí Průzkumníku dat.

V Průzkumník dat rozbalte položku Ukázka-Table, vyberte entity a pak vyberte Přidat entitu.
Nyní přidejte data do pole hodnota PartitionKey a do pole hodnota RowKey a vyberte Přidat entitu.

Teď můžete přidat další entity do tabulky, upravit si entity nebo zadat dotazy na data v Průzkumníku dat. V Průzkumníku dat také můžete škálovat propustnost a přidat do tabulky uložené procedury, uživatelsky definované funkce a aktivační události.

Klonování ukázkové aplikace

Teď naklonujeme aplikaci Table z GitHubu, nastavíme připojovací řetězec a spustíme ji. Přesvědčíte se, jak snadno se pracuje s daty prostřednictvím kódu programu.

Otevřete příkazový řádek, vytvořte novou složku git-samples a pak příkazový řádek zavřete.
```
md "C:\git-samples"
```
Otevřete okno terminálu Git, například Git Bash, a pomocí příkazu cd přejděte do nové složky, do které chcete nainstalovat ukázkovou aplikaci.
```
cd "C:\git-samples"
```
Ukázkové úložiště naklonujete spuštěním následujícího příkazu. Tento příkaz vytvoří na vašem počítači kopii ukázkové aplikace.
```
git clone https://github.com/Azure-Samples/storage-table-java-getting-started.git 
```

Tip

podrobnější návod k podobnému kódu naleznete v článku ukázkový článek pro Cosmos DB rozhraní API pro tabulky .

Kontrola kódu

Tento krok je volitelný. 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. V opačném případě můžete přeskočit k části aktualizace připojovacího řetězce v tomto dokumentu.

Následující kód ukazuje, jak vytvořit tabulku v rámci Azure Storage:

private static CloudTable createTable(CloudTableClient tableClient, String tableName) throws StorageException, RuntimeException, IOException, InvalidKeyException,   IllegalArgumentException, URISyntaxException, IllegalStateException {

  // Create a new table
  CloudTable table = tableClient.getTableReference(tableName);
  try {
      if (table.createIfNotExists() == false) {
          throw new IllegalStateException(String.format("Table with name \"%s\" already exists.", tableName));
      }
  }
  catch (StorageException s) {
      if (s.getCause() instanceof java.net.ConnectException) {
          System.out.println("Caught connection exception from the client. If running with the default configuration please make sure you have started the storage emulator.");
      }
      throw s;
  }

  return table;
}

Následující kód ukazuje, jak vložit data do tabulky:

private static void batchInsertOfCustomerEntities(CloudTable table) throws StorageException {

// Create the batch operation
TableBatchOperation batchOperation1 = new TableBatchOperation();
for (int i = 1; i <= 50; i++) {
    CustomerEntity entity = new CustomerEntity("Smith", String.format("%04d", i));
    entity.setEmail(String.format("smith%04d@contoso.com", i));
    entity.setHomePhoneNumber(String.format("425-555-%04d", i));
    entity.setWorkPhoneNumber(String.format("425-556-%04d", i));
    batchOperation1.insertOrMerge(entity);
}

// Execute the batch operation
table.execute(batchOperation1);
}

Následující kód ukazuje, jak zadávat dotazy na data z tabulky:

private static void partitionScan(CloudTable table, String partitionKey) throws StorageException {

    // Create the partition scan query
    TableQuery<CustomerEntity> partitionScanQuery = TableQuery.from(CustomerEntity.class).where(
        (TableQuery.generateFilterCondition("PartitionKey", QueryComparisons.EQUAL, partitionKey)));

    // Iterate through the results
    for (CustomerEntity entity : table.execute(partitionScanQuery)) {
        System.out.println(String.format("\tCustomer: %s,%s\t%s\t%s\t%s", entity.getPartitionKey(), entity.getRowKey(), entity.getEmail(), entity.getHomePhoneNumber(), entity.  getWorkPhoneNumber()));
    }
}

Následující kód ukazuje, jak odstranit data z tabulky:


System.out.print("\nDelete any tables that were created.");

if (table1 != null && table1.deleteIfExists() == true) {
    System.out.println(String.format("\tSuccessfully deleted the table: %s", table1.getName()));
}

if (table2 != null && table2.deleteIfExists() == true) {
    System.out.println(String.format("\tSuccessfully deleted the table: %s", table2.getName()));
}

Aktualizace připojovacího řetězce

Teď se vraťte zpátky na portál Azure Portal, kde najdete informace o připojovacím řetězci, a zkopírujte je do aplikace. Tím aplikaci umožníte komunikovat s hostovanou databází.

v Azure Cosmos DB účtu v Azure Portalvyberte připojovací řetězec.
Pomocí tlačítka pro kopírování na pravé straně zkopírujte PRIMÁRNÍ PŘIPOJOVACÍ ŘETĚZEC.
Otevřete soubor config. Properties ze složky C:\git-samples\storage-Table-Java-Getting-started\src\main\resources .

Okomentujte první řádek a zrušte komentář na druhém řádku. První dva řádky by teď měly vypadat takto.

#StorageConnectionString = UseDevelopmentStorage=true
StorageConnectionString = DefaultEndpointsProtocol=https;AccountName=[ACCOUNTNAME];AccountKey=[ACCOUNTKEY]

Vložte PRIMÁRNÍ PŘIPOJOVACÍ ŘETĚZEC z portálu do hodnoty StorageConnectionString na řádku 2.

Důležité

Pokud váš koncový bod používá adresu documents.azure.com, znamená to, že máte účet Preview, a pokud chcete pracovat s obecně dostupnou sadou Table API SDK, musíte si vytvořit nový účet Table API.
Uložte soubor config. Properties .

Teď jste aktualizovali aplikaci a zadali do ní všechny informace potřebné ke komunikaci s Azure Cosmos DB.

Spuštění aplikace

V okně terminálu Git přejděte příkazem cd do složky storage-table-java-getting-started.
```
cd "C:\git-samples\storage-table-java-getting-started"
```
Spuštěním následujících příkazů v okně terminálu Git spusťte aplikaci Java.
```
mvn compile exec:java 
```
V okně konzoly se zobrazí přidávání tabulkových dat do nové databáze tabulek ve službě Azure Cosmos DB.

Nyní se můžete vrátit na Průzkumník dat a zobrazit, dotazovat, upravit a pracovat s těmito novými daty.

Ověření smluv SLA na webu Azure Portal

Tento Azure Portal monitoruje propustnost Cosmos DB účtu, úložiště, dostupnost, latenci a konzistenci vašeho účtu. Grafy metrik přidružených k Azure Cosmos DB smlouva SLA (SLA) zobrazují hodnotu SLA v porovnání se skutečným výkonem. Díky této metrice je monitorování smluv SLA transparentní.

Kontrola metrik a smluv SLA:

V navigační nabídce vašeho Cosmos DB účtu vyberte Metriky.
Vyberte kartu, například Latence, a vpravo vyberte časový rámec. Porovnejte čáry Actual (Skutečný) a SLA (Sla) v grafech.
Zkontrolujte metriky na ostatních kartách.

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ů:

Na panelu hledání Azure Portal vyhledejte a vyberte skupiny prostředků.
V seznamu vyberte skupinu prostředků, kterou jste vytvořili pro tento rychlý Start.
Na stránce Přehled skupiny prostředků vyberte Odstranit skupinu prostředků.
V dalším okně zadejte název skupiny prostředků, kterou chcete odstranit, a pak vyberte Odstranit.

Další kroky

v tomto rychlém startu jste zjistili, jak vytvořit účet Azure Cosmos DB, vytvořit tabulku pomocí Průzkumník dat a spustit aplikaci Java pro přidání dat tabulky. Teď můžete zadávat dotazy na svá data pomocí rozhraní API tabulky.

Import tabulkových dat do rozhraní Table API