Accédez et gérez les requêtes enregistrées

Cet article explique comment utiliser l'interface utilisateur de Databricks pour accéder aux requêtes et les gérer.

Afficher les requêtes

Vous pouvez afficher les requêtes en utilisant les méthodes suivantes :

• Cliquez sur **Workspace** dans la barre latérale. Les requêtes sont consultables, par default, dans le dossier Accueil . Les utilisateurs peuvent organiser les requêtes dans des dossiers dans le navigateur de Workspace ainsi que d'autres objets Databricks.
• Cliquez sur Requêtes dans la barre latérale. Les objets dans les fenêtres Requêtes sont triés par ordre chronologique inverse par default. Vous pouvez réorganiser la liste en cliquant sur l'en-tête de colonne Date de création . Tapez dans la zone de texte Filtrer les requêtes pour filtrer par nom, tag ou propriétaire.

Organisez les requêtes dans des dossiers dans le navigateur de Workspace.

Vous pouvez organiser des queries en dossiers dans le navigateur de workspace et d'autres objets Databricks. Consultez le navigateur Workspace.

Transférer la propriété d'une query

Vous devez être administrateur du Workspace pour transférer la propriété d’une query. Les Service principals et les groupes ne peuvent pas se voir attribuer la propriété d’une query. Vous pouvez également transférer la propriété à l’aide de l’ API de permissions.

1. En tant qu'administrateur de l'espace de travail, connectez-vous à votre Workspace Databricks.

2. Dans la barre latérale, cliquez sur **Queries**.

3. Cliquez sur une requête.

4. Cliquez sur le bouton « Partager » en haut à droite pour ouvrir la boîte de dialogue de partage.

5. Cliquez sur l'icône en forme d'engrenage en haut à droite, puis cliquez sur Désigner un nouveau propriétaire .

   

6. Sélectionnez l'utilisateur à qui attribuer la propriété.

7. Cliquez sur Confirmer .

Configurer les autorisations de query

Les administrateurs du Workspace et le créateur de la query se voient automatiquement accorder les autorisations nécessaires pour contrôler quels utilisateurs peuvent gérer et exécuter des queries. Vous devez disposer au minimum de l'autorisation CAN MANAGE sur une query pour partager des queries.

Les query prennent en charge deux types de paramètres de partage :

• Exécuter en tant qu'invité : Les identifiants du visionneur sont utilisés pour exécuter la requête. Le visionneur doit également disposer au moins de l'autorisation CAN USE sur le warehouse. Dans l'éditeur SQL hérité, les utilisateurs ne peuvent se voir accorder la permission CAN EDIT que lorsque le paramètre de partage est défini sur Exécuter en tant qu'invité .
• **Exécuter en tant que propriétaire** : Dans le nouvel éditeur SQL, l'identifiant du propriétaire est utilisé pour les alertes héritées et les Lakeflow Jobs. L'identifiant du spectateur est toujours utilisé pour exécuter la query. Dans l'éditeur SQL hérité, les informations d'identification du propriétaire sont utilisées pour exécuter la query.

Pour plus d'informations sur les niveaux d'autorisation des query, consultez les ACL de query.

1. Dans la barre latérale, cliquez sur **Queries**.

2. Cliquez sur une requête.

3. Cliquez sur le bouton en haut à droite pour ouvrir la boîte de dialogue Partage .

   

4. Suivez les étapes en fonction du type d'autorisation que vous souhaitez accorder :

5. Recherchez et sélectionnez les groupes et les utilisateurs, et attribuez le niveau d'autorisation.

6. Cliquez sur **Ajouter**.

7. Dans le champ Paramètres de partage > Identifiants en bas, sélectionnez Exécuter en tant que visionneur ou Exécuter en tant que propriétaire .

Vous pouvez également copier le Link vers la query dans la boîte de dialogue Partage.

Accès administrateur à toutes les query

Un utilisateur administrateur de Workspace Databricks a un accès en lecture à toutes la query du Workspace. Lorsque l'onglet **Toutes les queries** est sélectionné, un administrateur du workspace peut visualiser et supprimer n'importe quelle query. Cependant, un administrateur de workspace ne peut pas modifier une query lorsque les informations d'identification de partage sont définies sur Exécuter en tant que propriétaire .

Pour afficher toutes les requêtes :

1. Cliquez sur Requêtes dans la barre latérale.
2. Cliquez sur l'onglet **Toutes les query** en haut de l'écran.

Création de query dans d'autres environnements

Vous pouvez créer des queries sans utiliser l'interface utilisateur de Databricks, en utilisant l'API REST, un connecteur JDBC/ODBC ou un outil partenaire.

Consultez les connecteurs, les bibliothèques, les drivers, les APIs et les outils SQL pour exécuter des commandes SQL et parcourir les objets de base de données dans Databricks.

Vous pouvez également créer une query avec le fournisseur Databricks Terraform et databricks_sql_query.

Consultez les partenaires technologiques pour en savoir plus sur les outils partenaires que vous pouvez utiliser via Partner Connect.