Gremlin için Azure Cosmos DB sunucu yanıt üst bilgileri

ŞUNLAR IÇIN GEÇERLIDIR: Gremlin

Bu makale, Gremlin için Azure Cosmos DB sunucusunun istek yürütmesi üzerine çağırana döndürdüğü üst bilgileri kapsar. Bu üst bilgiler istek performansı sorunlarını gidermek, Azure Cosmos DB hizmetiyle yerel olarak tümleşen uygulama oluşturmak ve müşteri desteğini basitleştirmek için kullanışlıdır.

Bu üst bilgilerle bağımlılık alarak uygulamanızın taşınabilirliğini diğer Gremlin uygulamalarıyla sınırladığınıza dikkat edin. Buna karşılık, Gremlin için Azure Cosmos DB ile daha sıkı tümleştirme elde edebilirsiniz. Bu üst bilgiler bir TinkerPop standardı değildir.

Üst Bilgiler

Durum kodları

Sunucu tarafından durum özniteliği için x-ms-status-code döndürülen en yaygın kodlar aşağıda listelenmiştir.

Örnekler

Bir durum özniteliğini okuyan Gremlin.Net temel alan örnek bir istemci uygulaması:

// Following example reads a status code and total request charge from server response attributes.
// Variable "server" is assumed to be assigned to an instance of a GremlinServer that is connected to Azure Cosmos DB account.
using (GremlinClient client = new GremlinClient(server, new GraphSON2Reader(), new GraphSON2Writer(), GremlinClient.GraphSON2MimeType))
{
  ResultSet<dynamic> responseResultSet = await GremlinClientExtensions.SubmitAsync<dynamic>(client, requestScript: "g.V().count()");
  long statusCode = (long)responseResultSet.StatusAttributes["x-ms-status-code"];
  double totalRequestCharge = (double)responseResultSet.StatusAttributes["x-ms-total-request-charge"];

  // Status code and request charge are logged into application telemetry.
}

Gremlin Java istemcisinden durum özniteliğinin nasıl okunduğunu gösteren bir örnek:

try {
  ResultSet resultSet = this.client.submit("g.addV().property('id', '13')");
  List<Result> results = resultSet.all().get();

  // Process and consume results

} catch (ResponseException re) {
  // Check for known errors that need to be retried or skipped
  if (re.getStatusAttributes().isPresent()) {
    Map<String, Object> attributes = re.getStatusAttributes().get();
    int statusCode = (int) attributes.getOrDefault("x-ms-status-code", -1);

    // Now we can check for specific conditions
    if (statusCode == 409) {
        // Handle conflicting writes
      }
    }

    // Check if we need to delay retry
    if (attributes.containsKey("x-ms-retry-after-ms")) {
      // Read the value of the attribute as is
      String retryAfterTimeSpan = (String) attributes.get("x-ms-retry-after-ms"));

      // Convert the value into actionable duration
			LocalTime locaTime = LocalTime.parse(retryAfterTimeSpan);
			Duration duration = Duration.between(LocalTime.MIN, locaTime);

      // Perform a retry after "duration" interval of time has elapsed
    }
  }
}

Sonraki adımlar

• Azure Cosmos DB için HTTP durum kodları
• Yaygın Azure Cosmos DB REST yanıt üst bilgileri
• TinkerPop Graph Sürücü Sağlayıcısı Gereksinimleri