Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Uso de elementos mágicos en las libretas de Amazon Neptune
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:
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:
También hay dos comandos mágicos, uno de línea y otro de celda, con los que trabajar con Machine learning de Neptune:
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
.ParaopenCypher:
~labels
.ParaSPARQL:
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
.ParaopenCypher:
~labels
.ParaSPARQL:
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
.ParaopenCypher:
~labels
.ParaSPARQL:
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
.ParaopenCypher:
~labels
.ParaSPARQL:
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.En el caso de openCypher solo, esto es
--rel-label-max-length
o-rel
en su lugar. -
--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 consistir en una única clave de propiedad o en una JSON cadena que puede especificar una propiedad diferente para cada tipo de etiqueta. Una JSON cadena solo se puede especificar mediante la inyección de variables.
El comando mágico de línea %seed
La magia %seed
lineal es una forma práctica de añadir datos al punto final de Neptune que puede utilizar para explorar y experimentar con Gremlin o consultas. openCypher SPARQL Proporciona un formulario en el que puede seleccionar el modelo de datos que desea explorar (gráfico de propiedades oRDF) 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 %reset_graph
La %reset_graph
(o%_graph_reset
) line magic ejecuta una ResetGraphllamada contra el punto final de Neptune Analytics. Acepta la siguiente entrada de línea opcional:
-
-ns o -- no-skip-snapshot - Si están presentes, se creará una instantánea final del gráfico antes de eliminar los datos del gráfico.
-
--silent: si está presente, no se muestra ningún resultado después de enviar la llamada de restablecimiento.
-
--store-to: se usa para especificar una variable en la que almacenar la respuesta. ResetGraph
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).
En el caso de los hosts de Neptune DB, la información de estado se obtendrá del punto final del estado de salud. En el caso de los hosts de Neptune Analytics, el estado se recuperará mediante. GetGraph API Para obtener más información, consulte %get_graph.
El comando mágico de línea %get_graph
La magia %get_graph
lineal recupera información sobre un gráfico a través del. GetGraph API Esta magia es funcionalmente idéntica a %status cuando se usa con Neptune Analytics.
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. -
--cancelQuery
o-c
: cancela una consulta en ejecución. No toma ningún valor. -
--silent-cancel
o-s
— Si--silent
se establece entrue
al cancelar una consulta, la consulta en curso se cancela con un código de HTTP respuesta de.200
De lo contrario, el código de HTTP respuesta sería.500
-
--store-to
: especifica el nombre de una variable en la que se van a almacenar los resultados de la consulta. -
-w/--includeWaiting
— Solo Neptune DB. Si se establece en true y no hay otros parámetros presentes, se devuelve la información de estado de las consultas en espera y de las consultas en ejecución. Este parámetro no selecciona un valor. -
--state
— Solo Neptune Analytics. Especifica el subconjunto de estados de consulta del que se va a recuperar el estado. -
-m/--maxResults
— Solo Neptune Analytics. Establece un límite superior para el conjunto de consultas devueltas que coinciden con el valor de--state
. -
--silent
: si está presente, no se muestra ningún resultado una vez finalizada la consulta.
El comando mágico de línea %sparql_status
Recupera la información sobre el estado de la SPARQL consulta.
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
osparql
. Si no indica este argumento, el valor predeterminado esgremlin
. -
--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 es10
.
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
Esta línea mágica muestra un JSON objeto que contiene la configuración que utiliza el portátil 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 es8182
.auth_mode
: el modo de autenticación que se utilizará al emitir comandos a Neptune. Debe serloIAM
si se conecta a un clúster que tiene habilitada la IAM autenticación o si noDEFAULT
.load_from_s3_arn
: Especifica un Amazon S3 ARN para que lo use la%load
magia. Si este valor está vacío, ARN debe especificarse en el%load
comando.ssl
: Un valor booleano que indica si se debe conectar o no a Neptune utilizando. TLS El valor predeterminado estrue
.aws_region
: la región en la que está implementado este cuaderno. Esta información se utiliza para la IAM autenticación y para las solicitudes.%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_service
La magia %graph_notebook_service
de línea establece la entrada de línea como el nombre del servicio utilizado para las solicitudes de Neptune.
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
La magia %statistics
de línea se utiliza para recuperar o gestionar las estadísticas DFE del motor (consulteAdministrar las estadísticas para que las use Neptuno DFE). 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
(opg
) ordf
.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
obasic
.Si no se indica, el valor predeterminado
status
, a no ser que se especifique--summary
, en cuyo caso el valor predeterminado esbasic
. -
--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
(opg
) ordf
.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
La magia %%graph_notebook_config
celular utiliza un JSON objeto que contiene información de configuración para modificar los ajustes que utiliza el portátil 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
La magia %%sparql
celular envía una SPARQL consulta al punto final 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 finalSPARQL. 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 SPARQL visualización solo incluye patrones triples en los que
o?
es unuri
o unbnode
(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
odetails
). -
--explain-format
: se utiliza para especificar el formato de respuesta de una consulta Explain (una de las siguientes opciones:text/csv
otext/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 SPARQLvisualización):
%%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 Gremlin profile API, 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
-
--profile-chop
: especifica la longitud máxima de la cadena de resultados del perfil. Si no indica este argumento, el valor predeterminado es 250. -
--profile-serializer
: especifica el serializador que se utilizará para los resultados. Los valores permitidos son cualquiera de los valores de enumeración de los «serializadores» de MIME tipo o TinkerPop controlador válidos. Si no indica este argumento, el valor predeterminado esapplication.json
. -
--profile-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. -
--profile-indexOps
: muestra un informe detallado de todas las operaciones de índice.
El comando mágico de celda %%opencypher
(también %%oc
)
La magia %%opencypher
celular (que también tiene la %%oc
forma abreviada), envía una openCypher consulta al punto final de Neptune. Acepta los siguientes argumentos de entrada de línea opcionales:
-
modo: el modo de consulta (
query
obolt
). Si no indica este argumento, el valor predeterminado esquery
. -
--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 es10
. -
--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 esauto
. -
--query-timeout
o-qt
: especifica el tiempo de espera máximo de la consulta en milisegundos. El valor predeterminado es1800000
. -
--query-parameters
oqp
: 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
-
Defina un mapa de openCypher parámetros en una celda del cuaderno.
params = '''{ "name":"john", "age": 20, }'''
-
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 final de Amazon API Gateway al que 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) Bandera que indica que no SSL debe utilizarse al conectarse con el exportador. -
--wait
: (opcional) indica que la operación debe esperar hasta que se haya completado la exportación. -
--wait-interval
interval-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 (predeterminado: 3600). -
--store-to
location-to-store-result
— (opcional) La variable en la que se almacenará 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
export job ID
— El ID del trabajo de exportación del que se va a recuperar el estado. -
--export-url
exporter-endpoint
— (opcional) El punto final de Amazon API Gateway al que 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) Bandera que indica que no SSL debe utilizarse al conectarse con el exportador. -
--wait
: (opcional) indica que la operación debe esperar hasta que se haya completado la exportación. -
--wait-interval
interval-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 (predeterminado: 3600). -
--store-to
location-to-store-result
— (opcional) La variable en la que se almacenará 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
ID for this job
— (opcional) ID para asignar a este trabajo. -
--s3-input-uri
S3 URI
— (opcional) El S3 URI en el que se encuentra la entrada para este trabajo de procesamiento de datos. -
--config-file-name
file name
— (opcional) Nombre del archivo de configuración para este trabajo de procesamiento de datos. -
--store-to
location-to-store-result
— (opcional) La variable en la que se almacenará el resultado del procesamiento de datos. -
--instance-type
(instance type)
— (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-interval
interval-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 (predeterminado: 3600).
-
-
%neptune_ml dataprocessing status
: recupera el estado de un trabajo de procesamiento de datos.Parámetros
-
--job-id
ID of the job
— ID del trabajo del que se va a recuperar el estado. -
--store-to
instance type
— (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-interval
interval-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, de espera a que se complete el trabajo de procesamiento de datos antes de devolver el estado más reciente (predeterminado: 3600).
-
-
%neptune_ml training start
: inicia el proceso de entrenamiento de modelos de Neptune ML.Parámetros
-
--job-id
ID for this job
— (opcional) ID para asignar a este trabajo. -
--data-processing-id
dataprocessing job ID
— (opcional) ID del trabajo de procesamiento de datos que creó los artefactos para usarlos en la formación. -
--s3-output-uri
S3 URI
— (opcional) El S3 URI en el que almacenar los resultados de este trabajo de entrenamiento de modelos. -
--instance-type
(instance type)
— (opcional) El tamaño de la instancia que se utilizará para este trabajo de entrenamiento de modelos. -
--store-to
location-to-store-result
— (opcional) La variable en la que se almacenará 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-interval
interval-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, de espera a que se complete el trabajo de entrenamiento del modelo antes de devolver el estado más reciente (predeterminado: 3600).
-
-
%neptune_ml training status
: recupera el estado de un trabajo de entrenamiento de modelos de Neptune ML.Parámetros
-
--job-id
ID of the job
— ID del trabajo del que se va a recuperar el estado. -
--store-to
instance type
— (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-interval
interval-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, de espera a que se complete el trabajo de procesamiento de datos antes de devolver el estado más reciente (predeterminado: 3600).
-
-
%neptune_ml endpoint create
: crea un punto de conexión de consulta de un modelo de Neptune ML.Parámetros
-
--job-id
ID for this job
— (opcional) ID para asignar a este trabajo. -
--model-job-id
model-training job ID
— (opcional) ID del trabajo de entrenamiento de modelos para el que se va a crear un punto final de consulta. -
--instance-type
(instance type)
— (opcional) El tamaño de la instancia que se utilizará para el punto final de la consulta. -
--store-to
location-to-store-result
— (opcional) La variable en la que se almacenará 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-interval
interval-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 del punto final antes de devolver el estado más reciente (predeterminado: 3600).
-
-
%neptune_ml endpoint status
: recupera el estado de un punto de conexión de consulta de Neptune ML.Parámetros
-
--job-id
endpoint creation ID
— (opcional) ID de un trabajo de creación de terminales del que se debe informar del estado. -
--store-to
location-to-store-result
— (opcional) La variable en la que se almacenará 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-interval
interval-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 del punto final antes de devolver el estado más reciente (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, la magia %%neptune_ml export start
celular puede consumir un JSON documento del cuerpo celular que contenga todos los parámetros descritos enParámetros utilizados para controlar el proceso de exportación de Neptune.
En el cuaderno Neptune-ML-01-Introduction-to-Node-Classification-Gremlinexport-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 utilizar ${export_params}
para inyectar el JSON documento en el cuerpo de un%%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.