Azure Cosmos DB لعناوين استجابة خادم Gremlin

ينطبق على: العفريت

تتناول هذه المقالة العناوين التي يقوم Azure Cosmos DB لخادم Gremlin بإرجاعها إلى المتصل عند تنفيذ الطلب. هذه العناوين مفيدة لاستكشاف أخطاء أداء الطلب وإصلاحها، وبناء التطبيق الذي يتكامل أصلا مع خدمة Azure Cosmos DB وتبسيط دعم العملاء.

ضع في اعتبارك أن الاعتماد على هذه الرؤوس يعني أنك تحد من إمكانية نقل تطبيقك إلى تطبيقات Gremlin الأخرى. في المقابل، تكتسب تكاملا أكثر إحكاما مع Azure Cosmos DB ل Gremlin. هذه الرؤوس ليست من معايير TinkerPop.

الرؤوس

تعليمات الحالة البرمجية

يتم سرد معظم الرموز الشائعة التي يتم إرجاعها لسمة الحالة x-ms-status-code بواسطة الخادم أدناه.

العينات

نموذج تطبيق عميل مبني على Gremlin.Net يقرأ سمة حالة واحدة:

// 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:

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

الخطوات التالية

• رموز حالة HTTP لـ Azure Cosmos DB
• رؤوس استجابة Azure Cosmos DB REST الشائعة
• متطلبات مزود برنامج تشغيل TinkerPop Graph