Utiliser la recherche JSON sur des documents dans le stockage d'objets

Vous utilisez DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX pour créer un index de recherche JSON sur les fichiers du service de stockage d'objets. Vous pouvez configurer un taux d'actualisation qui indique la fréquence en minutes à laquelle l'index est actualisé pour les nouveaux chargements ou suppressions. Pour plus d'informations, voir Créer 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 :

• Un index de recherche JSON index_name sur les fichiers JSON du service de stockage d'objets.

• Un tableau local INDEX_NAME$TXTIDX. Cette table est la table de mappage entre vos documents dans les fichiers du service de stockage d'objets et l'index de recherche JSON créé dans la base de données. Pour plus d'informations, voir Table de référence sur l'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 au-dessus de la table INDEX_NAME$TXTIDX. Pour plus d'informations, voir Vue de référence de l'index de recherche JSON.

• Table du journal des erreurs avec le suffixe standard index_name$txtidx_err. Pour plus d'informations, voir Table du journal des erreurs.

L'opération de création de l'index de recherche JSON est enregistrée dans la vue ALL_SCHEDULER_JOB_RUN_DETAILS. Pour plus d'informations, voir Surveiller la création de l'index texte.

Autonomous AI 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 dans un 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, voir Ensemble DBMS_CLOUD.

Pour plus d'informations, voir 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 le stockage d'objets.

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

   Pour plus d'informations, voir ProcédureCREATE_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'objets.

   
   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 :

   • Un index de recherche JSON VNCLOGS sur les fichiers de stockage d'objets situés sur l'URI spécifié dans le paramètre location_uri.

   • Un tableau local VNCLOGS$TXTIDX. Pour plus d'informations, voir Table de référence sur l'index de recherche JSON.

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

   • Table du journal des erreurs nommée VNC$TXTIDX_ERR. Le tableau contient une liste de documents JSON non valides dans vos fichiers. Pour plus d'informations, voir Table du journal des erreurs.

   Après avoir créé l'index de recherche JSON, vous pouvez interroger la vue VNCLOGS. 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 interrogation retourne les détails du journal pour les adresses IP spécifiées dans la condition JSON_TEXTCONTAINS. Notez que les critères d'index de recherche JSON sont spécifiés dans la colonne file_line_json, la 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 du stockage d'objets, représenté au moyen de la colonne data. La colonne data contient le contenu du fichier de stockage d'objets.

   Pour plus d'informations, voir ProcédureCREATE_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 le stockage d'objets.

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 de l'index de recherche JSON est enregistré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 la tâche de création d'index.

Le nom de la tâche DBMS_SCHEDULER est dérivé du paramètre INDEX_NAME spécifié 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'énoncé SELECT suivant avec une clause WHERE sur job_name affiche les détails d'exécution de la tâche :

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 du programmateur de création d'index.

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

Pour plus d'informations, voir ProcédureCREATE_EXTERNAL_TEXT_INDEX.

Une table locale est créée dans votre 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 en tant que INDEX_NAME, la valeur VNCLOGS crée la table de référence de l'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 interrogation fournit des informations internes sur l'emplacement des documents pertinents dans vos fichiers du service de stockage d'objets. L'interrogation 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.