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 ne fournit que le texte de la requête. Vous aurez tout de même besoin d'un accès approprié pour interroger les données. Le fait de limiter l'enregistrement au texte de la requête offre un avantage. En effet, vous pouvez ainsi partager une requête incomplète qui, même si elle n'est pas valide, pourra être utilisée par d'autres utilisateurs comme modèle à compléter ou à personnaliser.

  • 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 vers la 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. 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 la page BigQuery dans Cloud Console.

    Accéder à BigQuery

  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 de Cloud Console.

    # 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 Enregistrer la requête, saisissez un nom pour votre requête. Comme Visibilité, sélectionnez Personnel (modifiable uniquement par vous), puis cliquez sur Enregistrer.

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

Partager une requête enregistrée

Vous pouvez partager votre requête en sélectionnant une visibilité au niveau du projet ou publique. 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 de l'afficher, 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 la page BigQuery dans Cloud Console.

    Accéder à BigQuery

  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 de Cloud Console.

    # 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 Enregistrer la requête, saisissez un nom pour votre requête. Comme Visibilité, sélectionnez Projet (modifiable par les membres du projet), puis cliquez sur Enregistrer.

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

    Onglet

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

  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 en cliquant sur Partage de lien au-dessus de la zone de texte de l'éditeur de 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

  1. Ouvrez la page BigQuery dans Cloud Console.

    Accéder à BigQuery

  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 de Cloud Console.

    # 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 Enregistrer la requête, saisissez un nom pour votre requête. Comme Visibilité, sélectionnez Personnel (modifiable uniquement par vous), puis cliquez sur Enregistrer.

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

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

  8. Activez le partage de lien pour accéder au lien partageable et le copier dans le presse-papiers. Vous pouvez également accéder au lien en cliquant sur Partage de lien au-dessus de la zone de texte de l'éditeur de requête.

  9. Partagez le lien.

Mettre à jour des requêtes enregistrées

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

Console

  1. Ouvrez la page BigQuery dans Cloud Console.

    Accéder à BigQuery

  2. Cliquez sur Requêtes enregistrées dans le volet de navigation de gauche, puis sur Requêtes personnelles pour modifier une requête privée ou sur 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 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.

Supprimer des requêtes enregistrées

Pour supprimer une requête enregistrée :

Console

  1. Ouvrez la page BigQuery dans Cloud Console.

    Accéder à BigQuery

  2. Cliquez sur Requêtes enregistrées dans le volet de navigation de gauche, puis sur Requêtes personnelles pour supprimer une requête privée ou sur 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 Supprimer à droite de la requête.

    Supprimer une requête

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