Premiers pas avec les réservations

Découvrez comment créer une réservation, attribuer une réservation et supprimer une réservation dans BigQuery.

Vous pouvez également souscrire un engagement. Pour en savoir plus, consultez la section Engagements.

Avant de commencer ce tutoriel, consultez la page Présentation de la gestion des charges de travail pour comprendre les concepts de base.

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

Avant de commencer

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Vous pouvez créer un projet Google Cloud distinct pour administrer la réservation et lui attribuer un nom descriptif tel que bq-COMPANY_NAME-admin.
Make sure that billing is enabled for your Google Cloud project.
Enable the BigQuery Reservation API.
Enable the API

Pour en savoir plus, consultez la section Activer l'API BigQuery Reservation.
Dans la console Google Cloud, affichez vos quotas d'emplacements :

Afficher les quotas d'emplacements

Pour acheter des emplacements, vous devez disposer d'un quota d'emplacements suffisant pour la région dans laquelle vous souhaitez effectuer l'achat d'emplacements.

Si votre quota d'emplacements pour la région souhaitée est inférieur au nombre d'emplacements que vous voulez acheter, consultez la section Demander une augmentation du quota.

Créer une réservation d'autoscaling

Créez une réservation nommée prod dans l'emplacement multirégional US et attribuez-lui un maximum de 100 emplacements d'autoscaling.

Dans la console Google Cloud, accédez à la page BigQuery.

Accéder à BigQuery
Dans le panneau de navigation, accédez à la section Gestion de la capacité.
Cliquez sur Créer une réservation.
Dans le champ Reservation name (Nom de la réservation), saisissez prod.
Dans la liste déroulante Emplacement, sélectionnez us (plusieurs régions aux États-Unis).
Dans la liste Édition, sélectionnez Standard. Pour en savoir plus, consultez la page Comprendre les éditions BigQuery.
Dans le champ Sélecteur de taille de réservation maximale, sélectionnez Petite (100 emplacements).
Conservez les autres paramètres par défaut, puis cliquez sur Enregistrer.

Pour savoir comment créer une réservation à l'aide de SQL ou de l'outil bq, consultez la section Créer une réservation avec des emplacements dédiés.

Attribuer un projet à une réservation

Attribuez un projet à la réservation prod. Toutes les tâches de requête exécutées à partir de ce projet utilisent le nombre d'emplacements de la réservation prod. (Dans ce tutoriel, vous n'exécutez pas de tâche.)

Vous pouvez attribuer n'importe quel projet situé dans la même organisation et la même région que le projet d'administration dans lequel vous avez créé la réservation

Dans la console Google Cloud, accédez à la page BigQuery.

Accéder à BigQuery
Dans le panneau de navigation, accédez à la section Gestion de la capacité.
Cliquez sur l'onglet Réservations d'emplacements.
Dans la colonne Actions de la réservation nommée prod, cliquez sur Actions.
Cliquez sur Créer une attribution.
Dans la section Sélectionner une organisation, un dossier ou un projet, cliquez sur Parcourir.
Recherchez le projet, puis sélectionnez-le.
Cliquez sur Créer.

Lorsque vous créez une attribution de réservation, attendez au moins cinq minutes avant d'exécuter une requête. Sinon, la requête risque d'être facturée au tarif à la demande.

Pour savoir comment attribuer un projet à une réservation à l'aide de SQL ou de l'outil bq, consultez la section Attribuer un projet ou un dossier à une réservation.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

Supprimer le projet

Le moyen le plus simple d'empêcher la facturation est de supprimer le projet que vous avez créé pour ce tutoriel.

Pour supprimer le projet :

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Supprimer la réservation

Lorsque vous supprimez une réservation, toutes les tâches en cours d'exécution avec des emplacements de cette réservation échouent. Pour éviter les erreurs, exécutez les tâches en cours de transfert avant de supprimer la réservation.

Dans la console Google Cloud, accédez à la page BigQuery.

Accéder à BigQuery
Dans le panneau de navigation, accédez à la section Gestion de la capacité.
Cliquez sur l'onglet Réservations d'emplacements.
Pour la réservation nommée prod, cliquez sur Développer/réduire le nœud.
Pour chaque attribution de cette réservation, cliquez sur Actions, puis sur Supprimer.
Dans la colonne Actions de la réservation nommée prod, cliquez sur Actions.
Cliquez sur Supprimer.

Pour savoir comment supprimer une réservation à l'aide de SQL ou de l'outil bq, consultez la section Supprimer une réservation.

Étapes suivantes

Pour savoir comment gérer les charges de travail en utilisant les réservations BigQuery, consultez la page Gérer la charge de travail en utilisant des réservations.