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:
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:
Es gibt auch zwei Magics, eine Zeilen-Magics und eine Zellen-Magics für Neptune Machine Learning.
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.codeoderT.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-lengthoder-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 angegeben werden.
Die magische
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). 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). 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). Die Anforderung hat folgendes Format:
GET https://your-neptune-endpoint:port/loader?loadId=loadId
Die Zeilen-Magics sieht wie folgt aus:
%load_statusload id
Die Magie der %cancel_load-Zeile
Die Zeilen-Magics %cancel_load bricht einen bestimmten Ladeauftrag ab (siehe Neptune-Loader – Auftrag abbrechen). Die Anforderung hat folgendes Format:
DELETE https://your-neptune-endpoint:port/loader?loadId=loadId
Die Zeilen-Magics sieht wie folgt aus:
%cancel_loadload id
Die Magie der %status-Zeile
Ruft Statusinformationen vom Host-Endpunkt des Notebooks ab (%graph_notebook_configzeigt 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 Für Neptune Analytics-Hosts wird der Status über die API abgerufen. GetGraph Weitere Informationen finden Sie unter %get_graph.
Die Magie der %gremlin_status-Zeile
Ruft Informationen zum Status einer Gremlin-Abfrage 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:
-
--queryIdoder-q– Gibt die ID einer bestimmten ausgeführten Abfrage an, deren Status angezeigt werden soll. -
--cancelQueryoder-c– Bricht eine ausgeführte Abfrage ab. Nimmt keinen Wert an. -
--silent-cancelor-s– Wenn--silentbeim Abbrechen einer Abfrage auftruefestgelegt ist, wird die ausgeführte Abfrage mit dem HTTP-Antwortcode200abgebrochen. Andernfalls wäre der HTTP-Antwortcode500. -
--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
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:gremlinodersparql. Wenn Sie dieses Argument nicht angeben, ist der Standardwertgremlin. -
--limit– Gibt die maximale Anzahl von Stream-Einträgen an, die pro Seite angezeigt werden sollen. Wenn Sie dieses Argument nicht angeben, ist der Standardwert10.
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 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 ist8182.auth_mode: Der Authentifizierungsmodus, der verwendet werden soll, wenn Befehle an Neptune ausgegeben werden. Dieser mussIAMsein, wenn eine Verbindung mit einem Cluster hergestellt wird, für den die IAM-Authentifizierung aktiviert ist, andernfallsDEFAULT.load_from_s3_arn: Gibt den Amazon-S3-ARN an, den die Magics%loadverwenden soll. Wenn dieser Wert leer ist, muss der ARN im Befehl%loadangegeben werden.ssl: Ein boolescher Wert, der angibt, ob die Verbindung mit Neptune über TLS hergestellt werden soll oder nicht. Der Standardwert isttrue.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 für die neue Zelle ausführen, wird die Konfiguration entsprechend geändert.
Die Magie der
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
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). Diese Magics kann auch verwendet werden, um eine Diagrammübersicht abzurufen.
Sie akzeptiert die folgenden Parameter:
-
--language– Die Abfragesprache des Statistikendpunkts:propertygraph(oderpg) oderrdf.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,detailedoderbasic).Wenn nicht angegeben, ist der Standardwert
status. Wenn jedoch--summaryangegeben ist, ist der Standardwertbasic. -
--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 abzurufen. Sie ist ab Neptune-Engine-Version 1.2.1.0 verfügbar.
Sie akzeptiert die folgenden Parameter:
-
--language– Die Abfragesprache des Statistikendpunkts:propertygraph(oderpg) oderrdf.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
basicder 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 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 Diese Magie ist funktionell identisch mit der, %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:
-
-hoder--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ärehost:port/abc/def -
--expand-all– Dies ist ein Abfragevisualisierungshinweis, der den Visualizer anweist, alle Ergebnisse für?s ?p ?ounabhängig vom Bindungstyp in das Diagramm aufzunehmen.Standardmäßig enthält eine SPARQL-Visualisierung nur Tripelmuster, bei denen
o?entwederurioderbnode(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,staticoderdetails). -
--explain-format– Wird verwendet, um das Antwortformat für eine explain-Abfrage anzugeben (text/csvodertext/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):
%%sparql --expand-all SELECT * WHERE {?s ?p ?o} LIMIT 10
Die Magie der
Die %%gremlin Zellmagie sendet eine Gremlin-Abfrage an den Neptun-Endpunkt mit. WebSocket Sie akzeptiert eine optionale Zeileneingabe, um in den Modus Gremlin explain /> oder Gremlin-profile-API zu wechseln, und die getrennte optionale Eingabe eines Visualisierungshinweises, um das Verhalten der Visualisierungsausgabe zu ändern (siehe Gremlin-Visualisierung).
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 Standardwertapplication.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
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.queryboltWenn Sie dieses Argument nicht angeben, ist der Standardwertquery. -
--group-byoder-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-propertyoder-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-propertyoder-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-lengthoder-l– Gibt die maximale Anzahl der Zeichen einer Eckpunktbezeichnung an, die angezeigt werden können. Wenn Sie dieses Argument nicht angeben, ist der Standardwert10. -
--store-tooder-s) – Gibt den Namen der Variablen an, in der die Abfrageergebnisse gespeichert werden sollen. -
--plan-cacheoder-pc: Gibt den zu verwendenden Plan-Cache-Modus an. Der Standardwert istauto. -
--query-timeoutoder-qt: Gibt das maximale Abfrage-Timeout in Millisekunden an. Der Standardwert ist1800000. -
--query-parametersoderqp: Parameterdefinitionen, 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-
Definieren Sie eine Zuordnung von OpenCypher-Parametern in einer Notebook-Zelle.
params = '''{ "name":"john", "age": 20, }''' -
Übergeben Sie die Parameter an
--query-parametersin 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 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
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 verwenden, um einige Neptune-ML-Operationen zu initiieren und zu verwalten.
-
%neptune_ml export start– Startet einen neuen Exportauftrag.Parameters
-
--export-urlexporter-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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen den Exportstatusprüfungen fest (Standard: 60). -
--wait-timeouttimeout-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-tolocation-to-store-result— (optional) Die Variable, in der das Exportergebnis gespeichert werden soll. Wenn--waitangegeben ist, wird der endgültige Status dort gespeichert.
-
-
%neptune_ml export status– Ruft den Status eines Exportauftrags ab.Parameters
-
--job-idexport job ID— Die ID des Exportauftrags, für den der Status abgerufen werden soll. -
--export-urlexporter-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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen den Exportstatusprüfungen fest (Standard: 60). -
--wait-timeouttimeout-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-tolocation-to-store-result— (optional) Die Variable, in der das Exportergebnis gespeichert werden soll. Wenn--waitangegeben ist, wird der endgültige Status dort gespeichert.
-
-
%neptune_ml dataprocessing start– Startet den Neptune-ML-Datenverarbeitungsschritt.Parameters
-
--job-idID for this job— (optional) ID, die diesem Job zugewiesen werden soll. -
--s3-input-uriS3 URI— (optional) Die S3-URI, unter der die Eingabe für diesen Datenverarbeitungsauftrag gefunden werden soll. -
--config-file-namefile name— (optional) Name der Konfigurationsdatei für diesen Datenverarbeitungsauftrag. -
--store-tolocation-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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen den Statusprüfungen der Datenverarbeitung fest (Standard: 60). -
--wait-timeouttimeout-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-idID of the job— ID des Auftrags, für den der Status abgerufen werden soll. -
--store-toinstance 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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen den Statusüberprüfungen des Modelltrainings fest (Standard: 60). -
--wait-timeouttimeout-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-idID for this job— (optional) ID, die diesem Job zugewiesen werden soll. -
--data-processing-iddataprocessing job ID— (optional) ID des Datenverarbeitungsauftrags, der die Artefakte für das Training erstellt hat. -
--s3-output-uriS3 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-tolocation-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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen den Statusüberprüfungen des Modelltrainings fest (Standard: 60). -
--wait-timeouttimeout-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-idID of the job— ID des Jobs, für den der Status abgerufen werden soll. -
--store-toinstance 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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen den Statusüberprüfungen des Modelltrainings fest (Standard: 60). -
--wait-timeouttimeout-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-idID for this job— (optional) ID, die diesem Job zugewiesen werden soll. -
--model-job-idmodel-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-tolocation-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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen Statusüberprüfungen fest (Standard: 60). -
--wait-timeouttimeout-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-idendpoint creation ID— (optional) ID eines Auftrags zur Endpunkterstellung, für den der Status gemeldet werden soll. -
--store-tolocation-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-intervalinterval-to-wait— (optional) Legt die Zeit in Sekunden zwischen Statusüberprüfungen fest (Standard: 60). -
--wait-timeouttimeout-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 beschrieben werden.
Im Neptune-ML-01-Introduction-to-Node-Classification-Gremlin 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.
