Utilice DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX para crear un índice de búsqueda JSON en archivos de Object Storage. Puede configurar un ratio de refrescamiento que indique la frecuencia en minutos con la que se refresca el índice para las nuevas cargas o supresiones. Consulte Creación de un índice de búsqueda JSON en documentos JSON en archivos para obtener más información.

Los siguientes objetos se crean al crear un índice de búsqueda JSON:

• Índice de búsqueda JSON index_name en los archivos JSON de Object Storage.

• Tabla local INDEX_NAME$TXTIDX. Esta tabla es la tabla de asignación entre los documentos de los archivos de Object Storage y el índice de búsqueda JSON que se crea en la base de datos. Consulte Tabla de referencia de índice de búsqueda JSON para obtener más información.

• Vista con el nombre estándar INDEX_NAME. Puede utilizar la vista para realizar una búsqueda mediante JSON_TEXTCONTAINS. Esta vista se crea sobre la tabla INDEX_NAME$TXTIDX. Consulte Vista de referencia de índice de búsqueda JSON para obtener más información.

• Tabla de log de errores con el sufijo estándar index_name$txtidx_err. Consulte Tabla de logs de errores para obtener más información.

La operación de creación del índice de búsqueda JSON se registra en la vista ALL_SCHEDULER_JOB_RUN_DETAILS. Consulte Supervisión de Creación de Índices de Texto para obtener más información.

Autonomous Database soporta la creación de índices de búsqueda JSON para una serie de archivos de texto que contienen documentos JSON. Por ejemplo, puede indexar archivos JSON en formato comprimido y descomprimido, o seleccionar un delimitador de documento JSON diferente. Consulte DBMS_CLOUD Package para obtener más información sobre las opciones de manejo de archivos.

Consulte Indexación con Oracle Text para obtener más información.

Utilice DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX para crear un índice de búsqueda JSON en los archivos JSON almacenados en Object Storage.

1. Cree un objeto de credencial para acceder a la ubicación de origen.

   Consulte Procedimiento CREATE_CREDENTIAL para obtener más información.

2. Ejecute el procedimiento DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX para crear un índice de búsqueda JSON en los archivos de almacenamiento de objetos.

   
   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;
   /

   En este ejemplo, se crea lo siguiente:

   • Índice de búsqueda JSON VNCLOGS en los archivos de Object Storage ubicados en el URI especificado en el parámetro location_uri.

   • Tabla local VNCLOGS$TXTIDX. Consulte Tabla de referencia de índice de búsqueda JSON para obtener más información.

   • Vista con el nombre VNCLOGS. Esta vista se crea sobre la tabla VNCLOGS$TXTIDX. Puede utilizar la vista para realizar una búsqueda mediante JSON_TEXTCONTAINS. Consulte Vista de referencia de índice de búsqueda JSON para obtener más información.

   • Tabla de log de errores con el nombre VNC$TXTIDX_ERR. La tabla contiene una lista de documentos JSON no válidos en los archivos. Consulte Tabla de logs de errores para obtener más información.

   Después de crear el índice de búsqueda JSON, puede consultar la vista VNCLOGS. Por ejemplo:

   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}');
   

   Esta consulta devuelve los detalles de log de las direcciones IP especificadas en la condición JSON_TEXTCONTAINS. Tenga en cuenta que los criterios de índice de búsqueda JSON se especifican en la columna file_line_json, la columna indexada en la tabla de índice de búsqueda JSON de la base de datos, mientras que los documentos JSON se transmiten directamente desde Object Storage, representados a través de la columna data. La columna data contiene el contenido del archivo de Object Storage.

   Consulte el procedimiento CREATE_EXTERNAL_TEXT_INDEX para obtener más información.

Utilice el procedimiento DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX para borrar un índice de búsqueda JSON en los archivos JSON almacenados en Object Storage.

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

Al ejecutar DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX, la operación de creación del índice de búsqueda JSON se registra en la vista ALL_SCHEDULER_JOB_RUN_DETAILS.

Puede consultar la vista ALL_SCHEDULER_JOB_RUN_DETAILS para obtener el estado y cualquier error informado por el trabajo de creación de índices.

El nombre del trabajo DBMS_SCHEDULER se deriva del parámetro INDEX_NAME especificado al llamar a DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Para consultar la vista ALL_SCHEDULER_JOB_RUN_DETAILS, debe estar conectado como usuario ADMIN o tener el privilegio READ en la vista ALL_SCHEDULER_JOB_RUN_DETAILS.

Por ejemplo, la siguiente sentencia SELECT con una cláusula WHERE en job_name muestra los detalles de ejecución del trabajo:

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

También puede consultar la existencia de un trabajo del programador de creación de índices.

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

Consulte el procedimiento CREATE_EXTERNAL_TEXT_INDEX para obtener más información.

Se crea una tabla local en la base de datos con el sufijo estándar INDEX_NAME$TXTIDX. Esta tabla se crea internamente al ejecutar DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Puede consultar la tabla INDEX_NAME$TXTIDX para buscar una cadena mediante la palabra clave JSON_TEXTCONTAINS. Por ejemplo, al llamar al procedimiento DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX el valor INDEX_NAME como VNCLOGS, se crea la tabla de referencia de índice de búsqueda 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;
 

Esta consulta proporciona información interna sobre dónde se encuentran los documentos relevantes en los archivos de Object Storage. La consulta no proporciona los documentos reales.

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;
 

Se crea una vista con el nombre INDEX_NAME al ejecutar DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX para crear un índice JSON.