Utilizzo di Couchbase con IBM App Connect Enterprise

Couchbase è un database cloud NoSQL distribuito per applicazioni interattive. Offre prestazioni affidabili, facilità di scalabilità e un modello di dati flessibile.

I passaggi seguenti mostrano come connettersi a un account Couchbase e configurare un nodo Couchbase Request utilizzando il connector discovery.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso che contenga un nodo "Richiesta Couchbase ".
2. Selezionare il nodo Couchbase Request nel flusso per visualizzare le proprietà del nodo nell'editor.
3. Nella scheda Basic, fare clic su Launch Connector Discovery.
   Viene visualizzato un pannello in cui si specifica il nome del progetto di policy e i dettagli del vault da utilizzare durante la ricerca del connettore.
4. Specificare i dettagli del progetto di policy e del vault da utilizzare durante il rilevamento dei connettori:
   1. Nel campo Progetto di criteri, specificare il progetto di criteri utilizzato per memorizzare i criteri creati durante la ricerca dei connettori.
      In alternativa, è possibile creare un nuovo progetto di criteri facendo clic su Nuovo e specificando il nome del nuovo progetto di criteri. Quindi, fare clic su Fine.
   2. Specificare il vault da usare durante la scoperta del connettore. Per impostazione predefinita, le credenziali utilizzate durante il rilevamento dei connettori sono memorizzate in un vault di directory esterno, che è un vault di App Connect Enterprise che può essere utilizzato da qualsiasi server di integrazione. In alternativa, è possibile memorizzare le credenziali in un vault del server di integrazione, creato nella directory di lavoro del server di integrazione e utilizzabile solo da quello specifico server di integrazione.
      Per specificare il vault da utilizzare per la memorizzazione delle credenziali, completare i passaggi della sezione Utilizzo della procedura guidata di rilevamento del connettore di uno dei seguenti argomenti:

      • Configurazione di un vault di directory esterno
      • Configurazione di un vault del server di integrazione
   3. campo Chiave del vault, inserire la chiave del vault utilizzata per accedere alle credenziali memorizzate nel vault. La chiave del caveau deve essere lunga almeno 8 caratteri.
   4. Opzionale: 'Per impostazione predefinita, la posizione e la chiave del vault specificate vengono salvate come preferenze nel Toolkit, in modo che i valori siano preimpostati all'avvio di Connector Discovery. Se non si desidera salvare le preferenze, deselezionare Salva nelle preferenze del vault.
5. Fare clic su Launch Discovery per avviare la procedura guidata Connector Discovery per il connettore Couchbase.
   Viene visualizzata la finestra Scoperta connettore. Se sono disponibili connessioni (account) Couchbase esistenti, viene visualizzato un elenco di tali connessioni. Se non ci sono connessioni esistenti, lo stato del connettore Couchbase viene mostrato come " Not connected.
   • Se sono disponibili una o più connessioni (account) a Couchbase, completare i passaggi seguenti:
     1. Selezionare la connessione (account) che si desidera utilizzare facendo clic su di essa.
     2. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire sull'oggetto. Ad esempio, per recuperare i bucket da Couchbase, fare clic su Bucket e quindi su Recupera bucket.
   • Se non ci sono connessioni (account) esistenti, completare i passaggi seguenti:
     1. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire sull'oggetto. Ad esempio, per recuperare i bucket da Couchbase, fare clic su Bucket e quindi su Recupera bucket.
     2. Fare clic su Connetti.
        Viene visualizzata una finestra in cui si inseriscono i dettagli di connessione dell'account Couchbase. Inserire le seguenti informazioni nella procedura guidata del connettore:

        • Endpoint URL : La connessione URL utilizzata per connettersi al cluster del Couchbase Cluster del server nel formato <couchbase or couchbases>://<hostname or IP address>. Per connessioni sicure TLS, usa il couchbases:// prefisso.
        • Nome utente: il nome utente dell'account Couchbase.
        • Password: la password del nome utente specificato.
     3. Fare clic su Connetti.

     Per ulteriori informazioni su come identificare questi dettagli di connessione, consultare la sezione "Come utilizzare IBM App Connect con Couchbase " nella documentazione sulla Continuous Delivery (CD) disponibile all'indirizzo IBM App Connect in containers.

6. Impostare le proprietà del connettore richieste nella procedura guidata.

   Se si aggiungono condizioni per le azioni di recupero o di aggiornamento, è possibile utilizzare un filtro di condizione per affinare le condizioni applicate. Per usare il filtraggio delle condizioni, uscire dalla procedura guidata Connector Discovery facendo clic sul pulsante Chiudi (X) e quindi completare le istruzioni in Uso del filtraggio delle condizioni.

   È inoltre possibile impostare proprietà che specificano il numero massimo di record da recuperare e l'azione da intraprendere se tale limite viene superato.
7. Una volta terminato di specificare le proprietà nella procedura guidata Connector Discovery, fare clic su Salva.
   La credenziale utilizzata per connettersi al 'Couchbase è memorizzata nel vault, mentre gli altri dettagli della connessione sono salvati nel ' politica Couchbase . I valori delle proprietà impostati nella procedura guidata vengono restituiti al nodo " Couchbase Request" nel Toolkit " IBM App Connect Enterprise ".
8. Una volta terminata la scoperta e salvati i valori delle proprietà, uscire dalla procedura guidata di individuazione dei connettori facendo clic sulla X nell'angolo superiore destro della finestra o premendo Alt+F4.
9. Torna alla modifica del nodo "Richiesta di Couchbase " nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore impostate nella procedura guidata Connector Discovery (al punto 6) sono ora visibili sul nodo Couchbase Request nell'editor delle proprietà. La scheda Base mostra i valori delle proprietà Azione e Oggetto impostate nella procedura guidata. Ad esempio, se si è selezionato Secchi > Recupera secchi nella procedura guidata, le seguenti proprietà sono visibili nella scheda Base del nodo:

   • Azione - 'RETRIEVEALL
   • Oggetto - 'Bucket

   I valori delle proprietà Azione e Oggetto sono visualizzati in sola lettura. Se si desidera modificare questi valori, è possibile farlo facendo nuovamente clic su Avvia Connector Discovery e impostando i nuovi valori nella procedura guidata di Connector Discovery.

   La proprietà Schema base name specifica il nome base dei file di schema che descrivono il formato dei messaggi di richiesta e risposta inviati e ricevuti dal connettore Couchbase. Il nome di base dello schema viene impostato automaticamente la prima volta che si esegue il discovery per il nodo e si basa sul nome del flusso e del nodo corrente. Se si imposta manualmente questa proprietà prima di eseguire il discovery per la prima volta, viene utilizzato il valore impostato. Se si rinominano gli schemi dopo la scoperta, è necessario modificare questa proprietà in modo che corrisponda al nome di base dello schema utilizzato dagli schemi rinominati nel progetto. Se si modifica questa proprietà dopo l'individuazione, è necessario rinominare i nomi degli schemi in modo che corrispondano o eseguire nuovamente l'individuazione.

   A seconda dell'azione selezionata durante l'individuazione, la procedura guidata di individuazione del connettore genera uno schema di richiesta e uno schema di risposta, oppure solo uno schema di risposta. Uno schema di richiesta viene generato solo se l'azione e l'oggetto selezionati richiedono un messaggio di richiesta. Lo schema di richiesta generato viene utilizzato per la validazione del messaggio di richiesta. Se l'azione era " RETRIEVE o " DELETE, il connettore restituisce solo lo schema di risposta.

   I file di schema generati vengono aggiunti al progetto e possono essere utilizzati da un nodo di mappatura per trasformare i dati di input o di output. Il nome completo dello schema deriva dal nome di base dello schema (ad esempio " gen/MyMessageFlow.Couchbase_Request), seguito da " response.schema.json o " request.schema.json. È possibile aprire lo schema facendo clic su Apri schema richiesta o Apri schema risposta.

10. Verificare che le impostazioni delle proprietà sul nodo Couchbase Request siano corrette e salvare il flusso di messaggi.
11. Nella scheda " Connessione del nodo " Couchbase Richiesta, la proprietà " Politica mostra il nome del criterio che contiene i dettagli dell'identità di sicurezza da utilizzare per la connessione. La polizza ha un tipo di 'Couchbase.
    Per ulteriori informazioni, vedere Criteri diCouchbase.
12. Opzionale: Impostare la proprietà Timeout nella scheda Connection per specificare il tempo (in secondi) in cui il nodo attende che Couchbase elabori l'operazione.
13. La scheda Filter del nodo Couchbase Request contiene proprietà che controllano come il flusso di messaggi seleziona i dati. I valori iniziali di queste proprietà sono presi dai valori delle proprietà impostate per il connettore Couchbase nella procedura guidata di individuazione del connettore, comprese le proprietà delle opzioni di filtro e le eventuali condizioni specificate (come descritto nel passaggio 6). Quindi, se si torna alla procedura guidata di rilevamento del connettore e si modificano i valori delle proprietà (aggiungendo nuove condizioni, ad esempio), gli aggiornamenti si riflettono nelle proprietà impostate sul nodo.

    Le proprietà Filter Options controllano quali oggetti devono essere utilizzati durante l'esecuzione del nodo Couchbase Request. Le proprietà Limite filtro controllano il numero massimo di elementi da recuperare e l'azione da intraprendere se il limite viene superato.

    È possibile modificare i valori facendo clic su Modifica accanto al valore da modificare nella sezione Opzioni filtro e cambiando i valori delle proprietà impostate nella sezione Limite filtro.

    I valori delle proprietà possono essere valori di testo o espressioni ESQL o XPATH risolte dal contenuto del messaggio passato al nodo Couchbase Request durante la sua esecuzione.

14. Nella scheda Request, impostare la proprietà Data location per specificare la posizione nell'albero del messaggio in arrivo che contiene i dati dell'oggetto da creare in Couchbase. Questi dati costituiscono la richiesta inviata dal nodo Couchbase Request al sistema Couchbase.
15. Nella scheda Risultato, impostare la proprietà Posizione dei dati di output per specificare la posizione nell'albero dei messaggi di output per contenere i dati del record creato in Couchbase.
16. Per impostazione predefinita, i messaggi di richiesta sono convalidati rispetto allo schema di richiesta generato durante la scoperta del connettore. È possibile disattivare la validazione della richiesta o modificare le impostazioni di validazione utilizzando le proprietà Validation del nodo Couchbase Request.
17. Salvare il flusso di messaggi.