Sobre Snowflake Connector for SharePoint¶
Nota
O Snowflake Connector for SharePoint está sujeito aos Termos do conector.
Importante
Agradecemos pelo seu interesse no conector Snowflake para SharePoint. Agora, estamos focados em uma solução de próxima geração que oferecerá uma experiência significativamente melhor. Portanto, no momento não temos planos de passar esse conector para o status de disponibilidade geral. Você pode continuar usando esse conector como um recurso em versão preliminar, mas o suporte para futuras correções de bugs e melhorias não é garantido. A nova solução está disponível como Conector Openflow para SharePoint e inclui melhor desempenho, personalização e opções aprimoradas de implantação.
Este tópico descreve os conceitos básicos do Snowflake Connector for SharePoint, casos de uso, benefícios, principais recursos, como funciona e limitações.
O conector do Snowflake Connector for SharePoint conecta um site do Microsoft 365 SharePoint com o Snowflake para ingerir arquivos e permissões de usuário e mantê-los atualizados. O Snowflake Connector for SharePoint também oferece suporte ao Cortex Search Service e pode preparar os arquivos ingeridos para análise de conversação para uso em Assistentes de AI usando SQL, Python ou REST APIs.
Benefícios¶
Ingestão sem complicações: O conector é fácil de instalar e configurar. Você pode usar arquivos do SharePoint com o Cortex Search na interface de chat de sua escolha.
Seguro por padrão: O conector segue os controles de acesso do usuário final no SharePoint por meio de filtros do Cortex Search.
Escalável por design: Criado na estrutura do Snowflake Native App, o conector aproveita os recursos integrados de segurança, escalabilidade e confiabilidade do Snowflake.
Economia de custos: O conector economiza custos, eliminando a necessidade de transferir arquivos manualmente ou se integrar aos pontos de extremidade da API ou gerenciar soluções de terceiros.
Casos de uso¶
Use esse conector se quiser fazer o seguinte:
Como funciona¶
Esta seção descreve como esse conector funciona com base nos dois casos de uso mencionados anteriormente.
Criar assistentes de AI para documentos públicos no site do SharePoint da sua organização¶
Neste caso, o uso do Snowflake Connector for SharePoint pode ser dividido em quatro fases, cada uma associada a uma persona de usuário específica. O fluxo de trabalho a seguir descreve essas fases, a jornada do usuário associada e como esse conector funciona:
Um Administrador de conta Azure ou Office 365 em sua organização configura o Microsoft Graph para habilitar a autenticação do OAuth, conforme descrito em Obter acesso sem um usuário. Em seguida, ele compartilha as credenciais necessárias com o engenheiro de dados da organização.
Um especificador ou engenheiro de dados da organização instala o conector SharePoint para Snowflake do Snowflake Marketplace para sua conta Snowflake. Em seguida, eles configuram o conector com as seguintes informações:
Especificação das credenciais do OAuth para o SharePoint (ClientID, segredo do cliente e TenantID) obtidas na etapa 1.
Especificação do URL do site do SharePoint. Normalmente, esse é um site específico dentro do seu site do SharePoint.
Escolha se quer ingerir arquivos de todas as pastas ou de uma pasta específica no URL do SharePoint. Note que os arquivos das subpastas são sempre incluídos.
Depois que o conector valida a configuração, ele faz o seguinte:
Ingere arquivos e permissões de usuário compatíveis da fonte especificada.
Usa a função PARSE_DOCUMENT do Cortex AI para analisar e dividir os arquivos ingeridos.
Cria um Cortex Search Service para servir como um mecanismo RAG para seus próprios assistentes de AI com seus dados analisados e repartidos.
Um desenvolvedor de IT na organização cria um chatbot na interface de chat preferida, como extensões de botão no Slack, Teams ou uma página da Web, e o hospeda conforme apropriado em seu ambiente. O desenvolvedor de IT configura funções, permissões e autenticação no Snowflake para usar o ponto de extremidade disponível da REST API do Cortex Search no conjunto de REST APIs do Snowflake.
Depois de o assistente de AI começar a funcionar, os usuários empresariais da organização podem interagir com ele para fazer perguntas e ver respostas com base nos arquivos ingeridos do seu site do SharePoint em sua conta Snowflake. Todas as respostas têm referências com links para os documentos de origem do seu site do SharePoint.
Habilite os assistentes de AI para que eles possam aderir aos controles de acesso específicos do site do SharePoint de sua organização¶
Neste caso, o uso do Snowflake Connector for SharePoint pode ser dividido em quatro fases, cada uma associada a uma persona de usuário específica. O fluxo de trabalho a seguir descreve essas fases, a jornada do usuário associada e como esse conector funciona:
Um Administrador de conta Azure ou Office 365 em sua organização configura o Microsoft Graph para habilitar a autenticação do OAuth, conforme descrito em Obter acesso sem um usuário. Em seguida, ele compartilha as credenciais necessárias com o engenheiro ou o cientista de dados da organização.
Um especificador ou engenheiro de dados da organização instala o conector SharePoint para Snowflake do Snowflake Marketplace para sua conta Snowflake. Em seguida, ele configura o conector seguindo estas etapas:
Especificar as credenciais do OAuth do SharePoint (ID do cliente, segredo do cliente e ID do locatário) obtido na etapa 1.
Especificação do URL do site do SharePoint. Normalmente, esse é um site específico dentro do seu site do SharePoint.
Escolha se quer ingerir arquivos de todas as pastas ou de uma pasta específica no URL do SharePoint. Note que os arquivos das subpastas são sempre incluídos.
Depois que o conector valida a configuração, ele faz o seguinte:
Ingere arquivos e permissões de usuário compatíveis da fonte especificada.
Usar a função PARSE_DOCUMENT de AI do Cortex para analisar e repartir os arquivos ingeridos.
Criar um Cortex Search Service para funcionar como mecanismo RAG de seus próprios assistentes de AI com os dados analisados e repartidos.
Um desenvolvedor de IT na organização cria um chatbot na interface de chat preferida, como extensões de botão no Slack, Teams ou uma página da Web, e o hospeda conforme apropriado em seu ambiente.
Ele configura funções, permissões e autenticação no Snowflake para usar o ponto de extremidade disponível da REST API do Cortex Search no conjunto de REST APIs do Snowflake.
Ele especifica um filtro contendo o ID do e-mail do usuário doSharePoint quando o assistente de AI consulta a REST API do Cortex Search, por exemplo
filter.@contains.user_idsoufilter.@contains.user_emails. Isso restringe as respostas do Cortex Search a documentos aos quais o usuário empresarial especificado tem acesso no SharePoint da organização.
Depois que o assistente de AI estiver funcionamento, quando os usuários empresariais de sua organização interagirem com ele fazendo perguntas, eles verão apenas informações de arquivos do SharePoint aos quais têm acesso de acordo com o filtro especificado na Etapa 3(b). Todas as respostas têm referências com links para os documentos de origem do seu site do SharePoint.
Limitações¶
As alterações causadas pela movimentação ou renomeação de pastas não são capturadas durante a ingestão incremental.
O conector oferece suporte apenas a grupos do Microsoft 365.
O conector ingere apenas os tipos de arquivos compatíveis e ignora os demais.
Disponibilidade regional¶
O Snowflake Connector for SharePoint depende do documento do Cortex Parse e do Cortex Search.
O Snowflake Connector for SharePoint está atualmente disponível nas regiões listadas em Disponibilidade regional do Cortex Parse Document.