Utiliser la recherche JSON sur les documents dans Object Storage

Utilisez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX pour créer un index de recherche JSON sur les fichiers dans Object Storage. Vous pouvez configurer une fréquence d'actualisation qui indique la fréquence en minutes à laquelle l'index est actualisé pour les nouveaux téléchargements ou suppressions. Pour plus d'informations, reportez-vous à Création d'un index de recherche JSON sur des documents JSON dans des fichiers.

Les objets suivants sont créés lorsque vous créez un index de recherche JSON :

• Index de recherche JSON index_name sur les fichiers JSON Object Storage.

• Table locale INDEX_NAME$TXTIDX. Cette table est la table de correspondance entre vos documents dans les fichiers d'Object Storage et l'index de recherche JSON créé dans la base de données. Pour plus d'informations, reportez-vous à Table de référence d'index de recherche JSON.

• Vue portant le nom standard INDEX_NAME. Vous pouvez utiliser la vue pour effectuer une recherche à l'aide de JSON_TEXTCONTAINS. Cette vue est créée sur la table INDEX_NAME$TXTIDX. Pour plus d'informations, reportez-vous à Vue de référence d'index de recherche JSON.

• Table de journal d'erreurs avec le suffixe standard index_name$txtidx_err. Pour plus d'informations, reportez-vous à la section Error Log Table.

L'opération de création d'index de recherche JSON est journalisée dans la vue ALL_SCHEDULER_JOB_RUN_DETAILS. Pour plus d'informations, reportez-vous à Surveillance de la création des index de texte.

Autonomous Database prend en charge la création d'index de recherche JSON pour divers fichiers texte contenant des documents JSON. Par exemple, vous pouvez indexer des fichiers JSON au format compressé et non compressé, ou choisir un autre délimiteur de document JSON. Pour plus d'informations sur les options de traitement des fichiers, reportez-vous à la section DBMS_CLOUD Package.

Pour plus d'informations, reportez-vous à Indexation avec Oracle Text.

Utilisez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX pour créer un index de recherche JSON sur les fichiers JSON stockés dans Object Storage.

1. Créez un objet d'informations d'identification pour accéder à l'emplacement source.

   Pour plus d'informations, reportez-vous à Procédure CREATE_CREDENTIAL.

2. Exécutez la procédure DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX pour créer un index de recherche JSON sur les fichiers de stockage d'objet.

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

   Cet exemple crée les éléments suivants :

   • Index de recherche JSON VNCLOGS sur les fichiers Object Storage situés à l'URI indiqué dans le paramètre location_uri.

   • Table locale VNCLOGS$TXTIDX. Pour plus d'informations, reportez-vous à Table de référence d'index de recherche JSON.

   • Vue nommée VNCLOGS. Cette vue est créée sur la table VNCLOGS$TXTIDX. Vous pouvez utiliser la vue pour effectuer une recherche à l'aide de JSON_TEXTCONTAINS. Pour plus d'informations, reportez-vous à Vue de référence d'index de recherche JSON.

   • Table de journal d'erreurs nommée VNC$TXTIDX_ERR. La table contient la liste des documents JSON non valides dans vos fichiers. Pour plus d'informations, reportez-vous à la section Error Log Table.

   Après avoir créé l'index de recherche JSON, vous pouvez interroger la vue VNCLOGS. Par exemple :

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

   Cette requête renvoie les détails du journal pour les adresses IP indiquées dans la condition JSON_TEXTCONTAINS. Les critères d'index de recherche JSON sont indiqués sur la colonne file_line_json, colonne indexée dans la table d'index de recherche JSON de la base de données, tandis que les documents JSON sont transmis directement à partir d'Object Storage, représentés par la colonne data. La colonne data contient le contenu du fichier Object Storage.

   Pour plus d'informations, reportez-vous à Procédure CREATE_EXTERNAL_TEXT_INDEX.

Utilisez la procédure DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX pour supprimer un index de recherche JSON sur les fichiers JSON stockés dans Object Storage.

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

Lorsque vous exécutez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX, l'opération de création d'index de recherche JSON est journalisée dans la vue ALL_SCHEDULER_JOB_RUN_DETAILS.

Vous pouvez interroger la vue ALL_SCHEDULER_JOB_RUN_DETAILS pour obtenir le statut et toute erreur signalée par le travail de création d'index.

Le nom du travail DBMS_SCHEDULER est dérivé du paramètre INDEX_NAME indiqué lorsque vous appelez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Pour interroger la vue ALL_SCHEDULER_JOB_RUN_DETAILS, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège READ sur la vue ALL_SCHEDULER_JOB_RUN_DETAILS.

Par exemple, l'instruction SELECT suivante avec une clause WHERE sur job_name affiche les détails d'exécution du travail :

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

Vous pouvez également rechercher l'existence d'un travail de planificateur de création d'index.

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

Pour plus d'informations, reportez-vous à Procédure CREATE_EXTERNAL_TEXT_INDEX.

Une table locale est créée dans la base de données avec le suffixe standard INDEX_NAME$TXTIDX. Cette table est créée en interne lorsque vous exécutez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX.

Vous pouvez interroger la table INDEX_NAME$TXTIDX pour rechercher une chaîne à l'aide du mot-clé JSON_TEXTCONTAINS. Par exemple, lorsque vous appelez la procédure DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX, la valeur INDEX_NAME est VNCLOGS, cela crée la table de référence d'index de recherche 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;
 

Cette requête fournit des informations internes sur l'emplacement des documents pertinents dans vos fichiers dans Object Storage. La requête ne fournit pas les documents réels.

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;
 

Une vue portant le nom INDEX_NAME est créée lorsque vous exécutez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX pour créer un index JSON.