Suporte do SharePoint no Autonomous AI Database usando DBMS_CLOUD

Execute as etapas a seguir para acessar arquivos armazenados no SharePoint para carregar dados no Autonomous AI Database para análise.

1. Criar uma credencial do SharePoint
   Crie uma credencial com o ID do cliente do SharePoint e o segredo do cliente e especifique um nome de credencial.

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

2. Gerar o URI do SharePoint
   Execute DBMS_CLOUD.INIT_SHAREPOINT_URI para gerar o URI do SharePoint para o site, subsite, lista ou item do SharePoint que você deseja acessar.

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

   Este procedimento retorna o formato de URI correto para o local do SharePoint que você deseja acessar.

3. Listar objetos e revisar metadados

   Execute DBMS_CLOUD.LIST_OBJECTS_EXTENDED para identificar os arquivos disponíveis no SharePoint e os detalhes dos identificadores do SharePoint na coluna 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');

   A saída inclui uma coluna METADATA com atributos JSON específicos do SharePoint, como tenantid, siteid, listid e itemid.

   Consulte DBMS_CLOUD.LIST_OBJECTS_EXTENDED para obter mais informações.

4. Fazer Download de um Único Arquivo
   Depois de identificar o item desejado, execute DBMS_CLOUD.GET_OBJECT para fazer download de um único arquivo do SharePoint. Para GET_OBJECT, o URI do SharePoint deve incluir o 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');

   Execute a instrução acima quando quiser que o objeto seja retornado diretamente em vez de gravado em um diretório de banco de dados.

5. Fazer download de um objeto em um diretório
   Execute GET_OBJECT e inclua directory_name no procedimento.

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

   Como você especifica o nome do diretório, os arquivos são baixados para esse diretório de banco de dados.

   Consulte DBMS_CLOUD.GET_OBJECT para obter mais informações.

Você pode usar um pipeline quando quiser que o Autonomous AI Database descubra conteúdo e faça download dele em um workflow.

O sistema cria Pipelines no nível do site do SharePoint, não no nível da lista individual ou da biblioteca. A Oracle recomenda o uso de um pipeline por site.

Se um site tiver um subsite, crie um pipeline separado especificando o site combinado e o identificador do subsite no formato <site_id>/sites/<sub-site_id>.

1. Criar um pipeline de download

   Crie um pipeline DOWNLOAD para carregar dados do SharePoint.

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

   Este tipo de pipeline é o único tipo de pipeline suportado para o SharePoint.

2. Definir atributos de pipeline
   Especifique a credencial, o local do SharePoint, a prioridade e os valores de intervalo para o 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;
   /

   Se você também especificar o directory_name, o pipeline fará download dos arquivos para esse diretório, em vez de armazenar dados de arquivo na tabela de status do pipeline.

   Consulte Atributos DBMS_CLOUD_PIPELINE para obter mais informações.

3. Iniciar o pipeline

   Depois de definir os atributos, você poderá iniciar o pipeline:

   EXEC DBMS_CLOUD_PIPELINE.START_PIPELINE('MY_PIPE2');

   Quando o pipeline é iniciado, ele valida o URI e reúne itens de listas do site ou subsite de destino. O pipeline faz download dos dados para o diretório especificado. Se você não especificar um diretório, o pipeline o armazenará na coluna de dados da tabela de status do pipeline.

4. Revisar resultados do pipeline

   Revise a tabela de status do pipeline para confirmar se os objetos foram processados com sucesso e para inspecionar o status, os timestamps e os detalhes do conteúdo baixado. Se o pipeline gravar arquivos em um diretório, execute DBMS_CLOUD.LIST_FILES para verificar os arquivos baixados.

Você pode criar índices vetoriais diretamente do SharePoint usando DBMS_CLOUD_AI.CREATE_VECTOR_INDEX.