Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Verwendung von Magie in Amazon Neptune-Notizbüchern Die Neptune-Workbench stellt in den Notebooks mehrere so genannte *Magics*-Befehle bereit, die viel Zeit und Aufwand sparen. Sie können in zwei Kategorien eingeteilt werden: *Zeilen-Magics* und *Zellen-Magics*. *Zeilen-Magics* sind Befehle, denen ein einzelnes Prozentzeichen (`%`) vorangestellt ist. Sie akzeptieren nur Zeileneingaben, keine Eingaben vom Rest der Zelle. Die Neptune-Workbench stellt die folgenden Zeilen-Magics bereit: + [%seed](#notebooks-line-magics-seed) + [%load](#notebooks-line-magics-load) + [%load\_ids](#notebooks-line-magics-load-ids) + [%load\_status](#notebooks-line-magics-load-status) + [%cancel\_load](#notebooks-line-magics-cancel-load) + [%status](#notebooks-line-magics-status) + [%gremlin\_status](#notebooks-line-magics-gremlin-status) + [%opencypher\_status oder %oc\_status](#notebooks-line-magics-opencypher-status) + [`%stream_viewer`](#notebooks-line-magics-stream-viewer) + [%sparql\_status](#notebooks-line-magics-sparql-status) + [%graph\_notebook\_config](#notebooks-line-magics-graph-notebook-config) + [%graph\_notebook\_host](#notebooks-line-magics-graph-notebook-host) + [%graph\_notebook\_version](#notebooks-line-magics-graph-notebook-version) + [%graph\_notebook\_service](#notebooks-line-magics-graph-notebook-service) + [%graph\_notebook\_vis\_options](#notebooks-line-magics-graph-notebook-vis-options) + [%statistics](#notebooks-line-magics-statistics) + [%summary](#notebooks-line-magics-summary) + [%reset\_graph](#notebooks-line-magics-reset-graph) + [%get\_graph](#notebooks-line-magics-get-graph) + [%DegreeDistribution](#notebooks-line-magics-degreeDistribution) *Zellen-Magics* sind Befehle, denen zwei (`%%`) vorangestellt sind. Sie verwenden den Zelleninhalt als Eingabe, können jedoch auch Zeileninhalte als Eingabe verwenden. Die Neptune-Workbench stellt die folgenden Zellen-Magics bereit: + [%%sparql](#notebooks-cell-magics-sparql) + [%%gremlin](#notebooks-cell-magics-gremlin) + [%%opencypher oder %%oc](#notebooks-cell-magics-opencypher) + [%%graph\_notebook\_config](#notebooks-cell-magics-graph-notebook-config) + [%%graph\_notebook\_vis\_options](#notebooks-cell-magics-graph-notebook-vis-options) Es gibt auch zwei Magics, eine Zeilen-Magics und eine Zellen-Magics für [Neptune Machine Learning](machine-learning.md). + [%neptune\_ml](#notebooks-line-magics-neptune_ml) + [%%neptune\_ml](#notebooks-cell-magics-neptune_ml) **Anmerkung** Beim Arbeiten mit Neptune-Magics können Sie in der Regel über den Parameter `--help` oder `-h` einen Hilfetext abrufen. Der Text einer Zellen-Magics darf nicht leer sein. Wenn Sie Hilfe abrufen, müssen Sie daher einen Text eingeben, auch wenn es nur ein einzelnes Zeichen ist. Beispiel: ``` %%gremlin --help x ``` ## Variable Injektion in Zellen- oder Zeilen-Magics In einem Notebook definierte Variablen können in jeder Zellen- oder Zeilen-Magics im Notebook im folgenden Format referenziert werden: `${VAR_NAME}`. Angenommen, Sie definieren die folgenden Variablen: ``` c = 'code' my_edge_labels = '{"route":"dist"}' ``` Dann ist diese Gremlin-Abfrage in einer Zellen-Magics: ``` %%gremlin -de $my_edge_labels g.V().has('${c}','SAF').out('route').values('${c}') ``` Dies entspricht: ``` %%gremlin -de {"route":"dist"} g.V().has('code','SAF').out('route').values('code') ``` ## Abfrageargumente, die mit allen Abfragesprachen funktionieren Die folgenden Abfrageargumente funktionieren mit `%%gremlin`-, `%%opencypher`- und `%%sparql`-Magics in der Neptune-Workbench: **Allgemeine Abfrageargumente** + **`--store-to`** (oder **`-s`**)   –   Gibt den Namen der Variablen an, in der die Abfrageergebnisse gespeichert werden sollen. + **`--silent`**   –   Wenn vorhanden, wird nach Abschluss der Abfrage keine Ausgabe angezeigt. + **`--group-by`** (oder **`-g`**)   –   Gibt die Eigenschaft an, die zum Gruppieren von Knoten verwendet wird (z. B. `code` oder `T.region`). Die Farbe der Eckpunkte ist von der Gruppe abhängig, der sie zugewiesen sind. + **`--ignore-groups`**   –   Wenn vorhanden, werden alle Gruppierungsoptionen ignoriert. + **`--display-property`** (oder **`-d`**)   –   Gibt die Eigenschaft an, deren Wert für jeden Eckpunkt angezeigt werden soll. Der Standardwert für jede Abfragesprache ist wie folgt: + Für Gremlin:   `T.label`. + Für openCypher:   `~labels`. + Für SPARQL:   `type`. + **`--edge-display-property`** (or **`-t`**)   –   Gibt die Eigenschaft an, deren Wert für jede Kante angezeigt werden soll. Der Standardwert für jede Abfragesprache ist wie folgt: + Für Gremlin:   `T.label`. + Für openCypher:   `~labels`. + Für SPARQL:   `type`. + **`--tooltip-property`** (oder **`-de`**)   –   Gibt die Eigenschaft an, deren Wert als QuickInfo für jeden Knoten angezeigt werden soll. Der Standardwert für jede Abfragesprache ist wie folgt: + Für Gremlin:   `T.label`. + Für openCypher:   `~labels`. + Für SPARQL:   `type`. + **`--edge-tooltip-property`** (oder **`-te`**)   –   Gibt eine Eigenschaft an, deren Wert als QuickInfo für jede Kante angezeigt werden soll. Der Standardwert für jede Abfragesprache ist wie folgt: + Für Gremlin:   `T.label`. + Für openCypher:   `~labels`. + Für SPARQL:   `type`. + **`--label-max-length `** (oder **`-l`**)   –   Gibt die maximale Zeichenlänge einer Eckpunktbezeichnung an. Der Standardwert ist 10. + **`--edge-label-max-length `** (oder **`-le`**)   –   Gibt die maximale Zeichenlänge einer Kantenbezeichnung an. Der Standardwert ist 10. Nur im Fall von openCypher ist dies stattdessen `--rel-label-max-length` oder `-rel`. + **`--simulation-duration`** (oder **`-sd`**)   –   Gibt die maximale Dauer der Visualisierungsphysik-Simulation an. Der Standardwert ist 1 500 ms. + **`--stop-physics`** (oder **`-sp`**)   –   Deaktiviert die Visualisierungsphysik nach Stabilisierung der ursprünglichen Simulation. Eigenschaftswerte für diese Argumente können entweder aus einem einzelnen Eigenschaftsschlüssel oder aus einer JSON-Zeichenfolge bestehen, die für jeden Labeltyp eine andere Eigenschaft angeben kann. Eine JSON-Zeichenfolge kann nur durch [Variableneinfügung](#notebook-magics-variable-injection) angegeben werden. ## Die magische `` %seed-Linie Die Zeilen-Magics `%seed` ist eine bequeme Methode, wie Sie Ihrem Neptune-Endpunkt Daten hinzufügen können, um Gremlin-, openCypher- oder SPARQL-Abfragen zu untersuchen und mit ihnen zu experimentieren. Sie stellt ein Formular bereit, in dem Sie das Datenmodell auswählen können, das Sie untersuchen möchten (Eigenschaftsdiagramm oder RDF). Anschließend können Sie aus verschiedenen Beispieldatensätzen auswählen, die Neptune bereitstellt. ## Die Magie der `%load-Line` Die Zeilen-Magics `%load` generiert ein Formular, mit dem Sie eine Massenladeanforderung an Neptune senden können (siehe [Neptune-Loader-Befehl](load-api-reference-load.md)). Die Quelle muss ein Amazon-S3-Pfad in derselben Region wie der Neptune-Cluster sein. ## Die Magie der `%load_ids-Zeile` Die Zeilen-Magics `%load_ids` ruft die Lade-IDs ab, die an den Host-Endpunkt des Notebooks gesendet wurden (siehe [Neptune Loader-Anforderungsparameter Get-Status](load-api-reference-status-requests.md#load-api-reference-status-parameters)). Die Anforderung hat folgendes Format: ``` GET https://{{your-neptune-endpoint}}:{{port}}/loader ``` ## Die Magie der %load\_status-Zeile `` Die Zeilen-Magics `%load_status` ruft den Ladestatus eines bestimmten Ladeauftrags ab, der an den Host-Endpunkt des Notebooks gesendet wurde, angegeben durch die Zeileneingabe (siehe [Neptune Loader-Anforderungsparameter Get-Status](load-api-reference-status-requests.md#load-api-reference-status-parameters)). Die Anforderung hat folgendes Format: ``` GET https://{{your-neptune-endpoint}}:{{port}}/loader?loadId={{loadId}} ``` Die Zeilen-Magics sieht wie folgt aus: ``` %load_status {{load id}} ``` ## Die Magie der %cancel\_load-Zeile `` Die Zeilen-Magics `%cancel_load` bricht einen bestimmten Ladeauftrag ab (siehe [Neptune-Loader – Auftrag abbrechen](load-api-reference-cancel.md)). Die Anforderung hat folgendes Format: ``` DELETE https://{{your-neptune-endpoint}}:{{port}}/loader?loadId={{loadId}} ``` Die Zeilen-Magics sieht wie folgt aus: ``` %cancel_load {{load id}} ``` ## Die Magie der %status-Zeile `` Ruft [Statusinformationen](access-graph-status.md) vom Host-Endpunkt des Notebooks ab ([%graph\_notebook\_config](#notebooks-line-magics-graph-notebook-config)zeigt den Host-Endpunkt an). Für Neptune-DB-Hosts werden Statusinformationen vom Integritätsstatus-Endpunkt abgerufen. [https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-status.html](https://docs.aws.amazon.com/neptune/latest/userguide/access-graph-status.html) Für Neptune Analytics-Hosts wird der Status über die API abgerufen. [ GetGraph ](https://docs.aws.amazon.com/neptune-analytics/latest/apiref/API_GetGraph.html) Weitere Informationen finden Sie unter [%get\_graph](#notebooks-line-magics-get-graph). ## Die Magie der `%gremlin_status-Zeile` Ruft [Informationen zum Status einer Gremlin-Abfrage](gremlin-api-status.md) ab. ## Die Magie der `%opencypher_status-Zeile (auch %oc_status`) `` Ruft den Abfragestatus für eine opencypher-Abfrage ab. Die Zeilen-Magics verwendet die folgenden optionalen Argumente: + **`--queryId`** oder **`-q`**   –   Gibt die ID einer bestimmten ausgeführten Abfrage an, deren Status angezeigt werden soll. + **`--cancelQuery`** oder **`-c`**   –   Bricht eine ausgeführte Abfrage ab. Nimmt keinen Wert an. + **`--silent-cancel`** or **`-s`**   –   Wenn `--silent` beim Abbrechen einer Abfrage auf `true`festgelegt ist, wird die ausgeführte Abfrage mit dem HTTP-Antwortcode `200` abgebrochen. Andernfalls wäre der HTTP-Antwortcode `500`. + **`--store-to`**   –   Gibt den Namen der Variablen an, in der die Abfrageergebnisse gespeichert werden sollen. + **`-w/--includeWaiting`**— Nur Neptune DB. Wenn der Wert auf true gesetzt ist und keine anderen Parameter vorhanden sind, werden Statusinformationen für wartende Abfragen sowie für laufende Abfragen zurückgegeben. Dieser Parameter akzeptiert keinen Wert. + **`--state`**— Nur Neptune Analytics. Gibt an, für welche Teilmenge von Abfragestatus der Status abgerufen werden soll. + **`-m/--maxResults`**— Nur Neptune Analytics. Legt eine Obergrenze für die Menge der zurückgegebenen Abfragen fest, die dem Wert von entsprechen. `--state` + **`--silent`**   –   Wenn vorhanden, wird nach Abschluss der Abfrage keine Ausgabe angezeigt. ## Der Zauber der `` %stream\_viewer-Zeile Die Zeilen-Magics `%stream_viewer` zeigt eine Schnittstelle an, die eine interaktive Untersuchung der Einträge ermöglicht, die in Neptune-Streams protokolliert sind, wenn für den Neptune-Cluster Streams aktiviert sind. Der Befehl akzeptiert die folgenden optionalen Argumente: + **`language`**   –   Die Abfragesprache der Stream-Daten: `gremlin` oder `sparql`. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `gremlin`. + **`--limit`**   –   Gibt die maximale Anzahl von Stream-Einträgen an, die pro Seite angezeigt werden sollen. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `10`. **Anmerkung** Die Zeilen-Magics `%stream_viewer` wird nur in den Engine-Versionen 1.0.5.1 und früher vollständig unterstützt. ## Die Magie der %sparql\_status-Zeile `` Ruft [Informationen zum Status einer SPARQL-Abfrage](sparql-api-status.md) ab. ## Die Magie der %graph\_notebook\_config-Zeile `` Diese Zeilen-Magics zeigt das JSON-Objekt an, das die Konfiguration enthält, die das Notebook für die Kommunikation mit Neptune verwendet. Die Konfiguration enthält Folgendes: + `host`: Der Endpunkt, mit dem die Verbindung hergestellt und an den Befehle ausgegeben werden sollen. + `port`: Der Port, der für die Ausgabe von Befehlen an Neptune verwendet wird. Der Standardwert ist `8182`. + `auth_mode`: Der Authentifizierungsmodus, der verwendet werden soll, wenn Befehle an Neptune ausgegeben werden. Dieser muss `IAM` sein, wenn eine Verbindung mit einem Cluster hergestellt wird, für den die IAM-Authentifizierung aktiviert ist, andernfalls `DEFAULT`. + `load_from_s3_arn`: Gibt den Amazon-S3-ARN an, den die Magics `%load` verwenden soll. Wenn dieser Wert leer ist, muss der ARN im Befehl `%load` angegeben werden. + `ssl`: Ein boolescher Wert, der angibt, ob die Verbindung mit Neptune über TLS hergestellt werden soll oder nicht. Der Standardwert ist `true`. + `aws_region`: Die Region, in der dieses Notebook bereitgestellt wird. Diese Informationen werden für die IAM-Authentifizierung und für `%load`-Anforderungen verwendet. Sie können die Konfiguration ändern, indem Sie die Ausgabe für `%graph_notebook_config` in eine neue Zelle kopieren und dort Änderungen ausführen. Wenn Sie dann die Zellen-Magics [%%graph\_notebook\_config](#notebooks-cell-magics-graph-notebook-config) für die neue Zelle ausführen, wird die Konfiguration entsprechend geändert. ## Die Magie der `` %graph\_notebook\_host-Zeile Legt den Host des Notebooks als Zeileneingabe fest. ## Die `Magie der %graph_notebook_version` Zeile Die Zeilen-Magics `%graph_notebook_version` gibt die Versionsnummer des Neptune-Workbench-Notebooks zurück. In Version `1.27` wurde beispielsweise die Diagrammvisualisierung eingeführt. ## Die `Magie der` %graph\_notebook\_service-Zeile Der `%graph_notebook_service` Zeilenzauber legt die Zeileneingabe als den Dienstnamen fest, der für Neptune-Anfragen verwendet wird. ## Die Magie der Zeile `%graph_notebook_vis_options` Die Zeilen-Magics `%graph_notebook_vis_options` zeigt die aktuellen Visualisierungseinstellungen an, die das Notebook verwendet. Diese Optionen werden in der Dokumentation für [vis.js](https://visjs.github.io/vis-network/docs/network/#options) beschrieben. Sie können diese Einstellungen ändern, indem Sie die Ausgabe in eine neue Zelle kopieren, die gewünschten Änderungen ausführen und dann die Zellen-Magics `%%graph_notebook_vis_options` für die Zelle anwenden. Um die Visualisierungseinstellungen auf die Standardwerte zurückzusetzen, können Sie die Zeilen-Magics `%graph_notebook_vis_options` mit dem Parameter `reset` ausführen. Hierdurch werden alle Visualisierungseinstellungen zurückgesetzt: ``` %graph_notebook_vis_options reset ``` ## Die `Magie der %statistics-Linie` Die Zeilen-Magics `%statistics` wird verwendet, um DFE-Engine-Statistiken abzurufen oder zu verwalten (siehe [Verwalten von Statistiken, die die Neptune-DFE-Engine verwenden soll](neptune-dfe-statistics.md)). Diese Magics kann auch verwendet werden, um eine [Diagrammübersicht](neptune-graph-summary.md) abzurufen. Sie akzeptiert die folgenden Parameter: + **`--language`**   –   Die Abfragesprache des Statistikendpunkts: `propertygraph` (oder `pg`) oder `rdf`. Wenn nicht angegeben, ist der Standardwert `propertygraph`. + **`--mode`** (oder **`-m`**)   –   Gibt den Typ der Anforderung oder Aktion an, die gesendet werden soll: `status`, `disableAutoCompute`, `enableAutoCompute`, `refresh`, `delete`, `detailed` oder `basic`). Wenn nicht angegeben, ist der Standardwert `status`. Wenn jedoch `--summary` angegeben ist, ist der Standardwert `basic`. + **`--summary`**   –   Ruft die Diagrammübersicht vom Statistikübersichtendpunkt der ausgewählten Sprache ab. + **`--silent`**   –   Wenn vorhanden, wird nach Abschluss der Abfrage keine Ausgabe angezeigt. + **`--store-to`**   –   Wird verwendet, um eine Variable anzugeben, in der die Abfrageergebnisse gespeichert werden sollen. ## Die Magie der `%summary-Zeile` Die Zeilen-Magics `%summary` wird verwendet, um Informationen zur [Diagrammübersicht](neptune-graph-summary.md) abzurufen. Sie ist ab Neptune-Engine-Version `1.2.1.0` verfügbar. Sie akzeptiert die folgenden Parameter: + **`--language`**   –   Die Abfragesprache des Statistikendpunkts: `propertygraph` (oder `pg`) oder `rdf`. Wenn nicht angegeben, ist der Standardwert `propertygraph`. + **`--detailed`**   –   Schaltet die Anzeige von Strukturfeldern in der Ausgabe ein oder aus. Wenn nicht angegeben, ist der Übersichtsanzeigemodus `basic` der Standardwert. + **`--silent`**   –   Wenn vorhanden, wird nach Abschluss der Abfrage keine Ausgabe angezeigt. + **`--store-to`**   –   Wird verwendet, um eine Variable anzugeben, in der die Abfrageergebnisse gespeichert werden sollen. ## Die Magie der `%reset_graph-Linie` Die `%reset_graph` (oder`%_graph_reset`) -Zeile Magic führt einen [ ResetGraph ](https://docs.aws.amazon.com/neptune-analytics/latest/apiref/API_ResetGraph.html) Aufruf gegen den Neptune Analytics-Endpunkt aus. Sie akzeptiert die folgenden optionalen Zeileneingaben: + -ns oder --no-skip-snapshot — Falls vorhanden, wird ein endgültiger Graph-Snapshot erstellt, bevor die Graphdaten gelöscht werden. + --silent — Falls vorhanden, wird nach dem Absenden des Reset-Aufrufs keine Ausgabe angezeigt. + --store-to — Wird verwendet, um eine Variable anzugeben, auf die die Antwort gespeichert werden soll. ResetGraph ## Der Zauber der %get\_graph-Linie `` Die `%get_graph` Linienmagie ruft Informationen über ein Diagramm über die API ab. [ GetGraph ](https://docs.aws.amazon.com/neptune-analytics/latest/apiref/API_GetGraph.html) Diese Magie ist funktionell identisch mit der, [%status](#notebooks-line-magics-status) wenn sie mit Neptune Analytics verwendet wird. ## Die Magie der %DegreeDistribution-Linie `` Der `%degreeDistribution` Linienzauber erzeugt ein interaktives Histogramm, das die Gradverteilung der Scheitelpunkte in einem Graphen visualisiert. Das Histogramm zeigt die Anzahl der Scheitelpunkte (Y-Achse) an, die einen bestimmten Grad (X-Achse) haben. Es ist nur mit Neptune Analytics verfügbar. Es akzeptiert die folgenden Parameter, die auch im Dropdownmenü ausgewählt werden können: + **`--traversalDirection`**— Gibt an, welcher Grad analysiert werden soll. Muss einer der folgenden Werte sein: `"both"` (Standard)`"inbound"`, oder`"outbound"`. + **`--vertexLabels`**— Filtert Scheitelpunkte nach den bereitgestellten Beschriftungen (z. B.`airport country`). Die Standardeinstellung ist eine leere Liste. + **`--edgeLabels`**— Filtert Kanten nach den bereitgestellten Beschriftungen (z. B.`route`). Die Standardeinstellung ist eine leere Liste. ## Die Magie der `%%sparql-Zelle` Die Zellen-Magics `%%sparql` gibt eine SPARQL-Abfrage an den Neptune-Endpunkt aus. Sie akzeptiert die folgenden optionalen Zeileneingaben: + **`-h` oder `--help`**   –   Gibt Hilfetext zu diesen Parametern zurück. + **`--path`**   –   Stellt dem SPARQL-Endpunkt einen Pfad voran. Wenn Sie zum Beispiel `--path "abc/def"` angeben, wäre `{{host}}:{{port}}/abc/def` der aufgerufene Endpunkt. + **`--expand-all`**   –   Dies ist ein Abfragevisualisierungshinweis, der den Visualizer anweist, alle Ergebnisse für `?s ?p ?o` unabhängig vom Bindungstyp in das Diagramm aufzunehmen. Standardmäßig enthält eine SPARQL-Visualisierung nur Tripelmuster, bei denen `o?` entweder `uri` oder `bnode` (ein leerer Knoten) ist. Alle anderen `?o`-Bindungstypen, wie Literalzeichenfolgen oder Ganzzahlen, werden als Eigenschaften des `?s`-Knotens behandelt und können im Bereich **Details** auf der Registerkarte **Diagramm** angezeigt werden. Wenn Sie Literalwerte als Eckpunkte in die Visualisierung einfügen möchten, verwenden Sie stattdessen den Abfragehinweis `--expand-all`. Sie dürfen diesen Visualisierungshinweis nicht mit explain-Parametern kombinieren, da explain-Abfragen nicht visualisiert werden. + **`--explain-type`**   –   Wird verwendet, um den explain-Modus anzugeben, der verwendet werden soll (`dynamic`, `static` oder `details`). + **`--explain-format`**   –   Wird verwendet, um das Antwortformat für eine explain-Abfrage anzugeben (`text/csv` oder `text/html`). + **`--store-to`**   –   Wird verwendet, um eine Variable anzugeben, in der die Abfrageergebnisse gespeichert werden sollen. Beispiel für eine `explain`-Abfrage: ``` %%sparql explain SELECT * WHERE {?s ?p ?o} LIMIT 10 ``` Beispiel für eine Visualisierungsabfrage mit dem Visualisierungshinweisparameter `--expand-all` (siehe [SPARQL-Visualisierung](notebooks-visualization.md#notebooks-visualization-sparql)): ``` %%sparql --expand-all SELECT * WHERE {?s ?p ?o} LIMIT 10 ``` ## Die Magie der `` %%gremlin-Zellen Die `%%gremlin` Zellmagie sendet eine Gremlin-Abfrage an den Neptun-Endpunkt mit. WebSocket Sie akzeptiert eine optionale Zeileneingabe, um in den Modus [Gremlin `explain`](gremlin-explain.md) /> oder [Gremlin-`profile`-API](gremlin-profile-api.md) zu wechseln, und die getrennte optionale Eingabe eines Visualisierungshinweises, um das Verhalten der Visualisierungsausgabe zu ändern (siehe [Gremlin-Visualisierung](notebooks-visualization.md#notebooks-visualization-Gremlin)). Beispiel für eine `explain`-Abfrage: ``` %%gremlin explain g.V().limit(10) ``` Beispiel für eine `profile`-Abfrage: ``` %%gremlin profile g.V().limit(10) ``` Beispiel für eine Visualisierungsabfrage mit einem Visualisierungshinweisparameter: ``` %%gremlin -p v,outv g.V().out().limit(10) ``` **Optionale Parameter für %%gremlin-Profilabfragen ``** + **`--profile-chop`**   –   Gibt die maximale Länge der Profilergebnis-Zeichenfolge an. Wenn Sie dieses Argument nicht angeben, ist der Standardwert 250. + **`--profile-serializer`**   –   Gibt den Serializer an, der für die Ergebnisse verwendet werden soll. Zulässige Werte sind alle gültigen Aufzählungswerte des MIME-Typs oder des TinkerPop Treibers „Serializers“. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `application.json`. + **`--profile-no-results`**   –   Zeigt nur die Ergebniszahl an. Wenn dieser Parameter nicht verwendet wird, werden standardmäßig alle Abfrageergebnisse im Profilbericht angezeigt. + **`--profile-indexOps`**   –   Zeigt einen detaillierten Bericht zu allen Indexoperationen an. ## Die `` %%opencypher Cell Magic (auch %%oc) `` Die Zellen-Magics `%%opencypher` (auch als `%%oc` abgekürzt) gibt eine openCypher-Abfrage an den Neptune-Endpunkt aus. Sie akzeptiert die folgenden optionalen Zeileneingabenargumente: + **`--mode`**— Der Abfragemodus: entweder oder. `query` `bolt` Wenn Sie dieses Argument nicht angeben, ist der Standardwert `query`. + **`--group-by`** oder **`-g`**   –   Gibt die Eigenschaft an, die zum Gruppieren von Knoten verwendet wird. Beispiel, `code, ~id`. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `~labels`. + **`--ignore-groups`**   –   Wenn vorhanden, werden alle Gruppierungsoptionen ignoriert. + **`--display-property`** oder **`-d`**   –   Gibt die Eigenschaft an, deren Wert für jeden Eckpunkt angezeigt werden soll. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `~labels`. + **`--edge-display-property`** oder **`-de`**   –   Gibt die Eigenschaft an, deren Wert für jede Kante angezeigt werden soll. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `~labels`. + **`--explain-type`**— Wird verwendet, um den zu verwendenden Erklärungsmodus anzugeben (einer der folgenden Modi: dynamisch, statisch, Debug oder Details). + **`--label-max-length`** oder **`-l`**   –   Gibt die maximale Anzahl der Zeichen einer Eckpunktbezeichnung an, die angezeigt werden können. Wenn Sie dieses Argument nicht angeben, ist der Standardwert `10`. + **`--store-to`** oder **`-s`**)   –   Gibt den Namen der Variablen an, in der die Abfrageergebnisse gespeichert werden sollen. + **`--plan-cache`** oder **`-pc`**: Gibt den zu verwendenden Plan-Cache-Modus an. Der Standardwert ist `auto`. + **`--query-timeout`** oder **`-qt`**: Gibt das maximale Abfrage-Timeout in Millisekunden an. Der Standardwert ist `1800000`. + **`--query-parameters`** oder **`qp`**: [Parameterdefinitionen](opencypher-parameterized-queries.md), die auf die Abfrage angewendet werden sollen. Diese Option kann entweder einen einzelnen Variablennamen oder eine Zeichenfolgendarstellung der Zuordnung annehmen. **Beispiel für die Verwendung von `--query-parameters`** 1. Definieren Sie eine Zuordnung von OpenCypher-Parametern in einer Notebook-Zelle. ``` params = '''{ "name":"john", "age": 20, }''' ``` 1. Übergeben Sie die Parameter an `--query-parameters` in einer anderen Zelle mit `%%oc`. ``` %%oc --query-parameters params MATCH (n {name: $name, age: $age}) RETURN n ``` ## Die `Magie der Zelle %%graph_notebook_config` Die Zellen-Magics `%%graph_notebook_config` verwendet ein JSON-Objekt mit Informationen zur Konfiguration, um die Einstellungen zu ändern, die das Notebook für die Kommunikation mit Neptune verwendet, wenn möglich. Die Konfiguration hat das Format, das von der Zeilen-Magics [%graph\_notebook\_config](#notebooks-line-magics-graph-notebook-config) zurückgegeben wird. Beispiel: ``` %%graph_notebook_config { "host": "my-new-cluster-endpoint.amazon.com", "port": 8182, "auth_mode": "DEFAULT", "load_from_s3_arn": "", "ssl": true, "aws_region": "us-east-1" } ``` ## Die Magie der `Zelle von` %%graph\_notebook\_vis\_options Mit der Zellen-Magics `%%graph_notebook_vis_options` können Sie Visualisierungsoptionen für das Notebook festlegen. Sie können die von der Zeilen-Magics `%graph-notebook-vis-options` zurückgegebenen Einstellungen kopieren, in eine neue Zelle kopieren, Änderungen ausführen und die Zellen-Magics `%%graph_notebook_vis_options` verwenden, um die neuen Werte festzulegen. Diese Optionen werden in der Dokumentation für [vis.js](https://visjs.github.io/vis-network/docs/network/#options) beschrieben. Um die Visualisierungseinstellungen auf die Standardwerte zurückzusetzen, können Sie die Zeilen-Magics `%graph_notebook_vis_options` mit dem Parameter `reset` ausführen. Hierdurch werden alle Visualisierungseinstellungen zurückgesetzt: ``` %graph_notebook_vis_options reset ``` ## Die `Magie der %neptune_ml Linie` Sie können die Zeilen-Magics `%neptune_ml` verwenden, um verschiedene Neptune-ML-Operationen zu initiieren und zu verwalten. **Anmerkung** Sie können auch die Zellen-Magics [%%neptune\_ml](#notebooks-cell-magics-neptune_ml) verwenden, um einige Neptune-ML-Operationen zu initiieren und zu verwalten. + **`%neptune_ml export start`**   –   Startet einen neuen Exportauftrag. **Parameters** + **`--export-url`**{{exporter-endpoint}}— (*optional*) Der Amazon API Gateway-Endpunkt, an dem der Exporter aufgerufen werden kann. + **`--export-iam`**   –   (*optional*) Flag, das anzeigt, dass Anforderungen an die Export-URL mit SigV4 signiert werden müssen. + **`--export-no-ssl`**   –   (*optional*) Flag, das anzeigt, dass SSL nicht verwendet werden sollte, wenn eine Verbindung zum Exporter hergestellt wird. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis der Export abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen den Exportstatusprüfungen fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss des Exportauftrags gewartet werden soll, bevor der letzte Status zurückgegeben * wird (Standardeinstellung*: 3.600). + **`--store-to`**{{location-to-store-result}}— (*optional*) Die Variable, in der das Exportergebnis gespeichert werden soll. Wenn `--wait` angegeben ist, wird der endgültige Status dort gespeichert. + **`%neptune_ml export status`**   –   Ruft den Status eines Exportauftrags ab. **Parameters** + **`--job-id`**{{export job ID}}— Die ID des Exportauftrags, für den der Status abgerufen werden soll. + **`--export-url`**{{exporter-endpoint}}— (*optional*) Der Amazon API Gateway-Endpunkt, an dem der Exporteur aufgerufen werden kann. + **`--export-iam`**   –   (*optional*) Flag, das anzeigt, dass Anforderungen an die Export-URL mit SigV4 signiert werden müssen. + **`--export-no-ssl`**   –   (*optional*) Flag, das anzeigt, dass SSL nicht verwendet werden sollte, wenn eine Verbindung zum Exporter hergestellt wird. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis der Export abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen den Exportstatusprüfungen fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss des Exportauftrags gewartet werden soll, bevor der letzte Status zurückgegeben * wird (Standardeinstellung*: 3.600). + **`--store-to`**{{location-to-store-result}}— (*optional*) Die Variable, in der das Exportergebnis gespeichert werden soll. Wenn `--wait` angegeben ist, wird der endgültige Status dort gespeichert. + **`%neptune_ml dataprocessing start`**   –   Startet den Neptune-ML-Datenverarbeitungsschritt. **Parameters** + **`--job-id`**{{ID for this job}}— (*optional*) ID, die diesem Job zugewiesen werden soll. + **`--s3-input-uri`**{{S3 URI}}— (*optional*) Die S3-URI, unter der die Eingabe für diesen Datenverarbeitungsauftrag gefunden werden soll. + **`--config-file-name`**{{file name}}— (*optional*) Name der Konfigurationsdatei für diesen Datenverarbeitungsauftrag. + **`--store-to`**{{location-to-store-result}}— (*optional*) Die Variable, in der das Datenverarbeitungsergebnis gespeichert werden soll. + **`--instance-type`**{{(instance type)}}— (*optional*) Die Instanzgröße, die für diesen Datenverarbeitungsauftrag verwendet werden soll. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis die Datenverarbeitung abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen den Statusprüfungen der Datenverarbeitung fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss des Datenverarbeitungsauftrags gewartet werden soll, bevor der letzte Status zurückgegeben wird (*Standardeinstellung*: 3.600). + **`%neptune_ml dataprocessing status`**   –   Ruft den Status eines Datenverarbeitungsauftrags ab. **Parameters** + **`--job-id`**{{ID of the job}}— ID des Auftrags, für den der Status abgerufen werden soll. + **`--store-to`**{{instance type}}— (*optional*) Die Variable, in der das Ergebnis des Modelltrainings gespeichert werden soll. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis das Modelltraining abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen den Statusüberprüfungen des Modelltrainings fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss des Datenverarbeitungsauftrags gewartet werden soll, bevor der letzte Status zurückgegeben wird (*Standardeinstellung*: 3.600). + **`%neptune_ml training start`**   –   Startet den Neptune-ML-Modelltrainingsprozess. **Parameters** + **`--job-id`**{{ID for this job}}— (*optional*) ID, die diesem Job zugewiesen werden soll. + **`--data-processing-id`**{{dataprocessing job ID}}— (*optional*) ID des Datenverarbeitungsauftrags, der die Artefakte für das Training erstellt hat. + **`--s3-output-uri`**{{S3 URI}}— (*optional*) Die S3-URI, unter der die Ausgabe dieses Modelltraining-Jobs gespeichert werden soll. + **`--instance-type`**{{(instance type)}}— (*optional*) Die Instanzgröße, die für diesen Modelltraining-Job verwendet werden soll. + **`--store-to`**{{location-to-store-result}}— (*optional*) Die Variable, in der das Ergebnis des Modelltrainings gespeichert werden soll. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis das Modelltraining abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen den Statusüberprüfungen des Modelltrainings fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss des Modelltrainingsauftrags gewartet werden soll, bevor der letzte Status zurückgegeben wird (*Standardeinstellung*: 3.600). + **`%neptune_ml training status`**   –   Ruft den Status eines Neptune-ML-Modelltrainingsauftrags ab. **Parameters** + **`--job-id`**{{ID of the job}}— ID des Jobs, für den der Status abgerufen werden soll. + **`--store-to`**{{instance type}}— (*optional*) Die Variable, in der das Statusergebnis gespeichert werden soll. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis das Modelltraining abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen den Statusüberprüfungen des Modelltrainings fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss des Datenverarbeitungsauftrags gewartet werden soll, bevor der letzte Status zurückgegeben wird (*Standardeinstellung*: 3.600). + **`%neptune_ml endpoint create`**   –   Erstellt einen Abfrageendpunkt für ein Neptune-ML-Modell. **Parameters** + **`--job-id`**{{ID for this job}}— (*optional*) ID, die diesem Job zugewiesen werden soll. + **`--model-job-id`**{{model-training job ID}}— (*optional*) ID des Model-Training-Jobs, für den ein Abfrageendpunkt erstellt werden soll. + **`--instance-type`**{{(instance type)}}— (*optional*) Die Instanzgröße, die für den Abfrageendpunkt verwendet werden soll. + **`--store-to`**{{location-to-store-result}}— (*optional*) Die Variable, in der das Ergebnis der Endpunkterstellung gespeichert werden soll. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis die Endpunkterstellung abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen Statusüberprüfungen fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss der Endpunkterstellung gewartet werden soll, bevor der letzte Status zurückgegeben * wird (Standardeinstellung*: 3.600). + **`%neptune_ml endpoint status`**   –   Ruft den Status eines Neptune-ML-Abfrageendpunkts ab. **Parameters** + **`--job-id`**{{endpoint creation ID}}— (*optional*) ID eines Auftrags zur Endpunkterstellung, für den der Status gemeldet werden soll. + **`--store-to`**{{location-to-store-result}}— (*optional*) Die Variable, in der das Statusergebnis gespeichert werden soll. + **`--wait`**   –   (*optional*) Flag, das anzeigt, dass die Operation warten soll, bis die Endpunkterstellung abgeschlossen ist. + **`--wait-interval`**{{interval-to-wait}}— (*optional*) Legt die Zeit in Sekunden zwischen Statusüberprüfungen fest (*Standard*: 60). + **`--wait-timeout`**{{timeout-seconds}}— (*optional*) Legt die Zeit in Sekunden fest, die auf den Abschluss der Endpunkterstellung gewartet werden soll, bevor der letzte Status zurückgegeben * wird (Standardeinstellung*: 3.600). ## Die Magie der Zelle `%%neptune_ml` Die Zellen-Magics `%%neptune_ml` ignoriert Zeileneingaben wie `--job-id` oder `--export-url`. Stattdessen können Sie diese und andere Eingaben im Zelltext eingeben. Sie können diese Eingaben auch in einer anderen Zelle speichern, die einer Jupyter-Variablen zugewiesen ist, und sie dann mithilfe dieser Variablen in den Zelltext einfügen. So können Sie diese Eingaben immer wieder verwenden, ohne sie jedes Mal erneut eingeben zu müssen. Dies funktioniert nur, wenn die einfügende Variable der einzige Inhalt der Zelle ist. Sie können in derselben Zelle nicht mehrere Variablen oder eine Kombination aus Text und einer Variablen verwenden. Die Zellen-Magics `%%neptune_ml export start` kann beispielsweise ein JSON-Dokument im Zelltext verwenden, das alle Parameter enthält, die in [Parameter, die zur Steuerung des Neptun-Exportprozesses verwendet werden](export-parameters.md) beschrieben werden. Im [ Neptune-ML-01-Introduction-to-Node-Classification-Gremlin ](https://github.com/aws/graph-notebook/blob/main/src/graph_notebook/notebooks/04-Machine-Learning/Neptune-ML-01-Introduction-to-Node-Classification-Gremlin.ipynb) Notizbuch können Sie unter Funktionen ** konfigurieren ** im ** Abschnitt Daten und Modellkonfiguration ** exportieren sehen, wie die folgende Zelle Exportparameter in einem Dokument enthält, das einer Jupyter-Variablen mit dem Namen zugewiesen ist: `export-params` ``` export_params = { "command": "export-pg", "params": { "endpoint": neptune_ml.get_host(), "profile": "neptune_ml", "useIamAuth": neptune_ml.get_iam(), "cloneCluster": False }, "outputS3Path": f'{s3_bucket_uri}/neptune-export', "additionalParams": { "neptune_ml": { "targets": [ { "node": "movie", "property": "genre" } ], "features": [ { "node": "movie", "property": "title", "type": "word2vec" }, { "node": "user", "property": "age", "type": "bucket_numerical", "range" : [1, 100], "num_buckets": 10 } ] } }, "jobSize": "medium"} ``` Wenn Sie diese Zelle ausführen, speichert Jupyter das Parameterdokument unter diesem Namen. Anschließend können Sie mit `${export_params}` das JSON-Dokument wie folgt in den Text einer `%%neptune_ml export start cell` einfügen: ``` %%neptune_ml export start --export-url {neptune_ml.get_export_service_host()} --export-iam --wait --store-to export_results ${export_params} ``` ### Verfügbare Formen der Zellmagie von %%neptune\_ml `` Die Zellen-Magics `%%neptune_ml` kann in den folgenden Formularen verwendet werden: + **`%%neptune_ml export start`**   –   Startet einen Neptune-ML-Exportvorgang. + **`%%neptune_ml dataprocessing start`**   –   Startet einen Neptune-ML-Datenverarbeitungsauftrag. + **`%%neptune_ml training start`**   –   Startet einen Neptune-ML-Modelltrainingsauftrag. + **`%%neptune_ml endpoint create`**   –   Erstellt einen Neptune-ML-Abfrageendpunkt für ein Modell.