ınkerpop özellikleriyle Azure Cosmos DB gremlin graph desteği ve uyumluluğu

Uygulama hedefı: Gremlin API

Azure Cosmos DB, gremlinolarak bilinen Apache tinkerpop 'un grafik çapraz geçiş dilini destekler. Grafik varlıkları (köşeler ve kenarlar) oluşturmak, bu varlıkların içindeki özellikleri değiştirmek, sorgu ve geçiş işlemleri gerçekleştirmek ve varlıkları silmek için Gremlin dilini kullanabilirsiniz.

Azure Cosmos DB Graph altyapısı Apache tinkerpop geçiş adımları belirtimini yakından izler, ancak uygulamada Azure Cosmos DB özgü farklılıklar vardır. Bu makalede, Gremlin için hızlı bir yol sunuyoruz ve Gremlin API tarafından desteklenen Gremlin özelliklerini listeliyoruz.

Uyumlu istemci kitaplıkları

Aşağıdaki tabloda Azure Cosmos DB’ye karşı kullanabileceğiniz popüler Gremlin sürücüleri gösterilir:

desteklenen Graph nesneleri

TinkerPop, çeşitli grafik teknolojilerini kapsayan bir standarttır. Bu nedenle bir grafik sağlayıcısı tarafından sağlanan özellikleri tanımlamaya yönelik standart bir terminolojisi vardır. Azure Cosmos DB kalıcı, yüksek eşzamanlılığa sahip, birden çok sunucu ve kümeye ayrılabilen yazılabilir bir grafik veritabanı sağlar.

Aşağıdaki tabloda Azure Cosmos DB tarafından uygulanan TinkerPop özellikleri listelenmektedir:

Gremlin Tel biçimi

Azure Cosmos DB gremlin işlemlerinden sonuçları döndürürken JSON biçimini kullanır. Azure Cosmos DB şu anda JSON biçimini destekliyor. örneğin, aşağıdaki kod parçacığında Azure Cosmos DB istemciye döndürülen bir köşesinin JSON temsili gösterilmektedir:

  {
    "id": "a7111ba7-0ea1-43c9-b6b2-efc5e3aea4c0",
    "label": "person",
    "type": "vertex",
    "outE": {
      "knows": [
        {
          "id": "3ee53a60-c561-4c5e-9a9f-9c7924bc9aef",
          "inV": "04779300-1c8e-489d-9493-50fd1325a658"
        },
        {
          "id": "21984248-ee9e-43a8-a7f6-30642bc14609",
          "inV": "a8e3e741-2ef7-4c01-b7c8-199f8e43e3bc"
        }
      ]
    },
    "properties": {
      "firstName": [
        {
          "value": "Thomas"
        }
      ],
      "lastName": [
        {
          "value": "Andersen"
        }
      ],
      "age": [
        {
          "value": 45
        }
      ]
    }
  }

Köşelere yönelik JSON biçimi tarafından kullanılan özellikler aşağıda açıklanmıştır:

Her bir özellik, bir dizi içinde birden çok değer depolayabilir.

Kenar, grafiğin diğer bölümlerine gezintiyi kolaylaştırmak için aşağıdaki bilgiyi içerir.

Gremlin adımları

Şimdi de Azure Cosmos DB tarafından desteklenen Gremlin adımlarına bakalım. Gremlin hakkında eksiksiz bir başvuru için bkz. TinkerPop başvurusu.

Azure Cosmos DB tarafından sağlanan, yazma için iyileştirilmiş altyapı, köşe ve kenarlar içindeki tüm özelliklerin dizinlerinin otomatik olarak oluşturulmasını varsayılan olarak destekler. Bu nedenle herhangi bir özellik üzerindeki sorgulu filtreler, aralık sorguları, sıralama veya toplamalar dizinden işlenir ve etkin bir biçimde sunulur. Azure Cosmos DB’de dizin oluşturmanın işleyişi hakkında daha fazla bilgi için schema-agnostic dizin oluşturma makalemizi okuyun.

Davranış farklılıkları

• Azure Cosmos DB Graph altyapısı, tinkerpop gremlin 'in derinliği ilk kez olacak şekilde, ilk çapraz geçişi çalıştırır. bu davranış, Cosmos DB benzer şekilde yatay ölçeklenebilir sistemde daha iyi performans elde eder.

Desteklenmeyen özellikler

• Gremlin Bytecode graf dolaşma işlemlerine yönelik programlama dilinden bağımsız bir belirtimdir. Cosmos DB Graph henüz desteklemez. GremlinClient.SubmitAsync() kullanın ve geçişi bir metin dizesi olarak geçirin.

• property(set, 'xyz', 1) kardinalite kümesi bugün desteklenmiyor. Bunun yerine property(list, 'xyz', 1) kullanın. Daha fazla bilgi için bkz. ınkerpop Ile köşe özellikleri.

• match() Adım Şu anda kullanılamıyor. Bu adım bildirime dayalı sorgulama özellikleri sağlar.

• Köşelerin veya kenarlardaki Özellikler olarak nesneler desteklenmez. Özellikler yalnızca temel türler veya diziler olabilir.

• Dizi özelliklerine order().by(<array property>) göre sıralama desteklenmez. Yalnızca temel türlere göre sıralama desteklenir.

• Ilkel olmayan JSON türleri desteklenmez. string, number Veya türlerini kullanın true / false . null değerler desteklenmez.

• GraphSONv3 seri hale getirici Şu anda desteklenmiyor. GraphSONv2Bağlantı yapılandırmasındaki serileştirici, okuyucu ve yazıcı sınıflarını kullanın. Azure Cosmos DB gremlin apı tarafından döndürülen sonuçlar graphson biçimiyle aynı biçimde değil.

• Lambda ifadeleri ve işlevleri Şu anda desteklenmemektedir. Bu,, .map{<expression>} .by{<expression>} ve .filter{<expression>} işlevlerini içerir. Daha fazla bilgi edinmek ve Gremlin adımlarını kullanarak bunları yeniden yazmayı öğrenmek için Lambdalar hakkında bir notabakın.

• Sistemin dağıtılmış doğası nedeniyle işlemler desteklenmiyor. Gremlin hesabında uygun tutarlılık modelini "kendi yazınızla okumak" üzere yapılandırın ve çakışan yazmaları çözümlemek için iyimser eşzamanlılık kullanın.

Bilinen sınırlamalar

• Orta çapraz geçiş .V() adımlarıyla Gremlin sorguları için dizin kullanımı: Şu anda, .V() bir geçiş geçişinin yalnızca ilk çağrısı, bu dizine iliştirilmiş tüm filtre ve koşullara çözüm sağlamak için dizini kullanır. Sonraki çağrılar dizine danışmayacak, bu da sorgunun gecikmesini ve maliyetini artırabilir.

Varsayılan dizin oluşturma varsayılırsa, adımla başlayan tipik bir okunan Gremlin sorgusu, .V() .has() .where() sorgu maliyetini ve performansını iyileştirmek için veya gibi ilgili filtreleme adımlarında parametreleri kullanacaktır. Örnek:

g.V().has('category', 'A')

Ancak, .V() Gremlin sorgusuna birden fazla adım eklendiğinde, sorgu verilerinin çözümlenmesi en iyi durumda olmayabilir. Örnek olarak aşağıdaki sorguyu gerçekleştirin:

g.V().has('category', 'A').as('a').V().has('category', 'B').as('b').select('a', 'b')

Bu sorgu, adlandırılan özelliklerine göre iki köşe grubu döndürür category . Bu durumda, yalnızca ilk çağrı, g.V().has('category', 'A') özelliklerinin değerlerine göre köşeleri çözümlemek için dizini kullanır.

Bu sorguya yönelik bir geçici çözüm, ve gibi subtraversal adımlarını kullanmaktır .map() union() . Bu, aşağıda belirtilen şekilde belirlenir:

// Query workaround using .map()
g.V().has('category', 'A').as('a').map(__.V().has('category', 'B')).as('b').select('a','b')

// Query workaround using .union()
g.V().has('category', 'A').fold().union(unfold(), __.V().has('category', 'B'))

Gremlin executionProfile() adımınıkullanarak sorguların performansını gözden geçirebilirsiniz.

Sonraki adımlar

• SDK’larımızı kullanarak bir grafik uygulaması oluşturmaya başlayın
• Azure Cosmos DB’de grafik desteği hakkında daha fazla bilgi edinin