Conector Microsoft Graph do Oracle SQL

O conector Oracle SQL Microsoft Graph permite que a sua organização detete e indexe dados a partir de uma base de dados Oracle no local. Os índices de conectores especificaram conteúdo no Microsoft Search e Microsoft Copilot 365. Para manter o índice atualizado com os dados de origem, suporta pesquisas periódicas completas e incrementais. Com o conector SQL oracle, também pode restringir o acesso aos resultados da pesquisa para determinados utilizadores.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um conector do Oracle SQL Microsoft Graph.

Recursos

• Indexe registos da base de dados SQL Oracle com uma consulta SQL.
• Especifique as permissões de acesso para cada registo com a lista de utilizadores ou grupos adicionados na consulta SQL.
• Permita que os utilizadores finais façam perguntas relacionadas com registos indexados no Copilot.
• Utilize a Pesquisa Semântica no Copilot para permitir que os utilizadores encontrem conteúdos relevantes com base em palavras-chave, preferências pessoais e ligações sociais.

Limitações

• Versão do Oracle SQL: a base de dados no local tem de executar a versão 11g ou posterior da Base de Dados Oracle. O conector suporta a base de dados Oracle alojada em plataformas de VMs do Windows, Linux e Azure.
• Para suportar uma velocidade de pesquisa elevada e um melhor desempenho, o conector é criado para suportar apenas cargas de trabalho OLTP (Processamento de Transações Online). Cargas de trabalho OLAP (Processamento Analítico Online) que não executam a consulta SQL fornecida em 40 segundos e não são suportadas.
• As ACLs só são suportadas com um Nome Principal de Utilizador (UPN), Microsoft Entra ID ou Segurança do Active Directory.
• A indexação de conteúdo avançado dentro de colunas de base de dados não é suportada. Exemplos desses conteúdos são HTML, JSON, XML, blobs e análises de documentos que existem como ligações dentro das colunas da base de dados.

Pré-requisitos

• Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização.
• Instalar o agente do conector do Microsoft Graph: para aceder ao oracle SQL Server, tem de instalar e configurar o agente do conector. Consulte Instalar o agente do conector do Microsoft Graph para saber mais.
• Conta de Serviço: para ligar à base de dados SQL e permitir que o Microsoft Graph Connector atualize registos regularmente, precisa de uma conta de serviço com permissões de leitura concedidas à conta de serviço.

Introdução à Configuração

1. Nome a apresentar

Um nome a apresentar é utilizado para identificar cada citação em Copilot, ajudando os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno. O nome a apresentar também é utilizado como um filtro de origem de conteúdo. Está presente um valor predefinido para este campo, mas pode personalizá-lo para um nome que os utilizadores na sua organização reconhecem.

2. SQL servidor

Para ligar aos dados SQL, tem de especificar o nome do anfitrião, da porta e do serviço (base de dados).

Se o nome do serviço não estiver disponível e se ligar através do Identificador do Sistema (SID), o nome do serviço pode ser derivado com um dos seguintes comandos (a ser executado como administrador do sys).

• selecione SERVICE_NAME de gv$session em que sid in (selecione sid from v$MYSTAT);
• selecione sys_context('userenv','service_name') a partir de duplo;

3. Graph Connector Agent

O agente do conector do Graph atua como uma ponte entre a instância do site e as APIs do conector, permitindo uma transferência de dados segura e eficiente. Neste passo, selecione a configuração do agente que pretende utilizar para o conector.

Se ainda não instalou o agente do conector do Microsoft Graph , pode transferir o instalador do agente e seguir as instruções de instalação para configurá-lo. Depois de instalado, certifique-se de que o agente está configurado corretamente para ligar os sites no local ao conector.

4. Tipo de Autenticação

Para autenticar e sincronizar dados do Oracle SQL, escolha um dos dois métodos suportados:

a. Autenticação básica

b. autenticação

5. Implementar para público-alvo limitado

Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de Pesquisa antes de expandir o roll-out para uma audiência mais ampla. Para saber mais sobre a implementação limitada, clique aqui.

Conteúdo

Para procurar o conteúdo da base de dados, tem de especificar consultas SQL quando configurar o conector. Estas consultas SQL têm de atribuir um nome a todas as colunas da base de dados que pretende indexar (propriedades de origem). Isto inclui todas as associações SQL que precisam de ser executadas para obter todas as colunas. Para restringir o acesso aos resultados da pesquisa, tem de especificar Controle de Acesso Listas (ACLs) em consultas SQL quando configurar o conector.

1. Pesquisa completa (Obrigatório)

a. Selecionar colunas de dados (Obrigatório) e colunas ACL (Opcional)

b. Tipos de dados suportados

c. Marca d'água (Obrigatório)

2. Gerir propriedades

O conector SQL recolhe todas as colunas especificadas na consulta SQL de pesquisa completa como propriedades de origem para ingestão. Neste passo, pode definir o esquema de pesquisa para o seu conteúdo. Isto envolve definir as anotações de pesquisa, como procurar, obter, consultar e refinar as propriedades de origem selecionadas. Isto também inclui a atribuição de etiquetas semânticas e aliases para melhorar a relevância da pesquisa. Para saber mais sobre o esquema de pesquisa, veja a documentação sobre as diretrizes para "gerir propriedades".

3. Pesquisa incremental (opcional)

a. Consulta de sincronização incremental

Neste passo opcional, forneça uma consulta SQL para executar uma pesquisa incremental da base de dados. Com esta consulta, o conector SQL determina quaisquer alterações aos dados desde a última pesquisa incremental. Tal como na pesquisa completa, selecione todas as colunas onde pretende selecionar as opções Consulta, Pesquisa, Obter ou Refinar. Especifique o mesmo conjunto de colunas da ACL que especificou na consulta de pesquisa completa.

Os componentes na imagem seguinte assemelham-se aos componentes de pesquisa completos com uma exceção. Neste caso, "ModifiedDateTime" é a coluna de marca d'água selecionada. Reveja os passos de pesquisa completos para saber como escrever a consulta de pesquisa incremental e veja a imagem seguinte como um exemplo.

b. Instruções de eliminação recuperável (Opcional)

Num sistema de registos SQL, uma eliminação recuperável é uma técnica em que, em vez de remover fisicamente um registo de uma base de dados, marca-o como "eliminado" ao definir um sinalizador ou coluna específico. Isto permite que o registo permaneça na base de dados, mas é logicamente excluído da maioria das operações. Para eliminar linhas eliminadas de forma recuperável na base de dados durante a pesquisa incremental, especifique o nome e o valor da coluna de eliminação recuperável que indica que a linha foi eliminada.

Usuários

Pode optar por utilizar a origem de dados Apenas pessoas com acesso a esta origem de dados para restringir o acesso a utilizadores ou grupos, conforme selecionado na consulta de pesquisa completa, ou pode substituí-las para tornar os seus conteúdos visíveis para Todos.

1. Mapear colunas que contêm informações de permissões de acesso

Escolha as várias colunas de controlo de acesso (ACL) que especificam o mecanismo de controlo de acesso. Selecione o nome da coluna que especificou na consulta SQL de pesquisa completa. Tenha em atenção que "negar" tem precedência sobre as permissões "permitir".

Espera-se que cada uma das colunas da ACL seja uma coluna de valores múltiplos. Estes múltiplos valores de ID podem ser separados através de separadores, como ponto e vírgula (;), vírgula (,) e assim sucessivamente. Tem de especificar este separador no campo separador de valor .

Os seguintes tipos de ID são suportados para utilização como ACLs:

• Nome Principal de Utilizador (UPN): Um Nome Principal de Utilizador (UPN) é o nome de um utilizador do sistema num formato de endereço de e-mail. Um UPN (por exemplo: john.doe@domain.com) consiste no nome de utilizador (nome de início de sessão), separador (o símbolo @) e nome de domínio (sufixo UPN).
• Microsoft Entra ID: no Microsoft Entra ID, cada utilizador ou grupo tem um ID de objeto semelhante a "e0d3ad3d-0000-1111-2222-3c5f5c52ab9b".
• ID de Segurança do Active Directory (AD): numa configuração do AD no local, todos os utilizadores e grupos têm um identificador de segurança exclusivo imutável que se assemelha a "S-1-5-21-3878594291-2115959936-132693609-65242".

Sincronização

O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector do Graph.

Pode configurar pesquisas completas e incrementais com base nas opções de agendamento aqui presentes. Por predefinição, a pesquisa incremental (se configurada) está definida para cada 15 minutos e a pesquisa completa é definida para todos os dias. Se necessário, pode ajustar estas agendas de acordo com as suas necessidades de atualização de dados.

Neste momento, está pronto para criar a ligação para o Oracle SQL. Pode clicar no botão "Criar" para publicar os dados de ligação e de índice a partir da base de dados.

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector. Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver problemas ou quiser fornecer comentários, contacte o Microsoft Graph | Suporte.