Parametri utilizzati per controllare il processo di esportazione di Neptune

Sia che si utilizzi il servizio Neptune-Export o l'utilità da riga di comando neptune-export, i parametri per controllare l'esportazione sono per lo più gli stessi. Contengono un oggetto JSON passato all'endpoint Neptune-Export o a neptune-export nella riga di comando.

L'oggetto passato al processo di esportazione contiene fino a cinque campi di primo livello:

-d '{
      "command" : "(either export-pg or export-rdf)",
      "outputS3Path" : "s3:/(your Amazon S3 bucket)/(path to the folder for exported data)",
      "jobsize" : "(for Neptune-Export service only)",
      "params" : { (a JSON object that contains export-process parameters) },
      "additionalParams": { (a JSON object that contains parameters for training configuration) }
    }'

Indice

• Parametro command
• Parametro outputS3Path
• Parametro jobSize
• Oggetto params
• Oggetto additionalParams
• Campi dei parametri di esportazione nell'oggetto JSON params di primo livello
  • Elenco dei campi possibili nell'oggetto params dei parametri di esportazione
    • Elenco dei campi comuni a tutti i tipi di esportazioni
    • Elenco dei campi per le esportazioni dei grafi di proprietà
    • Elenco dei campi per le esportazioni RDF
  • Campi comuni a tutti i tipi di esportazioni
    • Campo cloneCluster in params
    • Campo cloneClusterInstanceType in params
    • Campo cloneClusterReplicaCount in params
    • Campo clusterId in params
    • Campo endpoint in params
    • Campo endpoints in params
    • Campo profile in params
    • Campo useIamAuth in params
    • Campo includeLastEventId in params
  • Campi per l'esportazione dei grafi di proprietà
    • Campo concurrency in params
    • Campo edgeLabels in params
    • Campo filter in params
    • Campo filterConfigFile in params
    • Campo format usato per i dati del grafo delle proprietà in params
    • Campo gremlinFilter in params
    • Campo gremlinNodeFilter in params
    • Campo gremlinEdgeFilter in params
    • Campo nodeLabels in params
    • Campo scope in params
  • Campi per l'esportazione dei dati RDF
    • Campo format utilizzato per i dati RDF in params
    • Campo rdfExportScope in params
    • Campo sparql in params
    • Campo namedGraph in params
• Esempi di filtro dei dati esportati
  • Filtro dell'esportazione dei dati del grafo delle proprietà
    • Esempio di utilizzo di scope per esportare solo gli archi
    • Esempio di utilizzo di nodeLabels e edgeLabels per esportare solo nodi e archi con etichette specifiche
    • Esempio di utilizzo di filter per esportare solo i nodi, gli archi e le proprietà specificati
    • Esempio che utilizza gremlinFilter.
    • Esempio che utilizza gremlinNodeFilter.
    • Esempio che utilizza gremlinEdgeFilter .
    • Combinazione di filter, gremlinNodeFilter, nodeLabels, edgeLabels e scope
  • Filtro dell'esportazione dei dati RDF
    • Utilizzo di rdfExportScope e sparql per esportare archi specifici
    • Usato namedGraph per esportare un singolo grafico con nome

Parametro command

Il parametro command di primo livello determina se esportare i dati del grafo delle proprietà o i dati RDF. Se si omette il parametro command, per impostazione predefinita il processo di esportazione prevede l'esportazione dei dati del grafo delle proprietà.

• export-pg: esporta i dati del grafo delle proprietà.

• export-rdf: esporta i dati RDF.

Parametro outputS3Path

Il parametro outputS3Path di primo livello è obbligatorio e deve contenere l'URI di una posizione Amazon S3 in cui è possibile pubblicare i file esportati:

  "outputS3Path" : "s3://(your Amazon S3 bucket)/(path to output folder)"

Il valore deve iniziare con s3://, seguito da un nome di bucket valido e, facoltativamente, da un percorso di cartella all'interno del bucket.

Parametro jobSize

Il parametro jobSize di primo livello viene utilizzato solo con il servizio Neptune-Export, non con l'utilità da riga di comando neptune-export, ed è facoltativo. Consente di caratterizzare le dimensioni del processo di esportazione che si sta avviando, per determinare la quantità di risorse di calcolo dedicate al job e il livello massimo di concorrenza.

  "jobsize" : "(one of four size descriptors)"

I quattro descrittori di dimensione validi sono:

• small: concorrenza massima: 8. Adatto per volumi di archiviazione fino a 10 GB.

• medium: concorrenza massima: 32. Adatto per volumi di archiviazione fino a 100 GB.

• large: concorrenza massima: 64. Adatto per volumi di archiviazione superiori a 100 GB ma inferiori a 1 TB.

• xlarge: concorrenza massima: 96. Adatto per volumi di archiviazione superiori a 1 TB.

Per impostazione predefinita, un'esportazione avviata nel servizio Neptune-Export viene eseguita come processo small.

Le prestazioni di un'esportazione dipendono non solo dall'impostazione jobSize, ma anche dal numero di istanze database da cui si esegue l'esportazione, dalle dimensioni di ogni istanza e dal livello di concorrenza effettivo del processo.

Per le esportazioni del grafo delle proprietà, è possibile configurare il numero di istanze database utilizzando il parametro cloneClusterReplicaConta e configurare il livello di concorrenza effettivo del processo con il parametro simultaneità.

Oggetto params

Il parametro params di primo livello è un oggetto JSON che contiene i parametri utilizzati per controllare il processo di esportazione stesso, come illustrato in Campi dei parametri di esportazione nell'oggetto JSON params di primo livello. Alcuni campi nell'oggetto params sono specifici per le esportazioni dei grafi di proprietà, altri per i dati RDF.

Oggetto additionalParams

Il parametro additionalParams di primo livello è un oggetto JSON che contiene i parametri che è possibile utilizzare per controllare le azioni applicate ai dati dopo l'esportazione. Al momento, additionalParams viene utilizzato solo per esportare i dati di training per Neptune ML.