Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# API `profile` Gremlin di Neptune
API `profile` Gremlin Neptune menjalankan traversal Gremlin, mengumpulkan berbagai metrik tentang proses, dan menghasilkan laporan profil sebagai output.
Ini berbeda dari TinkerPop langkah.profile () sehingga dapat melaporkan informasi khusus untuk mesin Neptunus.
Laporan profil mencakup informasi berikut tentang rencana kueri:
+ Alur operator fisik
+ Operasi indeks untuk eksekusi dan serialisasi kueri
+ Ukuran hasilnya
API `profile` menggunakan versi diperpanjang dari sintaks HTTP API untuk kueri, dengan `/gremlin/profile` sebagai titik akhir alih-alih `/gremlin`.
## Parameter khusus untuk `profile` Gremlin Neptune
+ **profile.results** — `boolean`, nilai yang diizinkan: `TRUE` dan `FALSE`, nilai default: `TRUE`.
Jika true, hasil kueri dikumpulkan dan ditampilkan sebagai bagian dari laporan `profile`. Jika false, hanya jumlah hasil yang ditampilkan.
+ **profile.chop** — `int`, nilai default: 250.
Jika non-nol, menyebabkan hasil string akan dipotong pada jumlah karakter tersebut. Hal ini tidak menjaga semua hasil dari ditangkap. Ini hanya membatasi ukuran string dalam laporan profil. Jika diatur ke nol, string berisi semua hasil.
+ **profile.serializer** – `string`, nilai default: ``.
Jika non-null, hasil yang dikumpulkan dikembalikan dalam pesan respons serial dalam format yang ditentukan oleh parameter ini. Jumlah operasi indeks yang diperlukan untuk menghasilkan pesan respons dilaporkan bersama dengan ukuran dalam byte yang akan dikirim ke klien.
Nilai yang diizinkan adalah `` atau salah satu jenis MIME yang valid atau nilai enum “Serializers” TinkerPop driver.
```
"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`, nilai yang diizinkan: `TRUE` dan `FALSE`, nilai default: `FALSE`.
Jika true, menunjukkan laporan detail dari semua operasi indeks yang terjadi selama eksekusi dan serialisasi kueri. Peringatan: Laporan ini bisa verbose.
## Contoh output dari `profile` Gremlin Neptune
Berikut ini adalah sampel kueri `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"}'
```
Query ini menghasilkan laporan `profile` berikut ketika dieksekusi pada grafik sampel rute udara dari posting blog, [Mari Saya Grafikkan Untuk Anda - Bagian 1 - Rute Udara](https://aws.amazon.com/blogs/database/let-me-graph-that-for-you-part-1-air-routes/).
```
*******************************************************
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
```
Selain rencana kueri dikembalikan oleh panggilan ke Neptune `explain`, hasil `profile` menyertakan statistik runtime sekitar eksekusi kueri. Setiap operasi Gabungan ditandai dengan waktu yang dibutuhkan untuk melakukan penggabungannya serta jumlah sebenarnya dari solusi yang melewatinya.
Output `profile` menyertakan waktu yang dibutuhkan selama fase eksekusi kueri inti, serta fase serialisasi jika opsi `profile.serializer` telah ditentukan.
Rincian operasi indeks yang dilakukan selama setiap fase juga disertakan di bagian bawah output `profile`.
Perhatikan bahwa proses berturut-turut dari kueri yang sama dapat menunjukkan hasil yang berbeda dalam hal operasi run-time dan indeks karena caching.
Untuk kueri yang menggunakan langkah `repeat()`, rincian perbatasan pada setiap iterasi tersedia jika langkah `repeat()` didorong ke bawah sebagai bagian dari `NeptuneGraphQueryStep`.
## Perbedaan dalam laporan `profile` saat DFE diaktifkan
Ketika mesin kueri alternatif Neptune DFE diaktifkan, output `profile` agak berbeda:
**Dioptimalkan oleh Traversal:** Bagian ini serupa dengan yang ada di output `explain`, tetapi berisi informasi tambahan. Ini menyertakan jenis operator DFE yang dipertimbangkan dalam perencanaan, dan kasus terburuk terkait dan perkiraan biaya kasus terbaik.
**Physical Pipeline:** Bagian ini menangkap operator yang digunakan untuk mengeksekusi query. `DFESubQuery`elemen abstrak rencana fisik yang digunakan oleh DFE untuk melaksanakan bagian dari rencana yang menjadi tanggung jawabnya. `DFESubQuery`Elemen-elemen tersebut dibuka di bagian berikut di mana statistik DFE terdaftar.
**DFEQueryStatistik Mesin:** Bagian ini muncul hanya ketika setidaknya sebagian dari kueri dijalankan oleh DFE. Ini menguraikan berbagai statistik runtime yang khusus untuk DFE, dan berisi rincian rinci dari waktu yang dihabiskan di berbagai bagian eksekusi kueri, oleh. `DFESubQuery`
Subquery bersarang dalam `DFESubQuery` elemen yang berbeda diratakan di bagian ini, dan pengidentifikasi unik ditandai dengan header yang dimulai dengan. `subQuery=`
**Metrik Traversal:** Bagian ini menunjukkan metrik traversal tingkat langkah, dan ketika mesin DFE menjalankan semua atau sebagian kueri, menampilkan metrik untuk dan/atau. `DFEStep` `NeptuneInterleavingStep` Lihat [Menyetel kueri Gremlin menggunakan `explain` dan `profile`](gremlin-traversal-tuning.md).
**catatan**
DFE adalah fitur eksperimental yang dirilis dalam mode lab, format tepat output `profile` dapat berubah.
## Sampel output `profile` ketika Neptune Dataflow engine (DFE) diaktifkan
Ketika mesin DFE sedang digunakan untuk menjalankan query Gremlin, output dari diformat seperti yang [API `profile` Gremlin](#gremlin-profile-api) ditunjukkan pada contoh di bawah ini.
Kueri:
```
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
```
**catatan**
Karena mesin DFE adalah fitur eksperimental yang dirilis dalam mode lab, format `profile` output yang tepat dapat berubah.