Créer une connexion SharePoint

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Créez une connexion Microsoft SharePoint dans l'Explorateur de catalogues pour stocker les informations d'identification d'authentification pour l'ingestion Lakeflow Connect. Tout utilisateur disposant du privilège USE CONNECTION sur la connexion peut alors créer des pipelines d'ingestion SharePoint sans avoir besoin d'un accès direct aux identifiants.

Alternativement, les utilisateurs administrateurs peuvent créer une connexion et un pipeline en même temps dans l'interface utilisateur d'ingestion de données. Voir Créer un pipeline d'ingestion.

Pour les exigences en matière de privilèges, consultez Se connecter aux sources d'ingestion gérées.

Les méthodes d'authentification suivantes sont prises en charge :

• OAuth U2M : géré par Databricks (Recommandé)

  • Aucun enregistrement d'application Azure requis. Databricks gère automatiquement OAuth et le refresh de jetons.

• OAuth U2M : géré par le client

  • Apportez votre propre enregistrement d'application Azure.

• OAuth M2M

  • Pour les pipelines de production entièrement automatisés qui s’exécutent sans interaction de l’utilisateur.

• OAuth avec refresh manuelle des jetons

  • Une méthode héritée. Non recommandé pour les nouvelles implémentations.

Prérequis

Terminez la configuration de la source qui correspond à votre méthode d'authentification choisie. Utilisez les informations d'authentification que vous obtenez pour créer la connexion.

Créer une connexion

Databricks-managed (Recommended)

Aucun enregistrement d'application Azure ni aucune configuration de la source n'est requise. Databricks gère automatiquement la configuration OAuth et le refresh des jetons.

1. Dans le Workspace Databricks, accédez à Catalogue > Créer une connexion .
2. Spécifiez un Nom de connexion unique.
3. Dans le menu déroulant Type de connexion , sélectionnez Microsoft SharePoint .
4. Dans le menu déroulant Type d'authentification , sélectionnez OAuth U2M : géré par Databricks .
5. Ajouter un commentaire (facultatif).
6. Cliquez sur Suivant .
7. Saisissez l'URL du site SharePoint.
8. Cliquez sur Se connecter et terminez l'authentification dans la fenêtre contextuelle.

Custom-managed

1. Terminez la configuration de la source U2M. Utilisez les détails d'authentification que vous obtenez pour créer la connexion.

2. Dans le workspace Databricks, cliquez sur Catalog > Créer > Créer une connexion .

3. Sur la page Principes de base de la connexion de l'assistant de configuration de la connexion , spécifiez un nom de connexion unique.

4. Dans le menu déroulant Type de connexion , sélectionnez Microsoft SharePoint .

5. Dans le menu déroulant Type d'authentification , sélectionnez OAuth .

6. Ajouter un commentaire (facultatif).

7. Cliquez sur Suivant .

8. Sur la page Authentification , saisissez les informations d'identification suivantes pour votre application Microsoft Entra ID :

   • Secret client : Le secret client que vous avez récupéré dans la configuration source.
   • Identifiant client : l'identifiant client que vous avez récupéré lors de la configuration source.
   • Domaine : L’URL de l’instance SharePoint au format suivant : https://MYINSTANCE.sharepoint.com
   • ID du tenant : L'ID du tenant que vous avez récupéré lors de la configuration de la source.

   

9. Cliquez sur Se connecter avec Microsoft SharePoint .

   Une nouvelle fenêtre s'ouvre. Une fois que vous vous êtes connecté avec vos identifiants SharePoint, les autorisations que vous accordez à l'application Entra ID s'affichent.

10. Cliquez sur Accepter .

    Un message **Autorisation accordée** s'affiche et vous êtes redirigé(e) vers le Workspace Databricks.

11. Cliquez sur Créer une connexion .

M2M

1. Terminez la configuration de la source M2M. Utilisez les détails d'authentification que vous obtenez pour créer la connexion.

2. Dans le workspace Databricks, cliquez sur Catalog > Créer > Créer une connexion .

3. Sur la page Principes de base de la connexion de l'assistant de configuration de la connexion , spécifiez un nom de connexion unique.

4. Dans le menu déroulant Type de connexion , sélectionnez Microsoft SharePoint .

5. Dans le menu déroulant Type d'authentification , sélectionnez OAuth Machine to Machine .

6. Ajouter un commentaire (facultatif).

7. Cliquez sur Suivant .

8. Sur la page Authentification , saisissez les informations d'identification suivantes pour votre application Microsoft Entra ID :

   • Secret client : Le secret client que vous avez récupéré dans la configuration source.
   • Identifiant client : l'identifiant client que vous avez récupéré lors de la configuration source.
   • Domaine : L’URL de l’instance SharePoint au format suivant : https://MYINSTANCE.sharepoint.com
   • ID du tenant : L'ID du tenant que vous avez récupéré lors de la configuration de la source.

9. Cliquez sur Se connecter avec Microsoft SharePoint .

   Une nouvelle fenêtre s'ouvre. Une fois que vous vous êtes connecté avec vos identifiants SharePoint, les autorisations que vous accordez à l'application Entra ID s'affichent.

10. Cliquez sur Accepter .

    Un message **Autorisation accordée** s'affiche et vous êtes redirigé(e) vers le Workspace Databricks.

11. Cliquez sur Créer une connexion .

Manual refresh token

1. Effectuez la configuration source de refresh de jeton manuel. Vous utiliserez les détails d'authentification que vous obtenez pour créer la connexion.

2. Dans le workspace Databricks, cliquez sur Catalog > Créer > Créer une connexion .

3. Sur la page Principes de base de la connexion de l'assistant de configuration de la connexion , spécifiez un nom de connexion unique.

4. Dans le menu déroulant Type de connexion , sélectionnez Microsoft SharePoint .

5. Dans le menu déroulant **Type d'authentification**, sélectionnez **OAuth Refresh Token**.

6. Ajouter un commentaire (facultatif).

7. Cliquez sur Suivant .

8. Sur la page Authentification , saisissez les informations d'identification suivantes pour votre application Microsoft Entra ID :

   • ID du tenant : L'ID du tenant que vous avez récupéré lors de la configuration de la source.
   • Identifiant client : l'identifiant client que vous avez récupéré lors de la configuration source.
   • Secret client : Le secret client que vous avez récupéré dans la configuration source.
   • Refresh token : Le refresh token que vous avez récupéré dans la configuration source.

   

9. Cliquez sur Créer une connexion .

attention

Ne partagez cette connexion avec d'autres utilisateurs Databricks que si vous vous êtes authentifié avec un compte de service. Si vous vous êtes authentifié avec un compte personnel, ne partagez pas la connexion. Le partage d’une connexion de compte personnel accorde à d’autres utilisateurs l’accès aux informations d’identification et aux données de votre compte personnel.

Étapes suivantes

Créer un pipeline d’ingestion.