Usare magics nei notebook Amazon Neptune

• %seed

• %load

• %load_ids

• %load_status

• %cancel_load

• %status

• %gremlin_status

• %opencypher_status o %oc_status

• %stream_viewer

• %sparql_status

• %graph_notebook_config

• %graph_notebook_host

• %graph_notebook_version

• %graph_notebook_service

• %graph_notebook_vis_options

• %statistics

• %summary

• %reset_graph

• %get_graph

• %%sparql

• %%gremlin

• %%opencypher o %%oc

• %%graph_notebook_config

• %%graph_notebook_vis_options

• %neptune_ml

• %%neptune_ml

Argomenti di query comuni

• --store-to (o -s): specifica il nome di una variabile in cui archiviare i risultati della query.

• --silent: se presente, non viene visualizzato alcun output dopo il completamento della query.

• --group-by (o -g): specifica la proprietà utilizzata per raggruppare i nodi (ad esempio code o T.region). I vertici sono colorati in base al gruppo assegnato.

• --ignore-groups: se presente, tutte le opzioni di raggruppamento vengono ignorate.

• --display-property (o -d): specifica la proprietà di cui occorre visualizzare il valore per ogni vertice.

  Il valore predefinito per ogni linguaggio di query è il seguente:

  • Per Gremlin: T.label.

  • PeropenCypher:. ~labels

  • PerSPARQL:type.

• --edge-display-property (o -t): specifica la proprietà di cui occorre visualizzare il valore per ogni arco.

  Il valore predefinito per ogni linguaggio di query è il seguente:

  • Per Gremlin: T.label.

  • PeropenCypher:~labels.

  • PerSPARQL:type.

• --tooltip-property (o -de): specifica una proprietà di cui occorre visualizzare il valore come descrizione comando per ogni nodo.

  Il valore predefinito per ogni linguaggio di query è il seguente:

  • Per Gremlin: T.label.

  • PeropenCypher:~labels.

  • PerSPARQL:type.

• --edge-tooltip-property (o -te): specifica una proprietà di cui occorre visualizzare il valore come descrizione comando per ogni arco.

  Il valore predefinito per ogni linguaggio di query è il seguente:

  • Per Gremlin: T.label.

  • PeropenCypher:~labels.

  • PerSPARQL:type.

• --label-max-length (o -l): specifica la lunghezza di caratteri massima di tutte le etichette dei vertici. Il valore predefinito è 10.

• --edge-label-max-length (o -le): specifica la lunghezza di caratteri massima di tutte le etichette degli archi. Il valore predefinito è 10.

  Nel caso di openCypher solo, questo è --rel-label-max-length o -rel invece.

• --simulation-duration (o -sd): specifica la durata massima della simulazione delle proprietà fisiche della visualizzazione. Il valore predefinito è 1.500 ms.

• --stop-physics (o -sp): disabilita le proprietà fisiche della visualizzazione dopo che la simulazione iniziale si è stabilizzata.

• -ns o -- no-skip-snapshot - Se presente, verrà creata un'istantanea finale del grafico prima che i dati del grafico vengano eliminati.

• --silent — Se presente, non viene visualizzato alcun output dopo l'invio della chiamata di reset.

• --store-to — Utilizzato per specificare una variabile in cui memorizzare la risposta. ResetGraph

• --queryId o -q: specifica l'ID di una query in esecuzione specifica per cui mostrare lo stato.

• --cancelQuery o -c: annulla una query in esecuzione. Non accetta un valore.

• --silent-canceloppure -s— Se --silent è impostato su true quando si annulla una query, la query in esecuzione viene annullata con un codice di risposta di. HTTP 200 Altrimenti, il codice di HTTP risposta sarebbe. 500

• --store-to: specifica il nome di una variabile in cui archiviare i risultati della query.

• -w/--includeWaiting— Solo Neptune DB. Se impostato su true e non sono presenti altri parametri, restituisce le informazioni sullo stato delle query in attesa e per quelle in esecuzione. Questo parametro non accetta un valore.

• --state— Solo Neptune Analytics. Specifica il sottoinsieme di stati di interrogazione di cui recuperare lo stato.

• -m/--maxResults— Solo Neptune Analytics. Imposta un limite massimo per l'insieme di query restituite che corrispondono al valore di. --state

• --silent: se presente, non viene visualizzato alcun output dopo il completamento della query.

• language: linguaggio di query dei dati del flusso: gremlin o sparql. L'impostazione predefinita, se non si specifica questo argomento, è gremlin.

• --limit: specifica il numero massimo di voci del flusso da visualizzare per pagina. Il valore predefinito, se non si specifica questo argomento, è 10.

• host: endpoint a cui connettersi e inviare i comandi.

• port: porta utilizzata per inviare comandi a Neptune. Il valore predefinito è 8182.

• auth_mode: modalità di autenticazione da utilizzare per l'invio dei comandi a Neptune. Deve esserlo IAM se ci si connette a un cluster con IAM l'autenticazione abilitata o in altro modo. DEFAULT

• load_from_s3_arn: specifica un Amazon ARN S3 per %load la magia da usare. Se questo valore è vuoto, ARN deve essere specificato nel %load comando.

• ssl: Un valore booleano che indica se connettersi o meno a Neptune utilizzando. TLS Il valore predefinito è true.

• aws_region: regione in cui è implementato questo notebook. Queste informazioni vengono utilizzate per l'IAMautenticazione e per le richieste. %load

• --language: linguaggio di query dell'endpoint delle statistiche: o propertygraph (o pg) o rdf.

  Se non viene specificato, il valore predefinito è propertygraph.

• --mode (o -m): specifica il tipo di richiesta o azione da inviare: una tra le seguenti: status, disableAutoCompute, enableAutoCompute,refresh, delete, detailed o basic).

  Se non viene specificato, il valore predefinito è status a meno che non sia specificato --summary, nel qual caso l'impostazione predefinita è basic.

• --summary: recupera il riepilogo del grafo dall'endpoint di riepilogo delle statistiche del linguaggio selezionato.

• --silent: se presente, non viene visualizzato alcun output dopo il completamento della query.

• --store-to: consente di specificare una variabile in cui archiviare i risultati della query.

• --language: linguaggio di query dell'endpoint delle statistiche: o propertygraph (o pg) o rdf.

  Se non viene specificato, il valore predefinito è propertygraph.

• --detailed: attiva o disattiva la visualizzazione dei campi delle strutture nell'output.

  Se non viene specificato, l'impostazione predefinita è la modalità di visualizzazione del riepilogo basic.

• --silent: se presente, non viene visualizzato alcun output dopo il completamento della query.

• --store-to: consente di specificare una variabile in cui archiviare i risultati della query.

• -h o --help: restituisce il testo della guida relativo a questi parametri.

• --path— Aggiunge un prefisso a un percorso verso l'endpoint. SPARQL Ad esempio, se si specifica --path "abc/def", l'endpoint chiamato sarà host:port/abc/def.

• --expand-all: si tratta di suggerimento per la visualizzazione delle query che indica al visualizzatore di includere tutti i risultati ?s ?p ?o nel diagramma del grafo, indipendentemente dal tipo di associazione.

  Per impostazione predefinita, una SPARQL visualizzazione include solo modelli tripli in cui o? è un uri o un bnode (nodo vuoto). Tutti gli altri tipi di ?o associazione, come stringhe letterali o numeri interi, vengono trattati come proprietà del nodo ?s che possono essere visualizzate nel riquadro Dettagli nella scheda Grafo.

  Utilizza invece l'hint di query --expand-all quando desideri includere valori letterali come i vertici nella visualizzazione.

  Non combinare questo suggerimento di visualizzazione con i parametri di spiegazione, in quanto le query EXPLAIN non vengono visualizzate.

• --explain-type: consente di specificare la modalità di spiegazione da utilizzare (tra le seguenti: dynamic, static o details).

• --explain-format: consente di specificare il formato della risposta per una query di spiegazione (text/csv o text/html).

• --store-to: consente di specificare una variabile in cui archiviare i risultati della query.

Parametri facoltativi per le query %%gremlin profile

• --profile-chop: specifica la lunghezza massima della stringa dei risultati del profilo. Il valore predefinito, se non si specifica questo argomento, è 250.

• --profile-serializer: specifica il serializzatore da utilizzare per i risultati. I valori consentiti sono tutti i valori enumerici «Serializers» del MIME tipo o del TinkerPop driver validi. Il valore predefinito, se non si specifica questo argomento, è application.json.

• --profile-no-results: visualizza solo il numero di risultati. Se non viene utilizzato, per impostazione predefinita nel report del profilo vengono visualizzati tutti i risultati della query.

• --profile-indexOps: mostra un report dettagliato di tutte le operazioni sull'indice.

• mode: modalità di query: query o bolt. Il valore predefinito, se non si specifica questo argomento, è query.

• --group-by o -g: specifica la proprietà utilizzata per raggruppare i nodi. Ad esempio code, ~id. Il valore predefinito, se non si specifica questo argomento, è ~labels.

• --ignore-groups: se presente, tutte le opzioni di raggruppamento vengono ignorate.

• --display-propery o -d: specifica la proprietà di cui occorre visualizzare il valore per ogni vertice. Il valore predefinito, se non si specifica questo argomento, è ~labels.

• --edge-display-propery o -de: specifica la proprietà di cui occorre visualizzare il valore per ogni arco. Il valore predefinito, se non si specifica questo argomento, è ~labels.

• --label-max-length o -l: specifica il numero massimo di caratteri di un'etichetta di vertice da visualizzare. Il valore predefinito, se non si specifica questo argomento, è 10.

• --store-to o -s: specifica il nome di una variabile in cui archiviare i risultati della query.

• --plan-cache o -pc: specifica la modalità cache del piano da utilizzare. Il valore predefinito è auto.

• --query-timeout o -qt: specifica il timeout di query massimo in millisecondi. Il valore predefinito è 1800000.

• --query-parameters o qp: definizioni dei parametri da applicare alla query. Questa opzione può accettare il nome di una singola variabile o una rappresentazione in formato stringa della mappa.

  Esempio di utilizzo di --query-parameters

  1. Definisci una mappa di openCypher parametri in una cella del notebook.

     params = '''{
      "name":"john",
      "age": 20,
     }'''

  2. Passa i parametri in --query-parameters in un'altra cella con %%oc.

     %%oc --query-parameters params
     
     MATCH (n {name: $name, age: $age}) 
     RETURN n

• --explain-type — Utilizzato per specificare la modalità di spiegazione da utilizzare (una delle seguenti: dinamica, statica o dettagliata).

• %neptune_ml export start: avvia un nuovo processo di esportazione.

  Parametri

  • --export-url exporter-endpoint   — (opzionale) L'endpoint Amazon API Gateway su cui è possibile chiamare l'esportatore.

  • --export-iam (facoltativo): flag che indica che le richieste all'URL di esportazione devono essere firmate tramite SigV4.

  • --export-no-ssl— (opzionale) Bandiera che indica che non SSL deve essere utilizzata per la connessione all'esportatore.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento dell'esportazione.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli dello stato dell'esportazione (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (facoltativo) Imposta il tempo, in secondi, di attesa per il completamento del processo di esportazione prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

  • --store-to location-to-store-result   — (opzionale) La variabile in cui memorizzare il risultato dell'esportazione. Se è specificato il flag --wait, lo stato finale verrà archiviato in tale posizione.

• %neptune_ml export status: recupera lo stato di un processo di esportazione.

  Parametri

  • --job-id export job ID   — L'ID del processo di esportazione di cui recuperare lo stato.

  • --export-url exporter-endpoint   — (opzionale) L'endpoint Amazon API Gateway su cui è possibile chiamare l'esportatore.

  • --export-iam (facoltativo): flag che indica che le richieste all'URL di esportazione devono essere firmate tramite SigV4.

  • --export-no-ssl— (opzionale) Bandiera che indica che non SSL deve essere utilizzata per la connessione all'esportatore.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento dell'esportazione.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli dello stato dell'esportazione (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (facoltativo) Imposta il tempo, in secondi, di attesa per il completamento del processo di esportazione prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

  • --store-to location-to-store-result   — (opzionale) La variabile in cui memorizzare il risultato dell'esportazione. Se è specificato il flag --wait, lo stato finale verrà archiviato in tale posizione.

• %neptune_ml dataprocessing start: avvia la fase di elaborazione dei dati di Neptune ML.

  Parametri

  • --job-id ID for this job   — (opzionale) ID da assegnare a questo lavoro.

  • --s3-input-uri S3 URI   — (opzionale) L'S3 URI in cui trovare l'input per questo processo di elaborazione dati.

  • --config-file-name file name   — (opzionale) Nome del file di configurazione per questo processo di elaborazione dati.

  • --store-to location-to-store-result   — (opzionale) La variabile in cui memorizzare il risultato dell'elaborazione dei dati.

  • --instance-type (instance type)   — (opzionale) La dimensione dell'istanza da utilizzare per questo processo di elaborazione dati.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento dell'elaborazione dati.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli dello stato dell'elaborazione dei dati (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (facoltativo) Imposta il tempo di attesa, in secondi, per il completamento del processo di elaborazione dati prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

• %neptune_ml dataprocessing status: recupera lo stato di un processo di elaborazione dati.

  Parametri

  • --job-id ID of the job   — ID del lavoro di cui recuperare lo stato.

  • --store-to instance type   — (opzionale) La variabile in cui memorizzare il risultato dell'allenamento del modello.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento dell'addestramento del modello.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli dello stato di addestramento del modello (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (opzionale) Imposta il tempo di attesa, in secondi, per il completamento del processo di elaborazione dati prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

• %neptune_ml training start: avvia il processo di addestramento del modello Neptune ML.

  Parametri

  • --job-id ID for this job   — (opzionale) ID da assegnare a questo lavoro.

  • --data-processing-id dataprocessing job ID   — (opzionale) ID del processo di elaborazione dati che ha creato gli artefatti da utilizzare per la formazione.

  • --s3-output-uri S3 URI   — (opzionale) L'S3 URI in cui memorizzare l'output di questo processo di addestramento del modello.

  • --instance-type (instance type)   — (opzionale) La dimensione dell'istanza da utilizzare per questo processo di formazione su modelli.

  • --store-to location-to-store-result   — (opzionale) La variabile in cui memorizzare il risultato dell'addestramento del modello.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento dell'addestramento del modello.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli dello stato di addestramento del modello (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (opzionale) Imposta il tempo di attesa, in secondi, per il completamento del processo di formazione del modello prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

• %neptune_ml training status: recupera lo stato di un processo di addestramento del modello Neptune ML.

  Parametri

  • --job-id ID of the job   — ID del lavoro di cui recuperare lo stato.

  • --store-to instance type   — (opzionale) La variabile in cui memorizzare il risultato dello stato.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento dell'addestramento del modello.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli dello stato di addestramento del modello (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (opzionale) Imposta il tempo di attesa, in secondi, per il completamento del processo di elaborazione dati prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

• %neptune_ml endpoint create: crea un endpoint di query per un modello Neptune ML.

  Parametri

  • --job-id ID for this job   — (opzionale) ID da assegnare a questo lavoro.

  • --model-job-id model-training job ID   — (opzionale) ID del lavoro di formazione del modello per il quale creare un endpoint di interrogazione.

  • --instance-type (instance type)   — (opzionale) La dimensione dell'istanza da utilizzare per l'endpoint di interrogazione.

  • --store-to location-to-store-result   — (opzionale) La variabile in cui memorizzare il risultato della creazione dell'endpoint.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento della creazione dell'endpoint.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli di stato (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (opzionale) Imposta il tempo, in secondi, di attesa per il completamento del processo di creazione dell'endpoint prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

• %neptune_ml endpoint status: recupera lo stato di un endpoint di query Neptune ML.

  Parametri

  • --job-id endpoint creation ID   — (opzionale) ID di un processo di creazione di endpoint di cui segnalare lo stato.

  • --store-to location-to-store-result   — (opzionale) La variabile in cui memorizzare il risultato dello stato.

  • --wait (facoltativo): flag che indica che l'operazione deve attendere il completamento della creazione dell'endpoint.

  • --wait-interval interval-to-wait   — (opzionale) Imposta il tempo, in secondi, tra i controlli di stato (impostazione predefinita: 60).

  • --wait-timeout timeout-seconds   — (opzionale) Imposta il tempo, in secondi, di attesa per il completamento del processo di creazione dell'endpoint prima di ripristinare lo stato più recente (impostazione predefinita: 3.600).

• %%neptune_ml export start: avvia un processo di esportazione Neptune ML.

• %%neptune_ml dataprocessing start: avvia un processo di elaborazione dati Neptune ML.

• %%neptune_ml training start: avvia un processo di addestramento del modello Neptune ML.

• %%neptune_ml endpoint create: crea un endpoint di query Neptune ML per un modello.