Snabbstart: Skapa en diagramdatabas med Java SDK och Azure Azure Azures DB Gremlin API

GÄLLER FÖR: Gremlin API

I den här snabbstarten kan du skapa och hantera ett Azure Azure Azure Db Gremlin-konto (graph) API-konto från Azure-portalen och lägga till data genom att använda en Java-app klonad från GitHub. Azure Azure Azures DB är en databastjänst med flera modeller som gör att du snabbt kan skapa och frågedokument, tabeller, nyckelvärden och grafdatabaser med globala distributionsfunktioner och vågräta skalfunktioner.

Krav

Skapa ett databaskonto

Innan du kan skapa en diagramdatabas måste du skapa ett Gremlin-databaskonto (Graph) med Azure AzureS DB.

  1. Logga in på Azure-portalen i ett nytt webbläsarfönster.

  2. I den vänstra menyn väljer du Skapa en resurs.

    Skapa en resurs i Azure Portal

  3. På sidan Ny väljer du DatabaserAzure Azure Azures DB.

    Fönstret Azure Portal-databaser

  4. På sidan Create Azure Azures DB Account anger du inställningarna för det nya Azure Azure Azures DB-kontot.

    Inställning Värde Beskrivning
    Prenumeration Prenumerationsnamn Välj den Azure-prenumeration som du vill använda för det här Azure Azure-kontot.
    Resursgrupp Resursgruppnamn Välj en resursgrupp eller välj Skapa nyoch ange sedan ett unikt namn för den nya resursgruppen.
    Kontonamn Ange ett unikt namn Ange ett unikt namn för att identifiera ditt Azure Azure Azures DB-konto. Din konto-URI läggs gremlin.azure.com till i ditt unika kontonamn.

    Kontonamnet får endast använda gemener, siffror och bindestreck (-), och måste innehålla mellan 3 och 44 tecken.
    API Gremlin (diagram) API:t avgör vilken typ av konto som ska skapas. Azure Azure Azures DB innehåller fem API:er: Core (SQL) för dokumentdatabaser, Gremlin för graph-databaser, MongoDB för dokumentdatabaser, Azure Table ochAndra. Du måste skapa ett separat konto för varje API.

    Välj Gremlin (diagram)eftersom du i den här snabbstarten skapar en tabell som fungerar med Gremlin API.

    Läs mer om Gremlin API.
    Plats Den region som är närmast dina användare Välj en geografisk plats som värd för ditt Azure Azure Azures DB-konto. Använd den plats som är närmast dina användare för att ge dem snabb åtkomst till data.
    Kapacitetsläge Etablerat dataflöde eller serverlös Välj Etablerat dataflöde om du vill skapa ett konto i etablerat dataflödesläge. Välj Serverless om du vill skapa ett konto i serverlöst läge.
    Tillämpa Azure Azure Azures DB-rabatt på fri nivå Användeller Använd inte Med Azure Azure Azures DB-fri nivå får du de första 1000 RU/s och 25 GB lagringsutrymme kostnadsfritt i ett konto. Läs mer om kostnadsfri nivå.

    Obs!

    Du kan ha upp till en kostnadsfri nivå Azure Azure DB-konto per Azure-prenumeration och måste anmäla dig när du skapar kontot. Om du inte ser alternativet för att tillämpa den kostnadsfria nivårabatten innebär det att ett annat konto i prenumerationen redan har aktiverats med kostnadsfri nivå.

    Den nya kontosidan för Azure Azure Azures DB

  5. Konfigurera följande information på fliken Global distribution. Du kan lämna standardvärdena för den här snabbstartsvyn:

    Inställning Värde Beskrivning
    Geo-Redundancy Inaktivera Aktivera eller inaktivera global distribution på ditt konto genom att koppla ihop regionen med en parregion. Du kan lägga till fler regioner i ditt konto senare.
    Skriver flera regioner Inaktivera Med funktionen för flera regioner kan du dra nytta av det etablerade dataflödet för dina databaser och behållare över hela världen.

    Obs!

    Följande alternativ är inte tillgängliga om du väljer Serverless som kapacitetsläge:

    • Använd kostnadsfri nivårabatt
    • Georedundans
    • Skriver flera regioner
  6. Du kan även konfigurera ytterligare information på följande flikar:

  7. Välj Granska + skapa.

  8. Det tar några minuter att skapa kontot. Vänta tills portalen visar grattis! Din Azure Azures DB-konto har skapats sida.

    Skapad sida för Azure Azure Azures DB-konto

Lägga till ett diagram

Nu kan du använda verktyget Datautforskaren i Azure-portalen för att skapa en diagramdatabas.

  1. Välj Ny Graphi Datautforskaren.

    Området Graph visas längst till höger kan du behöva rulla till höger för att se det.

    Azure Portal Data Explorer, sidan Lägg Graph data

  2. Ange inställningarna för det nya diagrammet på sidan Lägg till diagram.

    Inställning Föreslaget värde Beskrivning
    Databas-ID exempeldatabas Ange exempeldatabas som namn på den nya databasen. Databasnamn måste bestå av mellan 1 och 255 tecken och får inte / \ # ? innehålla ett avslutande blanksteg.
    Dataflöde 400 RUs Ändra dataflödet till 400 begärandeenheter per sekund (RU/s). Om du vill minska svarstiden kan du skala upp dataflödet senare.
    Graph ID exempeldiagram Ange exempeldiagram som namn på den nya samlingen. Graph namn har samma teckenkrav som databas-ID.
    Partitionsnyckel /pk Alla Db-konton i Det här kontot behöver en partitionsnyckel för att skala vågrätt. Läs om hur du väljer lämplig partitionsnyckel i Graph om datapartitionering.
  3. När formuläret har fyllts i väljer du OK.

Klona exempelprogrammet

Nu byter vi till att arbeta med kod. Vi klonar en Gremlin API-app från GitHub, anger anslutningssträngen och kör den. Du ser hur enkelt det är att arbeta med data med hjälp av programmering.

  1. Öppna en kommandotolk, skapa en ny mapp med namnet git-samples och stäng sedan kommandotolken.

    md "C:\git-samples"
    
  2. Öppna ett git terminal-fönster, till exempel git bash, och använd kommandot för att byta till cd en mapp för att installera exempelappen.

    cd "C:\git-samples"
    
  3. Kör följande kommando för att klona exempelarkivet. Med det här kommandot skapas en kopia av exempelappen på datorn.

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

Granska koden

Det här steget är valfritt. Om du vill veta hur databasresurserna skapas i koden kan du granska följande avsnitt. Annars kan du gå vidare och uppdatera anslutningssträngen.

Följande kodstycken hämtas från filen C:\git-samples\azure-dens-db-graph-java-getting-started\src\GetStarted\Program.java.

Den här Java-konsolappen använder en Gremlin API-databas med OSS Apache TinkerPop-drivrutinen.

  • Gremlin initieras från konfigurationen i ClientClient

    cluster = Cluster.build(new File("src/remote.yaml")).create();
    ...
    client = cluster.connect();
    
  • Serier med Gremlin-steg utförs med client.submit metoden.

    ResultSet results = client.submit(gremlin);
    
    CompletableFuture<List<Result>> completableFutureResults = results.all();
    List<Result> resultList = completableFutureResults.get();
    
    for (Result result : resultList) {
        System.out.println(result.toString());
    }
    

Uppdatera anslutningsinformationen

Gå nu tillbaka till Azure Portal för att hämta anslutningsinformationen och kopiera in den i appen. De här inställningarna gör att appen kan kommunicera med din värddatabas.

  1. På ditt Azure Azures DB-konto i Azure-portalenväljer du Nycklar.

    Kopiera den första delen av URI-värdet.

    Visa och kopiera en snabbtangent i Azure-portalen, sidan Nycklar

  2. Öppna src/remote.yaml-filen och klistra in det unika ID-värdet i hosts: [$name$.graphs.azure.com] .

    Rad 1 i remote.yaml bör nu se ut ungefär så här

    hosts: [test-graph.graphs.azure.com]

  3. Ändra graphs till gremlin.cosmosdb i endpoint värdet. (Om du skapade ditt graph-databaskonto före 20 december 2017 gör du inga ändringar i slutpunktsvärdet och fortsätter till nästa steg.)

    Slutpunktsvärdet bör nu se ut så här:

    "endpoint": "https://testgraphacct.gremlin.cosmosdb.azure.com:443/"

  4. Använd knappen Kopiera i Azure-portalen för att kopiera PRIMÄRNYCKELN och klistra in den $masterKey$ i password: $masterKey$ .

    Rad 4 av remote.yaml bör nu se ut ungefär så här

    password: 2Ggkr662ifxz2Mg==

  5. Ändra rad 3 av remote.yaml från

    username: /dbs/$database$/colls/$collection$

    till

    username: /dbs/sample-database/colls/sample-graph

    Om du har använt ett unikt namn för exempeldatabasen eller diagrammet uppdaterar du värdena efter behov.

  6. Spara remote.yaml-filen.

Kör konsolappen

  1. I git terminal-fönstret, cd till mappen azure-gits-db-graph-java-getting-started.

    cd "C:\git-samples\azure-cosmos-db-graph-java-getting-started"
    
  2. Använd följande kommando i fönstret git terminal för att installera nödvändiga Java-paket.

    mvn package
    
  3. I fönstret git terminal använder du följande kommando för att starta Java-programmet.

    mvn exec:java -D exec.mainClass=GetStarted.Program
    

    I terminalfönstret visas de hörn som läggs till i diagrammet.

    Om det uppstår timeout-fel kontrollerar du att du har uppdaterat anslutningsinformationen korrekt i Uppdatera anslutningsinformationen ochförsöker även köra det senaste kommandot igen.

    När programmet avslutas väljer du Retur och växlar sedan tillbaka till Azure Portal i webbläsaren.

Granska och lägga till exempeldata

Nu kan du gå tillbaka till Datautforskaren och se vilka hörn som lagts till i diagrammet och lägga till ytterligare datapunkter.

  1. På ditt Azure Azure Azures DB-konto i Azure-portalenväljer du Data Explorer, expandera exempeldiagram , Graphoch sedan Använd filter.

    Skärmbilden visar Graph markerat i A P I med alternativet Använd filter.

  2. Lägg märke till de nya användarna som lagts till i diagrammet i listan Resultat. Välj ben och observera att användaren är ansluten till Robin. Du kan flytta runt hörnen genom att dra och släppa, zooma in och ut genom att rulla med musens hjul och expandera grafens storlek med dubbelpilen.

    Nya hörn i diagrammet i Datautforskaren i Azure-portalen

  3. Nu lägger vi till några nya användare. Välj Nytt brytpunkt för att lägga till data i diagrammet.

    Skärmbilden visar fönstret Nytt hörn där du kan ange värden.

  4. Ange person i etikettrutan.

  5. Välj Lägg till egenskap för att lägga till följande egenskaper. Observera att du kan skapa unika egenskaper för varje person i diagrammet. Endast ID-nyckeln krävs.

    tangent värde Anteckningar
    id han/hon Brytpunktsidentifierarens unika identifierare. Om du inte anger ett id genereras ett åt dig.
    kön kvinna
    tech java

    Obs!

    I den här snabbstarten skapar du en samling som inte är partitionerad. Men om du skapar en partitionerad samling genom att ange en partitionsnyckel när samlingen skapas måste du inkludera partitionsnyckeln som en nyckel i varje ny brytpunkt.

  6. Välj OK. Du kan behöva expandera skärmen för att se OK längst ned på skärmen.

  7. Välj Nytt brytpunkt igen och lägg till ytterligare en ny användare.

  8. Ange en personetikett.

  9. Välj Lägg till egenskap för att lägga till följande egenskaper:

    tangent värde Anteckningar
    id rakesh Brytpunktsidentifierarens unika identifierare. Om du inte anger ett id genereras ett åt dig.
    kön man
    skola MIT
  10. Välj OK.

  11. Välj knappen Använd filter med standardfiltret för att visa alla värden i diagrammet. Alla användare visas nu i resultatlistan.

    När du lägger till mer data kan du använda filter för att begränsa resultaten. Som standard används g.V() DataUtforskaren för att hämta alla hörn i ett diagram. Du kan ändra den till en annandiagramfråga, till exempel , för att returnera antalet alla hörn i diagrammet i JSON-format. Om du ändrade filtret ändrar du tillbaka filtret till g.V() och väljer Använd filter g.V() att visa alla resultat igen.

  12. Nu kan du ansluta rakesh och now. Se till att det är markerat i resultatlistan och välj sedan Ändra målet för ett brytpunkt i ett diagram bredvid Mål på nedre högra sidan. Du kan behöva bredda fönstret för att se knappen.

    Ändra målet för en brytpunkt i ett diagram – Azure Azure AzureSDB

  13. I rutan Mål anger du rakeshoch i etikettrutan Edge vet dudet och markerar sedan kryssrutan.

    Lägga till en anslutning i Data Explorer – Azure AzureDb

  14. Välj rakesh i resultatlistan så ser du att det finns ett samband mellan nu och rakesh.

    Två hörn anslutna i Data Explorer – Azure AzureDb

När du gör det slutförs den resursskapande delen av den här självstudiekursen. Du kan fortsätta att lägga till hörn i diagrammet, ändra befintliga hörn eller ändra frågorna. Nu går vi igenom mätvärdena som Azure Azure Azures DB tillhandahåller och rensar sedan upp resurserna.

Granska SLA:er i Azure Portal

Azure Portal övervakar dataflödet för ditt Db-konto, lagring, tillgänglighet, svarstid och konsekvens. Diagram för mätvärden kopplade till azure Azures DB Service Level Agreement (SLA) visar SLA-värdet jämfört med faktiska prestanda. Den här uppsättning mätvärden gör att du kan övervaka dina SLA:er transparenta.

Så här granskar du mätvärden och SLA:er:

  1. Välj Mått i Db-kontots navigeringsmeny för ditt Db-konto.

  2. Välj en flik, till exempel Svarstid,och välj en tidsram till höger. Jämför linjerna Faktiskoch SLA i diagrammen.

    Azure Azure Azures DB metrics suite

  3. Granska måtten på de andra flikarna.

Rensa resurser

När du är klar med appen och Azure Azure Azures DB-konto kan du ta bort de Azure-resurser du skapat så att du inte tillkommer fler avgifter. Så här tar du bort resurserna:

  1. Sök efter och välj Resursgrupper i Azure Portal-sökfältet.

  2. I listan väljer du den resursgrupp som du skapade för den här snabbstarten.

    Markera den resursgrupp du vill ta bort

  3. På sidan Översikt över resursgruppen väljer du Ta bort resursgrupp.

    Ta bort resursgruppen

  4. I nästa fönster anger du namnet på den resursgrupp du vill ta bort och väljer sedan Ta bort.

Nästa steg

I den här snabbstarten har du lärt dig hur du skapar ett Azure Azure Azures DB-konto, skapar ett diagram med datautforskaren och kör ett Java-program som lägger till data i diagrammet. Nu kan du skapa mer komplexa frågor och implementera kraftfull diagramtrånglogik med Gremlin.