Neo4j

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione ExecuteCustomQuery

Questa azione ti consente di eseguire una query personalizzata.

Per creare una query personalizzata:

1. Segui le istruzioni dettagliate per aggiungere un'attività di connettori.
2. Quando configuri l'attività del connettore, seleziona Azioni nel tipo di azione che vuoi eseguire.
3. Nell'elenco Azione, seleziona Esegui query personalizzata, quindi fai clic su Fine.

   

4. Espandi la sezione Input attività e poi segui questi passaggi:
   1. Nel campo Timeout dopo, inserisci il numero di secondi di attesa prima dell'esecuzione della query.

      Valore predefinito: 180 secondi.

   2. Nel campo Numero massimo di righe, inserisci il numero massimo di righe da restituire dal database.

      Valore predefinito: 25.

   3. Per aggiornare la query personalizzata, fai clic su Modifica script personalizzato. Si apre la finestra di dialogo Editor di script.

      

   4. Nella finestra di dialogo Editor di script, inserisci la query SQL e fai clic su Salva.

      Puoi utilizzare un punto interrogativo (?) in un'istruzione SQL per rappresentare un singolo parametro che deve essere specificato nell'elenco parametri di ricerca. Ad esempio, la seguente query SQL seleziona tutte le righe della tabella Employees che corrispondono ai valori specificati per la colonna LastName:

      SELECT * FROM Employees where LastName=?

   5. Se hai utilizzato punti interrogativi nella query SQL, devi aggiungere il parametro facendo clic su + Aggiungi nome parametro per ogni punto interrogativo. Durante l'esecuzione dell'integrazione, questi parametri sostituiscono in sequenza i punti interrogativi (?) nella query SQL. Ad esempio, se hai aggiunto tre punti interrogativi (?), devi aggiungere tre parametri in ordine di sequenza.

      

      Per aggiungere parametri di ricerca:

      1. Nell'elenco Tipo, seleziona il tipo di dati del parametro.
      2. Nel campo Valore, inserisci il valore del parametro.
      3. Per aggiungere più parametri, fai clic su + Aggiungi parametro di query.

Se l'esecuzione va a buon fine, questa azione restituisce lo stato 200 (OK) con un corpo della risposta contenente i risultati della query.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: crea un nodo

Questo esempio mostra come creare un nuovo nodo.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection, and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   CREATE (:Movie {title: 'Hey', release_year: 2010})

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query restituisce un payload vuoto [ ].

Esempio: aggiorna un nodo

Questo esempio mostra come aggiornare un nodo.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   match(m:Movie{title: 'Inception'}) set m.release_year=2011 return m

Se l'azione ha esito positivo, il valore parametro di risposta connectorOutputPayload dell'attività Execute Custom Query è simile al seguente:

[{ "m": "{\"release_year\":2011,\"title\":\"Inception\"}" }]

Esempio: elimina un nodo

Questo esempio mostra come eliminare un nodo.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   match(m:Movie{title: 'hey'}) delete m

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query restituisce un payload vuoto [ ].

Esempio: creare una relazione

Questo esempio mostra come creare una relazione.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   CREATE(movie:Movie {title: 'bcon'}), (actor:Actor {name: 'leo'})
   CREATE(actor)-[:ACTED_IN]->(movie)

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query restituisce un payload vuoto [ ].

Esempio: aggiorna una relazione

Questo esempio mostra come aggiornare una relazione.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   match(movie:Movie {title: 'demo'}), (actor:Actor {name: 'first'})
   match(actor)-[r:ACTED_IN]->(movie) set actor.name='second',r.year=2024 return actor,r,movie

Se l'azione ha esito positivo, il valore parametro di risposta connectorOutputPayload dell'attività Execute Custom Query è simile al seguente:

[{   "actor": "{\"name\":\"second\"}",   "r": "{\"year\":2024}",   "movie": "{\"title\":\"demo\"}" }]

Esempio: elimina una relazione

Questo esempio mostra come eliminare una relazione.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   MATCH(movie:Movie {title: 'bcon44'}), (actor:Actor {name: 'jacky'})
   MATCH(actor)-[r:ACTED_IN]->(movie) delete r

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query restituisce un payload vuoto [ ].

Esempio: aggiornare l'etichetta di un nodo

Questo esempio mostra come aggiornare un'etichetta del nodo.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   MATCH (n:Person) where id(n)=18 set n:Actor RETURN n

Se l'azione ha esito positivo, il valore parametro di risposta connectorOutputPayload dell'attività Execute Custom Query è simile al seguente:

[{ "n": "{\"born\":1962,\"name\":\"Demi Moore\"}" }]

Esempio: aggiornamento del tipo di relazione

Questo esempio mostra come aggiornare un tipo di relazione.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   MATCH (n:Person) where id(n)=18 set n.born=1963 RETURN n

Se l'azione ha esito positivo, il valore parametro di risposta connectorOutputPayload dell'attività Execute Custom Query è simile al seguente:

[{ "n": "{\"born\":1963,\"name\":\"Demi Moore\"}" }]

Esempio: crea un tipo di dati

Questo esempio mostra come creare un tipo di dati.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   CREATE (:Product {unitPrice: 109.50,
   unitsInStock: 390,
   supplierID: "1",
   productID: "dumy-2",
   discontinued: false,
   quantityPerUnit: "10 boxes x 20 bags",
   productName: "productName-1",
   unitsOnOrder: 0,
   reorderLevel: 10,
   supplier: ["1"],
   expiry: Duration("P14DT18H12M"),
   categoryID: "1",
   updatedAt: DateTime("1984-11-11T12:31:14Z")})

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query restituisce un payload vuoto [ ].

Esempio: aggiornare un tipo di dati

Questo esempio mostra come aggiornare un tipo di dati.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   match(p:Product{productID: "dumy-1"}) set p.duration = Duration("P15DT19H12M"), p.updatedAt=DateTime("1984-11-12T12:31:14Z") return p

Se l'azione ha esito positivo, il valore parametro di risposta connectorOutputPayload dell'attività Execute Custom Query è simile al seguente:

[{ "p": "{\"unitPrice\":109.5,
\"unitsInStock\":390,
\"supplierID\":\"1\",
\"productID\":\"dumy-1\",
\"discontinued\":false,
\"quantityPerUnit\":\"10 boxes x 20 bags\",
\"productName\":\"productName-1\",
\"unitsOnOrder\":0,
\"duration\":\"P15DT19H12M\",
\"reorderLevel\":10,
\"supplier\":[\"1\"],
\"expiry\":\"P14DT18H12M\",
\"categoryID\":\"1\",
\"updatedAt\":\"1984-11-12T12:31:14Z\"}" }, 
{ "p":"{\"unitPrice\":109.5,
\"unitsInStock\":390,
\"supplierID\":\"1\",
\"productID\":\"dumy-1\",
\"discontinued\":false,
\"quantityPerUnit\":\"10 boxes x 20 bags\",
\"productName\":\"productName-1\",
\"unitsOnOrder\":0,
\"duration\":\"P15DT19H12M\",
\"reorderLevel\":10,
\"supplier\":[\"1\"],
\"expiry\":\"P14DT18H12M\",
\"categoryID\":\"1\",
\"updatedAt\":\"1984-11-12T12:31:14Z\"}" }]

Esempio: elimina un tipo di dati

Questo esempio mostra come eliminare un tipo di dati.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   match(p:Product{productID: "dumy-2"}) delete p

Questo esempio mostra come eliminare un tipo di dati. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query restituisce un payload vuoto [ ].

Esempio: ottenere il conteggio dei nodi

Questo esempio mostra come ottenere il conteggio dei nodi.

1. Nella finestra di dialogo Configure Connector, seleziona Region, Connection and Actions.
2. Seleziona Execute Custom Query dalle azioni, quindi fai clic su Fine.
3. Nella sezione Input attività di Connettore, fai clic su Edit Custom Script e poi inserisci un valore simile al seguente nel campo Custom Query:

   MATCH ()  
   RETURN count(*) AS numNodes

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività Execute Custom Query fornisce il payload, che è simile al seguente:

[{
  "numNodes": 6267.0
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elencare tutte le lingue

Questo esempio mostra come elencare tutte le lingue.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona multilanguage_table dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Data Mapper, fai clic su Apri editor di mappatura dei dati e imposta filterClause in base alle tue esigenze.

Esempio: recuperare una lingua

Questo esempio mostra come ottenere una lingua.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona multilanguage_table dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Imposta l'ID entità su Ottieni singola lingua. Per impostare l'ID entità, nella sezione Data Mapper, fai clic su Apri editor di mappatura dei dati, quindi inserisci 58.0 nel campo Valore di input e scegli entityId come variabile locale.