Vous avez besoin d’un plan Builder ou supérieur pour utiliser les connecteurs dans votre application.
Ce que vous pouvez faire
Transformez vos données et vos jobs en actions et en informations dans votre application.Exécuter des notebooks et des jobs
Déclenchez des notebooks Databricks et des jobs de pipeline de données depuis votre application.
Exécuter du SQL
Lancez du SQL sur votre lakehouse et vos entrepôts SQL, et affichez les résultats dans votre application.
Créer des tableaux de bord analytiques
Transformez les requêtes Databricks en graphiques, tableaux et tableaux de bord lisibles par votre équipe.
Configurer OAuth dans Databricks
Un administrateur de compte Databricks doit créer une application OAuth personnalisée avant que vous connectiez Databricks à Base44.1
Obtenir l'URL de callback Base44
Obtenez l’URL de callback Base44 dans Enregistrer les URL de callback.
2
Créer l'application OAuth Databricks
Suivez le guide Databricks pour créer une application OAuth personnalisée.Dans Databricks, ajoutez cette URL de callback comme URI de redirection et sélectionnez All APIs.
3
Générer vos identifiants
Cliquez sur Generate a client secret, puis copiez le Client ID et le Client Secret. Databricks n’affiche le Client Secret qu’une seule fois.
Connecter Databricks
Connectez Databricks pour que votre application puisse interroger vos données.Avant de commencer :
- Application OAuth Databricks : demandez à un administrateur de compte Databricks de créer une application OAuth personnalisée et de générer un client secret. Conservez son ID client et son Secret client. Consultez Configurer OAuth dans Databricks.
- URL de l’espace de travail Databricks : préparez l’URL de votre propre espace de travail Databricks. Copiez-la depuis votre navigateur lorsque vous êtes connecté à cet espace de travail.
- Accès à l’espace de travail Base44 : vous devez être propriétaire ou administrateur de l’espace de travail pour enregistrer le connecteur dans Base44.
- Accès à Databricks : chaque personne qui se connecte doit avoir accès aux ressources de l’espace de travail Databricks utilisées par votre application.
- Cliquez sur Connecteurs dans la barre latérale de votre espace de travail.
- Cliquez sur Ajouter un connecteur.
- Recherchez Databricks, puis cliquez dessus.
- Saisissez un Nom du connecteur.
- Saisissez le ID client et le Secret client de votre application OAuth Databricks.
- Conservez les valeurs par défaut sous Scopes. Sélectionnez
sqlsi votre application exécute du SQL. Consultez Scopes et permissions. - Saisissez votre propre Databricks Workspace URL sous Configuration de connexion, par exemple
https://dbc-xxxxxxxx-xxxx.cloud.databricks.com. Elle se termine par.databricks.com,.azuredatabricks.net,.cloud.databricks.usou.cloud.databricks.mil. Copiez-la depuis votre navigateur, sans chemin ni chaîne de requête, et ne saisissez pasdatabricks.comniaccounts.cloud.databricks.com. - Cliquez sur Ajouter un connecteur.
- Ouvrez votre application dans l’éditeur d’application.
- Demandez au chat IA d’ajouter une fonctionnalité Databricks.
- Autorisez le compte lorsque cela vous est demandé.
Scopes et permissions
Vos permissions Databricks déterminent les données et les ressources de l’espace de travail que votre application peut utiliser.1
Ajoutés par Base44
all-apis: appelle les API Databricksoffline_access: actualise la connexion sans nouvelle connexion
2
Configurés par vous
sql: exécute des requêtes SQL sur les entrepôts SQL Databricks. Sélectionnez-le sous Scopes si votre application exécute du SQL.- Laissez Portées supplémentaires vide, sauf si votre application a besoin de plus.
Accès : Databricks limite la connexion aux permissions existantes de l’identité connectée dans l’espace de travail.
Utiliser Databricks dans une fonction backend
Une fois Databricks connecté, vos fonctions backend peuvent récupérer un jeton d’accès et appeler les API Databricks. Base44 gère le flux OAuth et le stockage des identifiants.- Connecteur partagé
- Connecteur utilisateur de l'application
Utilisez
getWorkspaceConnection(connectorId) quand votre application utilise une identité Databricks partagée.Connecteurs (docs développeur)
Récupérez une connexion, lisez ses détails et appelez l’API du service depuis une fonction backend.
Dépannage
Vérifiez l’URL de votre espace de travail et vos permissions Databricks si le connecteur ne parvient pas à se connecter ou à exécuter des requêtes.L'URL de l'espace de travail est refusée
L'URL de l'espace de travail est refusée
L’hôte de votre espace de travail doit se terminer par
.databricks.com, .azuredatabricks.net, .cloud.databricks.us ou .cloud.databricks.mil. Saisissez-le seul, sans chemin, par exemple adb-123456789.10.azuredatabricks.net.Les requêtes échouent avec une erreur de permissions
Les requêtes échouent avec une erreur de permissions
Chaque personne qui se connecte a besoin de
CAN_USE sur l’entrepôt SQL interrogé par votre application. Sinon, Databricks renvoie PERMISSION_DENIED. Pour une connexion utilisateur de l’application, Unity Catalog s’applique par personne. La même requête peut donc renvoyer des lignes différentes selon la personne, ou TABLE_OR_VIEW_NOT_FOUND pour quelqu’un qui n’a pas accès à une table.Une requête échoue sans ID d'entrepôt
Une requête échoue sans ID d'entrepôt
Databricks n’a pas d’entrepôt SQL par défaut. Chaque requête a donc besoin d’un ID d’entrepôt. Dans Databricks, allez dans SQL → SQL Warehouses, puis ouvrez l’entrepôt et copiez son ID.
Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la version anglaise.