Usa ricerca JSON nei documenti nello storage degli oggetti

Utilizzare DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX per creare un indice di ricerca JSON nei file nello storage degli oggetti. È possibile configurare una frequenza di aggiornamento che indichi la frequenza in minuti alla quale l'indice viene aggiornato per eventuali nuovi caricamenti o eliminazioni. Per ulteriori informazioni, vedere Creare un indice di ricerca JSON nei documenti JSON nei file.

Quando si crea un indice di ricerca JSON, vengono creati gli oggetti seguenti:

• Indice di ricerca JSON index_name nei file JSON dello storage degli oggetti.

• Tabella locale INDEX_NAME$TXTIDX. Questa tabella è la tabella di mapping tra i documenti nei file nello storage degli oggetti e l'indice di ricerca JSON creato nel database. Per ulteriori informazioni, vedere Tabella di riferimento degli indici di ricerca JSON.

• Vista con il nome standard INDEX_NAME. È possibile utilizzare la vista per eseguire una ricerca utilizzando JSON_TEXTCONTAINS. Questa vista viene creata sopra la tabella INDEX_NAME$TXTIDX. Per ulteriori informazioni, vedere Vista riferimento indice di ricerca JSON.

• Tabella di log degli errori con il suffisso standard index_name$txtidx_err. Per ulteriori informazioni, vedere Tabella Log errori.

L'operazione di creazione dell'indice di ricerca JSON viene registrata nella vista ALL_SCHEDULER_JOB_RUN_DETAILS. Per ulteriori informazioni, vedere Controlla creazione indice di testo.

Autonomous Database supporta la creazione dell'indice di ricerca JSON per una vasta gamma di file di testo contenenti documenti JSON. Ad esempio, è possibile indicizzare i file JSON sia in formato compresso che non compresso oppure scegliere un delimitatore di documento JSON diverso. Per ulteriori informazioni sulle opzioni di gestione dei file, vedere DBMS_CLOUD Package.

Per ulteriori informazioni, vedere Indicizzazione con Oracle Text.

Utilizzare DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX per creare un indice di ricerca JSON nei file JSON memorizzati nello storage degli oggetti.

1. Creare un oggetto credenziale per accedere alla posizione di origine.

   Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.

2. Eseguire la procedura DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX per creare un indice di ricerca JSON nei file di storage degli oggetti.

   
   BEGIN 
    DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
           credential_name => 'OBJ_STORE_CRED',
           location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/vcnlogs/',
           index_name      => 'VNCLOGS',
           format          =>  JSON_OBJECT ('json_index' value 'true', 'json_index_doc_len' value 12000, 'file_compression' value 'gzip')
   );
   END;
   /

   In questo esempio viene creato quanto segue:

   • Indice di ricerca JSON VNCLOGS nei file di storage degli oggetti posizionati nell'URI specificato nel parametro location_uri.

   • Tabella locale VNCLOGS$TXTIDX. Per ulteriori informazioni, vedere Tabella di riferimento degli indici di ricerca JSON.

   • Vista denominata VNCLOGS. Questa vista viene creata sopra la tabella VNCLOGS$TXTIDX. È possibile utilizzare la vista per eseguire una ricerca utilizzando JSON_TEXTCONTAINS. Per ulteriori informazioni, vedere Vista riferimento indice di ricerca JSON.

   • Tabella di log degli errori con il nome VNC$TXTIDX_ERR. La tabella contiene una lista di documenti JSON non validi nei file. Per ulteriori informazioni, vedere Tabella Log errori.

   Dopo aver creato l'indice di ricerca JSON, è possibile eseguire una query sulla vista VNCLOGS. Ad esempio:

   SELECT JSON_QUERY (data, '$' returning CLOB pretty) AS RECORD 
    FROM vnclogs WHERE JSON_TEXTCONTAINS(file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}');
   

   Questa query restituisce i dettagli di log per gli indirizzi IP specificati nella condizione JSON_TEXTCONTAINS. Si noti che i criteri dell'indice di ricerca JSON sono specificati nella colonna file_line_json, la colonna indicizzata nella tabella di indice di ricerca JSON nel database, mentre i documenti JSON vengono trasmessi direttamente dallo storage degli oggetti, rappresentati tramite la colonna data. La colonna data contiene il contenuto del file di storage degli oggetti.

   Per ulteriori informazioni, vedere CREATE_EXTERNAL_TEXT_INDEX Procedure.

Utilizzare la procedura DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX per eliminare un indice di ricerca JSON nei file JSON memorizzati nello storage degli oggetti.

BEGIN 
 DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
  index_name => 'VCNLOGS',
);
END;
/

Quando si esegue DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX, l'operazione di creazione dell'indice di ricerca JSON viene registrata nella vista ALL_SCHEDULER_JOB_RUN_DETAILS.

È possibile eseguire una query sulla vista ALL_SCHEDULER_JOB_RUN_DETAILS per ottenere lo stato e qualsiasi errore segnalato dal job di creazione dell'indice.

Il nome del job DBMS_SCHEDULER deriva dal parametro INDEX_NAME specificato quando si chiama DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Per eseguire una query sulla vista ALL_SCHEDULER_JOB_RUN_DETAILS, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio READ nella vista ALL_SCHEDULER_JOB_RUN_DETAILS.

Ad esempio, l'istruzione SELECT seguente con una clausola WHERE in job_name mostra i dettagli di esecuzione per il job:

SELECT status, additional_info 
   FROM all_scheduler_job_run_details WHERE LOWER(job_name) = LOWER('index_name$JOB');

È inoltre possibile eseguire una query per verificare l'esistenza di un job scheduler di creazione indice.

SELECT status 
    FROM all_scheduler_jobs where LOWER(job_name) = LOWER('index_name$JOB');

Per ulteriori informazioni, vedere CREATE_EXTERNAL_TEXT_INDEX Procedure.

Viene creata una tabella locale all'interno del database con suffisso standard INDEX_NAME$TXTIDX. Questa tabella viene creata internamente quando si esegue DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

È possibile eseguire una query sulla tabella INDEX_NAME$TXTIDX per cercare una stringa utilizzando la parola chiave JSON_TEXTCONTAINS. Ad esempio, quando si chiama la procedura DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX il valore INDEX_NAME come VNCLOGS, viene creata la tabella di riferimento dell'indice di ricerca JSON VNCLOGS$TXTIDX.

SELECT * FROM (SELECT object_name, object_path, length, offset 
 FROM vnclogs$txtidx 
 WHERE JSON_TEXTCONTAINS (file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}') 
 ORDER BY mtime DESC) 
 WHERE rownum < 3;
 

Questa query fornisce informazioni interne sulla posizione dei file nello storage degli oggetti in cui si trovano i documenti pertinenti. La query non fornisce i documenti effettivi.

SELECT * FROM (SELECT object_name, object_path, data
 FROM vnclogs
 WHERE JSON_TEXTCONTAINS (file_line_json, '$.tuples', '{XXX.XXX.0.1.10.10.10.10.null.XXX_345}')
 ORDER BY mtime DESC)
 WHERE rownum < 3;
 

Una vista denominata INDEX_NAME viene creata quando si esegue DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX per creare un indice JSON.