Configuração do 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 as etapas para configurar seu Snowflake Connector for SharePoint.

Pré-requisitos¶

Antes de começar a instalar e configurar o conector, você deve fazer o seguinte:

Certifique-se de ter um aplicativo Microsoft Graph com as seguintes permissões:
- Sites.Selected: limita o acesso apenas aos sites especificados.
- Files.SelectedOperations.Selected: limita o acesso apenas a arquivos em sites especificados.
- GroupMember.Read.All: usado para resolver as permissões do grupo SharePoint.
Configure o SharePoint para habilitar a autenticação OAuth, conforme descrito em Obter acesso sem um usuário. O conector usa as seguintes APIs do Microsoft Graph para buscar dados do SharePoint:
Obtenha o URL do site de seu SharePoint do Microsoft 365 com arquivos ou pastas que deseja ingerir no Snowflake e as credenciais de seu administrador de conta Azure ou Office 365.

Instale o Snowflake Connector for SharePoint¶

Os conectores são instâncias de aplicativos nativos Snowflake. Para instalar o Snowflake Connector for SharePoint, faça o seguinte:

Faça o login no Snowflake como um usuário com a função ACCOUNTADMIN.
Navegue até Data Products » Marketplace.
Procure por Snowflake Connector for SharePoint e selecione Get.
Na caixa de diálogo, expanda Options e insira as seguintes informações:
- Em Application name, insira um nome para o aplicativo do conector.
- Em Warehouse used for installation, selecione o warehouse que deseja usar para a instalação do conector.
  
  Nota
  
  Este não é o mesmo warehouse que é usado pelo conector para sincronizar os dados do SharePoint. Em uma etapa posterior, você criará um warehouse separado para este fim.
Selecione Get para iniciar o processo de instalação. Isso pode levar alguns minutos para ser concluído.
Após a instalação bem-sucedida do conector, selecione Configure para prosseguir com a configuração do ou selecione Done para fechar a caixa de diálogo e concluir a instalação.

Opcional: Instalar várias instâncias do Snowflake Connector for SharePoint¶

É possível instalar várias instâncias do Snowflake Connector for SharePoint em sua conta Snowflake. Para instalar uma instância adicional, faça o seguinte:

Navegue até o Snowflake Marketplace e selecione Snowflake Connector for SharePoint. A página de detalhes do aplicativo é exibida.
Clique em Add instance. A caixa de diálogo de instalação é exibida.
Forneça o nome da instância e selecione o warehouse a ser usado durante a instalação.
Selecione Get para iniciar o processo de instalação.

Nota

Adicionar instâncias de conector pode levar vários minutos. Quando o processo de instalação for concluído, você receberá uma notificação por e-mail.
Para evitar a corrupção de dados ingeridos, durante a configuração do conector, sempre use um esquema de banco de dados diferente de todos os outros aplicativos nativos.

Configuração do Snowflake Connector for SharePoint¶

Cada instância do aplicativo do conector deve ser configurada para se comunicar com sua instância do Sharepoint associada. Após concluir o processo de instalação do, prossiga com as seguintes etapas.

Certifique-se de que todos os pré-requisitos foram concluídos. Para obter mais informações, consulte Pré-requisitos.
Se necessário, abra o assistente de configuração da seguinte forma:
1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.
2. No menu de navegação, selecione Data Products » Apps.
3. Procure e selecione o Snowflake Connector for SharePoint.

Configurar¶

Na etapa Configure do assistente, insira as informações nos seguintes campos:

Nota

Por padrão, os campos são definidos como os nomes dos objetos que são criados quando você configura o conector. Snowflake recomenda o uso de novos objetos para estes campos. No entanto, se necessário, você pode especificar os nomes dos objetos existentes (por exemplo, se estiver reinstalando o conector).

Campo

Descrição

Warehouse for Ingestion Data

Identificador para um novo warehouse virtual dedicado para o conector. Este warehouse é usado para calcular as tarefas de ingestão de dados e processamento de documentos.

Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto</sql-reference/identifiers-syntax> válido.

Alternativamente, você pode selecionar um warehouse existente.

Nota

Não especifique o warehouse utilizado durante a criação inicial do conector.

Warehouse for Cortex Search:

Identificador para um novo warehouse virtual dedicado do Cortex Search. Esse warehouse é usado para processar e atender consultas do Cortex Search.

Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto</sql-reference/identifiers-syntax> válido.

Nota

Não especifique o mesmo warehouse que você selecionou no início da instalação do conector. O processo de configuração cria um novo warehouse X-Small com o nome especificado.

Role for Cortex Search

Identificador para uma nova função personalizada para o conector. Especifique um nome que seja único para sua conta. O nome da função deve ser um identificador de objeto</sql-reference/identifiers-syntax> válido.

Usuários que concederam a função podem usar sua conta para consultar a REST API do Cortex sobre os dados ingeridos pelo aplicativo. Por padrão, somente a conta que você usou para instalar o conector tem permissão para consultar o Cortex.

Campo	Descrição
Warehouse for Ingestion Data	Identificador para um novo warehouse virtual dedicado para o conector. Este warehouse é usado para calcular as tarefas de ingestão de dados e processamento de documentos. Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto</sql-reference/identifiers-syntax> válido. Alternativamente, você pode selecionar um warehouse existente. Nota Não especifique o warehouse utilizado durante a criação inicial do conector.
Warehouse for Cortex Search:	Identificador para um novo warehouse virtual dedicado do Cortex Search. Esse warehouse é usado para processar e atender consultas do Cortex Search. Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto</sql-reference/identifiers-syntax> válido. Nota Não especifique o mesmo warehouse que você selecionou no início da instalação do conector. O processo de configuração cria um novo warehouse X-Small com o nome especificado.
Role for Cortex Search	Identificador para uma nova função personalizada para o conector. Especifique um nome que seja único para sua conta. O nome da função deve ser um identificador de objeto</sql-reference/identifiers-syntax> válido. Usuários que concederam a função podem usar sua conta para consultar a REST API do Cortex sobre os dados ingeridos pelo aplicativo. Por padrão, somente a conta que você usou para instalar o conector tem permissão para consultar o Cortex.

Clique em Configure para continuar.

Autenticar e se conectar ao Sharepoint¶

Importante

Certifique-se de que os pop-ups estejam habilitados em seu navegador.

Na etapa Authentication do assistente, insira as seguintes informações e credenciais para concluir a autenticação OAuth2 e a conexão com o SharePoint.

Entre em contato com seu administrador de conta Azure ou Office 365 para obter estas informações.

Campo	Descrição
SharePoint site URL	URL ou site do Sharepoint do qual o conector ingerirá o conteúdo. Para sites de nível superior, use somente o nome de domínio, por exemplo, `sitename.sharepoint.com`. Para sites secundários, use um nome de domínio com o caminho do site, por exemplo, `sitename.sharepoint.com/sites/SubSite`.
Client ID	Insira seu ID de cliente. Para saber mais sobre o ID de cliente e como encontrá-lo no Microsoft Entra, consulte ID do aplicativo (ID de cliente).
Client secret	Insira seu segredo de cliente. Para saber mais sobre um segredo de cliente e como encontrá-lo no Microsoft Entra, consulte Certificados e segredos.
Tenant ID	Insira seu ID de locatário. Para saber mais sobre o ID de locatário e como encontrá-lo no Microsoft Entra, consulte Encontrar seu ID de locatário do Microsoft 365.

Clique em Next para iniciar o processo de conexão, que pode levar vários minutos para ser concluído.

Validação da fonte¶

Na etapa Validate source do assistente, faça o seguinte:

Selecione a fonte em que você quer buscar os arquivos:
- Selecione All folders se quiser buscar arquivos de todas as pastas acessíveis com as credenciais fornecidas em Autenticar e se conectar ao Sharepoint.
- Selecione Specific folder se quiser buscar arquivos de uma pasta específica que possa ser acessada com as credenciais fornecidas em Autenticar e se conectar ao Sharepoint.
  
  Nota
  
  Esse caminho é relativo à pasta de documentos compartilhados. Por exemplo, para ingerir arquivos da pasta Shared%20Documents/user_manuals/cars, digite user_manuals/cars.
Nota

Para alterar a origem do arquivo de busca mais tarde, é necessário reinstalar o conector.
Clique em Validate para iniciar o processo de validação da fonte, que pode levar vários minutos.
Depois que o conector for configurado com sucesso, clique em Ingest files para iniciar a ingestão de dados.

Próxima etapa¶

Depois que seu conector estiver configurado, continue para Consultar o Cortex Search Service com o Snowflake Connector for SharePoint.