Unterstützung für Gremlin-Diagramme in Azure Cosmos DBAzure Cosmos DB Gremlin graph support

• 06/24/2019
• 6 Minuten Lesedauer
• • 

Azure Cosmos DB unterstützt die Apache Tinkerpop-Graphdurchlauf-Sprache, auch als Gremlin bezeichnet.Azure Cosmos DB supports Apache Tinkerpop's graph traversal language, known as Gremlin. Mithilfe der Gremlin-Sprache können Sie Diagrammentitäten (Vertices und Edges) erstellen, Eigenschaften innerhalb dieser Entitäten ändern, Abfragen und Traversierungen ausführen und Entitäten löschen.You can use the Gremlin language to create graph entities (vertices and edges), modify properties within those entities, perform queries and traversals, and delete entities.

Dieser Artikel enthält eine kurze exemplarische Vorgehensweise zu Gremlin und listet die Funktionen von Gremlin auf, die von der Gremlin-API unterstützt werden.In this article, we provide a quick walkthrough of Gremlin and enumerate the Gremlin features that are supported by the Gremlin API.

Kompatible ClientbibliothekenCompatible client libraries

In der folgenden Tabelle werden gängige Gremlin-Treiber aufgeführt, die Sie für Azure Cosmos DB verwenden können:The following table shows popular Gremlin drivers that you can use against Azure Cosmos DB:

Unterstützte Graph-ObjekteSupported Graph Objects

TinkerPop ist ein Standard, der eine große Bandbreite an Diagrammtechnologien abdeckt.TinkerPop is a standard that covers a wide range of graph technologies. Daher weist diese Standardterminologie auf, die beschreiben, welche Funktionen von einem Diagrammanbieter bereitgestellt werden.Therefore, it has standard terminology to describe what features are provided by a graph provider. Azure Cosmos DB stellt eine beständige und beschreibbare Diagrammdatenbank mit hoher Parallelität dar, die über mehrere Server oder Cluster hinweg partitioniert werden kann.Azure Cosmos DB provides a persistent, high concurrency, writeable graph database that can be partitioned across multiple servers or clusters.

Die folgende Tabelle enthält die TinkerPop-Funktionen, die von Azure Cosmos DB implementiert werden:The following table lists the TinkerPop features that are implemented by Azure Cosmos DB:

Gremlin-Sendeformat: GraphSONGremlin wire format: GraphSON

Azure Cosmos DB verwendet bei der Rückgabe von Ergebnissen aus Gremlin-Vorgängen das GraphSON-Format.Azure Cosmos DB uses the GraphSON format when returning results from Gremlin operations. Azure Cosmos DB unterstützt derzeit die Version „GraphSONv2“.Azure Cosmos DB currently supports "GraphSONv2" version. GraphSON ist das Standardformat von Gremlin zur Darstellung von Vertices, Edges und (ein- und mehrwertigen) Eigenschaften mittels JSON.GraphSON is the Gremlin standard format for representing vertices, edges, and properties (single and multi-valued properties) using JSON.

Der folgende Ausschnitt zeigt z.B. eine GraphSON-Darstellung eines Vertex in Azure Cosmos DB, der an den Client zurückgegeben wurde.For example, the following snippet shows a GraphSON representation of a vertex returned to the client from Azure Cosmos DB.

  {
    "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
        }
      ]
    }
  }

Die von GraphSON für Vertices verwendeten Eigenschaften sind nachfolgend beschrieben:The properties used by GraphSON for vertices are described below:

Zudem enthalten Edges folgende Informationen, die die Navigation in anderen Teilen des Diagramms unterstützen können.And the edge contains the following information to help with navigation to other parts of the graph.

Jede Eigenschaft kann mehrere Werte in einem Array speichern.Each property can store multiple values within an array.

Gremlin-SchritteGremlin steps

Sehen wir uns nun die Gremlin-Schritte an, die von Azure Cosmos DB unterstützt werden.Now let's look at the Gremlin steps supported by Azure Cosmos DB. Eine vollständige Referenz zu Gremlin finden Sie in der TinkerPop-Referenz.For a complete reference on Gremlin, see TinkerPop reference.

Die von Azure Cosmos DB bereitgestellte, für Schreibvorgänge optimierte Engine unterstützt standardmäßig die automatische Indizierung aller Eigenschaften in Vertices und Edges.The write-optimized engine provided by Azure Cosmos DB supports automatic indexing of all properties within vertices and edges by default. Daher werden Abfragen mit Filtern, Bereichsabfragen, Sortierungen oder Aggregate von Eigenschaften über den Index verarbeitet und effizient übermittelt.Therefore, queries with filters, range queries, sorting, or aggregates on any property are processed from the index, and served efficiently. Weitere Informationen zur Indizierung in Azure Cosmos DB finden Sie in unserem Dokument unter Schemagnostische Indizierung.For more information on how indexing works in Azure Cosmos DB, see our paper on schema-agnostic indexing.

Nächste SchritteNext steps

• Erste Schritte zum Erstellen einer Diagrammanwendung mithilfe unserer SDKsGet started building a graph application using our SDKs
• Informieren Sie sich ausführlicher über die Diagrammunterstützung in Azure Cosmos DB.Learn more about graph support in Azure Cosmos DB