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 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 de requête.

Autorisations

Les autorisations 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. L'interface utilisateur Web de BigQuery vous permet d'enregistrer une requête privée dans n'importe quel projet, mais vous seul pouvez afficher, mettre à jour ou supprimer cette 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 IAM bigquery.admin prédéfini au niveau du projet 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 IAM bigquery.admin et bigquery.user prédéfinis au niveau du projet 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 IAM bigquery.admin prédéfini au niveau du projet 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 IAM bigquery.admin prédéfini au niveau du projet 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. L'interface utilisateur Web de BigQuery vous permet d'enregistrer une requête publique dans n'importe quel projet, mais vous seul pouvez mettre à jour ou supprimer cette 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 Contrôle des accès.

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 enregistrer une requête privée dans l'interface utilisateur Web de BigQuery :

  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 BigQuery dans la zone de texte Nouvelle requête. Vous pouvez utiliser l'exemple de requête fourni dans le Guide de démarrage rapide sur l'interface utilisateur Web.

    #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 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 plus d'informations, consultez la section Affecter des contrôles d'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 :

  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 BigQuery dans la zone de texte Nouvelle requête. Vous pouvez utiliser l'exemple de requête fourni dans le Guide de démarrage rapide sur l'interface utilisateur Web.

    #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 :

  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 BigQuery dans la zone de texte Nouvelle requête. Vous pouvez utiliser l'exemple de requête fourni dans le Guide de démarrage rapide sur l'interface utilisateur Web.

    #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 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 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 requête publique

  9. Partagez le lien.

Mettre à jour des requêtes enregistrées

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

  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 puis, dans la section Requêtes, cliquez sur Requêtes enregistrées (pour modifier une requête privée) ou sur 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 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 :

  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.