Requisiti indispensabili

Lo strumento di analisi dei dati utilizza il pacchetto PL/SQL della utility Vector DBMS_VECTOR e DBMS_VECTOR_CHAIN.UTL_TO_EMBEDDING per fornire le API REST di terze parti che consentono di interagire con modelli di incorporamento esterni come Cohere, Google AI, Hugging Face, Oracle Cloud Infrastructure (OCI) Generative AI, OpenAI o Vertex AI. È necessario comprendere i termini dell'utilizzo di modelli di incorporamento di terze parti.

Supponiamo che tu sia un appassionato di finance e che tu voglia conoscere il finance attraverso le notizie per acquisire un migliore senso dei prodotti e degli investimenti finanziari. In questo esempio, è possibile utilizzare la funzione Ricerca vettoriale per trovare le notizie relative alla parola Bank.

Si consideri una tabella con le colonne CATEGORY, FILENAME, TITLE, CONTENT e un'altra colonna con etichetta VECTOR che contiene la rappresentazione vettoriale della colonna CONTENT. Poiché è possibile utilizzare la ricerca vettoriale su colonne di origine con dati non numerici (immagine o testo), qualsiasi colonna non numerica può essere incorporata e memorizzata come colonna vettoriale. In questo esempio, è tuttavia necessario cercare il testo pertinente dalla colonna CONTENT.

È possibile utilizzare lo strumento Analisi dati per eseguire la ricerca vettoriale.

Per indicare l'incorporamento della colonna nella colonna vettoriale, è necessario prima mappare la colonna appropriata con il vettore appropriato utilizzando lo strumento Analisi dati, cercare testo simile e quindi eseguire la query. Nella scheda Risultato query verrà visualizzato il contenuto simile a Bank.

1. Nello strumento Analisi dati, fare clic su + in Analisi per creare una nuova analisi.
2. Selezionare lo schema dall'elenco a discesa Schema ed eseguire una query dall'elenco a discesa Tipo.
3. Selezionare la tabella che si desidera interrogare dal browser delle tabelle. In questo esempio verrà selezionato BBCNEWS_DATA_ENCODE.
   
   
   
   Descrizione dell'immagine select-table.jpg
   
   

4. Immettere l'istruzione Select nell'area di modifica del foglio di lavoro SQL per recuperare tutte le colonne dalla tabella BBCNEWS_DATA_ENCODE.

   Specificare il comando seguente:

   Select * from BBCNEWS_DATA_ENCODE;

5. Fare clic su Esegui.
   
   
   
   Descrizione dell'immagine run-data-analysis.jpg
   
   

   È possibile visualizzare tutte le colonne della tabella BBCNEWS_DATA_ENCODE nella scheda Risultati query.

6. Selezionare la vista tabulare della modalità dalle icone che visualizzano varie modalità di visualizzazione del risultato della query.
   
   
   
   Descrizione dell'immagine tabular-view.jpg
   
   
7. Trascinare e rilasciare la colonna CONTENT nell'area di rilascio Colonna e fare clic su di essa per mappare la colonna vettoriale.
   
   
   
   Descrizione dell'immagine map-vector-column.jpg
   
   
8. Nella procedura guidata Mappa colonne vettoriali specificare i seguenti valori di campo:
   • Vettore mappa: selezionare dall'elenco a discesa la colonna costituita dalle incorporazioni vettoriali della colonna selezionata. In questo esempio si tratta di VECTOR.
   • Seleziona servizio: selezionare il servizio AI da utilizzare per utilizzare questa funzione dello strumento. In questo esempio si tratta dell'AI generativa OCI.
   • Seleziona credenziale: immettere la credenziale creata dalle impostazioni di Data Studio per accedere al provider di servizi di terze parti. Queste credenziali sono necessarie per abilitare l'accesso durante le chiamate API REST al provider di servizi di terze parti scelto.
   • URL AI generativa: specificare l'URL AI generativa che verrà utilizzato per chiamare il provider di servizi di terze parti, ad esempio Cohere, Google AI, Hugging Face, Oracle Cloud Infrastructure (OCI) Generative AI, OpenAI o Vertex AI.
   • Seleziona modello: specificare il modello di incorporamento da utilizzare per generare incorporamenti dal testo. In questo esempio verrà immesso cohere.embed-english-light-v2.0.

   Fare clic su Salva per salvare il mapping. Selezionare Cancella per cancellare i valori dei campi menzionati in questo passo.

9. Nei filtri con facet è possibile visualizzare la casella di testo sotto la colonna Contenuto. Fare clic sul segno + per espandere la casella di testo.
   
   
   
   Descrizione dell'immagine text.jpg
   
   
10. Immettere il testo seguente nella casella di testo per il contenuto simile alla parola Bank nella colonna CONTENT:

    BANK

    Fare clic su Cerca.

    
    
    
    Descrizione dell'immagine bank.jpg
    
    
11. Nella scheda Risultati query del pannello Output viene visualizzata la colonna di contenuto costituita dal contenuto correlato a Bank.
    
    
    
    Descrizione dell'immagine results.jpg
    
    

    È possibile passare il puntatore del mouse su ogni contenuto per visualizzare il relativo form espanso.

    
    
    
    Descrizione dell'immagine espansa-content.jpg