Visão geral do SDK dos conectores do Microsoft Graph
O SDK de conectores do Microsoft Graph simplifica o processo de criação de conectores de alta qualidade, eficientes e resilientes para fonte de dados que não têm um conector predefinido, mas que você deseja indexar ao Microsoft Graph.
O SDK inclui a estrutura e os componentes de contrato para ajudá-lo a escrever o código e as ferramentas para testar seu código.
O SDK dos conectores permite criar conectores personalizados do Microsoft Graph diretamente no IDE (ambiente de desenvolvimento integrado) do Visual Studio. Ele fornece tudo o que você precisa para criar, depurar e implantar seu conector personalizado.
Itens ingeridos por meio de conexões criadas com o SDK consomem sua cota de item. Para saber mais sobre como determinar a quantidade de cota de item que você tem e como comprar mais cota, confira requisitos e preços de licenciamento.
Componentes
O SDK dos conectores inclui os seguintes componentes:
Modelo de conector personalizado: se você quiser desenvolver seu conector personalizado em C#, poderá baixar o modelo no Visual Studio Marketplace e começar rapidamente. Você também pode optar por desenvolver seu conector personalizado em qualquer um dos idiomas desta lista.
Contratos: os contratos são arquivos de buffer de protocolo gRPC que contêm os contratos de interação entre a plataforma Microsoft (agente conector do Microsoft Graph) e o código do conector personalizado.
Agente conector do Microsoft Graph: um componente de software leve que gerencia recursos e coordenadas do conector entre o Centro de administração do Microsoft 365 e o código do conector personalizado.
Baixe a versão mais recente do agente conector e execute o assistente de configuração de instalação. Para obter mais informações, consulte Agente conector do Microsoft Graph.
Utilitário de teste do SDK dos conectores: inclui cenários de teste predefinidos que você pode usar para testar o código do conector personalizado e se comunicar com a plataforma do agente conector.
Recursos do agente de conector do Microsoft Graph
O agente do conector é criado na mesma plataforma de conector robusta usada para executar os conectores internos da Microsoft.
Ele inclui os seguintes recursos:
Obter dados do conector: o agente pode se conectar ao conector personalizado para obter dados da origem usando a lógica implementada pelo conector.
Centro de administração do Microsoft 365 integração: o agente permite que você configure, gerencie e monitore seus conectores personalizados por meio do Centro de administração do Microsoft 365.
Rastreamento de agendamento e gerenciamento: o agente é capaz de rastrear a fonte de dados por meio de rastreamentos completos e rastreamentos incrementais. Os rastreamentos completos (baseados em lista ou baseados no Microsoft Graph) passam por todos os dados periodicamente em um intervalo definido por você. Rastreamentos incrementais são mais frequentes e eles rastejam a fonte de dados do carimbo/ponto de verificação de data/hora anterior em um intervalo definido por você.
Exclusão, diferença e detecção de ciclo: o agente é capaz de detectar itens excluídos da fonte de dados com base nos itens enviados pelo conector durante rastreamentos completos periódicos. Em seguida, o agente cuida da exclusão do item do índice da Microsoft também.
O agente também detecta itens que foram alterados desde o último rastreamento calculando um hash do item e comparando-o com o hash do item visto anteriormente. Para tornar os rastreamentos mais rápidos, o agente envia os dados a serem indexados somente quando o item for alterado.
O agente também detecta itens duplicados que surgem de fontes de dados que têm itens vinculados (como sites) e ignora o rastreamento desses itens.
Mapeamento de identidade: o agente conector habilita o carimbo de ACLs (Controle de Acesso Listas) em seus dados para habilitar o corte de segurança. Você pode habilitar o corte de segurança com base em Microsoft Entra ID ou ACLs de sua fonte de dados.
Ingestão do Microsoft Graph: o agente ingere os dados no Microsoft Graph depois de recebê-los do conector personalizado.
Observação
Os seguintes recursos não estão disponíveis no momento:
- Travessia de fonte de dados baseada em grafo durante rastreamentos; por exemplo, atravessando estruturas de pastas.
- A capacidade de gerenciar permissões de pesquisa com base no controle de acesso de sua fonte de dados.
Você pode começar no C# com nossos conectores de exemplo ou em outros idiomas com suporte usando os contratos da página SDK dos conectores do Microsoft Graph no GitHub.