Trabajar con reservas de slots antiguas

Nota: Las reservas antiguas, incluido el acceso a la facturación con tarifa fija o a determinados periodos de compromiso, solo están disponibles para los clientes incluidos en la lista de permitidos. Para determinar si tienes acceso a estas funciones antiguas, ponte en contacto con tu administrador. El modelo de facturación de tarifa plana define cómo se te factura por los recursos de computación, pero las reservas y los compromisos de tarifa plana funcionan como puestos de la edición Enterprise.

La API BigQuery Reservation te permite comprar ranuras dedicadas (llamadas compromisos), crear grupos de ranuras (llamados reservas) y asignar proyectos, carpetas y organizaciones a esas reservas.

Las reservas te permiten asignar un número concreto de ranuras a una carga de trabajo. Por ejemplo, puede que no quieras que una carga de trabajo de producción compita con cargas de trabajo de prueba por las ranuras. Puedes crear una reserva llamada prod y asignar tus cargas de trabajo de producción a esta reserva. Para obtener más información, consulta Reservas.

Crear reservas

Permisos obligatorios

Para crear una reserva, necesitas el siguiente permiso de Gestión de Identidades y Accesos (IAM):

• bigquery.reservations.create en el proyecto de administración que mantiene la propiedad de los compromisos.

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye este permiso:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Para obtener más información sobre los roles de gestión de identidades y accesos en BigQuery, consulta el artículo sobre roles y permisos predefinidos.

Crear una reserva con slots específicos

Selecciona una de las opciones siguientes:

Consola

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el menú de navegación, haz clic en Gestión de la capacidad.

3. Haz clic en Crear reserva.

4. En el campo Nombre de la reserva, introduce un nombre para la reserva.

5. En la lista desplegable Ubicación, selecciona la ubicación.

6. En la sección Modelo de capacidad, seleccione el modelo de capacidad.

7. Si seleccionas la opción Tarifa plana, en Ranuras de referencia, introduce el número de ranuras de la reserva.

   1. En la lista Selector de tamaño máximo de reserva, selecciona el tamaño máximo de reserva.

   2. Opcional: En el campo Espacios publicitarios de referencia, introduce el número de espacios publicitarios de referencia de la reserva. Para usar solo la capacidad de espacio especificada, haz clic en el botón Ignorar espacios inactivos.

      La cantidad de ranuras de escalado automático disponibles se determina restando el valor de las ranuras de referencia del valor del tamaño máximo de la reserva. Por ejemplo, si creas una reserva con 100 espacios de base y un tamaño máximo de reserva de 400, tu reserva tendrá 300 espacios de escalado automático. Para obtener más información sobre los intervalos de referencia, consulta el artículo Usar reservas con intervalos de referencia y de autoescalado.

8. Para inhabilitar la función para compartir espacios libres, haz clic en el interruptor Ignorar espacios libres.

9. El desglose de los espacios se muestra en la tabla Estimación de costes. En la tabla Resumen de capacidad se muestra un resumen de la reserva.

10. Haz clic en Guardar.

La nueva reserva se muestra en la pestaña Reservas.

SQL

Para crear una reserva, usa la declaración de DDL CREATE RESERVATION.

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

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

   Haz los cambios siguientes:

   • ADMIN_PROJECT_ID: el ID de proyecto del proyecto de administración que posee el recurso de reserva
   • LOCATION: la ubicación de la reserva. Si seleccionas una ubicación de BigQuery Omni, la opción de edición se limitará a la edición Enterprise.

   • RESERVATION_NAME: el nombre de la reserva

     Debe empezar y acabar con una letra minúscula o un número, y solo puede contener letras minúsculas, números y guiones.

   • NUMBER_OF_BASELINE_SLOTS: número de espacios de referencia que se asignarán a la reserva. No puedes definir las opciones slot_capacity y edition en la misma reserva.
   • EDITION: la edición de la reserva. Al asignar una reserva a una edición, se producen cambios en las funciones y los precios. Para obtener más información, consulta Introducción a las ediciones de BigQuery.
   • NUMBER_OF_AUTOSCALING_SLOTS: número de ranuras de autoescalado asignadas a la reserva. Es igual al valor del tamaño máximo de la reserva menos el número de espacios publicitarios de referencia.

3. Haz clic en Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.

bq

Para crear una reserva, usa el comando bq mk con la marca --reservation:

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

Haz los cambios siguientes:

• ADMIN_PROJECT_ID: el ID del proyecto
• LOCATION: la ubicación de la reserva. Si seleccionas una ubicación de BigQuery Omni, tu opción de edición se limitará a la edición Enterprise.

• NUMBER_OF_BASELINE_SLOTS: número de espacios publicitarios básicos que se asignarán a la reserva.

• RESERVATION_NAME: el nombre de la reserva

• EDITION: la edición de la reserva. Al asignar una reserva a una edición, se producen cambios en las funciones y los precios. Para obtener más información, consulta Introducción a las ediciones de BigQuery.

• NUMBER_OF_AUTOSCALING_SLOTS: número de ranuras de autoescalado asignadas a la reserva. Es igual al valor del tamaño máximo de la reserva menos el número de espacios publicitarios de referencia.

Para obtener información sobre la marca --ignore_idle_slots, consulta la sección Ranuras inactivas. El valor predeterminado es false.

Python

Instala el paquete google-cloud-bigquery-reservation antes de usar este código de ejemplo. Crea un ReservationServiceClient. Describe la reserva que quieres crear con una Reservation. Crea la reserva con el 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}")

Actualizar reservas

Puedes hacer los siguientes cambios en una reserva:

• Cambia el tamaño de la reserva añadiendo o quitando espacios.
• Configura si las consultas de esta reserva usan ranuras inactivas.
• Cambiar la cantidad de ranuras de referencia o de autoescalado asignadas a una reserva.

Permisos obligatorios

Para actualizar una reserva, necesitas el siguiente permiso de gestión de identidades y accesos (IAM):

• bigquery.reservations.update en el proyecto de administración que mantiene la propiedad de los compromisos.

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye este permiso:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Para obtener más información sobre los roles de gestión de identidades y accesos en BigQuery, consulta el artículo sobre roles y permisos predefinidos.

Cambiar el tamaño de una reserva

Puedes añadir o quitar franjas horarias de una reserva.

Consola

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el menú de navegación, haz clic en Gestión de la capacidad.

3. Haz clic en la pestaña Reservas.

4. Busca la reserva que quieras modificar.

5. Abre la opción Acciones.

6. Haz clic en Editar.

7. En el cuadro de diálogo Selector de tamaño máximo de reserva, introduce el tamaño máximo de reserva.

8. En el campo Ranuras de referencia, introduce el número de ranuras de referencia.

9. Haz clic en Guardar.

SQL

Para cambiar el tamaño de una reserva, usa la ALTER RESERVATION SET OPTIONSdeclaración del lenguaje de definición de datos (DDL).

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

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

   Haz los cambios siguientes:

   • ADMIN_PROJECT_ID: el ID de proyecto del proyecto de administración que posee el recurso de reserva
   • LOCATION: la ubicación de la reserva, por ejemplo, europe-west9.

   • RESERVATION_NAME: el nombre de la reserva. Debe empezar y acabar con una letra minúscula o un número, y solo puede contener letras minúsculas, números y guiones.

   • NUMBER_OF_BASELINE_SLOTS: número de espacios de referencia que se asignarán a la reserva.

3. Haz clic en Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.

bq

Para actualizar el tamaño de una reserva, usa el comando bq update con la marca --reservation:

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

Haz los cambios siguientes:

• ADMIN_PROJECT_ID: el ID del proyecto
• LOCATION: la ubicación de la reserva
• NUMBER_OF_BASELINE_SLOTS: número de espacios publicitarios básicos que se asignarán a la reserva.
• RESERVATION_NAME: el nombre de la reserva

Python

Instala el paquete google-cloud-bigquery-reservation antes de usar este código de ejemplo. Crea un ReservationServiceClient. Describe las propiedades actualizadas con un Reservation y la propiedad FieldMask.paths. Actualiza la reserva con el 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}")

Configurar si las consultas usan ranuras inactivas

La marca --ignore_idle_slots controla si las consultas que se ejecutan en una reserva pueden usar las ranuras inactivas de otras reservas. Para obtener más información, consulta la sección Ranuras inactivas. Puedes actualizar esta configuración en una reserva que ya tengas.

Para actualizar una reserva, usa el comando bq update con la marca --reservation . En el siguiente ejemplo se asigna true a --ignore_idle_slots, lo que significa que la reserva solo usará los espacios asignados a la reserva.

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

Haz los cambios siguientes:

• ADMIN_PROJECT_ID: el ID del proyecto
• LOCATION: la ubicación de la reserva
• RESERVATION_NAME: el nombre de la reserva

Mostrar la configuración de espacios inactivos

Para consultar el ajuste Espacios inactivos de una reserva, sigue estos pasos:

SQL

Consulta la columna ignore_idle_slots de la vista INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT.

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

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

   Haz los cambios siguientes:

   • ADMIN_PROJECT_ID: el ID del proyecto de administración que posee los recursos de reserva
   • LOCATION: la ubicación de las reservas

3. Haz clic en Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.

bq

Usa el comando bq ls con la marca --reservation:

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

Haz los cambios siguientes:

• ADMIN_PROJECT_ID: el ID del proyecto de administración que posee los recursos de reserva
• LOCATION: la ubicación de las reservas

El campo ignoreIdleSlots contiene el ajuste de configuración.

Eliminar reservas

Cuando eliminas una reserva, las tareas que se estén ejecutando con los slots de esa reserva fallarán. Para evitar errores, permite que los trabajos en curso se completen antes de eliminar la reserva.

Permisos obligatorios

Para eliminar una reserva, necesita el siguiente permiso de gestión de identidades y accesos (IAM):

• bigquery.reservations.delete en el proyecto de administración que mantiene la propiedad de los compromisos.

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye este permiso:

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Para obtener más información sobre los roles de gestión de identidades y accesos en BigQuery, consulta el artículo sobre roles y permisos predefinidos.

Eliminar una reserva

Consola

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el menú de navegación, haz clic en Gestión de la capacidad.

3. Haz clic en la pestaña Reservas.

4. Busca la reserva que quieras eliminar.

5. Abre la opción Acciones.

6. Haz clic en Eliminar.

7. En el cuadro de diálogo Eliminar reserva, haz clic en Eliminar.

SQL

Para eliminar una reserva, utiliza la declaración de DDL DROP RESERVATION.

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

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

   Haz los cambios siguientes:

   • ADMIN_PROJECT_ID: el ID de proyecto del proyecto de administración que posee el recurso de reserva
   • LOCATION: la ubicación de la reserva
   • RESERVATION_NAME: el ID de la reserva

3. Haz clic en Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.

bq

Para eliminar una reserva, usa el comando bq rm con la marca --reservation:

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

Haz los cambios siguientes:

• ADMIN_PROJECT_ID: el ID del proyecto de administración que tiene el recurso de reserva.
• LOCATION: la ubicación de la reserva
• RESERVATION_NAME: el nombre de la reserva

Python

Instala el paquete google-cloud-bigquery-reservation antes de usar este código de ejemplo. Crea un ReservationServiceClient. Elimina la reserva con el 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}")

Añadir la API de reserva de BigQuery a Controles de Servicio de VPC

Nota: Es posible que esta función no esté disponible al usar reservas creadas con determinadas ediciones de BigQuery. Para obtener más información sobre las funciones habilitadas en cada edición, consulta el artículo Introducción a las ediciones de BigQuery

.

La API de reserva de BigQuery es compatible con Controles de Servicio de VPC. Para integrar la API BigQuery Reservation con Controles de Servicio de VPC, sigue las instrucciones de Crear un perímetro de servicio y añade la API BigQuery Reservation a los servicios protegidos.

Un perímetro de servicio protege el acceso a las reservas, los compromisos y las asignaciones de los proyectos de administración especificados en el perímetro. Cuando se crea una asignación, Controles de Servicio de VPC protege el proyecto de administración y el proyecto, la carpeta y la organización del asignado.