Trabalhe com reservas de slots antigas

A API BigQuery Reservation permite-lhe comprar slots dedicados (denominados compromissos), criar pools de slots (denominados reservas) e atribuir projetos, pastas e organizações a essas reservas.

As reservas permitem-lhe atribuir um número dedicado de espaços a uma carga de trabalho. Por exemplo, pode não querer que uma carga de trabalho de produção concorra com cargas de trabalho de teste por vagas. Pode criar uma reserva denominada prod e atribuir as suas cargas de trabalho de produção a esta reserva. Para mais informações, consulte o artigo Reservas.

Crie reservas

Autorizações necessárias

Para criar uma reserva, precisa da seguinte autorização de gestão de identidade e de acesso (IAM):

Cada uma das seguintes funções de IAM predefinidas inclui esta autorização:

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor

Para mais informações sobre as funções de IAM no BigQuery, consulte o artigo Funções e autorizações predefinidas.

Crie uma reserva com horários dedicados

Selecione uma das seguintes opções:

Consola

  1. Na Google Cloud consola, aceda à página do BigQuery.

    Aceda ao BigQuery

  2. No menu de navegação, clique em Gestão da capacidade.

  3. Clique em Criar reserva.

  4. No campo Nome da reserva, introduza um nome para a reserva.

  5. Na lista pendente Localização, selecione a localização.

  6. Na secção Modelo de capacidade, selecione o modelo de capacidade.

  7. Se selecionar a opção Tarifa fixa, em Espaços base, introduza o número de espaços para a reserva.

    1. Na lista do seletor de tamanho máximo da reserva, selecione o tamanho máximo da reserva.

    2. Opcional: no campo Intervalos de base, introduza o número de intervalos de base para a reserva. Para usar apenas a capacidade do espaço especificado, clique no botão Ignorar espaços inativos.

      A quantidade de espaços de dimensionamento automático disponíveis é determinada subtraindo o valor de espaços de base ao valor de tamanho máximo da reserva. Por exemplo, se criar uma reserva com 100 espaços base e um tamanho máximo de reserva de 400, a sua reserva tem 300 espaços de escalabilidade automática. Para mais informações sobre os horários de base, consulte o artigo Usar reservas com horários de base e de escalabilidade automática.

  8. Para desativar a partilha de espaços ociosos, clique no botão Ignorar espaços ociosos.

  9. A discriminação dos espaços é apresentada na tabela Estimativa de custos. É apresentado um resumo da reserva na tabela Resumo da capacidade.

  10. Clique em Guardar.

A nova reserva é visível no separador Reservas.

SQL

Para criar uma reserva, use a CREATE RESERVATION declaração DDL.

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No editor de consultas, introduza a seguinte declaração:

    CREATE RESERVATION
  `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
OPTIONS (
  slot_capacity = NUMBER_OF_BASELINE_SLOTS,
);

    Substitua o seguinte:

    • ADMIN_PROJECT_ID: o ID do projeto do projeto de administração que detém o recurso de reserva
    • LOCATION: a localização da reserva. Se selecionar uma localização do BigQuery Omni, a sua opção de edição está limitada à Enterprise Edition.

    • RESERVATION_NAME: o nome da reserva

      Tem de começar e terminar com uma letra minúscula ou um número e conter apenas letras minúsculas, números e traços.

    • NUMBER_OF_BASELINE_SLOTS: o número de espaços de base a atribuir à reserva. Não pode definir a opção slot_capacity e a opção edition na mesma reserva.
    • EDITION: a edição da reserva. A atribuição de uma reserva a uma edição implica alterações de funcionalidades e preços. Para mais informações, consulte o artigo Introdução às edições do BigQuery.
    • NUMBER_OF_AUTOSCALING_SLOTS: o número de espaços de escala automática atribuídos à reserva. Isto é igual ao valor do tamanho máximo da reserva menos o número de espaços base.

  3. Clique em Executar.

Para mais informações sobre como executar consultas, consulte o artigo Execute uma consulta interativa.

bq

Para criar uma reserva, use o comando bq mk com a flag --reservation:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --ignore_idle_slots=false \
    RESERVATION_NAME

Substitua o seguinte:

  • ADMIN_PROJECT_ID: o ID do projeto
  • LOCATION: a localização da reserva. Se selecionar uma localização do BigQuery Omni, a opção de edição está limitada à edição Enterprise.

  • NUMBER_OF_BASELINE_SLOTS: o número de espaços base a atribuir à reserva

  • RESERVATION_NAME: o nome da reserva

  • EDITION: a edição da reserva. A atribuição de uma reserva a uma edição implica alterações de funcionalidades e preços. Para mais informações, consulte o artigo Introdução às edições do BigQuery.

  • NUMBER_OF_AUTOSCALING_SLOTS: o número de espaços de escala automática atribuídos à reserva. Isto é igual ao valor do tamanho máximo da reserva menos o número de espaços base.

Para obter informações sobre a flag --ignore_idle_slots, consulte o artigo Espaços inativos. O valor predefinido é false.

Python

Instale o pacote google-cloud-bigquery-reservation antes de usar este exemplo de código. Construa um ReservationServiceClient. Descreva a reserva que quer criar com um Reservation. Crie a reserva com o método create_reservation. 
# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Set slot_capicity to the number of slots in the
# reservation.
slot_capacity = 100

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service
from google.cloud.bigquery_reservation_v1.types import (
    reservation as reservation_types,
)

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)

parent = reservation_client.common_location_path(project_id, location)

reservation = reservation_types.Reservation(slot_capacity=slot_capacity)
reservation = reservation_client.create_reservation(
    parent=parent,
    reservation=reservation,
    reservation_id=reservation_id,
)

print(f"Created reservation: {reservation.name}")

Atualize reservas

Pode fazer as seguintes atualizações a uma reserva:

  • Altere o tamanho da reserva adicionando ou removendo espaços.
  • Configure se as consultas nesta reserva usam espaços livres.
  • Altere a quantidade de espaços de base ou de dimensionamento automático atribuídos a uma reserva.

Autorizações necessárias

Para atualizar uma reserva, precisa da seguinte autorização de gestão de identidade e de acesso (IAM):

Cada uma das seguintes funções de IAM predefinidas inclui esta autorização:

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor

Para mais informações sobre as funções de IAM no BigQuery, consulte o artigo Funções e autorizações predefinidas.

Altere o tamanho de uma reserva

Pode adicionar ou remover horários de uma reserva existente.

Consola

  1. Na Google Cloud consola, aceda à página do BigQuery.

    Aceda ao BigQuery

  2. No menu de navegação, clique em Gestão da capacidade.

  3. Clique no separador Reservas.

  4. Encontre a reserva que quer atualizar.

  5. Expanda a opção Ações.

  6. Clique em Edit.

  7. Na caixa de diálogo Seletor de tamanho máximo da reserva, introduza o tamanho máximo da reserva.

  8. No campo Intervalos base, introduza o número de intervalos base.

  9. Clique em Guardar.

SQL

Para alterar o tamanho de uma reserva, use a declaração de linguagem de definição de dados (LDD) ALTER RESERVATION SET OPTIONS.

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No editor de consultas, introduza a seguinte declaração:

    ALTER RESERVATION
  `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
SET OPTIONS (
  slot_capacity = NUMBER_OF_BASELINE_SLOTS,
);

    Substitua o seguinte:

    • ADMIN_PROJECT_ID: o ID do projeto do projeto de administração que detém o recurso de reserva
    • LOCATION: a localização da reserva, por exemplo, europe-west9.

    • RESERVATION_NAME: o nome da reserva. Tem de começar e terminar com uma letra minúscula ou um número e conter apenas letras minúsculas, números e traços.

    • NUMBER_OF_BASELINE_SLOTS: o número de espaços de base a atribuir à reserva.

  3. Clique em Executar.

Para mais informações sobre como executar consultas, consulte o artigo Execute uma consulta interativa.

bq

Para atualizar o tamanho de uma reserva, use o comando bq update com a flag --reservation:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --reservation RESERVATION_NAME

Substitua o seguinte:

  • ADMIN_PROJECT_ID: o ID do projeto
  • LOCATION: a localização da reserva
  • NUMBER_OF_BASELINE_SLOTS: o número de espaços base a atribuir à reserva
  • RESERVATION_NAME: o nome da reserva

Python

Instale o pacote google-cloud-bigquery-reservation antes de usar este exemplo de código. Construa um ReservationServiceClient. Descreva as propriedades atualizadas com uma Reservation e a propriedade FieldMask.paths. Atualize a reserva com o método update_reservation. 
# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Set slot_capicity to the new number of slots in the
# reservation.
slot_capacity = 50

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service
from google.cloud.bigquery_reservation_v1.types import (
    reservation as reservation_types,
)
from google.protobuf import field_mask_pb2

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)

reservation_name = reservation_client.reservation_path(
    project_id, location, reservation_id
)
reservation = reservation_types.Reservation(
    name=reservation_name,
    slot_capacity=slot_capacity,
)
field_mask = field_mask_pb2.FieldMask(paths=["slot_capacity"])
reservation = reservation_client.update_reservation(
    reservation=reservation, update_mask=field_mask
)

print(f"Updated reservation: {reservation.name}")
print(f"\tslot_capacity: {reservation.slot_capacity}")

Configure se as consultas usam espaços disponíveis

O sinalizador --ignore_idle_slots controla se as consultas executadas numa reserva podem usar horários disponíveis de outras reservas. Para mais informações, consulte o artigo Espaços inativos. Pode atualizar esta configuração numa reserva existente.

Para atualizar uma reserva, use o comando bq update com a flag --reservation . O exemplo seguinte define --ignore_idle_slots como true, o que significa que a reserva só usa espaços atribuídos à reserva.

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --ignore_idle_slots=true \
    --reservation RESERVATION_NAME

Substitua o seguinte:

  • ADMIN_PROJECT_ID: o ID do projeto
  • LOCATION: a localização da reserva
  • RESERVATION_NAME: o nome da reserva

Liste a configuração do espaço inativo

Para apresentar a definição de horários disponíveis para uma reserva, faça o seguinte:

SQL

Consulte a coluna ignore_idle_slots da vista INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT.

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No editor de consultas, introduza a seguinte declaração:

    SELECT
  reservation_name,
  ignore_idle_slots
FROM
  `ADMIN_PROJECT_ID.region-LOCATION`.INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT;

    Substitua o seguinte:

  3. Clique em Executar.

Para mais informações sobre como executar consultas, consulte o artigo Execute uma consulta interativa.

bq

Use o comando bq ls com a flag --reservation:

bq ls --reservation \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION

Substitua o seguinte:

O campo ignoreIdleSlots contém a definição de configuração.

Elimine reservas

Quando elimina uma reserva, todas as tarefas que estão atualmente a ser executadas com horários dessa reserva falham. Para evitar erros, permita que os trabalhos em execução sejam concluídos antes de eliminar a reserva.

Autorizações necessárias

Para eliminar uma reserva, precisa da seguinte autorização de gestão de identidade e de acesso (IAM):

Cada uma das seguintes funções de IAM predefinidas inclui esta autorização:

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor

Para mais informações sobre as funções de IAM no BigQuery, consulte o artigo Funções e autorizações predefinidas.

Elimine uma reserva

Consola

  1. Na Google Cloud consola, aceda à página do BigQuery.

    Aceda ao BigQuery

  2. No menu de navegação, clique em Gestão da capacidade.

  3. Clique no separador Reservas.

  4. Encontre a reserva que quer eliminar.

  5. Expanda a opção Ações.

  6. Clique em Eliminar.

  7. Na caixa de diálogo Eliminar reserva, clique em Eliminar.

SQL

Para eliminar uma reserva, use a declaração DDL DROP RESERVATION.

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No editor de consultas, introduza a seguinte declaração:

    DROP RESERVATION
  `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`;

    Substitua o seguinte:

  3. Clique em Executar.

Para mais informações sobre como executar consultas, consulte o artigo Execute uma consulta interativa.

bq

Para eliminar uma reserva, use o comando bq rm com a flag --reservation:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation RESERVATION_NAME

Substitua o seguinte:

Python

Instale o pacote google-cloud-bigquery-reservation antes de usar este exemplo de código. Construa um ReservationServiceClient. Elimine a reserva com o método delete_reservation. 
# TODO(developer): Set project_id to the project ID containing the
# reservation.
project_id = "your-project-id"

# TODO(developer): Set location to the location of the reservation.
# See: https://cloud.google.com/bigquery/docs/locations for a list of
# available locations.
location = "US"

# TODO(developer): Set reservation_id to a unique ID of the reservation.
reservation_id = "sample-reservation"

# TODO(developer): Choose a transport to use. Either 'grpc' or 'rest'
transport = "grpc"

# ...

from google.cloud.bigquery_reservation_v1.services import reservation_service

reservation_client = reservation_service.ReservationServiceClient(
    transport=transport
)
reservation_name = reservation_client.reservation_path(
    project_id, location, reservation_id
)
reservation_client.delete_reservation(name=reservation_name)

print(f"Deleted reservation: {reservation_name}")

Adicione a API BigQuery Reservation aos VPC Service Controls

A API BigQuery Reservation suporta os VPC Service Controls. Para integrar a API BigQuery Reservation com os VPC Service Controls, siga as instruções em Crie um perímetro de serviço e adicione a API BigQuery Reservation aos serviços protegidos.

Um perímetro de serviço protege o acesso a reservas, compromissos e atribuições em projetos de administração especificados no perímetro. Quando cria uma atribuição, os VPC Service Controls protegem o projeto de administração e o projeto, a pasta e a organização do destinatário.