Często zadawane pytania dotyczące usługi Azure Cosmos DB dla języka Apache Gremlin

Krok wykonaniaProfile() w wersji zapoznawczej może służyć do przeprowadzenia analizy planu wykonywania zapytania. Ten krok należy dodać na końcu dowolnego zapytania Gremlin. Na przykład możesz dodać krok na końcu g.V('example').out('relationship') zapytania, co spowoduje g.V('example').out('relationship').executionProfile().

Dane wyjściowe profilu pokazują, ile czasu poświęca się na uzyskanie obiektów wierzchołków, obiektów krawędzi i rozmiaru roboczego zestawu danych. Te dane wyjściowe są powiązane ze standardowymi pomiarami kosztów zapytań usługi Azure Cosmos DB.

Wszystkie obiekty grafu, wierzchołki i krawędzie są wyświetlane jako dokumenty JSON w zapleczu. Zapytanie Gremlin może modyfikować jeden lub wiele obiektów grafu jednocześnie, a koszt zależy bezpośrednio od obiektów i krawędzi przetwarzanych przez zapytanie. Ten proces działa tak samo jak w przypadku wszystkich innych interfejsów API usługi Azure Cosmos DB.

Opłata RU zależy od roboczego zestawu danych procesu przetwarzania, a nie zestawu wyników. Rozważmy przykład, w którym zapytanie uzyskuje pojedynczy wierzchołek w wyniku, ale musi przechodzić przez kilka innych obiektów po drodze. W tym przykładzie koszt jest oparty na wszystkich obiektach grafu zaangażowanych w obliczanie wierzchołka wyniku.

Usługa Azure Cosmos DB używa partycjonowania poziomego do automatycznego skalowania magazynu i przepływności zgodnie z potrzebami. Liczba partycji w kontenerze określa maksymalną przepływność i pojemność magazynu. Aby uzyskać optymalną wydajność na dużą skalę, postępuj zgodnie z określonymi wytycznymi dotyczącymi interfejsu API dla kontenerów języka Gremlin. Aby dowiedzieć się więcej na temat partycjonowania i najlepszych rozwiązań, zobacz artykuł [partycjonowanie w usłudze Azure Cosmos DB.

Usługa Azure Cosmos DB dla języka Apache Gremlin używa sterowników typu open source jako głównych łączników dla usługi. Dlatego zalecaną opcją jest użycie sterowników obsługiwanych przez platformę Apache.

Większość natywnych sterowników języka Apache Gremlin umożliwia udostępnienie słownika parametrów na potrzeby wykonywania zapytań. Ta funkcja jest obsługiwana zarówno w bibliotekach , jak Gremlin.Net i gremlin (Node.js).

Usługa Azure Cosmos DB dla języka Apache Gremlin obsługuje podzbiór obszaru powierzchni Języka Gremlin. Aby uzyskać szczegółowe informacje na temat obsługiwanych kroków, zobacz artykuł pomocy technicznej języka Gremlin .

Aby rozwiązać ten błąd, napisz ponownie zapytania Języka Gremlin, wykonując obsługiwane kroki, ponieważ usługa Azure Cosmos DB udostępnia wszystkie podstawowe funkcje języka Gremlin.

Ten błąd jest prawdopodobnie zgłaszany, gdy jest używany niewłaściwy punkt końcowy.

Punkt końcowy, który generuje ten błąd, ma następujący wzorzec: https://<account-name>.documents.azure.com:443/. Ten punkt końcowy jest w rzeczywistości punktem końcowym dokumentów dla grafowej bazy danych.

Prawidłowym punktem końcowym do użycia jest punkt końcowy Gremlin, który ma następujący format: https://<account-name>.gremlin.cosmosdb.azure.com:443/.

Ten błąd oznacza, że przydzielone jednostki żądań na sekundę nie są wystarczające do obsługi zapytania. Ten błąd jest wyświetlany podczas uruchamiania zapytania, które uzyskuje wszystkie wierzchołki:

g.V()

To zapytanie próbuje pobrać wszystkie wierzchołki z grafu. Dlatego koszt tego zapytania jest równy co najmniej liczbie wierzchołków w odniesieniu do jednostek żądania (RU). Ustawienie jednostek żądania na sekundę (RU/s) powinno zostać dostosowane w celu rozwiązania tego zapytania.

Połączenie języka Gremlin odbywa się za pośrednictwem połączenia protokołu WebSocket. Mimo że połączenia protokołu WebSocket nie mają określonego czasu wygaśnięcia, usługa Azure Cosmos DB dla platformy Apache Gremlin zakończy bezczynne połączenia po 30 minutach braku aktywności.

Usługa Azure Cosmos DB dla języka Apache Gremlin nie obsługuje jeszcze płynnych wywołań interfejsu API. Wywołania interfejsu Fluent API opierają się na wewnętrznej funkcji formatowania, zwanej obsługą kodu bajtowego, której Azure Cosmos DB dla Apache Gremlin obecnie nie obsługuje. Z tego powodu najnowszy sterownik Gremlin-JavaScript również nie jest obsługiwany.

Opłaty za jednostkę żądania (RU) dla zapytania usługi Azure Cosmos DB dla języka Apache Gremlin można znaleźć przy użyciu jednej z kilku metod:

• Korzystanie z witryny Azure Portal

  1. Zaloguj się do witryny Azure Portal.

  2. Utwórz nowe konto usługi Azure Cosmos DB dla języka Apache Gremlin i zaimkuj je danymi lub wybierz istniejące konto, które zawiera już dane.

  3. Przejdź do okienka Eksplorator danych , a następnie wybierz kontener, nad którym chcesz pracować.

  4. Wprowadź prawidłowe zapytanie, a następnie wybierz pozycję Wykonaj zapytanie Gremlin.

  5. Wybierz Statystyki zapytania, aby wyświetlić rzeczywisty koszt żądania wykonanego.

• Korzystanie z zestawu .NET Software Development Kit (SDK)

  1. Uruchom zapytanie, aby uzyskać wynik jako obiekt typu ResultSet<>: ResultSet<dynamic> results = client.SubmitAsync<dynamic>("g.V().count()").Result;

  2. Pobierz opłatę za żądanie z wyników przy użyciu tablicy StatusAttributes i indeksatora x-ms-request-charge : double requestCharge = (double)results.StatusAttributes["x-ms-request-charge"];

• Korzystanie z zestawu Java SDK

  1. Uruchom zapytanie, aby uzyskać wynik jako obiekt typu ResultSet: ResultSet results = client.submit("g.V().count()");

  2. Pobierz opłatę za żądanie z wyników przy użyciu statusAttributes metody i x-ms-request-charge klucza: Map<String, Object> attributes = results.statusAttributes(); Double requestCharge = (Double) attributes.get("x-ms-request-charge");

Opłata za żądanie jest dostępna pod kluczem x-ms-request-charge w nagłówkach odpowiedzi zwracanych przez interfejs API dla języka Gremlin.