Partager via

Se connecter à Preset

  • Article

Preset propose une aide à la décision moderne à l’ensemble de votre organisation. Preset fournit une plateforme puissante et facile à utiliser pour l’exploration et la visualisation des données, optimisée par Apache Superset open source.

Vous pouvez intégrer vos entrepôts Databricks SQL (anciennement points de terminaison Databricks SQL) et clusters Azure Databricks avec Preset.

Se connecter à Preset à l’aide de Partner Connect

Pour connecter votre espace de travail Azure Databricks à Préréglage à l’aide de Partner Connect, consultez l’article Se connecter à des partenaires BI à l’aide de Partner Connect.

Notes

Partner Connect ne prend en charge que les entrepôts Databricks SQL pour Preset. Pour connecter un cluster dans votre espace de travail Azure Databricks à Preset, établissez la connexion manuellement.

Se connecter à Preset manuellement

Dans cette section, vous allez connecter manuellement un entrepôt ou cluster SQL existant dans votre espace de travail Databricks à Preset.

Notes

Pour les entrepôts SQL, vous pouvez utiliser Partner Connect pour simplifier le processus de connexion.

Exigences

Pour pouvoir opérer un intégration avec Preset manuellement, vous devez disposer des éléments suivants :

  • Un cluster ou un entrepôt SQL dans votre espace de travail Azure Databricks.

  • Les détails de connexion pour votre cluster ou votre entrepôt SQL, en particulier les valeurs Nom d’hôte du serveur, Port et Chemin HTTP.

  • Un jeton d’accès personnel Azure Databricks ou un jeton Microsoft Entra ID (anciennement Azure Active Directory). Pour créer un jeton d’accès personnel, effectuez les actions suivantes :

    1. Dans votre espace de travail Azure Databricks, cliquez sur votre nom d’utilisateur Azure Databricks dans la barre supérieure, puis sélectionnez Paramètres dans la liste déroulante.
    2. Cliquez sur Développeur.
    3. À côté de Jetons d’accès, cliquez sur Gérer.
    4. Cliquez sur Générer un nouveau jeton.
    5. (Facultatif) Entrez un commentaire qui vous aide à identifier ce jeton à l’avenir et modifiez sa durée de vie par défaut (90 jours). Pour créer un jeton sans durée de vie (non recommandé), laissez vide la zone Durée de vie (en jours).
    6. Cliquez sur Générer.
    7. Copiez le jeton affiché dans un emplacement sécurisé, puis cliquez sur Terminé.

    Remarque

    Veillez à enregistrer le jeton copié dans un emplacement sécurisé. Ne partagez pas votre jeton copié avec d'autres. Si vous le perdez, vous ne pouvez pas régénérer exactement le même. Vous devez donc répéter cette procédure pour créer un jeton. Si vous perdez le jeton copié ou si vous pensez que le jeton a été compromis, Databricks vous recommande vivement de supprimer immédiatement ce jeton de votre espace de travail en cliquant sur l’icône de la corbeille (Révoquer) à côté du jeton de la page Jetons d’accès.

    Si vous n'êtes pas en mesure de créer ou d'utiliser des jetons dans votre espace de travail, cela peut être dû au fait que votre administrateur d'espace de travail a désactivé les jetons ou ne vous a pas donné l'autorisation de créer ou d'utiliser des jetons. Consultez votre administrateur d'espace de travail ou les personnes suivantes :

    Remarque

    En guise de bonne pratique de sécurité, quand vous vous authentifiez avec des outils, systèmes, scripts et applications automatisés, Databricks recommande d’utiliser des jetons d’accès personnels appartenant à des principaux de service et non des utilisateurs de l’espace de travail. Pour créer des jetons d’accès pour des principaux de service, consultez la section Gérer les jetons pour un principal de service.

Étapes de connexion

Pour établir une connexion à Preset manuellement, procédez comme suit :

  1. Créez un compte Preset ou connectez-vous à votre compte Preset existant.

  2. Cliquez sur + Workspace.

  3. Dans la boîte de dialogue Add New Workspace (Ajouter un nouvel espace de travail), entrez un nom pour l’espace de travail, sélectionnez la région la plus proche de vous, puis cliquez sur Save.

  4. Ouvrez l’espace de travail en cliquant sur sa vignette.

  5. Dans la barre d’outils, cliquez sur Catalogue>Base de données.

  6. Cliquez sur + Database.

  7. Dans la boîte de dialogue Connect a database (Connecter une base de données), dans la liste Supported Databases (Bases de données prises en charge), sélectionnez l’une des options suivantes :

    • Pour un entrepôt SQL, sélectionnez Databricks SQL Warehouse.
    • Pour un cluster, sélectionnez Databricks Interactive Cluster.

  8. Pour SQLAlchemy URI, entrez la valeur suivante :

    Pour un entrepôt SQL :

    databricks+pyodbc://token:{access token}@{server hostname}:{port}/{database name}

    Pour un cluster :

    databricks+pyhive://token:{access token}@{server hostname}:{port}/{database name}

    Remplacez :

    • {access token} par la valeur du jeton d’accès personnel Azure Databricks< ou la valeur du jeton Azure Active Directory> issue des exigences.
    • {server hostname} par la valeur Nom d’hôte du serveur issue des exigences.
    • {port} par la valeur Port issue des exigences.
    • {database name} par le nom de la base de données cible dans votre espace de travail Azure Databricks.

    Par exemple, pour un entrepôt SQL :

    databricks+pyodbc://token:dapi...@adb-1234567890123456.7.azuredatabricks.net:443/default

    Par exemple, pour un cluster :

    databricks+pyhive://token:dapi...@adb-1234567890123456.7.azuredatabricks.net:443/default

  9. Cliquez sur l’onglet Advanced, puis développez Other.

  10. Pour Engine Parameters (Paramètres du moteur), entrez la valeur suivante :

    Pour un entrepôt SQL :

    {"connect_args": {"http_path": "sql/1.0/warehouses/****", "driver_path": "/opt/simba/spark/lib/64/libsparkodbc_sb64.so"}}

    Pour un cluster :

    {"connect_args": {"http_path": "sql/protocolv1/o/****"}}

    Remplacez sql/protocolv1/o/**** par la valeur Chemin HTTP issue des exigences.

    Par exemple, pour un entrepôt SQL :

    {"connect_args": {"http_path": "sql/1.0/warehouses/ab12345cd678e901", "driver_path": "/opt/simba/spark/lib/64/libsparkodbc_sb64.so"}}

    Par exemple, pour un cluster :

    {"connect_args": {"http_path": "sql/protocolv1/o/1234567890123456/1234-567890-buyer123"}}

  11. Cliquez sur l’onglet Basic, puis sur Test Connection.

    Notes

    Pour résoudre les problèmes de connexion, consultez la procédure pas à pas de connexion de base de données pour Databricks sur le site web de Preset.

  12. Une fois la connexion réussie, cliquez sur Connect.

Étapes suivantes

Explorez une ou plusieurs des ressources suivantes sur le site web de Preset :