Rövid útmutató: Átjárási csúcsok és élek a Gremlin-konzollal és az Azure Cosmos DB-vel az Apache Gremlinhez

Cikk
03/08/2024

A KÖVETKEZŐKRE VONATKOZIK: Gremlin

Az Apache Gremlinhez készült Azure Cosmos DB egy teljes körűen felügyelt gráfadatbázis-szolgáltatás, amely a gremlin lekérdezési nyelv használatával implementálja a népszerű Apache Tinkerpopgráf-számítási keretrendszert. A Gremlin API-ja alacsony súrlódási módot kínál a Gremlin használatának megkezdéséhez egy olyan szolgáltatással, amely minimális felügyelet mellett a lehető legtöbb növekedést és skálázást teszi lehetővé.

Ebben a rövid útmutatóban a Gremlin-konzollal csatlakozhat egy újonnan létrehozott Azure Cosmos DB for Gremlin-fiókhoz.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel.
- Nincs Azure-előfizetés? Regisztráljon egy ingyenes Azure-fiókra.
- Nem szeretne Azure-előfizetést? Ingyenesen kipróbálhatja az Azure Cosmos DB-t előfizetés nélkül.
Docker-gazdagép
- Nincs telepítve a Docker? Próbálja ki ezt a rövid útmutatót a GitHub Codespacesben.
Azure parancssori felület (CLI)

Azure Cloud Shell

Az Azure által üzemeltetett Azure Cloud Shell egy interaktív felület, amelyet a böngészőből használhat. A Bash vagy a PowerShell segítségével is használhatja a Cloud Shellt az Azure-szolgáltatásokhoz. A Cloud Shell előre telepített parancsaival futtathatja a jelen cikkben szereplő kódot anélkül, hogy bármit telepítenie kellene a helyi környezetben.

Az Azure Cloud Shell indítása:

Lehetőség	Példa/hivatkozás
Válassza a Kipróbálás lehetőséget egy kód vagy parancsblokk jobb felső sarkában. A Kipróbálás lehetőség választása nem másolja automatikusan a kódot vagy a parancsot a Cloud Shellbe.
Látogasson el a https://shell.azure.com webhelyre, vagy kattintson a Cloud Shell indítása gombra a böngészőben.
Az Azure Portal jobb felső sarkában található menüben kattintson a Cloud Shell gombra.

Az Azure Cloud Shell használata:

Indítsa el a Cloud Shellt.
A kód vagy parancs másolásához kattintson a Másolás gombra egy kódblokkon (vagy parancsblokkon).
Illessze be a kódot vagy parancsot a Cloud Shell-munkamenetbe a Windows és Linux rendszeren a Ctrl Shift+V billentyűkombinációval+, vagy a Cmd+Shift+V macOS rendszeren való kiválasztásával.
A kód vagy parancs futtatásához válassza az Enter lehetőséget .

API létrehozása Gremlin-fiókhoz és kapcsolódó erőforrásokhoz

A Gremlin-konzol használata előtt létre kell hozni a Gremlin API-fiókot. Emellett segít az adatbázis és a gráf helyének megőrzésében is.

Hozzon létre rendszerhéjváltozókat az accountName, a resourceGroupName és a hely számára.

# Variable for resource group name
resourceGroupName="msdocs-cosmos-gremlin-quickstart"
location="westus"

# Variable for account name with a randomly generated suffix

let suffix=$RANDOM*$RANDOM
accountName="msdocs-gremlin-$suffix"

Ha még nem tette meg, jelentkezzen be az Azure CLI-be a használatával az login.

Új az group create erőforráscsoport létrehozása az előfizetésben.

az group create \
    --name $resourceGroupName \
    --location $location

Új az cosmosdb create API létrehozása Gremlin-fiókhoz alapértelmezett beállításokkal.
```
az cosmosdb create \
    --resource-group $resourceGroupName \
    --name $accountName \
    --capabilities "EnableGremlin" \
    --locations regionName=$location \
    --enable-free-tier true
```
Feljegyzés

Azure-előfizetésenként egy ingyenes szintű Azure Cosmos DB-fiókkal rendelkezhet, és a fiók létrehozásakor kell feliratkoznia. Ha ez a parancs nem alkalmazza az ingyenes szintű kedvezményt, ez azt jelenti, hogy az előfizetés egy másik fiókja már engedélyezve lett az ingyenes szinttel.

Kérje le a Gremlin api-végpontjának NEVÉT a fiókhoz a használatával az cosmosdb show.

az cosmosdb show \
    --resource-group $resourceGroupName \
    --name $accountName \
    --query "name"

Keresse meg a KULCSOT a fiók az-cosmosdb-keys-listkulcsainak listájából.

az cosmosdb keys list \
    --resource-group $resourceGroupName \
    --name $accountName \
    --type "keys" \
    --query "primaryMasterKey"

Jegyezze fel a NAME és a KEY értékeket. Ezeket a hitelesítő adatokat később fogja használni.

Hozzon létre egy, a következővel elnevezett cosmicworks adatbázistaz cosmosdb gremlin database create: .

az cosmosdb gremlin database create \
    --resource-group $resourceGroupName \
    --account-name $accountName \
    --name "cosmicworks"

Diagram létrehozása a következő használatávalaz cosmosdb gremlin graph create: . Nevezze el a gráfot products, majd állítsa be az átviteli sebességet 400, és végül állítsa a partíciókulcs elérési útját a következőre /category: .
```
az cosmosdb gremlin graph create \
    --resource-group $resourceGroupName \
    --account-name $accountName \
    --database-name "cosmicworks" \
    --name "products" \
    --partition-key-path "/category" \
    --throughput 400
```

A Gremlin-konzol indítása és konfigurálása a Dockerrel

A Gremlin-konzol esetében ez a rövid útmutató a Docker Hub tárolórendszerképét tinkerpop/gremlin-console használja. Ez a kép biztosítja, hogy a konzol (3.4) megfelelő verzióját használja a Gremlin API-val való kapcsolathoz. A konzol futtatása után csatlakozzon a helyi Docker-gazdagépről a Gremlin-fiók távoli API-hoz.

Kérje le a 3.4tinkerpop/gremlin-console tárolólemezkép verzióját.
```
docker pull tinkerpop/gremlin-console:3.4
```

Hozzon létre egy üres munkamappát. Az üres mappában hozzon létre egy remote-secure.yaml fájlt. Adja hozzá ezt a YAML-konfigurációt a fájlhoz.

hosts: [<account-name>.gremlin.cosmos.azure.com]
port: 443
username: /dbs/cosmicworks/colls/products
password: <account-key>
connectionPool: {
  enableSsl: true,
  sslEnabledProtocols: [TLSv1.2]
}
serializer: {
  className: org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV2d0,
  config: {
    serializeResultToString: true
  }
}

Feljegyzés

Cserélje le a <account-name><account-key> helyőrzőket az ebben a rövid útmutatóban korábban beszerzett NÉV és KULCS értékekre.

Nyisson meg egy új terminált a munkamappa környezetében, amely tartalmazza a remote-secure.yaml fájlt.
Futtassa a Docker-tároló lemezképét interaktív (--interactive --tty) módban. Győződjön meg arról, hogy az aktuális munkamappát a /opt/gremlin-console/conf/ tárolón belüli elérési úthoz csatlakoztatja.
```
docker run -it --mount type=bind,source=.,target=/opt/gremlin-console/conf/ tinkerpop/gremlin-console:3.4
```
A Gremlin konzoltárolón belül csatlakozzon a távoli (API for Gremlin) fiókhoz a remote-secure.yaml konfigurációs fájl használatával.
```
:remote connect tinkerpop.server conf/remote-secure.yaml
```

Csúcspontok és élek létrehozása és átjárása

Most, hogy a konzol csatlakozik a fiókhoz, a standard Gremlin szintaxissal hozhat létre és léptethet át csúcsokat és éleket is.

Adjon hozzá egy csúcspontot egy termékhez a következő tulajdonságokkal:

Érték

Címke product

id 68719518371

name Kiama classic surfboard

price 285.55

category surfboards
```
:> g.addV('product').property('id', '68719518371').property('name', 'Kiama classic surfboard').property('price', 285.55).property('category', 'surfboards')
```
Fontos

Ne ködösd az :> előtagot. A parancs távoli futtatásához THis-előtag szükséges.
Adjon hozzá egy másik termék csúcspontot a következő tulajdonságokkal:

Érték

Címke product

id 68719518403

name Montau Turtle Surfboard

price 600

category surfboards
```
:> g.addV('product').property('id', '68719518403').property('name', 'Montau Turtle Surfboard').property('price', 600).property('category', 'surfboards')
```
Hozzon létre egy peremhálózatot , replaces amely a két termék közötti kapcsolatot határozza meg.
```
:> g.V(['surfboards', '68719518403']).addE('replaces').to(g.V(['surfboards', '68719518371']))
```
A gráf összes csúcsának megszámlálása.
```
:> g.V().count()
```

	Érték
Címke	`product`
id	`68719518371`
`name`	`Kiama classic surfboard`
`price`	`285.55`
`category`	`surfboards`

	Érték
Címke	`product`
id	`68719518403`
`name`	`Montau Turtle Surfboard`
`price`	`600`
`category`	`surfboards`

A gráfon haladva keresse meg az összes csúcspontot, amely a Kiama classic surfboard.

:> g.V().hasLabel('product').has('category', 'surfboards').has('name', 'Kiama classic surfboard').inE('replaces').outV()

A gráfon haladva keresse meg az összes lecserélt csúcsot Montau Turtle Surfboard .

:> g.V().hasLabel('product').has('category', 'surfboards').has('name', 'Montau Turtle Surfboard').outE('replaces').inV()

Az erőforrások eltávolítása

Ha már nincs szüksége a Gremlin-fiók API-jára, törölje a megfelelő erőforráscsoportot.

Hozzon létre egy rendszerhéjváltozót a resourceGroupName számára, ha még nem létezik.
```
# Variable for resource group name
resourceGroupName="msdocs-cosmos-gremlin-quickstart"
```
Az erőforráscsoport törlésére használható az group delete .
```
az group delete \
    --name $resourceGroupName
```

Hogyan oldottuk meg a problémát?

Az Apache Gremlinhez készült Azure Cosmos DB a Gremlin szolgáltatásként való felajánlásával megoldotta a problémát. Ezzel az ajánlattal nem kell felállnia saját Gremlin-kiszolgálópéldányait, és nem kell saját infrastruktúrát kezelnie. Még több, skálázhatja a megoldást, ahogy az igények idővel növekednek.

A Gremlin-fiók API-hoz való csatlakozáshoz a tinkerpop/gremlin-console tárolórendszerkép használatával úgy futtatta a Gremlin-konzolt, hogy az nem igényelt helyi telepítést. Ezután a remote-secure.yaml fájlban tárolt konfigurációval kapcsolódott a futó tárolóból a Gremlin-fiók API-ja. Innen több gyakori Gremlin-parancsot futtatott.

Következő lépés

Adatok létrehozása és lekérdezése az Azure Cosmos DB for Apache Gremlin használatával