Pré-requisitos:

A ferramenta de Análise de Dados utiliza o pacote PL/SQL do Vector Utility DBMS_VECTOR e DBMS_VECTOR_CHAIN.UTL_TO_EMBEDDING para fornecer as APIs REST de terceiros que permitem interagir com modelos de incorporação externos, como Cohere, Google AI, Hugging Face, Oracle Cloud Infrastructure (OCI) Generative AI, OpenAI ou Vertex AI. Você deve entender os termos do uso de modelos de incorporação de terceiros.

Suponha que você seja um entusiasta de finanças e queira aprender sobre finanças por meio de notícias para obter um melhor senso de produtos e investimentos financeiros. Neste exemplo, você pode usar o recurso Pesquisa de Vetor para encontrar notícias relacionadas à palavra Bank.

Considere uma tabela que tenha as colunas CATEGORY, FILENAME, TITLE, CONTENT e outra coluna rotulada como VECTOR, que contenha a representação vetorial da coluna CONTENT. Como podemos usar a pesquisa vetorial em colunas de origem com dados não numéricos (imagem ou texto), qualquer coluna não numérica pode ser incorporada e armazenada como uma coluna vetorial. Mas neste exemplo, precisamos procurar texto relevante na coluna CONTENT.

Você pode usar a ferramenta Análise de Dados para executar a pesquisa de vetores.

Para indicar qual a incorporação da coluna é mantida na coluna do vetor, primeiro devemos mapear a coluna apropriada com o vetor apropriado usando a ferramenta Análise de Dados, procurar texto semelhante e, em seguida, executar a consulta. A guia Resultado da Consulta exibirá o conteúdo semelhante a Bank.

1. Na ferramenta Análise de Dados, clique em + em Análises para criar uma nova Análise.
2. Selecione o Esquema na lista drop-down Schema e a Consulta na lista drop-down Tipo.
3. Selecione a tabela que você deseja consultar no browser de tabelas. Neste exemplo, você selecionará BBCNEWS_DATA_ENCODE.
   
   
   
   Descrição da ilustração select-table.jpg
   
   

4. Informe a instrução Selecionar na área de edição Planilha SQL para recuperar todas as colunas da tabela BBCNEWS_DATA_ENCODE.

   Especifique o seguinte comando:

   Select * from BBCNEWS_DATA_ENCODE;

5. Clique em Executar.
   
   
   
   Descrição da ilustração run-data-analysis.jpg
   
   

   Você pode exibir todas as colunas da tabela BBCNEWS_DATA_ENCODE na guia Resultados da Consulta.

6. Selecione a exibição tabular do modo nos ícones que exibem vários modos de visualização do resultado da consulta.
   
   
   
   Descrição da ilustração tabular-view.jpg
   
   
7. Arraste e solte a coluna CONTENT na área de soltura Coluna e clique nela para mapear a coluna de vetor.
   
   
   
   Descrição da ilustração map-vector-column.jpg
   
   
8. No assistente Mapear Coluna do Vetor, especifique os seguintes valores de campo:
   • Vetor de Mapa: Selecione na lista drop-down a coluna que consiste nas incorporações de vetor da coluna selecionada. Neste exemplo, é VETOR.
   • Selecionar Serviço: Selecione o serviço AI que você usará para utilizar esse recurso da ferramenta. Neste exemplo, é a OCI Generative AI.
   • Selecionar Credencial: Informe a credencial criada nas Definições do Data Studio para acessar o provedor de serviços de terceiros. Você precisa dessas credenciais para ativar o acesso durante as chamadas da API REST ao provedor de serviços de terceiros escolhido.
   • URL de IA generativa: Especifique o URL de IA generativa que você usará para chamar o provedor de serviços de terceiros, como Cohere, Google AI, Hugging Face, Oracle Cloud Infrastructure (OCI) Generative AI, OpenAI ou Vertex AI.
   • Selecionar Modelo: Especifique o modelo incorporado que você usará para gerar incorporações com base no texto. Neste exemplo, você informará cohere.embed-english-light-v2.0.

   Clique em Salvar para salvar o mapeamento. Selecione Limpar para limpar os valores de campo mencionados nesta etapa.

9. Nos Filtros Facetados, você pode exibir a caixa de texto na coluna Conteúdo. Clique no sign-on + para expandir a caixa de texto.
   
   
   
   Descrição da ilustração text.jpg
   
   
10. Digite o seguinte texto na caixa de texto para conteúdo semelhante à palavra Bank na coluna CONTENT:

    BANK

    Clique em Pesquisar.

    
    
    
    Descrição da ilustração bank.jpg
    
    
11. A guia Resultados da Consulta do painel Saída exibe a coluna de conteúdo que consiste no conteúdo relacionado a Bank.
    
    
    
    Descrição da ilustração results.jpg
    
    

    Você pode passar o mouse sobre cada conteúdo para exibir seu formulário expandido.

    
    
    
    Descrição da ilustração expandida-content.jpg