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 seulement le texte de la requête. Vous aurez tout de même besoin d'un accès approprié pour interroger les données. L'avantage de limiter l'enregistrement au texte de la requête est que cela vous permet de partager une requête incomplète qui, même si elle n'est pas 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.
  • Au niveau du 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.

Autorisations

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 nécessite des autorisations bigquery.savedqueries.create. Le rôle bigquery.admin prédéfini comprend ces autorisations bigquery.savedqueries.create.
    • L'affichage d'une requête enregistrée au niveau du projet nécessite 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 nécessite les autorisations bigquery.savedqueries.update. Le rôle bigquery.admin prédéfini comprend ces autorisations bigquery.savedqueries.update.
    • La suppression d'une requête enregistrée au niveau du projet nécessite les autorisations bigquery.savedqueries.delete. Le rôle bigquery.admin prédéfini comprend ces autorisations 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 Cloud Console.
    Accéder à Cloud Console

  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. Par exemple, vous pouvez utiliser la requête fournie dans le guide de démarrage rapide à l'aide de 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 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'UI 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 fournie dans le guide de démarrage rapide à l'aide 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 le nom de votre requête enregistrée, laissez le champ Visibility (Visibilité) défini sur Private (Visible only to you) (Privé (visible uniquement par vous)), puis cliquez sur OK.

    Boîte de dialogue

  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 Cloud Console.
    Accéder à Cloud Console

  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. Par exemple, vous pouvez utiliser la requête fournie dans le guide de démarrage rapide à l'aide de 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 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'UI 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 fournie dans le guide de démarrage rapide à l'aide 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 le nom de votre requête enregistrée, définissez le champ Visibility (Visibilité) sur Project (Project members can view and edit) (Projet (les membres du projet peuvent l'afficher et le modifier)), 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 Cloud Console.

UI classique

  1. Accédez à l'UI 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 fournie dans le guide de démarrage rapide à l'aide 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 le nom de votre requête enregistrée, définissez le champ Visibility (Visibilité) sur Public (Anyone with the link can view, but not edit) (Publique (toutes les personnes disposant du lien peuvent consulter la requête, mais ne peuvent pas la modifier)), puis cliquez 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 Cloud Console.
    Accéder à Cloud Console

  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'UI 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 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 Cloud Console.
    Accéder à Cloud Console

  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'UI Web de BigQuery.
    Accéder à l'UI 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 l'action.