기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Neptune의 Gremlin `profile` API
Neptune Gremlin `profile` API는 지정된 Gremlin 순회를 실행하고 해당 실행에 대한 다양한 지표를 수집하여 출력 지표로서 프로파일 보고서를 만듭니다.
이는 Neptune 엔진 고유의 정보를 보고할 수 있다는 점에서 TinkerPop .profile() 단계와 다릅니다.
프로파일 보고서에는 다음과 같이 쿼리 계획에 대한 정보가 포함됩니다.
+ 물리적 연산자 파이프라인
+ 쿼리 실행 및 직렬화를 위한 인덱스 작업
+ 결과 크기
`profile` API는 쿼리에서 엔드포인트로 `/gremlin` 대신 `/gremlin/profile`를 사용하는 연장된 버전의 HTTP API 구문을 사용합니다.
## Neptune Gremlin `profile` 전용 파라미터
+ **profile.results** – `boolean`, 허용된 값: `TRUE` 및 `FALSE`, 기본값: `TRUE`.
쿼리 결과가 true이면 `profile` 보고서의 일부로 수집 및 표시됩니다. false인 경우에는 결과 수만 표시됩니다.
+ **profile.chop** – `int`, 기본값: 250.
0으로 설정되어 있지 않으면 결과 문자열이 해당되는 문자 수에서 잘립니다. 이렇게 하면 모든 결과가 캡처되는 것을 막을 수 있습니다. 또한 프로파일 보고서에서 문자열의 크기를 간단히 제한할 수 있습니다. 0으로 설정되어 있으면 문자열에 모든 결과가 포함됩니다.
+ **profile.serializer** – `string`, 기본값: ``.
null이 아니면 수집된 결과가 직렬화된 응답 메시지에서 이 파라미터가 지정한 형식으로 반환됩니다. 이러한 응답 메시지를 만들기 위해 필요한 인덱스 작업의 수가 클라이언트에 전송되는 바이트 크기와 함께 보고됩니다.
허용값은 `` 또는 모든 유효한 MIME 형식 또는 TinkerPop 드라이버 "Serializers" 열거형 값입니다.
```
"application/json" or "GRAPHSON"
"application/vnd.gremlin-v1.0+json" or "GRAPHSON_V1"
"application/vnd.gremlin-v1.0+json;types=false" or "GRAPHSON_V1_UNTYPED"
"application/vnd.gremlin-v2.0+json" or "GRAPHSON_V2"
"application/vnd.gremlin-v2.0+json;types=false" or "GRAPHSON_V2_UNTYPED"
"application/vnd.gremlin-v3.0+json" or "GRAPHSON_V3"
"application/vnd.gremlin-v3.0+json;types=false" or "GRAPHSON_V3_UNTYPED"
"application/vnd.graphbinary-v1.0" or "GRAPHBINARY_V1"
```
+ **profile.indexOps** – `boolean`, 허용된 값: `TRUE` 및 `FALSE`, 기본값: `FALSE`.
true이면 쿼리 실행 및 직렬화 동안 수행된 모든 인덱스 작업에 대한 세부 보고서가 표시됩니다. 경고: 보고서가 상세 표시될 수 있습니다.
## Neptune Gremlin `profile`의 샘플 출력
다음은 `profile` 쿼리 샘플입니다.
```
curl -k -X POST https://your-neptune-endpoint:port/gremlin/profile \
-d '{"gremlin":"g.V().hasLabel(\"airport\").has(\"code\", \"AUS\").emit().repeat(in().simplePath()).times(2).limit(100)", "profile.serializer":"application/vnd.gremlin-v3.0+json"}'
```
이 쿼리는 블로그 게시물인 [사용자를 대신한 그래프 작성 - 1부 - 항로](https://aws.amazon.com/blogs/database/let-me-graph-that-for-you-part-1-air-routes/) 항로 샘플 그래프에서 실행하면 다음과 같은 `profile` 보고서를 생성합니다.
```
*******************************************************
Neptune Gremlin Profile
*******************************************************
Query String
==================
g.V().hasLabel("airport").has("code", "AUS").emit().repeat(in().simplePath()).times(2).limit(100)
Original Traversal
==================
[GraphStep(vertex,[]), HasStep([~label.eq(airport), code.eq(AUS)]), RepeatStep(emit(true),[VertexStep(IN,vertex), PathFilterStep(simple), RepeatEndStep],until(loops(2))), RangeGlobalStep(0,100)]
Optimized Traversal
===================
Neptune steps:
[
NeptuneGraphQueryStep(Vertex) {
JoinGroupNode {
PatternNode[(?1, , "AUS", ?) . project ?1 .], {estimatedCardinality=1, indexTime=84, hashJoin=true, joinTime=3, actualTotalOutput=1}
PatternNode[(?1, <~label>, ?2=, <~>) . project ask .], {estimatedCardinality=3374, indexTime=29, hashJoin=true, joinTime=0, actualTotalOutput=61}
RepeatNode {
Repeat {
PatternNode[(?3, ?5, ?1, ?6) . project ?1,?3 . IsEdgeIdFilter(?6) . SimplePathFilter(?1, ?3)) .], {hashJoin=true, estimatedCardinality=50148, indexTime=0, joinTime=3}
}
Emit {
Filter(true)
}
LoopsCondition {
LoopsFilter([?1, ?3],eq(2))
}
}, annotations={repeatMode=BFS, emitFirst=true, untilFirst=false, leftVar=?1, rightVar=?3}
}, finishers=[limit(100)], annotations={path=[Vertex(?1):GraphStep, Repeat[Vertex(?3):VertexStep]], joinStats=true, optimizationTime=495, maxVarId=7, executionTime=323}
},
NeptuneTraverserConverterStep
]
Physical Pipeline
=================
NeptuneGraphQueryStep
|-- StartOp
|-- JoinGroupOp
|-- SpoolerOp(100)
|-- DynamicJoinOp(PatternNode[(?1, , "AUS", ?) . project ?1 .], {estimatedCardinality=1, indexTime=84, hashJoin=true})
|-- SpoolerOp(100)
|-- DynamicJoinOp(PatternNode[(?1, <~label>, ?2=, <~>) . project ask .], {estimatedCardinality=3374, indexTime=29, hashJoin=true})
|-- RepeatOp
|-- (Iteration 0) [visited=1, output=1 (until=0, emit=1), next=1]
|-- BindingSetQueue (Iteration 1) [visited=61, output=61 (until=0, emit=61), next=61]
|-- SpoolerOp(100)
|-- DynamicJoinOp(PatternNode[(?3, ?5, ?1, ?6) . project ?1,?3 . IsEdgeIdFilter(?6) . SimplePathFilter(?1, ?3)) .], {hashJoin=true, estimatedCardinality=50148, indexTime=0})
|-- BindingSetQueue (Iteration 2) [visited=38, output=38 (until=38, emit=0), next=0]
|-- SpoolerOp(100)
|-- DynamicJoinOp(PatternNode[(?3, ?5, ?1, ?6) . project ?1,?3 . IsEdgeIdFilter(?6) . SimplePathFilter(?1, ?3)) .], {hashJoin=true, estimatedCardinality=50148, indexTime=0})
|-- LimitOp(100)
Runtime (ms)
============
Query Execution: 392.686
Serialization: 2636.380
Traversal Metrics
=================
Step Count Traversers Time (ms) % Dur
-------------------------------------------------------------------------------------------------------------
NeptuneGraphQueryStep(Vertex) 100 100 314.162 82.78
NeptuneTraverserConverterStep 100 100 65.333 17.22
>TOTAL - - 379.495 -
Repeat Metrics
==============
Iteration Visited Output Until Emit Next
------------------------------------------------------
0 1 1 0 1 1
1 61 61 0 61 61
2 38 38 38 0 0
------------------------------------------------------
100 100 38 62 62
Predicates
==========
# of predicates: 16
WARNING: reverse traversal with no edge label(s) - .in() / .both() may impact query performance
Results
=======
Count: 100
Output: [v[3], v[3600], v[3614], v[4], v[5], v[6], v[7], v[8], v[9], v[10], v[11], v[12], v[47], v[49], v[136], v[13], v[15], v[16], v[17], v[18], v[389], v[20], v[21], v[22], v[23], v[24], v[25], v[26], v[27], v[28], v[416], v[29], v[30], v[430], v[31], v[9...
Response serializer: GRYO_V3D0
Response size (bytes): 23566
Index Operations
================
Query execution:
# of statement index ops: 3
# of unique statement index ops: 3
Duplication ratio: 1.0
# of terms materialized: 0
Serialization:
# of statement index ops: 200
# of unique statement index ops: 140
Duplication ratio: 1.43
# of terms materialized: 393
```
Neptune `explain`로의 호출을 통해 반환되는 쿼리 계획 외에도 `profile` 결과에는 쿼리 실행과 관련된 런타임 통계가 포함됩니다. 각 조인 작업에는 조인 수행에 소요된 시간을 비롯해 이를 통해 전달된 실제 솔루션의 수가 태그로 지정됩니다.
`profile` 출력에는 핵심 쿼리 실행 단계 동안 소요된 시간을 비롯해 `profile.serializer` 직렬화 단계(옵션이 지정된 경우)가 포함됩니다.
각 단계 동안 수행된 인덱스 작업에 대한 분석도 `profile` 출력 하단에 포함됩니다.
동일한 쿼리를 연속적으로 실행하면 캐싱으로 인해 런타임 및 인덱스 작업 측면에서 서로 다른 결과가 표시될 수 있습니다.
`repeat()` 단계를 사용하는 쿼리의 경우, `repeat()` 단계가 `NeptuneGraphQueryStep`의 일부로 푸시 다운된 경우에 각 반복 작업의 경계 지대에 대한 분석이 제공됩니다.
## DFE가 활성화된 경우의 `profile` 보고서 차이
Neptune DFE 대체 쿼리 엔진이 활성화되면 `profile` 출력이 약간 달라집니다.
**최적화된 순회:** 이 섹션은 `explain` 출력 섹션과 비슷하지만, 추가 정보가 포함되어 있습니다. 여기에는 계획 시 고려했던 DFE 연산자 유형, 관련 최악의 사례 및 최적 사례 비용 추정치가 포함됩니다.
**물리적 파이프라인:** 이 섹션에서는 쿼리를 실행하는 데 사용되는 연산자를 캡처합니다. `DFESubQuery` 요소는 DFE가 담당하는 계획의 일부를 실행하는 데 사용하는 물리적 계획을 추상화합니다. `DFESubQuery` 요소는 DFE 통계가 나열된 다음 섹션에 설명되어 있습니다.
**DFEQueryEngine 통계:** 이 섹션은 쿼리의 적어도 일부가 DFE에 의해 실행되는 경우에만 표시됩니다. DFE에 특화된 다양한 런타임 통계를 요약하고, `DFESubQuery`에 의한 쿼리 실행의 여러 부분에 소요된 시간을 세부적으로 분석한 정보를 포함합니다.
이 섹션에서는 다양한 `DFESubQuery` 요소의 중첩된 하위 쿼리를 단순화하고, 고유 식별자는 `subQuery=`로 시작하는 헤더로 표시됩니다.
**순회 지표:** 이 섹션에는 단계별 순회 지표가 표시되며, DFE 엔진이 쿼리의 전체 또는 일부를 실행하는 경우 `DFEStep` 및/또는 `NeptuneInterleavingStep`에 대한 지표가 표시됩니다. [`explain` 및 `profile`을 사용하여 Gremlin 쿼리 조정](gremlin-traversal-tuning.md)을(를) 참조하세요.
**참고**
DFE는 랩 모드에서 출시된 실험용 기능이므로, `profile` 출력의 정확한 형식은 여전히 변경될 수 있습니다.
## Neptune 데이터 흐름 엔진(DFE)이 활성화된 경우의 샘플 `profile` 출력
DFE 엔진을 사용하여 Gremlin 쿼리를 실행하는 경우 [Gremlin `profile` API](#gremlin-profile-api)의 출력 형식은 아래 예제와 같이 지정됩니다.
쿼리:
```
curl https://your-neptune-endpoint:port/gremlin/profile \
-d "{\"gremlin\": \"g.withSideEffect('Neptune#useDFE', true).V().has('code', 'ATL').out()\"}"
```
```
*******************************************************
Neptune Gremlin Profile
*******************************************************
Query String
==================
g.withSideEffect('Neptune#useDFE', true).V().has('code', 'ATL').out()
Original Traversal
==================
[GraphStep(vertex,[]), HasStep([code.eq(ATL)]), VertexStep(OUT,vertex)]
Optimized Traversal
===================
Neptune steps:
[
DFEStep(Vertex) {
DFENode {
DFEJoinGroupNode[null](
children=[
DFEPatternNode((?1, vp://code[419430926], ?4, defaultGraph[526]) . project DISTINCT[?1] objectFilters=(in(ATL[452987149]) . ), {rangeCountEstimate=1},
opInfo=(type=PipelineJoin, cost=(exp=(in=1.00,out=1.00,io=0.00,comp=0.00,mem=0.00),wc=(in=1.00,out=1.00,io=0.00,comp=0.00,mem=0.00)),
disc=(type=PipelineScan, cost=(exp=(in=1.00,out=1.00,io=0.00,comp=0.00,mem=34.00),wc=(in=1.00,out=1.00,io=0.00,comp=0.00,mem=34.00))))),
DFEPatternNode((?1, ?5, ?6, ?7) . project ALL[?1, ?6] graphFilters=(!= defaultGraph[526] . ), {rangeCountEstimate=9223372036854775807})],
opInfo=[
OperatorInfoWithAlternative[
rec=(type=PipelineJoin, cost=(exp=(in=1.00,out=27.76,io=0.00,comp=0.00,mem=0.00),wc=(in=1.00,out=27.76,io=0.00,comp=0.00,mem=0.00)),
disc=(type=PipelineScan, cost=(exp=(in=1.00,out=27.76,io=Infinity,comp=0.00,mem=295147905179352830000.00),wc=(in=1.00,out=27.76,io=Infinity,comp=0.00,mem=295147905179352830000.00)))),
alt=(type=PipelineScan, cost=(exp=(in=1.00,out=27.76,io=Infinity,comp=0.00,mem=295147905179352830000.00),wc=(in=1.00,out=27.76,io=Infinity,comp=0.00,mem=295147905179352830000.00)))]])
} [Vertex(?1):GraphStep, Vertex(?6):VertexStep]
} ,
NeptuneTraverserConverterDFEStep,
DFECleanupStep
]
Physical Pipeline
=================
DFEStep
|-- DFESubQuery1
DFEQueryEngine Statistics
=================
DFESubQuery1
╔════╤════════╤════════╤═══════════════════════╤══════════════════════════════════════════════════════════════════════════════════════════════════════════════╤══════╤══════════╤═══════════╤════════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪═══════════════════════╪══════════════════════════════════════════════════════════════════════════════════════════════════════════════╪══════╪══════════╪═══════════╪════════╪═══════════╣
║ 0 │ 1 │ - │ DFESolutionInjection │ solutions=[] │ - │ 0 │ 1 │ 0.00 │ 0.01 ║
║ │ │ │ │ outSchema=[] │ │ │ │ │ ║
╟────┼────────┼────────┼───────────────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 1 │ 2 │ - │ DFEChunkLocalSubQuery │ subQuery=http://aws.amazon.com/neptune/vocab/v01/dfe/past/graph#089f43e3-4d71-4259-8d19-254ff63cee04/graph_1 │ - │ 1 │ 1 │ 1.00 │ 0.02 ║
╟────┼────────┼────────┼───────────────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 2 │ 3 │ - │ DFEChunkLocalSubQuery │ subQuery=http://aws.amazon.com/neptune/vocab/v01/dfe/past/graph#089f43e3-4d71-4259-8d19-254ff63cee04/graph_2 │ - │ 1 │ 242 │ 242.00 │ 0.02 ║
╟────┼────────┼────────┼───────────────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 3 │ 4 │ - │ DFEMergeChunks │ - │ - │ 242 │ 242 │ 1.00 │ 0.01 ║
╟────┼────────┼────────┼───────────────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 4 │ - │ - │ DFEDrain │ - │ - │ 242 │ 0 │ 0.00 │ 0.01 ║
╚════╧════════╧════════╧═══════════════════════╧══════════════════════════════════════════════════════════════════════════════════════════════════════════════╧══════╧══════════╧═══════════╧════════╧═══════════╝
subQuery=http://aws.amazon.com/neptune/vocab/v01/dfe/past/graph#089f43e3-4d71-4259-8d19-254ff63cee04/graph_1
╔════╤════════╤════════╤══════════════════════╤═════════════════════════════════════════════════════════════╤══════╤══════════╤═══════════╤═══════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪══════════════════════╪═════════════════════════════════════════════════════════════╪══════╪══════════╪═══════════╪═══════╪═══════════╣
║ 0 │ 1 │ - │ DFEPipelineScan │ pattern=Node(?1) with property 'code' as ?4 and label 'ALL' │ - │ 0 │ 1 │ 0.00 │ 0.22 ║
║ │ │ │ │ inlineFilters=[(?4 IN ["ATL"])] │ │ │ │ │ ║
║ │ │ │ │ patternEstimate=1 │ │ │ │ │ ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 1 │ 2 │ - │ DFEMergeChunks │ - │ - │ 1 │ 1 │ 1.00 │ 0.02 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 2 │ 4 │ - │ DFERelationalJoin │ joinVars=[] │ - │ 2 │ 1 │ 0.50 │ 0.09 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 3 │ 2 │ - │ DFESolutionInjection │ solutions=[] │ - │ 0 │ 1 │ 0.00 │ 0.01 ║
║ │ │ │ │ outSchema=[] │ │ │ │ │ ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────────────────────────────┼──────┼──────────┼───────────┼───────┼───────────╢
║ 4 │ - │ - │ DFEDrain │ - │ - │ 1 │ 0 │ 0.00 │ 0.01 ║
╚════╧════════╧════════╧══════════════════════╧═════════════════════════════════════════════════════════════╧══════╧══════════╧═══════════╧═══════╧═══════════╝
subQuery=http://aws.amazon.com/neptune/vocab/v01/dfe/past/graph#089f43e3-4d71-4259-8d19-254ff63cee04/graph_2
╔════╤════════╤════════╤══════════════════════╤═════════════════════════════════════╤══════╤══════════╤═══════════╤════════╤═══════════╗
║ ID │ Out #1 │ Out #2 │ Name │ Arguments │ Mode │ Units In │ Units Out │ Ratio │ Time (ms) ║
╠════╪════════╪════════╪══════════════════════╪═════════════════════════════════════╪══════╪══════════╪═══════════╪════════╪═══════════╣
║ 0 │ 1 │ - │ DFESolutionInjection │ solutions=[] │ - │ 0 │ 1 │ 0.00 │ 0.01 ║
║ │ │ │ │ outSchema=[?1] │ │ │ │ │ ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 1 │ 2 │ 3 │ DFETee │ - │ - │ 1 │ 2 │ 2.00 │ 0.01 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 2 │ 4 │ - │ DFEDistinctColumn │ column=?1 │ - │ 1 │ 1 │ 1.00 │ 0.21 ║
║ │ │ │ │ ordered=false │ │ │ │ │ ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 3 │ 5 │ - │ DFEHashIndexBuild │ vars=[?1] │ - │ 1 │ 1 │ 1.00 │ 0.03 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 4 │ 5 │ - │ DFEPipelineJoin │ pattern=Edge((?1)-[?7:?5]->(?6)) │ - │ 1 │ 242 │ 242.00 │ 0.51 ║
║ │ │ │ │ constraints=[] │ │ │ │ │ ║
║ │ │ │ │ patternEstimate=9223372036854775807 │ │ │ │ │ ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 5 │ 6 │ 7 │ DFESync │ - │ - │ 243 │ 243 │ 1.00 │ 0.02 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 6 │ 8 │ - │ DFEForwardValue │ - │ - │ 1 │ 1 │ 1.00 │ 0.01 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 7 │ 8 │ - │ DFEForwardValue │ - │ - │ 242 │ 242 │ 1.00 │ 0.02 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 8 │ 9 │ - │ DFEHashIndexJoin │ - │ - │ 243 │ 242 │ 1.00 │ 0.31 ║
╟────┼────────┼────────┼──────────────────────┼─────────────────────────────────────┼──────┼──────────┼───────────┼────────┼───────────╢
║ 9 │ - │ - │ DFEDrain │ - │ - │ 242 │ 0 │ 0.00 │ 0.01 ║
╚════╧════════╧════════╧══════════════════════╧═════════════════════════════════════╧══════╧══════════╧═══════════╧════════╧═══════════╝
Runtime (ms)
============
Query Execution: 11.744
Traversal Metrics
=================
Step Count Traversers Time (ms) % Dur
-------------------------------------------------------------------------------------------------------------
DFEStep(Vertex) 242 242 10.849 95.48
NeptuneTraverserConverterDFEStep 242 242 0.514 4.52
>TOTAL - - 11.363 -
Predicates
==========
# of predicates: 18
Results
=======
Count: 242
Index Operations
================
Query execution:
# of statement index ops: 0
# of terms materialized: 0
```
**참고**
DFE 엔진은 랩 모드에서 출시된 실험용 기능이기 때문에 `profile` 출력의 정확한 형식은 변경될 수 있습니다.