Package google.cloud.bigquery.reservation.v1beta1

Index

ReservationService

Cette API permet aux utilisateurs de gérer leurs réservations BigQuery aux tarifs forfaitaires.

Une réservation fournit aux utilisateurs des ressources de calcul garanties sous la forme d'emplacements. Un emplacement est une unité de capacité de calcul dans BigQuery, qui sert d'unité de base pour le parallélisme. Dans le cadre de l'analyse d'une table comportant plusieurs partitions, un emplacement donné travaille sur une partition unique de la table. Une ressource de réservation existe en tant que ressource enfant du projet et de l'emplacement d'administration, par exemple : projects/myproject/locations/US/reservations/reservationName.

Un engagement de capacité est une solution permettant d'acheter de la capacité de calcul pour des tâches BigQuery (sous la forme d'emplacements) avec une période d'engagement d'utilisation. Une ressource d'engagement de capacité existe en tant que ressource enfant du projet et de l'emplacement d'administration, par exemple : projects/myproject/locations/US/capacityCommitments/id.

CreateAssignment

rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment)

Renvoie google.rpc.Code.PERMISSION_DENIED si l'utilisateur ne dispose pas des autorisations "bigquery.admin" sur le projet utilisant la réservation et sur le projet propriétaire de cette réservation. Renvoie google.rpc.Code.INVALID_ARGUMENT lorsque l'emplacement de l'attribution ne correspond pas à celui de la réservation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

CreateReservation

rpc CreateReservation(CreateReservationRequest) returns (Reservation)

Crée une ressource de réservation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

DeleteAssignment

rpc DeleteAssignment(DeleteAssignmentRequest) returns (Empty)

Supprime une attribution. Aucune expansion n'a lieu. Par exemple, si organisationA contient les projets projet1 et projet2, qu'il existe une réservation res1, et que CreateAssignment a été préalablement appelée pour créer explicitement les attributions suivantes : <organisationA, res1> <projet1, res1>, alors la suppression de <organisationA, res1> n'aura aucun impact sur <projet1, res1>. Après la suppression de <organisationA, res1>, les requêtes provenant du projet1 continueront à utiliser res1, tandis que les requêtes provenant du projet2 utiliseront le mode à la demande.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

DeleteCapacityCommitment

rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) returns (Empty)

Supprime un engagement de capacité. Toute tentative de suppression d'un engagement de capacité avant son heure de fin (engagement_end_time) échoue avec le code d'erreur google.rpc.Code.FAILED_PRECONDITION.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

DeleteReservation

rpc DeleteReservation(DeleteReservationRequest) returns (Empty)

Supprime une réservation. Renvoie google.rpc.Code.FAILED_PRECONDITION lorsque la réservation comporte des attributions.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetBiReservation

rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation)

Récupère une réservation BI.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetCapacityCommitment

rpc GetCapacityCommitment(GetCapacityCommitmentRequest) returns (CapacityCommitment)

Renvoie les informations concernant l'engagement de capacité.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

GetReservation

rpc GetReservation(GetReservationRequest) returns (Reservation)

Renvoie les informations concernant la réservation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

ListAssignments

rpc ListAssignments(ListAssignmentsRequest) returns (ListAssignmentsResponse)

Répertorie les attributions. Seules les attributions créées explicitement sont renvoyées. Par exemple, si organisationA contient les projets projet1 et projet2, qu'il existe une réservation res1, et que CreateAssignment a été préalablement appelée pour créer explicitement les attributions suivantes : <organisationA, res1> <projet1, res1>, alors l'API décrite ici renvoie uniquement les deux attributions créées pour la réservation res1, et aucune fusion ou expansion n'est réalisée. Le caractère générique "-" peut être utilisé pour les réservations dans la requête. Dans ce cas, la méthode répertorie toutes les attributions appartenant au projet et à l'emplacement spécifiés. Notez que "-" ne peut être utilisé ni pour les projets, ni pour les emplacements.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

ListCapacityCommitments

rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) returns (ListCapacityCommitmentsResponse)

Répertorie tous les engagements de capacité pour le projet d'administration.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

ListReservations

rpc ListReservations(ListReservationsRequest) returns (ListReservationsResponse)

Répertorie toutes les réservations associées au projet à l'emplacement spécifié.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

MergeCapacityCommitments

rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) returns (CapacityCommitment)

Fusionne les engagements de capacité du même forfait en un seul. L'engagement de capacité qui en résulte possède l'heure de fin d'engagement (commitment_end_time) la plus élevée parmi les deux. Toute tentative de fusion des engagements de capacité d'un forfait différent échouera avec le code d'erreur google.rpc.Code.FAILED_PRECONDITION.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

MoveAssignment

rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment)

Déplace une attribution vers une nouvelle réservation. Il est possible de réaliser cette opération manuellement en supprimant l'attribution existante puis en créant une nouvelle attribution associée à la nouvelle réservation. Toutefois, cette méthode constitue une solution transactionnelle, qui permet de s'assurer que le détenteur de l'attribution possède toujours une réservation associée. Sans cette méthode, certaines requêtes peuvent se voir exécutées à la demande, ce qui est un comportement inattendu.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

SearchAssignments

rpc SearchAssignments(SearchAssignmentsRequest) returns (SearchAssignmentsResponse)

Recherche les attributions d'une ressource spécifiée pour une région spécifique. Si la requête porte sur un projet : 1) La méthode renvoie les attributions créées pour le projet, s'il en existe. 2) Sinon, elle renvoie les attributions créées pour l'ancêtre le plus proche. 3) Elle renvoie toutes les attributions correspondant à différents types de tâches JobTypes. La même logique s'applique si la requête porte sur un dossier. Si la requête concerne une organisation, la méthode renvoie les attributions créées au niveau de l'organisation (celle-ci ne possède pas d'ancêtre). Par rapport à la méthode ListAssignments, il existe des différences de comportement : 1) Cette API valide l'autorisation du détenteur de l'attribution. 2) Elle effectue une recherche hiérarchique (projet -> dossier -> organisation). 3) Le parent est ici projects/*/locations/*, au lieu de projects/*/locations/*reservations/*. Notez que "-" ne peut être utilisé ni pour les projets, ni pour les emplacements.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

SplitCapacityCommitment

rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) returns (SplitCapacityCommitmentResponse)

Répartit l'engagement de capacité en deux engagements du même forfait ayant une valeur de propriété commitment_end_time identique. Pour ce faire, il est fréquent de passer à un forfait inférieur. Par exemple, pour passer de 10 000 à 8 000 emplacements, répartissez 10 000 engagements de capacité en 2000 et 8000 engagements de capacité. Modifiez ensuite le forfait du premier en forfait modulable, puis supprimez-le.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

UpdateBiReservation

rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation)

Met à jour une réservation BI. Seuls les champs spécifiés par le masque de champ field_mask sont mis à jour. Une réservation BI unique possède toujours une taille de 0 par défaut. Pour réserver une capacité BI, vous devez lui attribuer une valeur supérieure à 0. Pour libérer la capacité BI, la taille de réservation doit être définie sur 0.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

UpdateCapacityCommitment

rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) returns (CapacityCommitment)

Met à jour un engagement de capacité existant.

Seuls les champs "plan" et "renewal_plan" peuvent être mis à jour. Un forfait ne peut être remplacé que par un forfait avec une période d'engagement plus longue. Toute tentative de remplacement par un forfait avec une période d'engagement plus courte échoue avec le code d'erreur google.rpc.Code.FAILED_PRECONDITION.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

UpdateReservation

rpc UpdateReservation(UpdateReservationRequest) returns (Reservation)

Met à jour une ressource de réservation existante.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la section Présentation de l'authentification.

Assignment

Un objet Assignment (attribution) permet à un projet d'envoyer des tâches d'un certain type utilisant des emplacements de la réservation spécifiée.

Champs
name

string

Uniquement en sortie. Nom de la ressource. Exemple : projects/myproject/locations/US/reservations/team1-prod/assignments/123.

assignee

string

La ressource qui utilisera la réservation. Par exemple : projects/myproject, folders/123, organizations/456.

job_type

JobType

Type de tâche qui utilisera la réservation.

state

State

Uniquement en sortie. État de l'attribution.

JobType (Type de tâche)

Types de tâches, qui peuvent être spécifiés lors de l'utilisation de la réservation.

Enums
JOB_TYPE_UNSPECIFIED Type non valide. Les requêtes comportant cette valeur seront rejetées avec le code d'erreur google.rpc.Code.INVALID_ARGUMENT.
PIPELINE Des tâches de pipeline (chargement/exportation) du projet vont utiliser la réservation.
QUERY Des tâches de requêtes liées au projet vont utiliser la réservation.

État

L'attribution restera à l'état "PENDING" (EN ATTENTE) si aucun engagement de capacité actif n'est présent. Elle devient ACTIVE dès qu'un engagement de capacité devient actif.

Enums
STATE_UNSPECIFIED Valeur d'état non valide.
PENDING Les requêtes de la personne responsable sont exécutées à la demande, si l'attribution associée est en attente.
ACTIVE L'attribution est prête.

BiReservation

Représente une réservation BI.

Champs
name

string

Nom de ressource de la réservation BI unique. Les noms de réservation sont au format projects/{project_id}/locations/{location_id}/bireservation.

update_time

Timestamp

Uniquement en sortie. Horodatage de la dernière mise à jour d'une réservation.

size

int64

Taille d'une réservation, en octets.

CapacityCommitment

Un engagement de capacité est une solution permettant d'acheter de la capacité de calcul pour des tâches BigQuery (sous la forme d'emplacements) avec une période d'engagement d'utilisation. Les engagements annuels sont renouvelés par défaut. Les engagements peuvent être supprimés une fois leur heure de fin d'engagement dépassée. Pour qu'un engagement annuel puisse être annulé, son forfait doit d'abord être modifié sur une base mensuelle ou flexible.

Une ressource d'engagement de capacité existe en tant que ressource enfant du projet d'administration.

Champs
name

string

Uniquement en sortie. Nom de ressource de l'engagement de capacité, par exemple : projects/myproject/locations/US/capacityCommitments/123

slot_count

int64

Nombre d'emplacements figurant dans cet engagement.

plan

CommitmentPlan

Forfait de l'engagement de capacité.

state

State

Uniquement en sortie. État de l'engagement.

commitment_end_time

Timestamp

Uniquement en sortie. Fin de la période d'engagement en cours. Elle ne s'applique qu'aux engagements de capacité actifs (état ACTIVE).

failure_status

Status

Uniquement en sortie. Indique le motif de l'échec pour un forfait d'engagement à l'état FAILED.

renewal_plan

CommitmentPlan

Forfait vers lequel cet engagement de capacité est converti une fois la propriété commitment_end_time transmise. Après modification du forfait, la période d'engagement est prolongée conformément à celui-ci. Ne s'applique qu'aux engagements ANNUELS.

CommitmentPlan

Le forfait définit la période d'engagement en cours. L'engagement de capacité ne peut pas être supprimé au cours de cette période.

Enums
COMMITMENT_PLAN_UNSPECIFIED Valeur de forfait non valide. Les requêtes comportant cette valeur seront rejetées avec le code d'erreur google.rpc.Code.INVALID_ARGUMENT.
FLEX Les engagements modulables ne peuvent pas être supprimés dans la minute suivant leur activation (état ACTIVE). Passé ce délai, ils ne sont plus soumis à une période d'engagement et peuvent être supprimés à tout moment.
TRIAL Les engagements d'essai ne peuvent pas être supprimés dans les 182 jours suivant leur activation (état ACTIVE). Ils sont ensuite convertis en un nouvel engagement basé sur le plan de renouvellement (valeur renewalPlan). Par défaut, la valeur renewalPlan de l'engagement d'essai est Flex, ce qui permet de la supprimer juste après la fin de la période d'engagement.
MONTHLY Les engagements mensuels ne peuvent pas être supprimés dans les 30 jours suivant leur activation (état ACTIVE). Passé ce délai, ils ne sont plus soumis à une période d'engagement et peuvent être supprimés à tout moment.
ANNUAL Les engagements annuels ne peuvent pas être supprimés dans les 365 jours suivant leur activation (état ACTIVE). Ils sont ensuite convertis en un nouvel engagement basé sur le plan de renouvellement (valeur renewalPlan).

État

L'engagement de capacité peut soit devenir immédiatement actif (état ACTIVE), soit passer de l'état PENDING (en attente) à ACTIVE (actif) ou FAILED (échec).

Enums
STATE_UNSPECIFIED Valeur d'état non valide.
PENDING L'engagement de capacité est en attente de provisionnement. Un engagement de capacité en attente n'est pas comptabilisé dans la capacité slot_capacity du parent.
ACTIVE Une fois les emplacements provisionnés, l'engagement de capacité devient actif. slot_count est alors ajouté à la capacité slot_capacity du parent.
FAILED L'engagement de capacité n'a pas pu être activé par le backend.

CreateAssignmentRequest

Requête pour ReservationService.CreateAssignment. Remarque : L'autorisation "bigquery.reservationAssignments.create" est requise sur le détenteur de l'attribution.

Champs
parent

string

Obligatoire. Nom de la ressource parent de l'attribution, par exemple : projects/myproject/locations/US/reservations/team1-prod

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • bigquery.reservationAssignments.create
assignment

Assignment

Ressource d'attribution à créer.

CreateCapacityCommitmentRequest

Requête pour ReservationService.CreateCapacityCommitment.

Champs
parent

string

Obligatoire. Nom de ressource de la réservation parente. Exemple : projects/myproject/locations/US

capacity_commitment

CapacityCommitment

Contenu de l'engagement de capacité à créer.

enforce_single_admin_project_per_org

bool

Si la valeur est définie sur "true", la requête échoue si un autre projet de l'organisation possède un engagement de capacité.

CreateReservationRequest

Requête pour ReservationService.CreateReservation.

Champs
parent

string

Obligatoire. Projet, emplacement. Exemple : projects/myproject/locations/US

reservation_id

string

ID de la réservation. Ce champ ne peut contenir que des caractères alphanumériques en minuscule ou des traits d'union. La longueur maximale est de 64 caractères.

reservation

Reservation

Contenu de la nouvelle réservation à créer.

DeleteAssignmentRequest

Requête pour ReservationService.DeleteAssignment. Remarque : L'autorisation "bigquery.reservationAssignments.delete" est requise sur l'objet de l'attribution.

Champs
name

string

Obligatoire. Nom de la ressource. Exemple : projects/myproject/locations/US/reservations/team1-prod/assignments/123

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.reservationAssignments.delete

DeleteCapacityCommitmentRequest

Requête pour ReservationService.DeleteCapacityCommitment.

Champs
name

string

Obligatoire. Nom de ressource de l'engagement de capacité à supprimer. Exemple : projects/myproject/locations/US/capacityCommitments/123

DeleteReservationRequest

Requête pour ReservationService.DeleteReservation.

Champs
name

string

Obligatoire. Nom de ressource de la réservation à récupérer. Exemple : projects/myproject/locations/US/reservations/team1-prod

GetBiReservationRequest

Requête permettant d'obtenir une réservation BI unique.

Champs
name

string

Obligatoire. Nom de la réservation demandée, par exemple : projects/{project_id}/locations/{location_id}/bireservation

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bi.reservations.get

GetCapacityCommitmentRequest

Requête pour ReservationService.GetCapacityCommitment.

Champs
name

string

Obligatoire. Nom de ressource de l'engagement de capacité à récupérer. Exemple : projects/myproject/locations/US/capacityCommitments/123

GetReservationRequest

Requête pour ReservationService.GetReservation.

Champs
name

string

Obligatoire. Nom de ressource de la réservation à récupérer. Exemple : projects/myproject/locations/US/reservations/team1-prod

ListAssignmentsRequest

Requête pour ReservationService.ListAssignments.

Champs
parent

string

Obligatoire. Nom de la ressource parent, par exemple : projects/myproject/locations/US/reservations/team1-prod ou projects/myproject/locations/US/reservations/-

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • bigquery.reservationAssignments.list
page_size

int32

Nombre maximum d'éléments à renvoyer.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

ListAssignmentsResponse

Réponse pour ReservationService.ListAssignments.

Champs
assignments[]

Assignment

Liste des attributions visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

ListCapacityCommitmentsRequest

Requête pour ReservationService.ListCapacityCommitments.

Champs
parent

string

Obligatoire. Nom de ressource de la réservation parente. Exemple : projects/myproject/locations/US

page_size

int32

Nombre maximum d'éléments à renvoyer.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

ListCapacityCommitmentsResponse

Réponse pour ReservationService.ListCapacityCommitments.

Champs
capacity_commitments[]

CapacityCommitment

Liste des engagements de capacité visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

ListReservationsRequest

Requête pour ReservationService.ListReservations.

Champs
parent

string

Obligatoire. Nom de la ressource parente contenant le projet et l'emplacement, par exemple : projects/myproject/locations/US

page_size

int32

Nombre maximum d'éléments à renvoyer.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

filter

string

Peut être utilisé pour filtrer les réservations sur la base du nom, de l'engagement, etc. Exemple : filter="reservation.slot_capacity > 200" filter="reservation.name = "*dev/*"" Vous pouvez trouver des détails concernant la syntaxe de filtrage avancé sur cette page.

ListReservationsResponse

Réponse pour ReservationService.ListReservations.

Champs
reservations[]

Reservation

Liste des réservations visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

MergeCapacityCommitmentsRequest

Requête pour ReservationService.MergeCapacityCommitments.

Champs
parent

string

Nom de la ressource parente qui identifie l'administrateur du projet et son emplacement (par exemple, projects/myproject/locations/us)

capacity_commitment_ids[]

string

Identifiants des engagements de capacité à fusionner. Vous devez vous assurer que ces engagements de capacité existent pour l'administrateur et l'emplacement du projet spécifiés par la ressource parente.

MoveAssignmentRequest

Requête pour ReservationService.MoveAssignment. Remarque : L'autorisation "bigquery.reservationAssignments.create" est requise sur destination_id. Remarque : Les autorisations "bigquery.reservationAssignments.create" et "bigquery.reservationAssignments.delete" sont requises sur le détenteur de l'attribution.

Champs
name

string

Obligatoire. Nom de ressource de l'attribution. Exemple : projects/myproject/locations/US/reservations/team1-prod/assignments/123

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.reservationAssignments.delete
destination_id

string

Nouvel identifiant de réservation. Exemple : projects/myotherproject/locations/US/reservations/team2-prod

Réservation

Une réservation est un mécanisme permettant de garantir des emplacements aux utilisateurs.

Champs
name

string

Nom de ressource de la réservation. Exemple : projects/*/locations/*/reservations/team1-prod

slot_capacity

int64

Nombre minimal d'emplacements disponibles pour cette réservation. Un emplacement est une unité de puissance de calcul dans BigQuery qui sert d'unité de base pour le parallélisme. Les requêtes utilisant cette réservation peuvent utiliser davantage d'emplacements pendant l'exécution si ignore_idle_slots est défini sur "false". Si la capacité d'emplacements de la nouvelle réservation dépasse la capacité d'emplacements du parent ou si la capacité totale de la nouvelle réservation et de ses réservations sœurs dépasse la capacité d'emplacements du parent, la requête échoue avec une erreur google.rpc.Code.RESOURCE_EXHAUSTED.

ignore_idle_slots

bool

Si la valeur est définie sur "false", toute requête utilisant cette réservation exploitera les emplacements vides associés aux autres réservations figurant dans le même projet d'administration. Si la valeur est définie sur "true", toute requête utilisant cette réservation s'exécutera avec la capacité d'emplacements maximale spécifiée ci-dessous.

SearchAssignmentsRequest

Requête pour ReservationService.SearchAssignments. Remarque : L'autorisation "bigquery.reservationAssignments.search" est requise sur le détenteur de l'attribution.

Champs
parent

string

Obligatoire. Nom de la ressource du projet d'administrateur (contenant le projet et l'emplacement), par exemple : "projects/myproject/locations/US".

query

string

Dans la requête, veuillez indiquer le nom de la ressource en tant que détenteur de l'attribution. Par exemple : "assignee=projects/myproject" "assignee=folders/123" "assignee=organizations/456"

page_size

int32

Nombre maximum d'éléments à renvoyer.

page_token

string

Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant.

SearchAssignmentsResponse

Réponse pour ReservationService.SearchAssignments.

Champs
assignments[]

Assignment

Liste des attributions visibles par l'utilisateur.

next_page_token

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

SplitCapacityCommitmentRequest

Requête pour ReservationService.SplitCapacityCommitment.

Champs
name

string

Obligatoire. Nom de la ressource, par exemple : projects/myproject/locations/US/capacityCommitments/123

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • bigquery.capacityCommitments.update
slot_count

int64

Nombre d'emplacements dans l'engagement de capacité après la scission.

SplitCapacityCommitmentResponse

Réponse de ReservationService.SplitCapacityCommitment.

Champs
first

CapacityCommitment

Premier engagement de capacité, résultat d'une scission.

second

CapacityCommitment

Deuxième engagement de capacité, résultat d'une scission.

UpdateBiReservationRequest

Une requête permettant de mettre à jour une réservation BI.

Champs
reservation

BiReservation

Une réservation à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource reservation indiquée :

  • bi.reservations.update
update_mask

FieldMask

Liste des champs à mettre à jour dans cette requête.

UpdateCapacityCommitmentRequest

Requête pour ReservationService.UpdateCapacityCommitment.

Champs
capacity_commitment

CapacityCommitment

Contenu de l'engagement de capacité à mettre à jour.

update_mask

FieldMask

Masque de champ standard pour l'ensemble des champs à mettre à jour.

UpdateReservationRequest

Requête pour ReservationService.UpdateReservation.

Champs
reservation

Reservation

Contenu de la réservation à mettre à jour.

update_mask

FieldMask

Masque de champ standard pour l'ensemble des champs à mettre à jour.