Google BigQuery Reservation V1 Client - Class Assignment (2.7.0)

Reference documentation and code samples for the Google BigQuery Reservation V1 Client class Assignment.

An assignment allows a project to submit jobs of a certain type using slots from the specified reservation.

Generated from protobuf message google.cloud.bigquery.reservation.v1.Assignment

Namespace

Google \ Cloud \ BigQuery \ Reservation \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ name
string

Output only. Name of the resource. E.g.: projects/myproject/locations/US/reservations/team1-prod/assignments/123 . The assignment_id must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.

↳ assignee
string

Optional. The resource which will use the reservation. E.g. projects/myproject , folders/123 , or organizations/456 .

↳ job_type
int

Optional. Which type of jobs will use the reservation.

↳ state
int

Output only. State of the assignment.

↳ enable_gemini_in_bigquery
bool

Optional. Deprecated: "Gemini in BigQuery" is now available by default for all BigQuery editions and should not be explicitly set. Controls if "Gemini in BigQuery" ( https://cloud.google.com/gemini/docs/bigquery/overview ) features should be enabled for this reservation assignment.

↳ scheduling_policy
SchedulingPolicy

Optional. The scheduling policy to use for jobs and queries of this assignee when running under the associated reservation. The scheduling policy controls how the reservation's resources are distributed. This overrides the default scheduling policy specified on the reservation. This feature is not yet generally available.

↳ principal
string

Optional. Represents the principal for this assignment. If not empty, jobs run by this principal will utilize the associated reservation. Otherwise, jobs will fall back to using the reservation assigned to the project, folder, or organization (in that order). If no reservation is assigned at any of these levels, on-demand capacity will be used. The supported formats are: * * principal://goog/subject/USER_EMAIL_ADDRESS for users, * * principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS for service accounts, * * principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT_ID for workload identity pool identities. * * The special value unknown_or_deleted_user represents principals which cannot be read from the user info service, for example deleted users.

getName

Output only. Name of the resource. E.g.: projects/myproject/locations/US/reservations/team1-prod/assignments/123 .

The assignment_id must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.

Returns
Type
Description
string

setName

Output only. Name of the resource. E.g.: projects/myproject/locations/US/reservations/team1-prod/assignments/123 .

The assignment_id must only contain lower case alphanumeric characters or dashes and the max length is 64 characters.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getAssignee

Optional. The resource which will use the reservation. E.g.

projects/myproject , folders/123 , or organizations/456 .

Returns
Type
Description
string

setAssignee

Optional. The resource which will use the reservation. E.g.

projects/myproject , folders/123 , or organizations/456 .

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getJobType

Optional. Which type of jobs will use the reservation.

Returns
Type
Description
int
Enum of type JobType .

setJobType

Optional. Which type of jobs will use the reservation.

Parameter
Name
Description
var
int

Enum of type JobType .

Returns
Type
Description
$this

getState

Output only. State of the assignment.

Returns
Type
Description
int
Enum of type State .

setState

Output only. State of the assignment.

Parameter
Name
Description
var
int

Enum of type State .

Returns
Type
Description
$this

getEnableGeminiInBigquery

Optional. Deprecated: "Gemini in BigQuery" is now available by default for all BigQuery editions and should not be explicitly set.

Controls if "Gemini in BigQuery" ( https://cloud.google.com/gemini/docs/bigquery/overview ) features should be enabled for this reservation assignment.

Returns
Type
Description
bool

setEnableGeminiInBigquery

Optional. Deprecated: "Gemini in BigQuery" is now available by default for all BigQuery editions and should not be explicitly set.

Controls if "Gemini in BigQuery" ( https://cloud.google.com/gemini/docs/bigquery/overview ) features should be enabled for this reservation assignment.

Parameter
Name
Description
var
bool
Returns
Type
Description
$this

getSchedulingPolicy

Optional. The scheduling policy to use for jobs and queries of this assignee when running under the associated reservation. The scheduling policy controls how the reservation's resources are distributed. This overrides the default scheduling policy specified on the reservation.

This feature is not yet generally available.

Returns
Type
Description

hasSchedulingPolicy

clearSchedulingPolicy

setSchedulingPolicy

Optional. The scheduling policy to use for jobs and queries of this assignee when running under the associated reservation. The scheduling policy controls how the reservation's resources are distributed. This overrides the default scheduling policy specified on the reservation.

This feature is not yet generally available.

Parameter
Name
Description
Returns
Type
Description
$this

getPrincipal

Optional. Represents the principal for this assignment. If not empty, jobs run by this principal will utilize the associated reservation. Otherwise, jobs will fall back to using the reservation assigned to the project, folder, or organization (in that order). If no reservation is assigned at any of these levels, on-demand capacity will be used.

The supported formats are:

  • principal://goog/subject/USER_EMAIL_ADDRESS for users,
  • principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS for service accounts,
  • principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT_ID for workload identity pool identities.
  • The special value unknown_or_deleted_user represents principals which cannot be read from the user info service, for example deleted users.
Returns
Type
Description
string

setPrincipal

Optional. Represents the principal for this assignment. If not empty, jobs run by this principal will utilize the associated reservation. Otherwise, jobs will fall back to using the reservation assigned to the project, folder, or organization (in that order). If no reservation is assigned at any of these levels, on-demand capacity will be used.

The supported formats are:

  • principal://goog/subject/USER_EMAIL_ADDRESS for users,
  • principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS for service accounts,
  • principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT_ID for workload identity pool identities.
  • The special value unknown_or_deleted_user represents principals which cannot be read from the user info service, for example deleted users.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
Create a Mobile Website
View Site in Mobile | Classic
Share by: