Rövid útmutató: Átjárási csúcsok és élek a Gremlin-konzollal és az Azure Cosmos DB-vel az Apache Gremlinhez
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 Tinkerpop
grá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
- 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-list
kulcsainak 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ával
az cosmosdb gremlin graph create
: . Nevezze el a gráfotproducts
, majd állítsa be az átviteli sebességet400
, é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.4
tinkerpop/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()
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.