Header respons server Azure Cosmos DB untuk Gremlin

BERLAKU UNTUK: Gremlin

Artikel ini membahas header yang dikembalikan azure Cosmos DB untuk server Gremlin ke pemanggil setelah eksekusi permintaan. Header ini berguna untuk memecahkan masalah performa permintaan, membangun aplikasi yang terintegrasi secara asli dengan layanan Azure Cosmos DB dan menyederhanakan dukungan pelanggan.

Perlu diingat bahwa mengambil ketergantungan pada header ini Anda membatasi portabilitas aplikasi Anda ke implementasi Gremlin lainnya. Sebagai gantinya, Anda mendapatkan integrasi yang lebih ketat dengan Azure Cosmos DB untuk Gremlin. Header ini bukan standar TinkerPop.

Header

Kode status

Sebagian besar kode umum yang dikembalikan untuk x-ms-status-code atribut status oleh server tercantum di bawah ini.

Sampel

Contoh aplikasi klien berdasarkan Gremlin.Net yang membaca satu atribut status:

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

Contoh yang menunjukkan cara membaca atribut status dari klien Gremlin Java:

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

Langkah berikutnya

• Daftar Kode Status HTTP untuk Azure Cosmos DB
• Header respons Common Azure Cosmos DB REST
• Persyaratan Penyedia Driver TinkerPop Graph