View a markdown version of this page

neptune.read () - Amazon Neptune
Le migliori pratiche per neptune.read ()

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

neptune.read ()

Neptune supporta una CALL procedura neptune.read per leggere i dati da Amazon S3 e quindi eseguire una query OpenCypher (lettura, inserimento, aggiornamento) utilizzando i dati. La procedura restituisce ogni riga del file come riga della variabile di risultato dichiarata. Utilizza le credenziali IAM del chiamante per accedere ai dati in Amazon S3. Consulta Gestione delle autorizzazioni per neptune.read () per configurare le autorizzazioni. La AWS regione del bucket Amazon S3 deve trovarsi nella stessa regione in cui si trova l'istanza. Attualmente, le letture interregionali non sono supportate.

Sintassi 

CALL neptune.read(
  {
    source: "string",
    format: "parquet/csv",
    concurrency: 10
  }
)
YIELD row
...
Input

  • source (obbligatorio): URI Amazon S3 per un singolo oggetto. Il prefisso Amazon S3 per più oggetti non è supportato.

  • formato (obbligatorio) - parquet e csv sono supportati.

  • concurrency (opzionale) - Tipo: numero intero uguale o superiore a 0. Impostazione predefinita: 0. Specifica il numero di thread da utilizzare per leggere il file. Se il valore è 0, verrà utilizzato il numero massimo di thread consentiti dalla risorsa. Per Parquet, si consiglia di impostare un numero di gruppi di righe.

Output

Il neptune.read restituisce:

  • riga - Tipo:map

    • Ogni riga del file, dove le chiavi sono le colonne e i valori sono i dati trovati in ogni colonna.

    • Puoi accedere ai dati di ogni colonna come una proprietà access (row.col).

Le migliori pratiche per neptune.read ()

Le operazioni di lettura di Neptune S3 possono richiedere molta memoria. Utilizza tipi di istanza adatti ai carichi di lavoro di produzione, come indicato in Scelta dei tipi di istanza per Amazon Neptune. Scelta dei tipi di istanza per Amazon Neptune

L'utilizzo della memoria e le prestazioni delle neptune.read() richieste sono influenzati da una serie di fattori come la dimensione del file, il numero di colonne, il numero di righe e il formato del file. A seconda della struttura, i file di piccole dimensioni (ad esempio, file CSV pari o inferiori a 100 MB, file Parquet da 20 MB o meno) possono funzionare in modo affidabile sulla maggior parte dei tipi di istanze adatti alla produzione, mentre i file più grandi possono richiedere una memoria notevole che i tipi di istanze più piccoli non possono fornire.

Durante il test di questa funzionalità, si consiglia di iniziare con file di piccole dimensioni e scalare gradualmente per garantire che il carico di lavoro di lettura possa essere adattato alle dimensioni dell'istanza. Se notate neptune.read() richieste che comportano eccezioni di memoria insufficiente o riavvii dell'istanza, valutate la possibilità di suddividere i file in blocchi più piccoli, di ridurne la complessità o di passare a tipi di istanza più grandi.