Configurer Snowflake Connector for SharePoint¶
Note
Le Snowflake Connector for SharePoint est soumis aux `Conditions du connecteur<https://www.snowflake.com/legal/snowflake-connector-terms/>`_.
Important
Merci de votre intérêt pour le Snowflake Connector pour SharePoint. Nous nous concentrons maintenant sur une solution de nouvelle génération qui offrira une expérience considérablement améliorée. Par conséquent, le déplacement de ce connecteur vers l’état de mise à disposition générale ne figure actuellement pas dans la feuille de route de notre produit. Vous pouvez continuer à utiliser ce connecteur en tant que fonction de prévisualisation, mais notez que la prise en charge des futures corrections de bogues et améliorations n’est pas garantie. La nouvelle solution est disponible en tant que Connecteur Openflow pour SharePoint et comprend de meilleures performances, une meilleure personnalisation et des options de déploiement améliorées.
Ce chapitre décrit les étapes de la configuration de votre Snowflake Connector for SharePoint.
Conditions préalables¶
Avant de commencer l’installation et la configuration du connecteur, vous devez procéder comme suit :
Assurez-vous d’avoir une application `Microsoft Graph <https://learn.microsoft.com/en-us/graph/overview>`_avec les autorisations suivantes :
Sites.Selected: limite l’accès aux seuls sites spécifiés.
Files.SelectedOperations.Selected: limite l’accès aux seuls fichiers des sites spécifiés.
GroupMember.Read.All: utilisé pour résoudre les autorisations du groupe SharePoint.
Configurer SharePoint pour activer l’authentification OAuth comme décrit dans Obtenir l’accès sans utilisateur. Le connecteur utilise les APIs Microsoft Graph suivantes pour récupérer des données depuis SharePoint :
Obtenez l’URL de votre site Microsoft 365 SharePoint avec les fichiers ou dossiers que vous souhaitez ingérer dans Snowflake et les identifiants de votre administrateur de compte Azure ou Office 365.
Installer le Snowflake Connector for SharePoint¶
Les connecteurs sont des instances d’applications natives Snowflake. Pour installer le Snowflake Connector for SharePoint, procédez comme suit :
Connectez-vous à Snowflake en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.
Accédez à Data Products » Marketplace.
Recherchez Snowflake Connector for SharePoint et sélectionnez Get.
Dans la boîte de dialogue, développez Options et saisissez les informations suivantes :
Dans Application name, saisissez un nom pour votre application de connecteur.
Dans Warehouse used for installation, sélectionnez l’entrepôt que vous souhaitez utiliser pour installer le connecteur.
Note
Il ne s’agit pas du même entrepôt que celui utilisé par le connecteur pour synchroniser les données depuis SharePoint. Dans une étape ultérieure, vous créerez un entrepôt distinct à cette fin.
Sélectionnez Get pour démarrer le processus d’installation. Cette opération peut prendre quelques minutes.
Une fois le connecteur installé, sélectionnez Configure pour poursuivre la configuration ou sélectionnez Done pour fermer la boîte de dialogue et terminer l’installation.
En option : Installation de plusieurs instances de Snowflake Connector for SharePoint¶
Vous pouvez installer plusieurs instances de Snowflake Connector for SharePoint sur votre compte Snowflake. Pour installer une instance supplémentaire, procédez comme suit :
Naviguez sur le Snowflake Marketplace et sélectionnez Snowflake Connector for SharePoint. La page de détails de l’application apparaît.
Cliquez sur Add instance. La boîte de dialogue d’installation apparaît.
Fournissez le nom de l’instance et sélectionnez l’entrepôt à utiliser lors de l’installation.
Sélectionnez Get pour démarrer le processus d’installation.
Note
L’ajout d’instances de connecteur peut prendre plusieurs minutes. Une fois le processus d’installation terminé, vous recevez une notification par e-mail.
Pour éviter la corruption des données ingérées, lors de la configuration du connecteur, utilisez toujours un schéma de base de données différent de celui de toutes les autres applications natives.
Configurer Snowflake Connector for SharePoint¶
Chaque instance d’application de connecteur doit être configurée de sorte à communiquer avec son instance Sharepoint associée. Après avoir terminé le processus d’installation, procédez comme suit.
Assurez-vous de remplir toutes les conditions préalables. Pour plus d’informations, voir Conditions préalables.
Si nécessaire, ouvrez l’assistant de configuration comme suit :
Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.
Dans le menu de navigation, sélectionnez Data Products » Apps.
Recherchez le Snowflake Connector for SharePoint et sélectionnez-le.
Configurer¶
À l’étape Configure de l’assistant, saisissez des informations dans les champs suivants :
Note
Par défaut, les champs sont définis sur les noms des objets créés lors de la configuration du connecteur. Snowflake recommande d’utiliser de nouveaux objets pour ces champs. Cependant, si nécessaire, vous pouvez spécifier les noms des objets existants (par exemple, en cas de réinstallation du connecteur).
Champ
Description
Warehouse for Ingestion Data
Identificateur d’un nouvel entrepôt virtuel dédié au connecteur. Cet entrepôt est utilisé pour calculer les tâches d’ingestion de données et de traitement des documents.
Indiquez un nom unique pour votre compte. Le nom de l’entrepôt doit être un identificateur d’objet valide.
Vous pouvez également sélectionner un entrepôt existant.
Note
Ne spécifiez pas l’entrepôt utilisé lors de la création initiale du connecteur.
Warehouse for Cortex Search :
Identificateur d’un nouvel entrepôt virtuel dédié à la Cortex Search. Cet entrepôt est utilisé pour traiter et répondre aux requêtes Cortex Search.
Indiquez un nom unique pour votre compte. Le nom de l’entrepôt doit être un identificateur d’objet valide.
Note
Ne spécifiez pas le même entrepôt que celui que vous avez sélectionné au début de l’installation du connecteur. Le processus de configuration crée un entrepôt X-Small avec le nom spécifié.
Role for Cortex Search
Identificateur d’un nouveau rôle personnalisé pour le connecteur. Indiquez un nom unique pour votre compte. Le nom du rôle doit être un identificateur d’objet valide.
Les utilisateurs qui ont accordé le rôle peuvent utiliser leur compte pour interroger l’API REST Cortex sur les données ingérées par l’application. Par défaut, seul le compte que vous avez utilisé pour installer le connecteur a l’autorisation d’interroger Cortex.
Cliquez sur Configure pour continuer.
S’authentifier et se connecter à Sharepoint¶
Important
Assurez-vous que les fenêtres contextuelles sont activées dans votre navigateur.
À l’étape Authentication de l’assistant, saisissez les informations et les identifiants de connexion suivants pour effectuer l’authentification OAuth2 et vous connecter à SharePoint.
Contactez votre administrateur de compte Azure ou Office 365 pour obtenir ces informations.
Champ
Description
SharePoint site URL
URL ou site Sharepoint à partir duquel le connecteur ingérera du contenu.
Pour les sites de niveau supérieur, utilisez uniquement le nom de domaine, par exemple
sitename.sharepoint.com
. Pour les sous-sites, utilisez un nom de domaine avec le chemin du site, par exemplesitename.sharepoint.com/sites/SubSite
.Client ID
Indiquez votre ID client. Pour en savoir plus sur l’ID client et comment le trouver dans Microsoft Entra, voir ID d’application (ID client).
Client secret
Entrez votre clé secrète client. Pour en savoir plus sur une clé secrète client et sur la façon de la trouver dans Microsoft Entra, voir Certificats et secrets.
Tenant ID
Saisissez votre ID client. Pour en savoir plus sur l’ID client et comment le trouver dans Microsoft Entra, voir Recherchez votre ID client Microsoft 365.
Cliquer Next pour démarrer le processus de connexion, qui peut prendre plusieurs minutes.
Validation de la source¶
À l’étape Validate source de l’assistant, procédez comme suit :
Sélectionnez la source à partir de laquelle vous souhaitez récupérer les fichiers :
Sélectionnez All folders si vous souhaitez récupérer des fichiers à partir de tous les dossiers accessibles via les identifiants de connexion que vous avez fournis dans S’authentifier et se connecter à Sharepoint.
Sélectionnez Specific folder si vous souhaitez récupérer des fichiers à partir d’un dossier spécifique accessible via les identifiants de connexion que vous avez fournis dans S’authentifier et se connecter à Sharepoint.
Note
Ce chemin est relatif au dossier Documents partagés. Par exemple, pour ingérer des fichiers du dossier
Shared%20Documents/user_manuals/cars
, entrezuser_manuals/cars
.
Note
Pour modifier la source du fichier de récupération ultérieurement, vous devez réinstaller le connecteur.
Cliquez sur Validate pour démarrer le processus de validation de la source, ce qui peut prendre plusieurs minutes.
Une fois votre connecteur configuré, cliquez sur Ingest files pour commencer l’ingestion de données.
Étape suivante¶
Une fois votre connecteur configuré, passez à Requête auprès du Cortex Search Service avec Snowflake Connector for SharePoint.