86 lines
2.7 KiB
Markdown
86 lines
2.7 KiB
Markdown
# 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
|
|
|
|
```plsql
|
|
DECLARE
|
|
ONNX_MOD_FILE VARCHAR2(100) := 'all_MiniLM_L12_v2.onnx';
|
|
MODNAME VARCHAR2(500);
|
|
LOCATION_URI VARCHAR2(300) := 'https://objectstorage.us-chicago-1.oraclecloud.com/p/YspaXeded3c3ShsteS31GeX_cNCcgUjDHzWt9lqevD9D7FlBRgC1a9vmzFE41X9X/n/idajmumkp9ca/b/lohmann-ai-br/o/LLM/';
|
|
|
|
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:
|
|
```sql
|
|
SELECT model_name, model_type, created_on
|
|
FROM all_models
|
|
WHERE model_name = 'ALL_MINILM_L12_V2';
|
|
```
|
|
|
|
### Gerar Embedding de um texto:
|
|
```sql
|
|
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.
|
|
|
|
---
|