Uso de los comandos mágicos del entorno de trabajo de Neptune en sus cuadernos

El entorno de trabajo de Neptune incluye una serie de los denominados comandos mágicos en los cuadernos que ahorran una gran cantidad de tiempo y esfuerzo. Se dividen en dos categorías: comandos mágicos de línea y comandos mágicos de celda.

Los comandos mágicos de línea son comandos precedidos por un único signo de porcentaje (%). Solo reciben entradas de línea, no entradas del resto del cuerpo de la celda. El entorno de trabajo de Neptune ofrece los siguientes comandos mágicos de línea:

• %seed

• %load

• %load_ids

• %load_status

• %cancel_load

• %status

• %gremlin_status

• %opencypher_status u %oc_status

• %stream_viewer

• %sparql_status

• %graph_notebook_config

• %graph_notebook_host

• %graph_notebook_version

• %graph_notebook_vis_options

• %statistics

• %summary

Los comandos mágicos de celda están precedidos por dos signos de porcentaje (%%) en lugar de uno, y utilizan el contenido de la celda como entrada, aunque también pueden tomar el contenido de la línea como entrada. El entorno de trabajo de Neptune ofrece los siguientes comandos mágicos de celda:

• %%sparql

• %%gremlin

• %%opencypher u %%oc

• %%graph_notebook_config

• %%graph_notebook_vis_options

También hay dos comandos mágicos, uno de línea y otro de celda, con los que trabajar con Machine learning de Neptune:

• %neptune_ml

• %%neptune_ml

nota

Cuando se trabaja con los comandos mágicos de Neptune, por lo general, se puede obtener texto de ayuda mediante un parámetro --help o -h. Con un comando mágico de celda, el cuerpo no puede estar vacío, así que cuando solicite ayuda, coloque texto de relleno, aunque sea un solo carácter, en el cuerpo. Por ejemplo:

%%gremlin --help
  x

Inyección de variables en comandos mágicos de celda o línea

Se puede hacer referencia a las variables definidas en un cuaderno dentro de cualquier comando mágico de celda o línea del cuaderno mediante el formato: ${VAR_NAME}.

Por ejemplo, supongamos que define estas variables:

c = 'code'
my_edge_labels = '{"route":"dist"}'

Luego, esta consulta de Gremlin en un comando mágico de celda:

%%gremlin -de $my_edge_labels
g.V().has('${c}','SAF').out('route').values('${c}')

Equivale a:

%%gremlin -de {"route":"dist"}
g.V().has('code','SAF').out('route').values('code')

Argumentos de consulta que funcionan con todos los lenguajes de consulta

Los siguientes argumentos de consulta funcionan con los comandos mágicos %%gremlin, %%opencypher y %%sparql en el entorno de trabajo de Neptune:

Argumentos comunes de consulta

• --store-to (o -s): especifica el nombre de una variable en la que se van a almacenar los resultados de la consulta.

• --silent: si está presente, no se muestra ningún resultado una vez finalizada la consulta.

• --group-by (o -g): especifica la propiedad utilizada para agrupar los nodos (como, por ejemplo, code oT.region). Los vértices se colorean en función del grupo asignado.

• --ignore-groups: si están presentes, se ignoran todas las opciones de agrupación.

• --display-property (o -d): especifica la propiedad cuyo valor debe mostrarse para cada vértice.

  El valor predeterminado de cada lenguaje de consulta es el siguiente:

  • Para Gremlin: T.label.

  • Para openCypher: ~labels.

  • Para SPARQL: type.

• --edge-display-property (o -t): especifica la propiedad cuyo valor debe mostrarse para cada borde.

  El valor predeterminado de cada lenguaje de consulta es el siguiente:

  • Para Gremlin: T.label.

  • Para openCypher: ~labels.

  • Para SPARQL: type.

• --tooltip-property (o -de): especifica la propiedad cuyo valor debe mostrarse como ayuda contextual para cada nodo.

  El valor predeterminado de cada lenguaje de consulta es el siguiente:

  • Para Gremlin: T.label.

  • Para openCypher: ~labels.

  • Para SPARQL: type.

• --edge-tooltip-property (o -te): especifica la propiedad cuyo valor debe mostrarse como ayuda contextual para cada borde.

  El valor predeterminado de cada lenguaje de consulta es el siguiente:

  • Para Gremlin: T.label.

  • Para openCypher: ~labels.

  • Para SPARQL: type.

• --label-max-length (o -l): especifica la longitud máxima de caracteres de cualquier etiqueta de vértice. El valor predeterminado es 10.

• --edge-label-max-length (o -le): especifica la longitud máxima de caracteres de cualquier etiqueta de borde. El valor predeterminado es 10.

  Solo en el caso de openCypher, es --rel-label-max-length o, en su lugar, -rel.

• --simulation-duration (o -sd): especifica la duración máxima de la simulación física de visualización. El valor predeterminado es 1500 ms.

• --stop-physics (o -sp): deshabilita la simulación física de visualización una vez que la simulación inicial se haya estabilizado.

Los valores de propiedad de estos argumentos pueden constar de una única clave de propiedad o de una cadena JSON que puede especificar una propiedad diferente para cada tipo de etiqueta. Una cadena JSON solo se puede especificar mediante la inyección de variables.

El comando mágico de línea %seed

El comando mágico de línea %seed es una forma práctica de añadir datos al punto de conexión de Neptune que puede utilizar para explorar y experimentar con consultas de Gremlin, openCypher o SPARQL. Proporciona un formulario en el que puede seleccionar el modelo de datos que desea explorar (gráfico de propiedades o RDF) y, a continuación, elegir entre varios conjuntos de datos de muestra diferentes que proporciona Neptune.

El comando mágico de línea %load

El comando mágico de línea %load genera un formulario que puede utilizar para enviar una solicitud de carga masiva a Neptune (consulte Comando del programa de carga de Neptune). El origen debe ser una ruta de Amazon S3 en la misma región que el clúster de Neptune.

El comando mágico de línea %load_ids

El comando mágico de línea %load_ids recupera los identificadores de carga que se enviaron al punto de conexión del host del cuaderno (consulte Parámetros de las solicitudes de obtención de estado del programa de carga de Neptune). La solicitud se realiza de la siguiente forma:

GET https://your-neptune-endpoint:port/loader

El comando mágico de línea %load_status

El comando mágico de línea %load_status recupera el estado de carga de un determinado trabajo de carga que se ha enviado al punto de conexión del host del cuaderno, especificado en la entrada de línea (consulte Parámetros de las solicitudes de obtención de estado del programa de carga de Neptune). La solicitud se realiza de la siguiente forma:

GET https://your-neptune-endpoint:port/loader?loadId=loadId

El comando mágico de línea tiene un aspecto similar al siguiente:

%load_status load id

El comando mágico de línea %cancel_load

El comando mágico de línea %cancel_load cancela un determinado trabajo de carga (consulte Cancelación de trabajo del programa de carga de Neptune). La solicitud se realiza de la siguiente forma:

DELETE https://your-neptune-endpoint:port/loader?loadId=loadId

El comando mágico de línea tiene un aspecto similar al siguiente:

%cancel_load load id

El comando mágico de línea %status

Recupera la información de estado del punto de conexión del host del cuaderno (%graph_notebook_config muestra el punto de conexión del host).

El comando mágico de línea %gremlin_status

Recupera información de estado de consulta de Gremlin.

El comando mágico de línea %opencypher_status (también %oc_status)

Recupera el estado de una consulta de openCypher. Este comando mágico de línea adopta los siguientes argumentos opcionales:

• --queryId o -q: especifica el ID de una consulta en ejecución específica cuyo estado debe mostrarse.

• --cancel_query o -c: cancela una consulta en ejecución. No toma ningún valor.

• --silent o -s: si --silent se establece en true al cancelar una consulta, la consulta en ejecución se cancela con un código de respuesta HTTP de 200. De lo contrario, el código de respuesta HTTP sería 500.

• --store-to: especifica el nombre de una variable en la que se van a almacenar los resultados de la consulta.

El comando mágico de línea %sparql_status

Recupera la información sobre el estado de la consulta de SPARQL.

El comando mágico de línea %stream_viewer

El comando mágico de línea %stream_viewer muestra una interfaz que permite explorar de forma interactiva las entradas registradas en las transmisiones de Neptune, si estas están habilitadas en el clúster de Neptune. Acepta los siguientes argumentos opcionales:

• language: el lenguaje de consulta de los datos de la transmisión: gremlin o sparql. Si no indica este argumento, el valor predeterminado es gremlin.

• --limit: especifica el número máximo de entradas de transmisión que se van a mostrar por página. Si no indica este argumento, el valor predeterminado es 10.

nota

El comando mágico de línea %stream_viewer solo es totalmente compatible con las versiones de motor 1.0.5.1 y anteriores.

El comando mágico de línea %graph_notebook_config

Este comando mágico de línea muestra un objeto JSON que incluye la configuración que utiliza el cuaderno para comunicarse con Neptune. La configuración incluye:

• host: el punto de conexión al que conectarse y emitir comandos.

• port: el puerto que se utiliza al emitir comandos a Neptune. El valor predeterminado es 8182.

• auth_mode: el modo de autenticación que se utilizará al emitir comandos a Neptune. Debe ser IAM si se conecta a un clúster que tenga habilitada la autenticación de IAM, o de lo contrario, DEFAULT.

• load_from_s3_arn: especifica un ARN de Amazon S3 para que lo utilice el comando mágico %load. Si este valor está vacío, se debe especificar el ARN en el comando %load.

• ssl: un valor booleano que indica si se debe conectar o no a Neptune mediante TLS. El valor predeterminado es true.

• aws_region: la región en la que está implementado este cuaderno. Esta información se utiliza para la autenticación de IAM y para las solicitudes de %load.

Para cambiar la configuración, copie el resultado de %graph_notebook_config en una celda nueva y modifíquelo ahí. Luego, al ejecutar el comando mágico de celda %%graph_notebook_config en la nueva celda, la configuración cambiará en consecuencia.

El comando mágico de línea %graph_notebook_host

Establece la entrada de línea como host del cuaderno.

El comando mágico de línea %graph_notebook_version

El comando mágico de línea %graph_notebook_version devuelve el número de versión del cuaderno del entorno de trabajo de Neptune. Por ejemplo, la visualización de gráficos se introdujo en la versión 1.27.

El comando mágico de línea %graph_notebook_vis_options

El comando mágico de línea %graph_notebook_vis_options muestra la configuración de visualización actual que está utilizando el cuaderno. Estas opciones se explican en la documentación de vis.js.

Para modificar esta configuración, copie el resultado en una celda nueva, realice los cambios que desee y, a continuación, ejecute el comando mágico de celda %%graph_notebook_vis_options en la celda.

Para restaurar la configuración de visualización a sus valores predeterminados, puede ejecutar el comando mágico de línea %graph_notebook_vis_options con un parámetro reset. Esto restablece todos los ajustes de visualización:

%graph_notebook_vis_options reset

El comando mágico de línea %statistics

El comando mágico de línea %statistics se utiliza para recuperar o administrar las estadísticas del motor DFE (consulte Administración de las estadísticas para que las utilice el DFE de Neptune). Este comando mágico también se puede utilizar para recuperar un resumen de gráficos.

Acepta los siguientes parámetros:

• --language: el lenguaje de consulta del punto de conexión de las estadísticas: propertygraph (o pg) o rdf.

  Si no se indica, el valor predeterminado es propertygraph.

• --mode (o -m): especifica el tipo de solicitud o acción que se va a enviar. Una de las siguientes opciones: status, disableAutoCompute, enableAutoCompute, refresh, delete, detailed o basic.

  Si no se indica, el valor predeterminado status, a no ser que se especifique --summary, en cuyo caso el valor predeterminado es basic.

• --summary: recupera el resumen de gráficos del punto de conexión del resumen de estadísticas del lenguaje seleccionado.

• --silent: si está presente, no se muestra ningún resultado una vez finalizada la consulta.

• --store-to: se utiliza para especificar una variable en la que almacenar los resultados de la consulta.

El comando mágico de línea %summary

El comando mágico de línea %summary se utiliza para recuperar la información del resumen de gráficos. Está disponible a partir de la versión del motor de Neptune 1.2.1.0.

Acepta los siguientes parámetros:

• --language: el lenguaje de consulta del punto de conexión de las estadísticas: propertygraph (o pg) o rdf.

  Si no se indica, el valor predeterminado es propertygraph.

• --detailed: habilita o deshabilita la visualización de los campos de estructuras en el resultado.

  Si no se indica, el valor predeterminado es el modo de visualización del resumen basic.

• --silent: si está presente, no se muestra ningún resultado una vez finalizada la consulta.

• --store-to: se utiliza para especificar una variable en la que almacenar los resultados de la consulta.

El comando mágico de celda %%graph_notebook_config

El comando mágico de celda %%graph_notebook_config utiliza un objeto JSON que incluye información de configuración para modificar los ajustes que utiliza el cuaderno para comunicarse con Neptune, si es posible. La configuración adopta la misma forma devuelta por el comando mágico de línea %graph_notebook_config.

Por ejemplo:

%%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"
}

El comando mágico de celda %%sparql

El comando mágico de celda %%sparql emite una consulta de SPARQL al punto de conexión de Neptune. Acepta la siguiente entrada de línea opcional:

• -h o --help: devuelve texto de ayuda sobre estos parámetros.

• --path: prefija una ruta al punto de conexión de SPARQL. Por ejemplo, si especifica --path "abc/def", el punto de conexión llamado sería host:port/abc/def.

• --expand-all: se trata de una sugerencia de visualización de consultas que indica al visualizador que incluya todos los resultados ?s ?p ?o en el diagrama del gráfico, independientemente del tipo de enlace.

  De forma predeterminada, una visualización de SPARQL solo incluye patrones triples en los que o? es uri o bnode (nodo en blanco). Todos los demás tipos de enlaces ?o, como las cadenas literales o los números enteros, se tratan como propiedades del nodo ?s y se pueden ver mediante el panel detalles de la pestaña Gráfico.

  Utilice la sugerencia de consulta --expand-all cuando desee incluir valores literales como vértices en la visualización.

  No combine esta sugerencia de visualización con los parámetros de explicación, ya que las consultas de explicación no se visualizan.

• --explain-type: se utiliza para especificar el modo de explicación que se va a utilizar (una de las siguientes opciones: dynamic, static o details).

• --explain-format: se utiliza para especificar el formato de respuesta de una consulta Explain (una de las siguientes opciones: text/csv o text/html).

• --store-to: se utiliza para especificar una variable en la que almacenar los resultados de la consulta.

Ejemplo de una consulta de explain:

%%sparql explain

SELECT * WHERE {?s ?p ?o} LIMIT 10

Ejemplo de una consulta de visualización con un parámetro de sugerencia de visualización --expand-all (consulte Visualización de SPARQL):

%%sparql --expand-all

SELECT * WHERE {?s ?p ?o} LIMIT 10

El comando mágico de celda %%gremlin

La magia %%gremlin celular envía una consulta de Gremlin al punto final de Neptuno utilizando. WebSocket Acepta una entrada de línea opcional para alternar entre el modo /> explain de Gremlin o API profile de Gremlin, y una entrada de sugerencia de visualización opcional independiente para modificar el comportamiento de la salida de la visualización (consulte Visualización de Gremlin).

Ejemplo de una consulta de explain:

%%gremlin explain

g.V().limit(10)

Ejemplo de una consulta de profile:

%%gremlin profile

g.V().limit(10)

Ejemplo de una consulta de visualización con una sugerencia de consulta de visualización:

%%gremlin -p v,outv

g.V().out().limit(10)

Parámetros opcionales para consultas de %%gremlin profile

• --chop: especifica la longitud máxima de la cadena de resultados del perfil. Si no indica este argumento, el valor predeterminado es 250.

• --serializer: especifica el serializador que se utilizará para los resultados. Los valores permitidos son cualquiera de los valores de enumeración válidos del tipo MIME o de los « TinkerPop serializadores» del controlador. Si no indica este argumento, el valor predeterminado es application.json.

• --no-results: muestra solo el recuento de resultados. Si no se utiliza, todos los resultados de la consulta se muestran de forma predeterminada en el informe de perfil.

• --indexOps: muestra un informe detallado de todas las operaciones de índice.

El comando mágico de celda %%opencypher (también %%oc)

El comando mágico de celda %%opencypher (que también tiene la forma abreviada %%oc) emite una consulta openCypher al punto de conexión de Neptune. Acepta los siguientes argumentos de entrada de línea opcionales:

• modo: el modo de consulta (query o bolt). Si no indica este argumento, el valor predeterminado es query.

• --group-by o -g: especifica la propiedad utilizada para agrupar los nodos. Por ejemplo, code, ~id. Si no indica este argumento, el valor predeterminado es ~labels.

• --ignore-groups: si están presentes, se ignoran todas las opciones de agrupación.

• --display-propery o -d: especifica la propiedad cuyo valor debe mostrarse para cada vértice. Si no indica este argumento, el valor predeterminado es ~labels.

• --edge-display-propery o -de: especifica la propiedad cuyo valor debe mostrarse para cada borde. Si no indica este argumento, el valor predeterminado es ~labels.

• --label-max-length o -l: especifica el número máximo de caracteres que debe mostrar una etiqueta de vértice. Si no indica este argumento, el valor predeterminado es 10.

• --store-to o -s: especifica el nombre de una variable en la que se van a almacenar los resultados de la consulta.

• --plan-cache o -pc: especifica el modo de caché del plan que se va a utilizar. El valor predeterminado es. auto (*plan-cache solo está disponible para Neptune Analytics)

• --query-timeout o -qt: especifica el tiempo de espera máximo de la consulta en milisegundos. El valor predeterminado es 1800000.

• --query-parameters o qp: definiciones de parámetros que se van a aplicar a la consulta. Esta opción puede aceptar un único nombre de variable o una representación en cadena de la asignación.

  Ejemplo de uso de --query-parameters

  1. Defina un mapa de los parámetros de openCypher en una celda del cuaderno.

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

  2. Pase los parámetros de --query-parameters a otra celda con %%oc.

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

• --explain-type: se utiliza para especificar el modo de explicación que se va a utilizar (uno de los siguientes: dinámico, estático o detallado).

El comando mágico de celda %%graph_notebook_vis_options

El comando mágico de celda %%graph_notebook_vis_options le permite configurar las opciones de visualización del cuaderno. Puede copiar los ajustes devueltos por el comando mágico de línea %graph-notebook-vis-options en una nueva celda, realizar cambios en ellos y usar el comando mágico de celda %%graph_notebook_vis_options para establecer los nuevos valores.

Estas opciones se explican en la documentación de vis.js.

Para restaurar la configuración de visualización a sus valores predeterminados, puede ejecutar el comando mágico de línea %graph_notebook_vis_options con un parámetro reset. Esto restablece todos los ajustes de visualización:

%graph_notebook_vis_options reset

El comando mágico de línea %neptune_ml

Puede utilizar el comando mágico de línea %neptune_ml para iniciar y administrar diversas operaciones de Neptune ML.

nota

También puede iniciar y administrar algunas operaciones de Neptune ML con el comando mágico de celda %%neptune_ml.

• %neptune_ml export start: inicia un nuevo trabajo de exportación.

  Parámetros

  • --export-url exporter-endpoint: (opcional) el punto de conexión de Amazon API Gateway donde se puede llamar al exportador.

  • --export-iam: (opcional) indica que las solicitudes a la URL de exportación deben firmarse con SigV4.

  • --export-no-ssl: (opcional) indica que SSL no debe utilizarse al conectarse al exportador.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado la exportación.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones del estado de la exportación (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de exportación antes de devolver el estado más reciente (valor predeterminado: 3600).

  • --store-tolocation-to-store-result— (opcional) La variable en la que se almacena el resultado de la exportación. Si se especifica --wait, el estado final se almacenará allí.

• %neptune_ml export status: recupera el estado de un trabajo de exportación.

  Parámetros

  • --job-id ID del trabajo de exportación: el ID del trabajo de exportación del que se va a recuperar el estado.

  • --export-url exporter-endpoint: (opcional) el punto de conexión de Amazon API Gateway donde se puede llamar al exportador.

  • --export-iam: (opcional) indica que las solicitudes a la URL de exportación deben firmarse con SigV4.

  • --export-no-ssl: (opcional) indica que SSL no debe utilizarse al conectarse al exportador.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado la exportación.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones del estado de la exportación (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de exportación antes de devolver el estado más reciente (valor predeterminado: 3600).

  • --store-tolocation-to-store-result— (opcional) La variable en la que se almacena el resultado de la exportación. Si se especifica --wait, el estado final se almacenará allí.

• %neptune_ml dataprocessing start: inicia el paso de procesamiento de datos de Neptune ML.

  Parámetros

  • --job-id Identificador para este trabajo: (opcional) identificador para asignar a este trabajo.

  • --s3-input-uri URI de S3: (opcional) el URI de S3 en el que se encuentra la entrada de este trabajo de procesamiento de datos.

  • --config-file-name nombre de archivo: (opcional) nombre del archivo de configuración de este trabajo de procesamiento de datos.

  • --store-tolocation-to-store-result— (opcional) La variable en la que se almacenará el resultado del procesamiento de datos.

  • --instance-type (tipo de instancia): (opcional) el tamaño de la instancia que se utilizará para este trabajo de procesamiento de datos.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado el procesamiento de datos.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones del estado del procesamiento de datos (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de procesamiento de datos antes de devolver el estado más reciente (valor predeterminado: 3600).

• %neptune_ml dataprocessing status: recupera el estado de un trabajo de procesamiento de datos.

  Parámetros

  • --job-id ID del trabajo: el ID del trabajo del que se va a recuperar el estado.

  • --store-to tipo de instancia: (opcional) la variable en la que se almacena el resultado del entrenamiento de modelos.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado el entrenamiento de modelos.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones de estado del entrenamiento del modelo (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de procesamiento de datos antes de devolver el estado más reciente (valor predeterminado: 3600).

• %neptune_ml training start: inicia el proceso de entrenamiento de modelos de Neptune ML.

  Parámetros

  • --job-id Identificador para este trabajo: (opcional) identificador para asignar a este trabajo.

  • --data-processing-id ID del trabajo de procesamiento de datos: (opcional) ID del trabajo de procesamiento de datos que creó los artefactos para usarlos en el entrenamiento.

  • --s3-output-uri URI de S3: (opcional) el URI de S3 en el que se almacena el resultado de este trabajo de entrenamiento de modelos.

  • --instance-type (tipo de instancia): (opcional) el tamaño de la instancia que se utilizará para este trabajo de entrenamiento de modelos.

  • --store-tolocation-to-store-result— (opcional) La variable en la que se almacena el resultado del entrenamiento del modelo.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado el entrenamiento de modelos.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones del estado del entrenamiento del modelo (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de entrenamiento de modelos antes de devolver el estado más reciente (valor predeterminado: 3600).

• %neptune_ml training status: recupera el estado de un trabajo de entrenamiento de modelos de Neptune ML.

  Parámetros

  • --job-id ID del trabajo: el ID del trabajo del que se va a recuperar el estado.

  • --store-to tipo de instancia: (opcional) la variable en la que se almacena el resultado del estado.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado el entrenamiento de modelos.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones del estado del entrenamiento del modelo (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de procesamiento de datos antes de devolver el estado más reciente (valor predeterminado: 3600).

• %neptune_ml endpoint create: crea un punto de conexión de consulta de un modelo de Neptune ML.

  Parámetros

  • --job-id Identificador para este trabajo: (opcional) identificador para asignar a este trabajo.

  • --model-job-id ID del trabajo de entrenamiento de modelos: (opcional) ID del trabajo de entrenamiento de modelos para el que se creará un punto de conexión de consulta.

  • --instance-type (tipo de instancia): (opcional) el tamaño de la instancia que se utilizará para el punto de conexión de consulta.

  • --store-tolocation-to-store-result— (opcional) La variable en la que se almacena el resultado de la creación del punto final.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado la creación del punto de conexión.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones de estado (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de creación de punto de conexión antes de devolver el estado más reciente (valor predeterminado: 3600).

• %neptune_ml endpoint status: recupera el estado de un punto de conexión de consulta de Neptune ML.

  Parámetros

  • --job-id ID de creación de punto de conexión: (opcional) ID de un trabajo de creación de punto de conexión para notificar el estado.

  • --store-tolocation-to-store-result— (opcional) La variable en la que se almacena el resultado del estado.

  • --wait: (opcional) indica que la operación debe esperar hasta que se haya completado la creación del punto de conexión.

  • --wait-intervalinterval-to-wait— (opcional) Establece el tiempo, en segundos, entre las comprobaciones de estado (predeterminado: 60).

  • --wait-timeout timeout-seconds: (opcional) establece el tiempo, en segundos, que se debe esperar a que se complete el trabajo de creación de punto de conexión antes de devolver el estado más reciente (valor predeterminado: 3600).

El comando mágico de celda %%neptune_ml

El comando mágico de celda %%neptune_ml ignora las entradas de línea como --job-id o --export-url. En cambio, le permite proporcionar esas entradas y otras dentro del cuerpo de la celda.

También puede guardar estas entradas en otra celda, asignarlas a una variable de Jupyter y luego inyectarlas en el cuerpo de la celda con esa variable. De esta forma, puede utilizar dichas entradas una y otra vez sin tener que volver a introducirlas cada vez.

Esto solo funciona si la variable de inyección es el único contenido de la celda. No puede utilizar varias variables en una celda ni una combinación de texto y una variable.

Por ejemplo, el comando mágico de celda %%neptune_ml export start puede consumir un documento JSON en el cuerpo de la celda que incluya todos los parámetros descritos en Parámetros utilizados para controlar el proceso de exportación de Neptune.

En el cuaderno Neptune-ML-01-Introduction-to-Node-Classification-Gremlin, en Configuración de características de la sección Exportación de la configuración de modelos y datos, puede ver cómo la siguiente celda incluye los parámetros de exportación en un documento asignado a una variable de Jupyter denominada 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"}

Al ejecutar esta celda, Jupyter guarda el documento de parámetros con ese nombre. A continuación, puede usar ${export_params} para inyectar el documento JSON en el cuerpo de una %%neptune_ml export start cell, de la siguiente manera:

%%neptune_ml export start --export-url {neptune_ml.get_export_service_host()} --export-iam --wait --store-to export_results

${export_params}

Formas disponibles del comando mágico de celda %%neptune_ml

El comando mágico de celda %%neptune_ml se puede utilizar de las siguientes formas:

• %%neptune_ml export start: inicia un proceso de exportación de Neptune ML.

• %%neptune_ml dataprocessing start: inicia un trabajo de procesamiento de datos de Neptune ML.

• %%neptune_ml training start: inicia un trabajo de entrenamiento de modelos de Neptune ML.

• %%neptune_ml endpoint create: crea un punto de conexión de consulta de Neptune ML para un modelo.