oci_tips/23AI/readme.md

Instalação de Modelo ONNX no Oracle Autonomous Database 23AI

Este script PL/SQL realiza a instalação de um modelo ONNX de embeddings no Oracle Autonomous Database 23AI, utilizando os recursos nativos da OCI e do pacote DBMS_VECTOR.

🧩 Objetivo

Carregar o modelo all-MiniLM-L12-v2.onnx a partir de um bucket no Oracle Object Storage e registrá-lo no banco para uso com DBMS_VECTOR.EMBED_TEXT.

---

📁 Pré-Requisitos

• Bucket no Oracle Object Storage com o modelo .onnx disponível publicamente ou configurado com uma credential_name.
• Privilégios para usar os pacotes:
  • DBMS_CLOUD
  • DBMS_VECTOR
  • DBMS_DATA_MINING (para drop do modelo)
• Permissão de escrita no diretório DATA_PUMP_DIR.

---

📜 Script PL/SQL

DECLARE 
    ONNX_MOD_FILE VARCHAR2(100) := 'all_MiniLM_L12_v2.onnx';
    MODNAME VARCHAR2(500);
    LOCATION_URI VARCHAR2(300) := 'https://path/to/the/folder/where/the/model/file/is/available/';

BEGIN
    DBMS_OUTPUT.PUT_LINE('ONNX model file name in Object Storage is: '||ONNX_MOD_FILE); 

    -- Define o nome do modelo com base no nome do arquivo
    SELECT UPPER(REGEXP_SUBSTR(ONNX_MOD_FILE, '[^.]+')) INTO MODNAME FROM dual;
    DBMS_OUTPUT.PUT_LINE('Model will be loaded and saved with name: '||MODNAME);

    -- Drop do modelo anterior, se existir
    BEGIN DBMS_DATA_MINING.DROP_MODEL(model_name => MODNAME);
    EXCEPTION WHEN OTHERS THEN NULL; END;

    -- Download do modelo do Object Storage para o banco
    DBMS_CLOUD.GET_OBJECT(                            
        credential_name => NULL,
        directory_name => 'DATA_PUMP_DIR',
        object_uri => LOCATION_URI || ONNX_MOD_FILE);

    -- Registro do modelo no banco
    DBMS_VECTOR.LOAD_ONNX_MODEL(
        directory => 'DATA_PUMP_DIR',
        file_name => ONNX_MOD_FILE,
        model_name => MODNAME);

    DBMS_OUTPUT.PUT_LINE('New model successfully loaded with name: '||MODNAME);
END;

---

✅ Pós-Instalação

Validar se o modelo foi carregado:

SELECT model_name, model_type, created_on 
FROM all_models 
WHERE model_name = 'ALL_MINILM_L12_V2';

Gerar Embedding de um texto:

SELECT DBMS_VECTOR.EMBED_TEXT(
         'ALL_MINILM_L12_V2', 
         'Exemplo de texto para embedding'
       ) AS emb 
FROM dual;

---

📌 Observações

• O nome do modelo será sempre o nome do arquivo em maiúsculas, sem a extensão.
• A função EMBED_TEXT exige que o modelo seja do tipo embedding ONNX com entrada de string.
• Sessões que usam DBMS_VECTOR devem garantir que o modelo foi carregado previamente no ambiente.

---