Hızlı Başlangıç: Gremlin konsolunu kullanarak Azure Cosmos DB graf veritabanı oluşturma, sorgulama ve çapraz geçiş yapma
Uygulama hedefı: 
Gremlin API
Azure Cosmos DB, Microsoft'un genel olarak dağıtılmış çok modelli veritabanı hizmetidir. Bu hizmetle belge, anahtar/değer ve grafik veritabanlarını kolayca oluşturup sorgulayabilir ve tüm bunları yaparken Azure Cosmos DB'nin genel dağıtım ve yatay ölçeklendirme özelliklerinden faydalanabilirsiniz.
bu hızlı başlangıçta, Azure portal kullanarak bir Azure Cosmos DB gremlin apı hesabı, veritabanı ve graf (kapsayıcı) oluşturma ve ardından gremlin apı verileriyle çalışmak için Apache tinkerpop 'tan gremlin konsolunu kullanma gösterilmektedir. Bu öğreticide köşe ve kenarlar oluşturup sorgular, bir köşe özelliğini güncelleştirir, köşeleri sorgular, grafiğin çapraz geçişini yapar ve bir köşeyi bırakırsınız.
Gremlin konsolu, Groovy/Java tabanlıdır ve Linux, Mac ve Windows üzerinde çalışır. Konsolu Apache TinkerPop sitesinden indirebilirsiniz.
Önkoşullar
Bu hızlı başlangıca yönelik bir Azure Cosmos DB hesabı oluşturmak için Azure aboneliğinizin olması gerekir.
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Ayrıca Gremlin konsolunu yüklemeniz gerekir. Önerilen sürüm v 3.4.3 veya daha önceki bir sürüm. (Windows 'da gremlin konsolunu kullanmak için java çalışma zamanı'nı yüklemeniz gerekir, en azından java 8 gerekir, ancak java 11 kullanılması tercih edilir.
Veritabanı hesabı oluşturma
Yeni bir tarayıcı penceresinde Azure portalında oturum açın.
Sol menüde Kaynak oluştur'a tıklayın.
Yeni sayfasında Veritabanları Azure veritabanı > veritabanı'Cosmos seçin.
Azure veritabanı Cosmos veritabanı hesabı oluştur sayfasında, yeni Azure Cosmos DB hesabının ayarlarını girin.
Ayar Değer Açıklama Abonelik Abonelik adı Bu Azure Cosmos hesabı için kullanmak istediğiniz Azure aboneliğini seçin. Kaynak Grubu Kaynak grubu adı Bir kaynak grubu seçin veya Yeni oluştur seçeneğini belirleyin ve yeni kaynak grubu için benzersiz bir ad girin. Hesap Adı Benzersiz bir ad girin Azure Cosmos DB hesabınızı tanımlayan benzersiz bir ad girin. Hesap URI'niz gremlin.azure.com benzersiz hesap adınıza eklenir.
Hesap adı yalnızca küçük harf, rakam ve kısa çizgi (-) kullanabilir ve 3 ile 44 karakter uzunluğunda olmalıdır.API Gremlin (graf) API, oluşturulacak hesap türünü belirler. Azure Cosmos DB beş API sağlar: Belge veritabanları için çekirdek (SQL), graf veritabanları için Gremlin, belge veritabanları için MongoDB, Azure Tablosu ve Cassandra. Her API için ayrı bir hesap oluşturmanız gerekir.
Gremlin (graf) öğesini seçin çünkü bu hızlı başlangıçta Gremlin API'si ile çalışan bir tablo oluşturuyoruz.
Gremlin API hakkında daha fazla bilgi edinin.Konum Kullanıcılarınıza en yakın bölge Azure Cosmos DB hesabınızın barındırılacağı coğrafi konumu seçin. Verilere en hızlı erişimi sağlamak için kullanıcılarınıza en yakın olan konumu kullanın. Kapasite modu Sağlanan aktarım hızı veya Sunucusuz Sağlanan aktarım hızı modunda hesap oluşturmak için Sağlanan aktarım hızı'ı seçin. Sunucusuz modda bir hesap oluşturmak için Sunucusuz'ı seçin. Azure Cosmos DB ücretsiz katmanı indirimini uygulama Uygula veya Uygula Azure Cosmos DB ücretsiz katmanı ile bir hesapta ilk 1000 RU/sn ve 25 GB depolama alanı ücretsiz olarak elde edilir. Ücretsiz katman hakkında daha fazla bilgi. Not
Azure aboneliği başına en fazla bir ücretsiz azure Cosmos DB hesabına sahip olabilir ve hesabı oluştururken kabul etmek zorundasınız. Ücretsiz katman indirimi uygulama seçeneğini görmüyorsanız bu, abonelikte başka bir hesabın ücretsiz katmanla zaten etkinleştirilmiştir anlamına gelir.
Genel Dağıtım sekmesinde aşağıdaki ayrıntıları yapılandırabilirsiniz. Bu hızlı başlangıç için varsayılan değerleri bırakın:
Ayar Değer Açıklama Coğrafi Yedeklilik Devre Dışı Bırak Bölgenizi bir çift bölgeyle eşleştirerek hesabınız üzerinde genel dağıtımı etkinleştirin veya devre dışı bırakma. Hesabınıza daha sonra daha fazla bölge ekebilirsiniz. Birden Çok Bölgeli Yazmalar Devre Dışı Bırak Çok bölgeli yazma özelliği, dünya genelindeki veritabanlarınız ve kapsayıcılar için sağlanan aktarım hızından yararlanmanızı sağlar. Not
Kapasite modu olarak Sunucusuz seçeneğini belirtirsanız aşağıdaki seçenekler kullanılamaz:
- Ücretsiz Katman İndirimi Uygula
- Coğrafi yedeklilik
- Birden Çok Bölgeli Yazmalar
İsteğe bağlı olarak, aşağıdaki sekmelerde ek ayrıntıları yapılandırabilirsiniz:
- Ağ - Sanal ağdan erişimi yapılandırma.
- Yedekleme İlkesi - Düzenli veya sürekli yedekleme ilkesi yapılandırma.
- Şifreleme - Hizmet tarafından yönetilen anahtar veya müşteri tarafından yönetilen bir anahtar kullanın.
- Etiketler- Etiketler, birden çok kaynağa ve kaynak gruplarına aynı etiketi uygulayarak kaynakları kategorilere ayırmanız ve birleştirilmiş faturalamayı görüntülemenizi sağlayan ad/değer çiftleridir.
Gözden geçir ve oluştur’u seçin.
Hesabın oluşturulması birkaç dakika sürer. Portalda Tebrikler! Azure Cosmos DB hesabınız oluşturuldu sayfası.
Graf ekleme
Şimdi bir grafik veritabanı oluşturmak için Azure portalında Veri Gezgini aracını kullanabilirsiniz.
yeni Veri Gezgini > Graph seçin.
Grafik Ekle alanı en sağda görüntülenir, görmek için sağa kaydırmanız gerekebilir.
Grafik Ekle sayfasında, yeni grafik için ayarları girin.
Ayar Önerilen değer Açıklama Veritabanı Kimliği sample-database Yeni veritabanınızın adı olarak sample-database girin. Veritabanı adı 1 ile 255 karakter arasında olmalı, / \ # ?içermemeli ve boşlukla bitmemelidir.Aktarım hızı 400 RU Aktarım hızını saniyede 400 istek birimi (RU/s) olarak değiştirin. Daha sonra gecikme süresini azaltmak isterseniz işlem hızının ölçeğini artırabilirsiniz. Graf Kimliği sample-graph Yeni koleksiyonunuzun adı olarak sample-graph girin. Graf adı karakter gereksinimleri, veritabanı kimliklerine ilişkin karakter gereksinimleri ile aynıdır. Bölüm Anahtarı /PK tüm Cosmos DB hesapları yatay olarak ölçeklendirmek için bir bölüm anahtarına ihtiyaç duyar. Graph veri bölümlendirme makalesindeuygun bölüm anahtarını seçme hakkında bilgi edinin. Form doldurulduktan sonra Tamam' ı seçin.
app service 'e/Graph Bağlan
Gremlin Konsolu’nu başlatmadan önce
apache-tinkerpop-gremlin-console-3.2.5/confdizininde remote-secure.yaml yapılandırma dosyasını oluşturun veya değiştirin.ana bilgisayar, bağlantı noktası, kullanıcı adı, parola, bağlantı havuzu ve serileştirici değerlerini aşağıdaki tabloda tanımlanan şekilde girin:
Ayar Önerilen değer Açıklama hosts [Hesap-adı. Gremlin. Cosmos.Azure.com] Aşağıdaki ekran görüntüsüne bakın. Bu, köşeli ayraçlar içinde Azure portal Genel Bakış sayfasındaki Gremlin URI değeridir ve sonunda: 443/removed. Not: Gremlin değerlerini, daha sonra Gremlin sorgularını yürütmeye çalışırken, büyük olasılıkla "ana bilgisayar zamanında yanıt vermedi" özel durumuyla sonuçlanan URI 'yi değil , [Account-Name. Documents.Azure.com] ile biten URI 'yi kullanmayın. port 443 443 olarak ayarlayın. username Kullanıcı adınız /dbs/<db>/colls/<coll>formunun kaynağı; burada<db>veritabanı adınız ve<coll>koleksiyon adınızdır.password Birincil anahtarınız Aşağıdaki ikinci ekran görüntüsüne bakın. Bu sizin birincil anahtarınızdır, bu anahtarı Azure portalının Anahtarlar sayfasındaki Birincil Anahtar kutusunda bulabilirsiniz. Değeri kopyalamak için kutunun solundaki kopyala düğmesini kullanın. connectionPool {enableSsl: true} TLS için bağlantı havuzu ayarınız. serializer { className: org.apache.tinkerpop.gremlin.
Driver. ser. GraphSONMessageSerializerV2d0,
config: { serializeResultToString: true }}Bu değere ayarlayın ve değeri yapıştırırken tüm \nsatır sonlarını silin.Hosts değeri için genel bakış sayfasından GREMLIN URI değerini kopyalayın:
Parola değeri için, anahtarlar sayfasından birincil anahtarı kopyalayın:
Remote-secure.yaml dosyanız aşağıdaki gibi görünmelidir:
hosts: [your_database_server.gremlin.cosmos.azure.com] port: 443 username: /dbs/your_database/colls/your_collection password: your_primary_key connectionPool: { enableSsl: true } serializer: { className: org.apache.tinkerpop.gremlin.driver.ser.GraphSONMessageSerializerV2d0, config: { serializeResultToString: true }}Ana bilgisayar parametresinin değerini köşeli ayraç [] içinde sardığınızdan emin olun.
Terminalinizde Gremlin Konsolunu başlatmak için
bin/gremlin.batveyabin/gremlin.shçalıştırın.Terminalinizde uygulama hizmetinize bağlanmak için
:remote connect tinkerpop.server conf/remote-secure.yamlçalıştırın.İpucu
No appenders could be found for loggerhatasını alırsanız, remote-secure.yaml dosyasındaki seri hale getirici değerini 2. adımda açıklanan şekilde güncelleştirdiğinizden emin olun. Yapılandırmanız doğruysa, bu uyarı, konsolunun kullanımını etkilememesi gerektiği için güvenle yok sayılabilir.Ardından tüm konsol komutlarını uzak sunucuya yönlendirmek için
:remote consolekomutunu çalıştırın.Not
:remote consolekomutunu çalıştırmaz ancak tüm konsol komutlarını uzak sunucuya yönlendirmek isterseniz, komutun önüne:>ekleyin; örneğin komutu:> g.V().count()olarak çalıştırın. Bu önek komutun bir parçasıdır ve Azure Cosmos DB ile Gremlin konsolunu kullanırken önemlidir. Bu öneki çıkararak konsola komutu yerel olarak; genellikle bellek içi bir grafikte yürütmesini söylemiş olursunuz. Bu:>önekini kullandığınızda, konsola, bu örnekte Azure Cosmos DB'de (localhost öykünücüsü veya bir Azure örneği) olmak üzere uzak bir komutu yürütmesini söylemiş olursunuz.
Harika! Kurulumu tamamladığımıza göre, bazı konsol komutlarını çalıştırmaya başlayalım.
Basit bir count() komutunu deneyelim. İstendiğinde konsola aşağıdakileri yazın:
g.V().count()
Köşe ve kenar oluşturma
İlk olarak Thomas, Mary Kay, Robin, Ben ve Jack için beş kişi köşesi ekleyelim.
Giriş (Thomas):
g.addV('person').property('firstName', 'Thomas').property('lastName', 'Andersen').property('age', 44).property('userid', 1).property('pk', 'pk')
Çıkış:
==>[id:796cdccc-2acd-4e58-a324-91d6f6f5ed6d,label:person,type:vertex,properties:[firstName:[[id:f02a749f-b67c-4016-850e-910242d68953,value:Thomas]],lastName:[[id:f5fa3126-8818-4fda-88b0-9bb55145ce5c,value:Andersen]],age:[[id:f6390f9c-e563-433e-acbf-25627628016e,value:44]],userid:[[id:796cdccc-2acd-4e58-a324-91d6f6f5ed6d|userid,value:1]]]]
Giriş (Mary Kay):
g.addV('person').property('firstName', 'Mary Kay').property('lastName', 'Andersen').property('age', 39).property('userid', 2).property('pk', 'pk')
Çıkış:
==>[id:0ac9be25-a476-4a30-8da8-e79f0119ea5e,label:person,type:vertex,properties:[firstName:[[id:ea0604f8-14ee-4513-a48a-1734a1f28dc0,value:Mary Kay]],lastName:[[id:86d3bba5-fd60-4856-9396-c195ef7d7f4b,value:Andersen]],age:[[id:bc81b78d-30c4-4e03-8f40-50f72eb5f6da,value:39]],userid:[[id:0ac9be25-a476-4a30-8da8-e79f0119ea5e|userid,value:2]]]]
Giriş (Robin):
g.addV('person').property('firstName', 'Robin').property('lastName', 'Wakefield').property('userid', 3).property('pk', 'pk')
Çıkış:
==>[id:8dc14d6a-8683-4a54-8d74-7eef1fb43a3e,label:person,type:vertex,properties:[firstName:[[id:ec65f078-7a43-4cbe-bc06-e50f2640dc4e,value:Robin]],lastName:[[id:a3937d07-0e88-45d3-a442-26fcdfb042ce,value:Wakefield]],userid:[[id:8dc14d6a-8683-4a54-8d74-7eef1fb43a3e|userid,value:3]]]]
Giriş (Ben):
g.addV('person').property('firstName', 'Ben').property('lastName', 'Miller').property('userid', 4).property('pk', 'pk')
Çıkış:
==>[id:ee86b670-4d24-4966-9a39-30529284b66f,label:person,type:vertex,properties:[firstName:[[id:a632469b-30fc-4157-840c-b80260871e9a,value:Ben]],lastName:[[id:4a08d307-0719-47c6-84ae-1b0b06630928,value:Miller]],userid:[[id:ee86b670-4d24-4966-9a39-30529284b66f|userid,value:4]]]]
Giriş (Jack):
g.addV('person').property('firstName', 'Jack').property('lastName', 'Connor').property('userid', 5).property('pk', 'pk')
Çıkış:
==>[id:4c835f2a-ea5b-43bb-9b6b-215488ad8469,label:person,type:vertex,properties:[firstName:[[id:4250824e-4b72-417f-af98-8034aa15559f,value:Jack]],lastName:[[id:44c1d5e1-a831-480a-bf94-5167d133549e,value:Connor]],userid:[[id:4c835f2a-ea5b-43bb-9b6b-215488ad8469|userid,value:5]]]]
Ardından, kişilerimiz arasındaki ilişkiler için kenarlar ekleyelim.
Giriş (Thomas -> Mary Kay):
g.V().hasLabel('person').has('firstName', 'Thomas').addE('knows').to(g.V().hasLabel('person').has('firstName', 'Mary Kay'))
Çıkış:
==>[id:c12bf9fb-96a1-4cb7-a3f8-431e196e702f,label:knows,type:edge,inVLabel:person,outVLabel:person,inV:0d1fa428-780c-49a5-bd3a-a68d96391d5c,outV:1ce821c6-aa3d-4170-a0b7-d14d2a4d18c3]
Giriş (Thomas -> Robin):
g.V().hasLabel('person').has('firstName', 'Thomas').addE('knows').to(g.V().hasLabel('person').has('firstName', 'Robin'))
Çıkış:
==>[id:58319bdd-1d3e-4f17-a106-0ddf18719d15,label:knows,type:edge,inVLabel:person,outVLabel:person,inV:3e324073-ccfc-4ae1-8675-d450858ca116,outV:1ce821c6-aa3d-4170-a0b7-d14d2a4d18c3]
Giriş (Robin -> Ben):
g.V().hasLabel('person').has('firstName', 'Robin').addE('knows').to(g.V().hasLabel('person').has('firstName', 'Ben'))
Çıkış:
==>[id:889c4d3c-549e-4d35-bc21-a3d1bfa11e00,label:knows,type:edge,inVLabel:person,outVLabel:person,inV:40fd641d-546e-412a-abcc-58fe53891aab,outV:3e324073-ccfc-4ae1-8675-d450858ca116]
Köşe güncelleştirme
Thomas köşesini yeni yaşı olan 45 ile güncelleştirelim.
Giriş:
g.V().hasLabel('person').has('firstName', 'Thomas').property('age', 45)
Çıkış:
==>[id:ae36f938-210e-445a-92df-519f2b64c8ec,label:person,type:vertex,properties:[firstName:[[id:872090b6-6a77-456a-9a55-a59141d4ebc2,value:Thomas]],lastName:[[id:7ee7a39a-a414-4127-89b4-870bc4ef99f3,value:Andersen]],age:[[id:a2a75d5a-ae70-4095-806d-a35abcbfe71d,value:45]]]]
Grafınızı sorgulama
Şimdi de grafiğinize karşı çeşitli sorgular çalıştıralım.
İlk olarak, yalnızca 40 yaşından büyük kişileri döndürecek bir filtre sorgulamayı deneyelim.
Giriş (filtre sorgusu):
g.V().hasLabel('person').has('age', gt(40))
Çıkış:
==>[id:ae36f938-210e-445a-92df-519f2b64c8ec,label:person,type:vertex,properties:[firstName:[[id:872090b6-6a77-456a-9a55-a59141d4ebc2,value:Thomas]],lastName:[[id:7ee7a39a-a414-4127-89b4-870bc4ef99f3,value:Andersen]],age:[[id:a2a75d5a-ae70-4095-806d-a35abcbfe71d,value:45]]]]
Ardından, 40 yaşından büyük kişiler için ad planlaması yapalım.
Giriş (filtre + planlama sorgusu):
g.V().hasLabel('person').has('age', gt(40)).values('firstName')
Çıkış:
==>Thomas
Grafınızı çapraz geçirme
Şimdi grafiği Thomas'ın tüm arkadaşlarını döndürecek şekilde geçirelim.
Giriş (Thomas’ın arkadaşları):
g.V().hasLabel('person').has('firstName', 'Thomas').outE('knows').inV().hasLabel('person')
Çıkış:
==>[id:f04bc00b-cb56-46c4-a3bb-a5870c42f7ff,label:person,type:vertex,properties:[firstName:[[id:14feedec-b070-444e-b544-62be15c7167c,value:Mary Kay]],lastName:[[id:107ab421-7208-45d4-b969-bbc54481992a,value:Andersen]],age:[[id:4b08d6e4-58f5-45df-8e69-6b790b692e0a,value:39]]]]
==>[id:91605c63-4988-4b60-9a30-5144719ae326,label:person,type:vertex,properties:[firstName:[[id:f760e0e6-652a-481a-92b0-1767d9bf372e,value:Robin]],lastName:[[id:352a4caa-bad6-47e3-a7dc-90ff342cf870,value:Wakefield]]]]
Ardından, sonraki köşe katmanlarını alalım. Thomas'ın arkadaşlarının tüm arkadaşlarını almak üzere grafiği çapraz geçirin.
Giriş (Thomas’ın arkadaşlarının arkadaşları):
g.V().hasLabel('person').has('firstName', 'Thomas').outE('knows').inV().hasLabel('person').outE('knows').inV().hasLabel('person')
Çıkış:
==>[id:a801a0cb-ee85-44ee-a502-271685ef212e,label:person,type:vertex,properties:[firstName:[[id:b9489902-d29a-4673-8c09-c2b3fe7f8b94,value:Ben]],lastName:[[id:e084f933-9a4b-4dbc-8273-f0171265cf1d,value:Miller]]]]
Köşe bırakma
Şimdi de grafik veritabanından bir köşeyi silelim.
Giriş (Jack köşesini bırakın):
g.V().hasLabel('person').has('firstName', 'Jack').drop()
Grafınızı temizleme
Son olarak, veritabanındaki tüm köşe ve kenarları temizleyelim.
Giriş:
g.E().drop()
g.V().drop()
Tebrikler! Bu Azure Cosmos DB: Gremlin API’si öğreticisini tamamladınız!
Azure portalında SLA'ları gözden geçirme
Bu Azure portal, Cosmos DB aktarım hızı, depolama alanı, kullanılabilirlik, gecikme süresi ve tutarlılığı izler. Bir Azure Cosmos DB Hizmet Düzeyi Sözleşmesi (SLA) ile ilişkili ölçümler, gerçek performansla karşılaştırıldığında SLA değerini gösterir. Bu ölçüm paketi, SLA'larınızı izlemenizi saydam hale gelir.
Ölçümleri ve SLA'ları gözden geçirmek için:
Hesap gezinti Cosmos DB Ölçümler'i seçin.
Gecikme süresi gibi bir sekme seçin ve sağdan bir zaman çerçevesi seçin. Grafiklerde Gerçek ve SLA çizgilerini karşılaştırın.
Diğer sekmelerde ölçümleri gözden geçirme.
Kaynakları temizleme
Uygulama ve hesap hesabınızla Azure Cosmos DB, daha fazla ücret ödemeden oluşturduğunuz Azure kaynaklarını silebilirsiniz. Kaynakları silmek için:
Arama Azure portal kaynak grupları için arama ve seçimlerini kullanın.
Listeden bu hızlı başlangıç için oluşturduğunuz kaynak grubunu seçin.
Kaynak grubunun Genel Bakış sayfasında Kaynak grubunu sil'i seçin.
Sonraki pencerede, silinecek kaynak grubunun adını girin ve Sil'i seçin.
Sonraki adımlar
Bu hızlı başlangıçta bir Azure Cosmos DB hesabı oluşturmayı, Veri Gezgini’ni kullanarak grafik oluşturmayı, köşe ve kenar oluşturmayı ve Gremlin konsolunu kullanarak grafiğinizi çapraz geçirmeyi öğrendiniz. Artık daha karmaşık sorgular derleyebilir ve Gremlin kullanarak güçlü grafik geçişi mantığını kullanabilirsiniz.