Gremlin için Azure Cosmos DB graf desteği ve TinkerPop özellikleriyle uyumluluk

ŞUNLAR IÇIN GEÇERLIDIR: Gremlin

Azure Cosmos DB, Apache Tinkerpop'un Gremlin olarak bilinen graf 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'ye özgü farklılıklar vardır. Bu makalede, Gremlin'e yönelik hızlı bir kılavuz sağlar ve Gremlin api'sinin desteklediği Gremlin özelliklerini numaralandırırız.

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 Grafik 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ç döndürürken JSON biçimini kullanır. Azure Cosmos DB şu anda JSON biçimini desteklemektedir. Örneğin aşağıdaki kod parçacığı, Azure Cosmos DB'den istemciye döndürülen bir köşenin JSON gösterimini gösterir:

  {
    "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öşeler için 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ı

• TinkerPop Gremlin derinlik öncelikliyken Azure Cosmos DB Graph altyapısı genişlik öncelikli dolaşma çalıştırır. Bu davranış, Azure Cosmos DB gibi yatay olarak ölçeklenebilir sistemde daha iyi performans sağlar.

Desteklenmeyen özellikler

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

• property(set, 'xyz', 1) küme kardinalitesi bugün desteklenmiyor. Bunun yerine property(list, 'xyz', 1) kullanın. Daha fazla bilgi edinmek için bkz . TinkerPop ile köşe özellikleri.

• Bu match() adım şu anda kullanılamıyor. Bu adım bildirim temelli sorgulama özellikleri sağlar.

• Köşelerde veya kenarlarda özellik 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.

• İlkel olmayan JSON türleri desteklenmez. , numberveya true/false türlerini kullanın.string null değerleri desteklenmez.

• GraphSONv3 seri hale getiricisi şu anda desteklenmiyor. Bağlantı yapılandırmasında Seri Hale Getirici, Okuyucu ve Yazıcı sınıflarını kullanın GraphSONv2 . Gremlin için Azure Cosmos DB tarafından döndürülen sonuçlar GraphSON biçimiyle aynı biçime sahip değildir.

• Lambda ifadeleri ve işlevleri şu anda desteklenmemektedir. Buna , , .by{<expression>}ve işlevleri dahildir..map{<expression>}.filter{<expression>} Daha fazla bilgi edinmek ve Gremlin adımlarını kullanarak bunları yeniden yazmayı öğrenmek için bkz . Lambdas'ta Not.

• Sistemin dağıtılmış yapısı nedeniyle işlemler desteklenmez. Gremlin hesabında uygun tutarlılık modelini "kendi yazmalarınızı okuyacak" şekilde yapılandırın ve çakışan yazmaları çözmek için iyimser eşzamanlılık kullanın.

Bilinen sınırlamalar

• Orta çapraz geçiş .V() adımlarını içeren Gremlin sorguları için dizin kullanımı: Şu anda, yalnızca ilk .V() geçiş çağrısı, dizine eklenen filtreleri veya önkoşulları çözümlemek için dizinden yararlanacaktır. Sonraki çağrılar dizine danışmaz ve bu da sorgunun gecikme süresini ve maliyetini artırabilir.

Varsayılan dizin oluşturma varsayıldığında, adımla .V() başlayan tipik bir okuma Gremlin sorgusu, ekli filtreleme adımlarında veya .where() gibi .has() parametreleri kullanarak sorgunun maliyetini ve performansını iyileştirir. Örneğin:

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

Ancak, Gremlin sorgusuna birden .V() fazla adım eklendiğinde, sorgunun veri çözümlemesi en uygun olmayabilir. Örnek olarak aşağıdaki sorguyu alın:

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

Bu sorgu, adlı categoryözelliklerine göre iki köşe grubu döndürür. 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 sorgu için geçici bir çözüm, ve union()gibi .map() çıkarma adımlarını kullanmaktır. Bu, aşağıda örneklenmiştir:

// 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