Enregistrer et partager des requêtes

Cette page décrit comment enregistrer et partager des requêtes. Les requêtes enregistrées ou partagées ne contiennent que la requête proprement dite. Par conséquent :

  • Une requête partagée fournit uniquement le texte de la requête. Vous avez toujours besoin d'un accès approprié pour interroger les données. L'enregistrement limité au texte de la requête a pour principal intérêt de vous permettre de partager une requête qui, même incomplète et non valide, pourra être utilisée comme modèle à compléter ou à personnaliser par d'autres utilisateurs.

  • La seule option de requête conservée dans une requête enregistrée concerne la version SQL, qui détermine si la requête utilise l'ancien SQL ou le SQL standard.

Trois types de visibilité sont disponibles pour les requêtes enregistrées :

  • Privé : les requêtes enregistrées privées ne sont visibles que par l'utilisateur qui les a créées.
  • Projet : les requêtes enregistrées au niveau du projet sont visibles par les membres détenteurs des rôles Cloud IAM BigQuery prédéfinis possédant les autorisations requises.
  • Public : les requêtes enregistrées publiques sont visibles par toute personne disposant du lien vers la requête.

Permissions

Les autorisations Cloud IAM suivantes sont requises pour créer, afficher, mettre à jour ou supprimer des requêtes enregistrées :

  • Requêtes enregistrées privées :
    • La création de requêtes enregistrées privées ne nécessite pas d'autorisation particulière. Vous pouvez enregistrer une requête privée dans n'importe quel projet, mais vous seul pouvez afficher, mettre à jour ou supprimer la requête.
  • Requêtes enregistrées au niveau du projet :
    • La création d'une requête enregistrée au niveau du projet requiert l'autorisation bigquery.savedqueries.create. Le rôle bigquery.admin prédéfini comprend cette autorisation bigquery.savedqueries.create.
    • L'affichage d'une requête enregistrée au niveau du projet requiert les autorisations bigquery.savedqueries.get et bigquery.savedqueries.list. Les rôles bigquery.admin et bigquery.user prédéfinis comprennent ces autorisations bigquery.savedqueries.get et bigquery.savedqueries.list.
    • La mise à jour d'une requête enregistrée au niveau du projet requiert l'autorisation bigquery.savedqueries.update. Le rôle bigquery.admin prédéfini comprend cette autorisation bigquery.savedqueries.update.
    • La suppression d'une requête enregistrée au niveau du projet requiert l'autorisation bigquery.savedqueries.delete. Le rôle bigquery.admin prédéfini comprend cette autorisation bigquery.savedqueries.delete.
  • Requêtes enregistrées publiques :
    • La création de requêtes publiques ne nécessite pas d'autorisation particulière. Vous pouvez enregistrer une requête publique dans n'importe quel projet, mais vous seul pouvez mettre à jour ou supprimer la requête. Toute personne disposant du lien peut afficher une requête enregistrée publique.

Pour en savoir plus sur les rôles IAM dans BigQuery, consultez la page Rôles et autorisations prédéfinis.

Créer une requête enregistrée privée

Lorsque vous enregistrez une requête en définissant le mode de visibilité sur Privé, vous seul pouvez afficher, mettre à jour ou supprimer cette requête.

Pour créer une requête partagée privée :

Console

  1. Ouvrez l'UI Web de BigQuery dans la console GCP.
    Accéder à la console GCP

  2. Cliquez sur Saisir une nouvelle requête.

  3. Saisissez une requête SQL valide dans la zone de texte de l'éditeur de requête. Vous pouvez utiliser l'exemple de requête fourni dans le Guide de démarrage rapide sur l'interface utilisateur Web.

    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Cliquez sur Enregistrer la requête.

  5. Dans la boîte de dialogue Save query (Enregistrer la requête), saisissez un nom pour votre requête. Sélectionnez Personal (editable only by you) (Personnel (modifiable uniquement par vous)) pour Visibility (Visibilité), puis cliquez sur Save (Enregistrer).

    Enregistrer une requête privée

  6. Pour afficher votre requête enregistrée, cliquez sur Requêtes enregistrées. La page Requêtes personnelles doit s'ouvrir par défaut.

  7. Cliquez sur le nom de votre requête enregistrée pour développer celle-ci.

  8. Cliquez sur Partager l'URL de la requête pour accéder à un lien que vous pouvez partager et copier dans le presse-papiers. Vous pouvez également accéder au lien via l'icône bouton Partage par lien située au-dessus de la zone de texte de l'éditeur de requête.

  9. Partagez le lien avec un autre membre de votre équipe.

UI classique

  1. Accédez à l'interface utilisateur Web de BigQuery.
    Accéder à l'UI Web de BigQuery

  2. Cliquez sur Saisir une requête.

  3. Saisissez une requête SQL dans la zone de texte Nouvelle requête. Par exemple, vous pouvez utiliser la requête du démarrage rapide de l'interface utilisateur Web classique.

    #standardSQL
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Cliquez sur Enregistrer la requête pour ouvrir la boîte de dialogue Enregistrer la requête.

  5. Dans la boîte de dialogue Save query (Enregistrer la requête), saisissez un nom pour la requête que vous enregistrez, laissez le champ Visibility (Visibilité) défini sur Private (Visible only to you) (Privé (visible uniquement pour vous), puis cliquez sur OK.

    Boîte de dialogue "Enregistrer la requête"

  6. Pour afficher votre requête enregistrée, assurez-vous que l'option Query History (Historique des requêtes) est sélectionnée dans le volet de navigation de gauche et cliquez sur Saved Queries (Requêtes enregistrées) dans la section Queries (Requêtes).

    Enregistrer la liste des requêtes

Partager une requête enregistrée

Pour partager une requête, définissez sa visibilité sur Projet ou sur Public lorsque vous l'enregistrez. La visibilité "Projet" permet aux membres des rôles Cloud IAM BigQuery prédéfinis de disposer des autorisations requises pour afficher, mettre à jour ou supprimer la requête.

La visibilité "Public" permet à tout utilisateur disposant du lien de la requête d'afficher celle-ci, mais pas de la mettre à jour ni de la supprimer. Pour exécuter la requête, les utilisateurs doivent avoir accès aux données auxquelles la requête est appelée à accéder. Pour en savoir plus, consultez la page Contrôler l'accès aux ensembles de données.

Lorsque vous partagez une requête, pensez à inclure un commentaire décrivant cette requête, comme dans l'exemple fourni plus avant.

Créer une requête enregistrée au niveau du projet

Pour partager une requête avec un autre membre de votre projet :

Console

  1. Ouvrez l'UI Web de BigQuery dans la console GCP.
    Accéder à la console GCP

  2. Cliquez sur Saisir une nouvelle requête.

  3. Saisissez une requête SQL BigQuery valide dans la zone de texte de l'éditeur de requête. Vous pouvez utiliser l'exemple de requête fourni dans le Guide de démarrage rapide sur l'interface utilisateur Web.

    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Cliquez sur Enregistrer la requête.

  5. Dans la boîte de dialogue Save query (Enregistrer la requête), saisissez un nom pour votre requête. Sélectionnez Project (editable by project members) (Projet (modifiable par les membres du projet)) pour Visibility (Visibilité), puis cliquez sur Save (Enregistrer).

    Enregistrer une requête de projet

  6. Pour afficher votre requête enregistrée, cliquez sur Requêtes enregistrées dans le volet de navigation de gauche, puis cliquez sur Project queries (Requêtes du projet).

    Onglet Requêtes du projet

  7. Cliquez sur le nom de votre requête enregistrée pour développer celle-ci.

  8. Cliquez sur Partager l'URL de la requête pour accéder à un lien que vous pouvez partager et copier dans le presse-papiers. Vous pouvez également accéder au lien via l'icône bouton Partage par lien située au-dessus de la zone de texte de l'éditeur de requête.

  9. Partagez le lien avec un autre membre de votre équipe.

UI classique

  1. Accédez à l'interface utilisateur Web de BigQuery.
    Accéder à l'interface utilisateur Web de BigQuery

  2. Cliquez sur Saisir une requête.

  3. Saisissez une requête SQL dans la zone de texte Nouvelle requête. Par exemple, vous pouvez utiliser la requête du démarrage rapide de l'interface utilisateur Web classique.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Cliquez sur Enregistrer la requête pour ouvrir la boîte de dialogue Enregistrer la requête.

  5. Dans la boîte de dialogue Save Query (Enregistrer la requête), saisissez un nom pour la requête que vous enregistrez, définissez le champ Visibility (Visibilité) sur Project (Project members can view and edit) (Projet [affichage et modification par les membres du projet]), puis cliquez sur OK.

    Partager requête projet

  6. Pour afficher votre requête enregistrée, assurez-vous que l'option Query History (Historique des requêtes) est sélectionnée dans le volet de navigation de gauche et cliquez sur Project Queries (Requêtes de projet) dans la section Queries (Requêtes).

    Liste requêtes projet

  7. Cliquez sur le nom de votre requête enregistrée pour développer celle-ci.

    Requête projet développée

  8. Cliquez sur Partager le lien pour accéder au lien partageable et le copier dans le presse-papiers.

    Lien de partage requête projet

    Vous pouvez également accéder à ce lien via l'icône de lien située au-dessus de la zone de texte Nouvelle requête.

    Icône de lien requête

  9. Partagez le lien avec un autre membre de votre équipe.

Créer une requête enregistrée publique

Pour partager une requête avec tous les utilisateurs :

Console

Actuellement, il n'est pas possible de créer une requête enregistrée publique à l'aide de la console GCP.

UI classique

  1. Accédez à l'interface utilisateur Web de BigQuery.
    Accéder à l'interface utilisateur Web de BigQuery

  2. Cliquez sur Saisir une requête.

  3. Saisissez une requête SQL dans la zone de texte Nouvelle requête. Par exemple, vous pouvez utiliser la requête du démarrage rapide de l'interface utilisateur Web classique.

    #standardSQL
    # Find highest birth weights
    SELECT
     weight_pounds, state, year, gestation_weeks
    FROM
     `bigquery-public-data.samples.natality`
    ORDER BY weight_pounds DESC LIMIT 10
  4. Cliquez sur Enregistrer la requête pour ouvrir la boîte de dialogue Enregistrer la requête.

  5. Dans la boîte de dialogue Save Query (Enregistrer la requête), saisissez un nom pour la requête que vous enregistrez, définissez le champ Visibility (Visibilité) sur Public (Anyone with the link can view, but not edit) (Public [toute personne disposant du lien peut afficher, mais pas modifier]), puis cliquez sur OK.

    Partager une requête publique

  6. Pour afficher votre requête enregistrée, assurez-vous que l'option Query History (Historique des requêtes) est sélectionnée dans le volet de navigation de gauche et cliquez sur Saved Queries (Requêtes enregistrées) dans la section Queries (Requêtes).

    Liste de requêtes enregistrées publiques

  7. Cliquez sur le nom de votre requête publique enregistrée pour développer celle-ci.

    Requête publique développée

  8. Cliquez sur Share Link (Partager le lien) pour accéder au lien partageable et le copier dans le presse-papiers.

    Lien de partage requête publique

    Vous pouvez également accéder à ce lien via l'icône de lien située au-dessus de la zone de texte Nouvelle requête.

    Icône de lien de requête publique

  9. Partagez le lien.

Mettre à jour des requêtes enregistrées

Pour mettre à jour une requête enregistrée :

Console

  1. Ouvrez l'UI Web de BigQuery dans la console GCP.
    Accéder à la console GCP

  2. Cliquez sur Requêtes enregistrées dans le volet de navigation de gauche, puis cliquez sur Personal queries (Requêtes personnelles) pour modifier une requête privée ou sur Project Queries (Requêtes du projet) pour modifier une requête au niveau du projet. Cliquez sur la requête souhaitée pour la développer.

  3. À droite de la requête, cliquez sur Open query in editor (Ouvrir la requête dans l'éditeur).

    Mettre à jour une requête

  4. Modifiez la requête.

  5. Cliquez sur Enregistrer la requête pour la mettre à jour sans changer son nom. Si vous souhaitez modifier son nom, cliquez sur la flèche vers le bas en regard de Enregistrer la requête. Choisissez Enregistrer sous, puis apportez les modifications nécessaires dans la boîte de dialogue.

UI classique

  1. Accédez à l'interface utilisateur Web de BigQuery.
    Accéder à l'UI Web de BigQuery

  2. Cliquez sur Query History (Historique des requêtes) dans le volet de navigation de gauche puis, dans la section Queries (Requêtes), cliquez sur Saved Queries (Requêtes enregistrées) (pour modifier une requête privée) ou sur Project Queries (Requêtes de projet) (pour modifier une requête enregistrée au niveau du projet ou publique).

    Liste requêtes projet

  3. Sur la droite de la requête, cliquez sur Modifier la requête.

    Bouton Modifier la requête

  4. Modifiez la requête.

  5. Cliquez sur Enregistrer la requête pour ouvrir la boîte de dialogue Enregistrer la requête.

  6. Dans la boîte de dialogue Enregistrer la requête, laissez le nom inchangé et cliquez sur OK.

Supprimer des requêtes enregistrées

Pour supprimer une requête enregistrée :

Console

  1. Ouvrez l'UI Web de BigQuery dans la console GCP.
    Accéder à la console GCP

  2. Cliquez sur Requêtes enregistrées dans le volet de navigation de gauche, puis cliquez sur Personal queries (Requêtes personnelles) pour supprimer une requête privée ou sur Project Queries (Requêtes du projet) pour supprimer une requête au niveau du projet. Cliquez sur la requête souhaitée pour la développer.

  3. Cliquez sur Delete (Supprimer) à droite de la requête.

    Supprimer une requête

  4. Lorsque vous y êtes invité, cliquez sur Supprimer pour confirmer.

UI classique

  1. Accédez à l'interface utilisateur Web de BigQuery.
    Accéder à l'interface utilisateur Web de BigQuery

  2. Cliquez sur Historique des requêtes dans le volet de navigation de gauche.

  3. Sur la droite de la requête, cliquez sur le bouton Supprimer la requête enregistrée (X).

  4. Lorsque vous y êtes invité, cliquez sur OK pour confirmer.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.