Azure Cosmos DB for Gremlin 서버 응답 헤더

적용 대상: Gremlin

이 문서에서는 Azure Cosmos DB for Gremlin 서버가 요청 실행 시 호출자에게 반환하는 헤더에 대해 설명합니다. 이러한 헤더는 Azure Cosmos DB 서비스에 기본적으로 통합되고 고객 지원을 간소화하는 애플리케이션을 구축하는 요청 성능 문제 해결에 유용합니다.

이러한 헤더에 대한 종속성을 사용하면 애플리케이션의 이식성을 다른 Gremlin 구현으로 제한할 수 있습니다. 반환 시 Azure Cosmos DB for 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
    }
  }
}

다음 단계

• Azure Cosmos DB에 대한 HTTP 상태 코드
• 일반 Azure Cosmos DB REST 응답 헤더
• TinkerPop Graph 드라이버 공급자 요구 사항