Azure Cosmos DB for Apache Gremlin についてよく寄せられる質問

executionProfile() というプレビュー手順を利用し、クエリ実行プランを分析できます。 このステップは、Gremlin クエリの末尾に追加する必要があります。 たとえば、g.V('example').out('relationship') クエリの末尾にステップを追加すると、g.V('example').out('relationship').executionProfile() のようになります。

プロファイルの出力には、頂点オブジェクト、エッジ オブジェクト、および作業データ セットのサイズの取得に費やされた時間が表示されます。 この出力は、Azure Cosmos DB クエリの標準コスト測定に関連しています。

すべてのグラフ オブジェクト、頂点、エッジは、バックエンドで JSON ドキュメントとして表示されます。 Gremlin クエリでは、一度に 1 つまたは複数のグラフ オブジェクトを変更できます。コストは、クエリによって処理されるオブジェクトとエッジに直接依存します。 このプロセスは、他のすべての Azure Cosmos DB API の場合と同じように機能します。

RU 料金は、結果セットではなく、トラバーサルの作業データ セットによって異なります。 クエリが結果として 1 つの頂点を取得するが、途中で他の複数のオブジェクトを走査する必要がある例を考えてみましょう。 この例では、コストは、結果の頂点の計算に関連するすべてのグラフ オブジェクトに基づいています。

Azure Cosmos DB では、水平パーティション分割を使用して、必要に応じてストレージとスループットを自動的にスケーリングします。 コンテナー内のパーティションの数によって、その最大スループットとストレージ容量が決まります。 大規模なパフォーマンスを最適化するには、Gremlin コンテナー用 API の特定のガイドラインに従ってください。 パーティション分割とベスト プラクティスの詳細については、[Azure Cosmos DB でのパーティション分割に関する記事] を参照してください。

Azure Cosmos DB for Apache Gremlin は、オープンソース ドライバーをサービスのメイン コネクタとして使用します。 そのため、Apache でサポートされているドライバーを使用することをお勧めします。

ほとんどのネイティブ Apache Gremlin ドライバーでは、クエリ実行用のパラメーターのディクショナリを提供するオプションを使用できます。 この機能は、 Gremlin.Net および gremlin (Node.js) ライブラリの両方でサポートされています。

Azure Cosmos DB for Apache Gremlin では、Gremlin のサーフェス領域のサブセットがサポートされています。 サポートされている手順の詳細については、 Gremlin のサポート 記事を参照してください。

このエラーを解決するには、サポートされている手順を使用して Gremlin クエリを書き換えます。Azure Cosmos DB には、すべての基本的な Gremlin 機能が用意されています。

このエラーはおそらく、間違ったエンドポイントが使用されているときにスローされます。

このエラーを生成するエンドポイントには、次のパターンがあります: https://<account-name>.documents.azure.com:443/。 このエンドポイントは、実際にはグラフ データベースのドキュメント エンドポイントです。

使用する正しいエンドポイントは Gremlin エンドポイントであり、形式は https://<account-name>.gremlin.cosmosdb.azure.com:443/ です。

このエラーは、秒あたりで割り当てられている要求ユニットではクエリに十分なサービスを提供できないことを意味します。 このエラーは、すべての頂点を取得するクエリを実行すると表示されます。

g.V()

このクエリでは、グラフからすべての頂点を取得するように試行されます。 そのため、このクエリのコストは、少なくとも要求ユニット (RU) の点で頂点の数と同じです。 このクエリに対処するには、1 秒あたりの要求ユニット数 (RU/秒) 設定を調整する必要があります。

Gremlin 接続は WebSocket 接続経由で行われます。 WebSocket 接続には特定の有効期間はありませんが、Azure Cosmos DB for Apache Gremlin は、非アクティブ状態が 30 分続くとアイドル状態の接続を終了します。

Azure Cosmos DB for Apache Gremlin では、Fluent API 呼び出しはまだサポートされていません。 Fluent API 呼び出しは、バイトコード サポートと呼ばれる内部書式設定機能に依存します。これは、Azure Cosmos DB for Apache Gremlin では現在提供されていません。 このため、最新の Gremlin-JavaScript ドライバーもサポートされていません。

Azure Cosmos DB for Apache Gremlin クエリの要求ユニット (RU) 料金は、次のいずれかの方法で確認できます。

• Azure ポータルを使用する

  1. Azure portal にサインインします。

  2. 新しい Azure Cosmos DB for Apache Gremlin アカウントを作成 してデータをシード処理するか、既にデータが含まれている既存のアカウントを選択します。

  3. [データ エクスプローラー] ウィンドウに移動し、作業するコンテナーを選択します。

  4. 有効なクエリを入力し、[ Gremlin クエリの実行] を選択します。

  5. クエリ統計を選択して、実行した要求の実際の要求料金を表示します。

• .NET ソフトウェア開発キット (SDK) を使用する

  1. クエリを実行して、 ResultSet<>型のオブジェクトとして結果を取得します。 ResultSet<dynamic> results = client.SubmitAsync<dynamic>("g.V().count()").Result;

  2. StatusAttributes配列と x-ms-request-charge インデクサーを使用して、結果から要求料金を取得します。double requestCharge = (double)results.StatusAttributes["x-ms-request-charge"];

• Java SDK の使用

  1. クエリを実行して、 ResultSet型のオブジェクトとして結果を取得します。 ResultSet results = client.submit("g.V().count()");

  2. statusAttributesメソッドとx-ms-request-charge キーを使用して、結果から要求料金を取得します。Map<String, Object> attributes = results.statusAttributes(); Double requestCharge = (Double) attributes.get("x-ms-request-charge");

要求の料金は、Gremlin 用 API によって返される応答ヘッダー内の x-ms-request-charge キーで確認できます。