Trabajar con reservas de ranuras

Console

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

   Ir a BigQuery

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

3. Haz clic en Crear reserva.

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

5. En la lista Ubicación, selecciona ubicación. Si seleccionas una ubicación de BigQuery Omni, la opción de edición se limita a Enterprise Edition.

6. En la lista Edición, selecciona la edición. Las funciones de la edición de BigQuery, como el ajuste de escala automático, solo están disponibles dentro de una edición. Para obtener más información, consulta Introducción a las ediciones de BigQuery.

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

8. En el campo Ranuras de referencia, ingresa la cantidad de ranuras del modelo de referencia para la reserva (opcional).

   La cantidad de ranuras disponibles con ajuste de escala automático se determina restando el valor de las ranuras del modelo de referencia del tamaño máximo de la reserva. Por ejemplo, si creas una reserva con 100 ranuras de referencia y un tamaño máximo de reserva de 400, la reserva tiene 300 ranuras de ajuste de escala automático. Para obtener más información sobre las ranuras de referencia, consulta Usa reservas con ranuras de referencia y de ajuste de escala automático.

9. Para inhabilitar el uso compartido de ranuras inactivas y utilizar solamente la capacidad de ranura especificada, haz clic en el botón de activación Ignorar ranuras inactivas.

10. Para expandir la sección Configuración avanzada, haz clic en la flecha de expansión expand_more.

11. Opcional: Para configurar la simultaneidad de los trabajos de destino, haz clic en el botón de activación Anular la simultaneidad automática del trabajo de destino y, luego, ingresa la simultaneidad de los trabajos de destino.

12. El desglose de ranuras se muestra en la tabla Estimación de costos. Se muestra un resumen de la reserva en la tabla Resumen de capacidad.

13. Haz clic en Guardar.

La reserva nueva se puede ver en la pestaña Reservas de ranuras.

SQL

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

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

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

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

   • RESERVATION_NAME por el nombre de la reserva

     El nombre solo puede contener caracteres alfanuméricos en minúscula o guiones, debe comenzar con una letra y no debe terminar con un guion. La longitud máxima es de 64 caracteres.

   • NUMBER_OF_BASELINE_SLOTS es la cantidad de ranuras de referencia que asignarás a la reserva. No puedes configurar las opciones slot_capacity y edition en la misma reserva.
   • EDITION: es la edición de la reserva. Asignar una reserva a una edición incluye cambios en los atributos y los precios. Para obtener más información, consulta Introducción a las ediciones de BigQuery.
   • NUMBER_OF_AUTOSCALING_SLOTS es la cantidad de ranuras de ajuste de escala automático asignadas a la reserva. Esto es igual al valor del tamaño máximo de la reserva menos la cantidad de ranuras del modelo de referencia.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta 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 \
    --edition=EDITION \
    --autoscale_max_slots=NUMBER_OF_AUTOSCALING_SLOTS \
    --max_slots=MAXIMUM_NUMBER_OF_SLOTS
    --scaling_mode=SCALING_MODE
    RESERVATION_NAME

Reemplaza lo siguiente:

• ADMIN_PROJECT_ID: El ID del proyecto
• LOCATION por la ubicación de la reserva. Si seleccionas una ubicación de BigQuery Omni, la opción de edición se limita a Enterprise Edition.

• NUMBER_OF_BASELINE_SLOTS es la cantidad de ranuras de referencia que asignarás a la reserva.

• RESERVATION_NAME por el nombre de la reserva. El nombre solo puede contener caracteres alfanuméricos en minúscula o guiones, debe comenzar con una letra y no debe terminar con un guion. La longitud máxima es de 64 caracteres.

• EDITION: es la edición de la reserva. Asignar una reserva a una edición incluye cambios en los atributos y los precios. Para obtener más información, consulta Introducción a las ediciones de BigQuery.

• NUMBER_OF_AUTOSCALING_SLOTS es la cantidad de ranuras de ajuste de escala automático asignadas a la reserva. Esto es igual al valor del tamaño máximo de la reserva menos la cantidad de ranuras del modelo de referencia. Esto no se puede configurar con las marcas --max_slots o --scaling_mode.

• MAXIMUM_NUMBER_OF_SLOTS: Es la cantidad máxima de ranuras que puede consumir la reserva. Este valor se debe configurar con la marca --scaling_mode (vista previa).

• SCALING_MODE: Es el modo de ajuste de la reserva. Las opciones son ALL_SLOTS, IDLE_SLOTS_ONLY o AUTOSCALE_ONLY. Este valor se debe configurar con la marca --scaling_mode (vista previa).

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

Terraform

Usa el recurso google_bigquery_reservation.

Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

En el siguiente ejemplo, se crea una reserva llamada my-reservation:

resource "google_bigquery_reservation" "default" {
  name              = "my-reservation"
  location          = "us-central1"
  slot_capacity     = 100
  edition           = "ENTERPRISE"
  ignore_idle_slots = false # Use idle slots from other reservations
  concurrency       = 0     # Automatically adjust query concurrency based on available resources
  autoscale {
    max_slots = 200 # Allow the reservation to scale up to 300 slots (slot_capacity + max_slots) if needed
  }
}

Para aplicar tu configuración de Terraform en un proyecto Google Cloud , completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.

Prepara el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

1. En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

   Copia el código de muestra en el main.tf recién creado.

   De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo debes hacerlo una vez por directorio.

   terraform init

   De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google:

   terraform init -upgrade

Aplica los cambios

1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:

   terraform plan

   Corrige la configuración según sea necesario.

2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:

   terraform apply

   Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

3. Abre tu proyecto Google Cloud para ver los resultados. En la consola de Google Cloud , navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

Python

# 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}")

Console

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

   Ir a BigQuery

2. En el panel de navegación, ve a la sección Administración de capacidad y, luego, haz clic en Crear reserva.

3. En el campo Nombre de la reserva, ingresa un nombre para la reserva.

4. En la lista Ubicación, selecciona ubicación. Si seleccionas una ubicación de BigQuery Omni, la opción de edición se limita a Enterprise Edition.

5. En la lista Edición, selecciona la edición. El ajuste de escala automático solo está disponible dentro de una edición. Para obtener más información, consulta Información sobre las ediciones de BigQuery.

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

7. En el campo Ranuras de referencia, ingresa la cantidad de ranuras del modelo de referencia para la reserva (opcional).

   La cantidad de ranuras disponibles con ajuste de escala automático se determina restando el valor de las ranuras del modelo de referencia del tamaño máximo de la reserva. Por ejemplo, si creas una reserva con 100 ranuras de referencia y un tamaño máximo de reserva de 400, la reserva tiene 300 ranuras de ajuste de escala automático. Para obtener más información sobre las ranuras de referencia, consulta Usa reservas con ranuras de referencia y de ajuste de escala automático.

8. Para inhabilitar el uso compartido de ranuras inactivas y utilizar solamente la capacidad de ranura especificada, haz clic en el botón de activación Ignorar ranuras inactivas.

9. Para expandir la sección Configuración avanzada, haz clic en la flecha de expansión expand_more.

   1. En la lista ¿Cómo usar las ranuras inactivas?, selecciona la opción de configuración.

10. El desglose de ranuras se muestra en la tabla Estimación de costos. Se muestra un resumen de la reserva en la tabla Resumen de capacidad.

11. Haz clic en Guardar.

La reserva nueva se puede ver en la pestaña Reservas de ranuras.

bq

Para crear una reserva predecible, usa el comando bq mk con la marca --reservation y establece los valores de max_slots y scaling_mode:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation \
    --slots=NUMBER_OF_BASELINE_SLOTS \
    --ignore_idle_slots=false \
    --edition=EDITION \
    --max_slots=MAXIMUM_NUMBER_OF_SLOTS \
    --scaling_mode=SCALING_MODE
    RESERVATION_NAME

Reemplaza lo siguiente:

• ADMIN_PROJECT_ID: El ID del proyecto
• LOCATION por la ubicación de la reserva. Si seleccionas una ubicación de BigQuery Omni, la opción de edición se limita a Enterprise Edition.

• NUMBER_OF_BASELINE_SLOTS es la cantidad de ranuras de referencia que asignarás a la reserva.

• RESERVATION_NAME: El nombre de la reserva

• EDITION: es la edición de la reserva. Asignar una reserva a una edición incluye cambios en los atributos y los precios. Para obtener más información, consulta Introducción a las ediciones de BigQuery.

• MAXIMUM_NUMBER_OF_SLOTS: Es la cantidad máxima de ranuras que puede consumir la reserva. Este valor se debe configurar con la marca --scaling_mode.

• SCALING_MODE: SCALING_MODE: Es el modo de escalamiento de la reserva. Las opciones son ALL_SLOTS, IDLE_SLOTS_ONLY o AUTOSCALE_ONLY. Este valor se debe configurar con la marca max_slots. Este valor debe estar alineado con la marca ignore_idle_slots. Para obtener más detalles, consulta Previsibilidad de las reservas.

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

SQL

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

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

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

   CREATE RESERVATION
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME`
   OPTIONS (
     slot_capacity = NUMBER_OF_BASELINE_SLOTS,
     edition = EDITION,
     ignore_idle_slots=IGNORE_IDLE_SLOTS
     max_slots = MAX_NUMBER_OF_SLOTS,
     scaling_mode = SCALING_MODE);

   Reemplaza lo siguiente:

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

   • RESERVATION_NAME: Es el nombre de la reserva. El nombre solo puede contener caracteres alfanuméricos en minúscula o guiones, debe comenzar con una letra y no debe terminar con un guion. La longitud máxima es de 64 caracteres.

   • NUMBER_OF_BASELINE_SLOTS es la cantidad de ranuras de referencia que asignarás a la reserva. No puedes configurar las opciones slot_capacity y edition en la misma reserva.
   • EDITION: es la edición de la reserva. Asignar una reserva a una edición incluye cambios en los atributos y los precios. Para obtener más información, consulta Introducción a las ediciones de BigQuery.
   • IGNORE_IDLE_SLOTS: Indica si la reserva usa ranuras inactivas o no. El valor predeterminado es false.
   • MAX_NUMBER_OF_SLOTS: Es la cantidad máxima de ranuras que puede consumir la reserva. Este valor se debe configurar con la opción scaling_mode.
   • SCALING_MODE: Es el modo de ajuste de la reserva. Las opciones son ALL_SLOTS, IDLE_SLOTS_ONLY o AUTOSCALE_ONLY. Este valor se debe configurar con la opción max_slots. Este valor debe estar alineado con la opción ignore_idle_slots. Para obtener más detalles, consulta Previsibilidad de las reservas.

3. Haz clic en play_circle Ejecutar.

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

Console

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

   Ir a BigQuery

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

3. Haz clic en la pestaña Reservas de ranuras.

4. Busca la reserva que deseas actualizar.

5. Expande la opción more_vert Actions.

6. Haz clic en Editar.

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

8. En el campo Ranuras de referencia, ingresa la cantidad de ranuras del modelo de referencia.

9. Para expandir la sección Configuración avanzada, haz clic en la flecha de expansión expand_more.

10. Opcional: Para configurar la simultaneidad de los trabajos de destino, haz clic en el botón de activación Anular la simultaneidad automática del trabajo de destino y, luego, ingresa la simultaneidad de los trabajos de destino.

11. Haz clic en Guardar.

SQL

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

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

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

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

   • RESERVATION_NAME por el nombre de la reserva. El nombre solo puede contener caracteres alfanuméricos en minúscula o guiones, debe comenzar con una letra y no debe terminar con un guion. La longitud máxima es de 64 caracteres.

   • NUMBER_OF_BASELINE_SLOTS: es la cantidad de ranuras del modelo de referencia que asignarás a la reserva.
   • NUMBER_OF_AUTOSCALING_SLOTS es la cantidad de ranuras de ajuste de escala automático asignadas a la reserva. Esto es igual al valor del tamaño máximo de la reserva menos la cantidad de ranuras del modelo de referencia.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta 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 \
    --autoscale_max_slots=NUMBER_OF_AUTOSCALING_SLOTS \
    --reservation RESERVATION_NAME

Reemplaza lo siguiente:

• ADMIN_PROJECT_ID: El ID del proyecto
• LOCATION: la ubicación de la reserva
• NUMBER_OF_BASELINE_SLOTS es la cantidad de ranuras de referencia que asignarás a la reserva.
• RESERVATION_NAME por el nombre de la reserva. El nombre solo puede contener caracteres alfanuméricos en minúscula o guiones, debe comenzar con una letra y no debe terminar con un guion. La longitud máxima es de 64 caracteres.
• NUMBER_OF_AUTOSCALING_SLOTS es la cantidad de ranuras de ajuste de escala automático asignadas a la reserva. Esto es igual al valor del tamaño máximo de la reserva menos la cantidad de ranuras del modelo de referencia.

Python

# 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}")

SQL

Consulta la columna ignore_idle_slots de la vista INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT.

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

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

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

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

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

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

Reemplaza lo siguiente:

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

El campo ignoreIdleSlots contiene la configuración.

Console

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

   Ir a BigQuery

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

3. Haz clic en la pestaña Reservas.

4. Busca la reserva que deseas borrar.

5. Expande la opción more_vert Actions.

6. Haz clic en Borrar.

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

SQL

Para borrar una reserva, usa la declaración DDL DROP RESERVATION.

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

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

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

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

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

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

Reemplaza lo siguiente:

• ADMIN_PROJECT_ID por el ID del proyecto de administración que posee el recurso de reserva
• LOCATION: la ubicación de la reserva
• RESERVATION_NAME por el nombre de la reserva. El nombre solo puede contener caracteres alfanuméricos en minúscula o guiones, debe comenzar con una letra y no debe terminar con un guion. La longitud máxima es de 64 caracteres.

Python

# 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}")

Console

En la consola de Google Cloud , puedes permitir el acceso a varios recursos de reserva con una condición.

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

   Ir a IAM

2. Selecciona un proyecto, una carpeta o una organización.

3. Para otorgar el rol bigquery.resourceEditor a una principal que tiene un rol en los recursos de la reserva, haz lo siguiente:

   1. En la pestaña Ver por principales, navega a la principal correspondiente o usa la opción Filtro para encontrarla.

   2. Haz clic en edit Editar principal.

   3. En la página Asignar roles, haz clic en add Agregar roles.

   4. En el campo Buscar roles, ingresa bigquery.resourceEditor.

   5. Marca la opción BigQuery Resource Editor en los resultados de la búsqueda y, luego, haz clic en Aplicar.

   6. Haz clic en Guardar.

4. Como alternativa, para otorgar el rol de bigquery.resourceEditor a una principal que no tiene un rol en los recursos de la reserva, haz lo siguiente:

   1. Haz clic en person_add Otorgar acceso.

   2. En la página Agregar principales, en el campo Principales nuevas, ingresa el identificador de la principal, por ejemplo, my-user@example.com.

   3. Haz clic en add Agregar roles.

   4. En el campo Buscar roles, ingresa bigquery.resourceEditor.

   5. Marca la opción BigQuery Resource Editor en los resultados de la búsqueda y, luego, haz clic en Aplicar.

   6. En el cuadro BigQuery Resource Editor, haz clic en Add condition.

   7. En la página Agregar condición, haz lo siguiente:

      1. Ingresa valores en los campos Título y Descripción.

      2. En el Creador de condiciones, agrega tu condición. Por ejemplo, para agregar una condición que otorgue el rol a todos los nombres de reserva que terminen con /reservation1, en Tipo de condición, elige Nombre, en Operador, elige Termina con y, en Valor, ingresa /reservation1.

      3. Haz clic en Guardar.

5. Haz clic en Guardar.

bq

En la herramienta de línea de comandos de bq, puedes otorgar acceso a un recurso de reserva individual.

Para otorgar acceso a una reserva, usa el comando bq set-iam-policy:

bq set-iam-policy RESOURCE FILE_NAME

Reemplaza lo siguiente:

• RESOURCE: Es el nombre del recurso de reserva. Por ejemplo, projects/project1/locations/US/reservations/reservation1

• FILE_NAME: Es el archivo que contiene la política en formato JSON. El formato debe seguir la estructura de la política de IAM para las políticas de permisos. Por ejemplo:

  {
    "bindings": [
      {
        "members": [
          "user:my-user@example.com"
        ],
        "role": "roles/bigquery.resourceEditor"
      }
    ],
    "etag": "BwUjMhCsNvY=",
    "version": 1
  }