Prise en charge de SharePoint dans une base de données Autonomous AI à l'aide de DBMS_CLOUD

Exécutez les étapes suivantes pour accéder aux fichiers stockés dans SharePoint afin de charger des données dans la base de données Autonomous AI pour analyse.

1. Créer des informations d'identification SharePoint
   Créez des informations d'identification avec l'ID client SharePoint et la clé secrète client, puis indiquez un nom d'informations d'identification.

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'SHAREPOINT_CRED',
       username        => '<client-id>',
       password        => '<client-secret>'
     );
   END;
   /

2. Générer l'URI SharePoint
   Exécutez DBMS_CLOUD.INIT_SHAREPOINT_URI pour générer l'URI SharePoint pour le site, le sous-site, la liste ou l'élément SharePoint auquel vous voulez accéder.

   DECLARE
     l_location_uri varchar2(4000);
   BEGIN
     l_location_uri := DBMS_CLOUD.INIT_SHAREPOINT_URI(
       tenant_id   => 'Tenant ID',
       site_id     => 'Site ID',
       sub_site_id => 'Sub Site ID',
       list_id     => 'List ID',
       item_id     => 'Item ID'
     );
   END;
   /

   Cette procédure renvoie le format d'URI correct pour l'emplacement SharePoint auquel vous voulez accéder.

3. Répertorier les objets et vérifier les métadonnées

   Exécutez DBMS_CLOUD.LIST_OBJECTS_EXTENDED pour identifier les fichiers disponibles dans SharePoint et les détails des identificateurs SharePoint dans la colonne METADATA.

   SELECT *
   FROM DBMS_CLOUD.LIST_OBJECTS_EXTENDED(
     location_uri    => DBMS_CLOUD.INIT_SHAREPOINT_URI(
                         tenant_id   => 'Tenant ID',
                         site_id     => 'Site ID',
                         sub_site_id => 'Sub Site ID',
                         list_id     => 'List ID',
                         item_id     => 'Item ID'),
     credential_name => 'SHAREPOINT_CRED');

   La sortie inclut une colonne METADATA avec des attributs JSON spécifiques à SharePoint tels que tenantid, siteid, listid et itemid.

   Pour plus d'informations, reportez-vous à DBMS_CLOUD.LIST_OBJECTS_EXTENDED.

4. Télécharger un seul fichier
   Une fois que vous avez identifié l'élément souhaité, exécutez DBMS_CLOUD.GET_OBJECT pour télécharger un fichier unique à partir de SharePoint. Pour GET_OBJECT, l'URI SharePoint doit inclure itemid.

   DBMS_CLOUD.GET_OBJECT(
     object_uri      => DBMS_CLOUD.INIT_SHAREPOINT_URI(
                         tenant_id   => 'Tenant ID',
                         site_id     => 'Site ID',
                         sub_site_id => 'Sub Site ID',
                         list_id     => 'List ID',
                         item_id     => 'Item ID'),
     credential_name => 'SHAREPOINT_CRED');

   Exécutez l'instruction ci-dessus lorsque vous souhaitez que l'objet soit renvoyé directement au lieu d'être écrit dans un répertoire de base de données.

5. Télécharger un objet en local dans un répertoire
   Exécutez GET_OBJECT et incluez directory_name dans la procédure.

   DBMS_CLOUD.GET_OBJECT(
     object_uri      => DBMS_CLOUD.INIT_SHAREPOINT_URI(
                         tenant_id   => 'Tenant ID',
                         site_id     => 'Site ID',
                         sub_site_id => 'Sub Site ID',
                         list_id     => 'List ID',
                         item_id     => 'Item ID'),
     credential_name => 'SHAREPOINT_CRED',
     directory_name  => 'STAGING');

   Comme vous indiquez le nom du répertoire, les fichiers sont téléchargés vers ce répertoire de base de données.

   Pour plus d'informations, reportez-vous à DBMS_CLOUD.GET_OBJECT.

Vous pouvez utiliser un pipeline lorsque vous voulez que la base de données Autonomous AI repère du contenu et le télécharge dans un workflow.

Le système crée des pipelines au niveau du site SharePoint, et non au niveau de la liste ou de la bibliothèque. Oracle recommande d'utiliser un pipeline par site.

Si un site a un sous-site, créez un pipeline distinct en spécifiant l'identifiant combiné du site et du sous-site au format <site_id>/sites/<sub-site_id>.

1. Créer un pipeline de téléchargement

   Créez un pipeline DOWNLOAD pour charger des données à partir de SharePoint.

   BEGIN
     DBMS_CLOUD_PIPELINE.CREATE_PIPELINE(
       pipeline_name => 'MY_PIPE2',
       pipeline_type => 'DOWNLOAD',
       description   => 'Downloads data from SharePoint to Autonomous Database'
     );
   END;
   /

   Ce type de pipeline est le seul type de pipeline pris en charge pour SharePoint.

2. Définir les attributs de pipeline
   Indiquez les informations d'identification, l'emplacement SharePoint, la priorité et les valeurs d'intervalle du pipeline.

   BEGIN
     DBMS_CLOUD_PIPELINE.SET_ATTRIBUTE(
       pipeline_name => 'MY_PIPE2',
       attributes    => JSON_OBJECT(
         'credential_name' VALUE 'SHAREPOINT_CRED',
         'location'        VALUE DBMS_CLOUD.INIT_SHAREPOINT_URI(
                               tenant_id => 'Tenant ID',
                               site_id   => 'Site ID'),
         'priority'        VALUE 'HIGH',
         'interval'        VALUE '5')
     );
   END;
   /

   Si vous indiquez également directory_name, le pipeline télécharge les fichiers dans ce répertoire au lieu de stocker les données de fichier dans la table de statut du pipeline.

   Pour plus d'informations, voir Attributs DBMS_CLOUD_PIPELINE.

3. Démarrer le pipeline

   Une fois les attributs définis, vous pouvez démarrer le pipeline :

   EXEC DBMS_CLOUD_PIPELINE.START_PIPELINE('MY_PIPE2');

   Lorsque le pipeline démarre, il valide l'URI et rassemble les éléments du site ou sous-site cible. Le pipeline télécharge les données vers le répertoire indiqué. Si vous n'indiquez pas de répertoire, le pipeline le stocke dans la colonne de données de la table de statut du pipeline.

4. Vérifier les résultats du pipeline

   Consultez la table des statuts de pipeline pour vérifier que les objets ont bien été traités et pour inspecter le statut, les horodatages et les détails du contenu téléchargé. Si le pipeline écrit des fichiers dans un répertoire, exécutez DBMS_CLOUD.LIST_FILES pour vérifier les fichiers téléchargés.

Vous pouvez créer des index vectoriels directement à partir de SharePoint à l'aide de DBMS_CLOUD_AI.CREATE_VECTOR_INDEX.