Amazon Neptune 노트북에서 매직 사용

• %seed

• %load

• %load_ids

• %load_status

• %cancel_load

• %status

• %gremlin_status

• %opencypher_status 또는 %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, or %%oc

• %%graph_notebook_config

• %%graph_notebook_vis_options

• %neptune_ml

• %%neptune_ml

일반적인 쿼리 인수

• --store-to(또는 -s)   –   쿼리 결과를 저장할 변수 이름을 지정합니다.

• --silent   –   있는 경우 쿼리가 완료된 후 출력이 표시되지 않습니다.

• --group-by(또는 -g)   –   노드를 그룹화하는 데 사용되는 속성(예: code 또는 T.region)을 지정합니다. 버텍스는 할당된 그룹에 따라 색상이 지정됩니다.

• --ignore-groups   –   있는 경우 모든 그룹화 옵션이 무시됩니다.

• --display-property(또는 -d)   –   각 버텍스에 대해 값을 표시해야 하는 속성을 지정합니다.

  각 쿼리 언어의 기본값은 다음과 같습니다.

  • Gremlin의 경우:   T.label.

  • openCypher의 경우: ~labels.

  • SPARQL의 경우: type.

• --edge-display-property(또는 -t)   –   각 엣지에 대해 값을 표시해야 하는 속성을 지정합니다.

  각 쿼리 언어의 기본값은 다음과 같습니다.

  • Gremlin의 경우:   T.label.

  • openCypher의 경우: ~labels.

  • SPARQL의 경우: type.

• --tooltip-property(또는 -de)   –   각 노드에 대해 값을 도구 설명으로 표시해야 하는 속성을 지정합니다.

  각 쿼리 언어의 기본값은 다음과 같습니다.

  • Gremlin의 경우:   T.label.

  • openCypher의 경우: ~labels.

  • SPARQL의 경우: type.

• --edge-tooltip-property(또는 -te)   –   각 엣지에 대해 값을 도구 설명으로 표시해야 하는 속성을 지정합니다.

  각 쿼리 언어의 기본값은 다음과 같습니다.

  • Gremlin의 경우:   T.label.

  • openCypher의 경우: ~labels.

  • SPARQL의 경우: type.

• --label-max-length (또는 -l)   –   모든 버텍스 레이블의 최대 문자 길이를 지정합니다. 기본값은 10입니다.

• --edge-label-max-length (또는 -le)   –   모든 엣지 레이블의 최대 문자 길이를 지정합니다. 기본값은 10입니다.

  openCypher 의 경우에만 또는 --rel-label-max-length -rel 입니다.

• --simulation-duration(또는 -sd)   –   시각화 물리 시뮬레이션의 최대 기간을 지정합니다. 기본값은 1,500ms입니다.

• --stop-physics(또는 -sp)   –   초기 시뮬레이션이 안정화된 후 시각화 물리를 비활성화합니다.

• -ns 또는 --no-skip-snapshot - 있는 경우 그래프 데이터가 삭제되기 전에 최종 그래프 스냅샷이 생성됩니다.

• --무음 - 있는 경우 재설정 호출이 제출된 후 출력이 표시되지 않습니다.

• --store-to – ResetGraph 응답을 저장할 변수를 지정하는 데 사용됩니다.

• --queryId 또는 -q   –   상태를 표시할 실행 중인 특정 쿼리의 ID를 지정합니다.

• --cancelQuery 또는 -c   –   실행 중인 쿼리를 취소합니다. 값을 취하지 않습니다.

• --silent-cancel 또는 -s - 쿼리를 취소할 true 때 --silent 이 로 설정된 경우 실행 중인 쿼리는 HTTP 응답 코드 로 취소됩니다200. 그렇지 않으면 HTTP 응답 코드는 입니다500.

• --store-to   –   쿼리 결과를 저장할 변수 이름을 지정합니다.

• -w/--includeWaiting – Neptune DB만 해당. true로 설정되고 다른 파라미터가 없는 경우 는 대기 중인 쿼리와 실행 중인 쿼리의 상태 정보를 반환합니다. 이 파라미터는 값을 갖지 않습니다.

• --state – Neptune Analytics만 해당. 상태를 검색할 쿼리 상태의 하위 집합을 지정합니다.

• -m/--maxResults – Neptune Analytics만 해당. 의 값과 일치하는 반환된 쿼리 세트의 상한을 설정합니다--state.

• --silent   –   있는 경우 쿼리가 완료된 후 출력이 표시되지 않습니다.

• language   –   스트림 데이터의 쿼리 언어로, gremlin 또는 sparql입니다. 이 인수를 제공하지 않는 경우 기본값은 gremlin입니다.

• --limit   –   페이지당 표시할 최대 스트림 항목 수를 지정합니다. 이 인수를 제공하지 않는 경우 기본값은 10입니다.

• host: 연결하고 명령을 실행할 엔드포인트입니다.

• port: Neptune에 명령을 실행할 때 사용하는 포트입니다. 기본값은 8182입니다.

• auth_mode: Neptune에 명령을 실행할 때 사용하는 인증 모드입니다. IAM 인증이 활성화된 클러스터에 연결하는 IAM 경우 또는 이어야 합니다DEFAULT.

• load_from_s3_arn: 사용할 %load 매직에 ARN 대한 Amazon S3를 지정합니다. 이 값이 비어 있는 경우 %load 명령에 를 지정해야 ARN 합니다.

• ssl: 를 사용하여 Neptune에 연결할지 여부를 나타내는 부울 값입니다TLS. 기본값은 true입니다.

• aws_region: 이 노트북이 배포된 리전입니다. 이 정보는 IAM 인증 및 %load 요청에 사용됩니다.

• --language   –   통계 엔드포인트의 쿼리 언어로, propertygraph(또는 pg)나 rdf입니다.

  지정하지 않은 경우 기본값은 propertygraph입니다.

• --mode(또는 -m)   –   제출할 요청 또는 작업의 유형을 status, disableAutoCompute, enableAutoCompute, refresh, delete, detailed, basic 중 하나로 지정합니다.

  지정하지 않으면 --summary가 설정되지 않은 경우에 기본값은 status입니다. 설정된 경우의 기본값은 basic입니다.

• --summary   –   선택한 언어의 통계 요약 엔드포인트에서 그래프 요약을 검색합니다.

• --silent   –   있는 경우 쿼리가 완료된 후 출력이 표시되지 않습니다.

• --store-to   –   쿼리 결과를 저장할 변수를 지정하는 데 사용됩니다.

• --language   –   통계 엔드포인트의 쿼리 언어로, propertygraph(또는 pg)나 rdf입니다.

  지정하지 않은 경우 기본값은 propertygraph입니다.

• --detailed   –   출력에서 구조 필드 표시를 켜거나 끕니다.

  지정되지 않은 경우 기본값은 basic 요약 표시 모드입니다.

• --silent   –   있는 경우 쿼리가 완료된 후 출력이 표시되지 않습니다.

• --store-to   –   쿼리 결과를 저장할 변수를 지정하는 데 사용됩니다.

• -h 또는 --help   –   이러한 파라미터에 대한 도움말 텍스트를 반환합니다.

• --path - SPARQL 엔드포인트의 경로를 접두사로 붙입니다. 예를 들어, --path "abc/def"를 지정하는 경우 호출되는 엔드포인트는 host:port/abc/def입니다.

• --expand-all   –   바인딩 유형에 관계없이 그래프 다이어그램에 모든 ?s ?p ?o 결과를 포함하도록 시각화 도우미에 지시하는 쿼리 시각화 힌트입니다.

  기본적으로 SPARQL 시각화에는 이 o? uri 또는 bnode (빈 노드)인 트리플 패턴만 포함됩니다. 리터럴 문자열이나 정수와 같은 다른 모든 ?o 바인딩 유형은 그래프 탭의 세부 정보 창에서 볼 수 있는 ?s 노드의 속성으로 취급됩니다.

  버텍스와 같은 리터럴 값을 시각화에 대신 포함하려는 경우 --expand-all 쿼리 힌트를 사용하세요.

  설명 쿼리는 시각화되지 않으므로, 이 시각화 힌트를 설명 파라미터와 함께 사용하지 마세요.

• --explain-type   –   사용할 설명 모드(dynamic, static, details 중 하나)를 지정하는 데 활용됩니다.

• --explain-format   –   설명 쿼리의 응답 형식(text/csv, text/html 중 하나)을 지정하는 데 사용됩니다.

• --store-to   –   쿼리 결과를 저장할 변수를 지정하는 데 사용됩니다.

%%gremlin profile 쿼리용 옵션 파라미터

• --profile-chop   –   프로필 결과 문자열의 최대 길이를 지정합니다. 이 인수를 제공하지 않는 경우 기본값은 250입니다.

• --profile-serializer   –   결과에 사용할 직렬 변환기를 지정합니다. 허용되는 값은 유효한 MIME 유형 또는 TinkerPop 드라이버 “Serializers” 열거형 값입니다. 이 인수를 제공하지 않는 경우 기본값은 application.json입니다.

• --profile-no-results   –   결과 수만 표시합니다. 사용하지 않을 경우 기본적으로 모든 쿼리 결과가 프로파일 보고서에 표시됩니다.

• --profile-indexOps   –   모든 인덱스 작업에 대한 자세한 보고서를 표시합니다.

• mode   –   쿼리 모드로, query 또는 bolt입니다. 이 인수를 제공하지 않는 경우 기본값은 query입니다.

• --group-by 또는 -g   –   노드를 그룹화하는 데 사용되는 속성을 지정합니다. 예: code, ~id. 이 인수를 제공하지 않는 경우 기본값은 ~labels입니다.

• --ignore-groups   –   있는 경우 모든 그룹화 옵션이 무시됩니다.

• --display-propery 또는 -d   –   각 버텍스에 대해 값을 표시해야 하는 속성을 지정합니다. 이 인수를 제공하지 않는 경우 기본값은 ~labels입니다.

• --edge-display-propery 또는 -de   –   각 엣지에 대해 값을 표시해야 하는 속성을 지정합니다. 이 인수를 제공하지 않는 경우 기본값은 ~labels입니다.

• --label-max-length 또는 -l   –   표시할 버텍스 레이블의 최대 문자 수를 지정합니다. 이 인수를 제공하지 않는 경우 기본값은 10입니다.

• --store-to 또는 -s   –   쿼리 결과를 저장할 변수 이름을 지정합니다.

• --plan-cache 또는 -pc   –   사용할 계획 캐시 모드를 지정합니다. 기본값은 auto입니다.

• --query-timeout 또는 -qt   –   최대 쿼리 제한 시간을 밀리초 단위로 지정합니다. 기본값은 1800000입니다.

• --query-parameters or qp   –  쿼리에 적용할 파라미터 정의입니다. 이 옵션은 단일 변수 이름을 사용하거나 맵의 문자열 표현을 사용할 수 있습니다.

  --query-parameters의 사용 예

  1. 하나의 노트북 셀에서 openCypher 파라미터 맵을 정의합니다.

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

  2. %%oc를 사용하여 파라미터를 다른 셀의 --query-parameters로 전달합니다.

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

• --explain-type – 사용할 설명 모드를 지정하는 데 사용됩니다(동적, 정적 또는 세부 정보 중 하나).

• %neptune_ml export start   –   새 내보내기 작업을 시작합니다.

  파라미터

  • --export-url exporter-endpoint   – (선택 사항 ) 내보내기를 호출할 수 있는 Amazon API Gateway 엔드포인트입니다.

  • --export-iam   –   (선택 사항) 내보내기 URL에 대한 요청에 SigV4를 사용하여 서명해야 함을 나타내는 플래그입니다.

  • --export-no-ssl – (선택 사항) 를 내보내기에 연결할 때 를 사용해서는 SSL 안 된다는 플래그입니다.

  • --wait   –   (선택 사항) 내보내기가 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 내보내기 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 내보내기 작업이 완료될 때까지 기다렸다가 최신 상태(기본값: 3,600)를 반환하는 시간을 초 단위로 설정합니다.

  • --store-to location-to-store-result   – (선택 사항 ) 내보내기 결과를 저장할 변수입니다. --wait를 지정하면 최종 상태가 해당 위치에 저장됩니다.

• %neptune_ml export status   –   내보내기 작업의 상태를 검색합니다.

  파라미터

  • --job-id export job ID   - 상태를 검색할 내보내기 작업의 ID입니다.

  • --export-url exporter-endpoint   – (선택 사항 ) 내보내기를 호출할 수 있는 Amazon API Gateway 엔드포인트입니다.

  • --export-iam   –   (선택 사항) 내보내기 URL에 대한 요청에 SigV4를 사용하여 서명해야 함을 나타내는 플래그입니다.

  • --export-no-ssl – (선택 사항) 를 내보내기에 연결할 때 를 사용해서는 SSL 안 됨을 나타내는 플래그입니다.

  • --wait   –   (선택 사항) 내보내기가 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 내보내기 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 내보내기 작업이 완료될 때까지 기다렸다가 최신 상태(기본값: 3,600)를 반환하는 시간을 초 단위로 설정합니다.

  • --store-to location-to-store-result   – (선택 사항 ) 내보내기 결과를 저장할 변수입니다. --wait를 지정하면 최종 상태가 해당 위치에 저장됩니다.

• %neptune_ml dataprocessing start   –   Neptune ML 데이터 처리 단계를 시작합니다.

  파라미터

  • --job-id ID for this job   – (선택 사항) 이 작업에 할당할 ID입니다.

  • --s3-input-uri S3 URI   – (선택 사항 ) 이 데이터 처리 작업에 대한 입력을 URI 찾을 S3입니다.

  • --config-file-name file name   – (선택 사항) 이 데이터 처리 작업에 대한 구성 파일의 이름입니다.

  • --store-to location-to-store-result   – (선택 사항 ) 데이터 처리 결과를 저장할 변수입니다.

  • --instance-type (instance type)   – (선택 사항 ) 이 데이터 처리 작업에 사용할 인스턴스 크기입니다.

  • --wait   –   (선택 사항) 데이터 처리가 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 데이터 처리 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 데이터 처리 작업이 완료될 때까지 기다렸다가 최신 상태(기본값: 3,600)를 반환하는 시간을 초 단위로 설정합니다.

• %neptune_ml dataprocessing status   –   데이터 처리 작업의 상태를 검색합니다.

  파라미터

  • --job-id ID of the job   - 상태를 검색할 작업의 ID입니다.

  • --store-to instance type   – (선택 사항 ) 모델 훈련 결과를 저장할 변수입니다.

  • --wait   –   (선택 사항) 모델 훈련이 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 모델 훈련 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 데이터 처리 작업이 완료될 때까지 기다렸다가 최신 상태(기본값: 3,600)를 반환하는 시간을 초 단위로 설정합니다.

• %neptune_ml training start   –   Neptune ML 모델 훈련 프로세스를 시작합니다.

  파라미터

  • --job-id ID for this job   – (선택 사항) 이 작업에 할당할 ID입니다.

  • --data-processing-id dataprocessing job ID   – (선택 사항) 훈련에 사용할 아티팩트를 생성한 데이터 처리 작업의 ID입니다.

  • --s3-output-uri S3 URI   – (선택 사항 ) 이 모델 훈련 작업의 출력을 URI 저장할 S3입니다.

  • --instance-type (instance type)   – (선택 사항 ) 이 모델 훈련 작업에 사용할 인스턴스 크기입니다.

  • --store-to location-to-store-result   – (선택 사항 ) 모델 훈련 결과를 저장할 변수입니다.

  • --wait   –   (선택 사항) 모델 훈련이 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 모델 훈련 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 최신 상태(기본값: 3,600)를 반환하기 전에 모델 훈련 작업이 완료될 때까지 기다리는 시간을 초 단위로 설정합니다.

• %neptune_ml training status   –   Neptune ML 모델 훈련 작업의 상태를 검색합니다.

  파라미터

  • --job-id ID of the job   - 상태를 검색할 작업의 ID입니다.

  • --store-to instance type   – (선택 사항 ) 상태 결과를 저장할 변수입니다.

  • --wait   –   (선택 사항) 모델 훈련이 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 모델 훈련 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 데이터 처리 작업이 완료될 때까지 기다렸다가 최신 상태를 반환하는 시간을 초 단위로 설정합니다(기본값: 3,600).

• %neptune_ml endpoint create   –   Neptune ML 모델의 쿼리 엔드포인트를 생성합니다.

  파라미터

  • --job-id ID for this job   – (선택 사항) 이 작업에 할당할 ID입니다.

  • --model-job-id model-training job ID   – (선택 사항) 쿼리 엔드포인트를 생성할 모델 훈련 작업의 ID입니다.

  • --instance-type (instance type)   – (선택 사항 ) 쿼리 엔드포인트에 사용할 인스턴스 크기입니다.

  • --store-to location-to-store-result   – (선택 사항 ) 엔드포인트 생성 결과를 저장할 변수입니다.

  • --wait   –   (선택 사항) 엔드포인트 생성이 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 엔드포인트 생성 작업이 완료될 때까지 기다렸다가 최신 상태를 반환하는 시간을 초 단위로 설정합니다(기본값: 3,600).

• %neptune_ml endpoint status   –   Neptune ML 쿼리 엔드포인트의 상태를 검색합니다.

  파라미터

  • --job-id endpoint creation ID   – (선택 사항) 상태를 보고할 엔드포인트 생성 작업의 ID입니다.

  • --store-to location-to-store-result   – (선택 사항 ) 상태 결과를 저장할 변수입니다.

  • --wait   –   (선택 사항) 엔드포인트 생성이 완료될 때까지 작업이 대기해야 함을 나타내는 플래그입니다.

  • --wait-interval interval-to-wait   – (선택 사항 ) 상태 확인 사이의 시간을 초 단위로 설정합니다(기본값: 60).

  • --wait-timeout timeout-seconds   – (선택 사항 ) 엔드포인트 생성 작업이 완료될 때까지 기다렸다가 최신 상태(기본값: 3,600)를 반환하는 시간을 초 단위로 설정합니다.

• %%neptune_ml export start   –   Neptune ML 내보내기 프로세스를 시작합니다.

• %%neptune_ml dataprocessing start   –   Neptune ML 데이터 처리 작업을 시작합니다.

• %%neptune_ml training start   –   Neptune ML 모델 훈련 작업을 시작합니다.

• %%neptune_ml endpoint create   –   모델의 Neptune ML 쿼리 엔드포인트를 생성합니다.