Trabalhe com atribuições de reservas

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.

Crie atribuições de reservas

Para usar as posições que compra, cria uma atribuição que atribui um projeto, uma pasta ou uma organização a uma reserva de posições. Não pode atribuir nem afetar um número específico de espaços ao nível da atribuição. Os espaços são geridos e atribuídos ao nível da reserva.

Os projetos usam a reserva mais específica na hierarquia de recursos à qual estão atribuídos. Uma atribuição de pasta substitui uma atribuição de organização e uma atribuição de projeto substitui uma atribuição de pasta. As atribuições de pastas e organizações não estão disponíveis para reservas da edição padrão.

Para criar uma atribuição numa reserva, a reserva tem de cumprir, pelo menos, um dos seguintes critérios:

• Está configurado com um número de espaços de base atribuídos diferente de zero.

• Está configurado com um número de vagas de escalamento automático diferente de zero.

• Está configurado para usar ranhuras inativas e existem ranhuras inativas disponíveis no projeto.

Se tentar atribuir um recurso a uma reserva que não cumpra, pelo menos, um destes critérios, recebe a seguinte mensagem: Assignment is pending, your project will be executed as on-demand.

Pode atribuir um recurso a uma reserva de failover, mas a atribuição fica pendente na localização secundária.

Autorizações necessárias

Para criar uma atribuição de reserva, precisa da seguinte autorização de gestão de identidades e acessos (IAM):

• bigquery.reservationAssignments.create no projeto de administração e no cessionário.

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.

Atribua uma organização a uma reserva

Consola

1. Na Google Cloud consola, aceda à página 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 na tabela de reservas.

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

6. Clique em Criar atribuição.

7. Na secção Crie um trabalho, clique em Procurar.

8. Procure ou pesquise a organização e selecione-a.

9. Na secção Tipo de serviço, selecione um tipo de serviço a atribuir a esta reserva. As opções incluem o seguinte:

   • QUERY
   • CONTINUOUS
   • PIPELINE
   • BACKGROUND
   • ML_EXTERNAL

   Para mais informações sobre os tipos de serviços, consulte o artigo Atribuições de reservas. Este valor predefinido é QUERY.

   Para saber como permitir que os utilizadores usem o Gemini no BigQuery com atribuições da edição Enterprise Plus, consulte o artigo Configure o Gemini no BigQuery.

10. Clique em Criar.

SQL

Para atribuir uma organização a uma reserva, use a declaração DDL CREATE ASSIGNMENT.

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

   Aceda ao BigQuery

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

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
   OPTIONS (
     assignee = 'organizations/ORGANIZATION_ID',
     job_type = 'JOB_TYPE');

   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
   • RESERVATION_NAME: o nome da reserva

   • ASSIGNMENT_ID: o ID da atribuição

     O ID tem de ser exclusivo do projeto e da localização, começar e terminar com uma letra minúscula ou um número, e conter apenas letras minúsculas, números e traços.

   • ORGANIZATION_ID: o ID da organização
   • JOB_TYPE: o tipo de trabalho a atribuir a esta reserva, como QUERY, CONTINUOUS, PIPELINE, BACKGROUND ou ML_EXTERNAL

3. Clique em Executar.

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

bq

Para atribuir as tarefas de uma organização a uma reserva, use o comando bq mk com a flag --reservation_assignment:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_id=ORGANIZATION_ID \
    --job_type=JOB_TYPE \
    --assignee_type=ORGANIZATION

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
• RESERVATION_NAME: o nome da reserva
• ORGANIZATION_ID: o ID da organização
• JOB_TYPE: o tipo de tarefa a atribuir a esta reserva, como QUERY, CONTINUOUS, PIPELINE, BACKGROUND ou ML_EXTERNAL

Quando cria uma atribuição de reserva, aguarde, pelo menos, 5 minutos antes de executar uma consulta. Caso contrário, a consulta pode ser faturada com os preços a pedido.

Atribua um projeto ou uma pasta a uma reserva

Consola

1. Na Google Cloud consola, aceda à página 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 na tabela de reservas.

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

6. Clique em Criar atribuição.

7. Na secção Crie um trabalho, clique em Procurar.

8. Procure ou pesquise o projeto ou a pasta e selecione-o.

9. Na secção Tipo de serviço, selecione um tipo de serviço a atribuir a esta reserva. As opções incluem o seguinte:

   • QUERY
   • CONTINUOUS
   • PIPELINE
   • BACKGROUND
   • ML_EXTERNAL

   Para mais informações sobre os tipos de trabalhos, consulte os trabalhos de reserva. Este valor predefinido é QUERY.

10. Clique em Criar.

SQL

Para atribuir um projeto a uma reserva, use a declaração DDL CREATE ASSIGNMENT.

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

   Aceda ao BigQuery

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

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
   OPTIONS(
     assignee="projects/PROJECT_ID",
     job_type="JOB_TYPE");

   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
   • RESERVATION_NAME: o nome da reserva

   • ASSIGNMENT_ID: o ID da atribuição

     O ID tem de ser exclusivo do projeto e da localização, começar e terminar com uma letra minúscula ou um número, e conter apenas letras minúsculas, números e traços.

   • PROJECT_ID: o ID do projeto a atribuir à reserva
   • JOB_TYPE: o tipo de trabalho a atribuir a esta reserva, como QUERY, CONTINUOUS, PIPELINE, BACKGROUND ou ML_EXTERNAL

3. Clique em Executar.

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

bq

Para atribuir tarefas a uma reserva, use o comando bq mk com a flag --reservation_assignment:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_id=PROJECT_ID \
    --job_type=JOB_TYPE \
    --assignee_type=PROJECT

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
• RESERVATION_NAME: o nome da reserva
• PROJECT_ID: o ID do projeto a atribuir a esta reserva
• JOB_TYPE: o tipo de tarefa a atribuir a esta reserva, como QUERY, CONTINUOUS, PIPELINE, BACKGROUND ou ML_EXTERNAL

Terraform

Use o recurso google_bigquery_reservation_assignment.

Nota: para criar objetos do BigQuery com o Terraform, tem de ativar a API Cloud Resource Manager.

Para se autenticar no BigQuery, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.

O exemplo seguinte atribui um projeto à reserva com o nome 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
  }
}

data "google_project" "project" {}

resource "google_bigquery_reservation_assignment" "default" {
  assignee    = "projects/${data.google_project.project.project_id}"
  job_type    = "QUERY"
  reservation = google_bigquery_reservation.default.id
}

Para aplicar a configuração do Terraform num Google Cloud projeto, conclua os passos nas secções seguintes.

Prepare o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

   Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

Prepare o diretório

Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

1. No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf.

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

2. Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

   Copie o exemplo de código para o ficheiro main.tf criado recentemente.

   Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.

3. Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
4. Guarde as alterações.
5. Inicialize o Terraform. Só tem de fazer isto uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do fornecedor Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Reveja a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expetativas:

   terraform plan

   Faça as correções necessárias à configuração.

2. Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando:

   terraform apply

   Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).

3. Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

Nota: os exemplos do Terraform partem geralmente do princípio de que as APIs necessárias estão ativadas no seu Google Cloud projeto.

Quando cria uma atribuição de reserva, aguarde, pelo menos, 5 minutos antes de executar uma consulta. Caso contrário, a consulta pode ser faturada com os preços a pedido.

Para criar um projeto que use apenas espaços inativos, crie uma reserva com 0 espaços atribuídos e, em seguida, siga os passos anteriores para atribuir o projeto a essa reserva.

Nota: um projeto pode ser atribuído, no máximo, a uma reserva numa única região.

Atribua um projeto a none

As atribuições a none representam a ausência de uma atribuição. Projetos atribuídos para none usar preços segundo a procura.

Nota: as atribuições a none são suportadas apenas para tarefas QUERY.

SQL

Para atribuir um projeto a none, use a declaração DDL CREATE ASSIGNMENT.

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

   Aceda ao BigQuery

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

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.none.ASSIGNMENT_ID`
   OPTIONS(
     assignee="projects/PROJECT_ID",
     job_type="QUERY");

   Substitua o seguinte:

   • LOCATION: a localização dos trabalhos que devem usar preços a pedido

   • ASSIGNMENT_ID: o ID da atribuição

     O ID tem de ser exclusivo do projeto e da localização, começar e terminar com uma letra minúscula ou um número, e conter apenas letras minúsculas, números e traços.

   • PROJECT_ID: o ID do projeto a atribuir à reserva

3. Clique em Executar.

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

bq

Para atribuir um projeto a none, use o comando bq mk com a flag --reservation_assignment:

bq mk \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=none \
    --job_type=QUERY \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT

Substitua o seguinte:

• LOCATION: a localização dos trabalhos que devem usar preços a pedido
• PROJECT_ID: o ID do projeto a atribuir a none

Terraform

Use o recurso google_bigquery_reservation_assignment.

Nota: para criar objetos do BigQuery com o Terraform, tem de ativar a API Cloud Resource Manager.

Para se autenticar no BigQuery, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.

O exemplo seguinte atribui um projeto a none:

data "google_project" "project" {}

resource "google_bigquery_reservation_assignment" "default" {
  assignee    = "projects/${data.google_project.project.project_id}"
  job_type    = "QUERY"
  reservation = "projects/${data.google_project.project.project_id}/locations/us/reservations/none"
}

Para aplicar a configuração do Terraform num Google Cloud projeto, conclua os passos nas secções seguintes.

Prepare o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

   Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

Prepare o diretório

Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

1. No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf.

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

2. Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

   Copie o exemplo de código para o ficheiro main.tf criado recentemente.

   Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.

3. Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
4. Guarde as alterações.
5. Inicialize o Terraform. Só tem de fazer isto uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do fornecedor Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Reveja a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expetativas:

   terraform plan

   Faça as correções necessárias à configuração.

2. Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando:

   terraform apply

   Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).

3. Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

Nota: os exemplos do Terraform partem geralmente do princípio de que as APIs necessárias estão ativadas no seu Google Cloud projeto.

Substitua uma reserva numa consulta

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Para pedir apoio técnico ou enviar feedback sobre esta funcionalidade, contacte [e-mail].

Para usar uma reserva específica numa consulta, precisa da seguinte autorização de gestão de identidade e acesso (IAM):

• bigquery.reservations.use na reserva ou no respetivo projeto de administração.

Para atribuir uma consulta a uma reserva específica, faça uma das seguintes ações:

Consola

1. Aceda à página do BigQuery.

   Aceda ao BigQuery

2. Clique em Consulta SQL.

3. No editor de consultas, introduza uma consulta GoogleSQL válida.

4. Clique em Mais e, de seguida, clique em Definições de consulta.

5. Desmarque a caixa de verificação Definição de localização automática e, de seguida, selecione a região ou as várias regiões em que a reserva se encontra.

6. Na lista Reserva, selecione a reserva na qual quer executar a consulta.

7. Clique em Guardar.

8. Escreva uma consulta no separador do editor e execute-a. A consulta é executada na reserva que especificou.

SQL

Pode usar a variável de sistema @@reservation para atribuir a reserva na qual a sua consulta é executada:

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

   Aceda ao BigQuery

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

   SET @@reservation='RESERVATION';
   SELECT QUERY;

   Substitua o seguinte:

   • RESERVATION: a reserva na qual quer que a consulta seja executada.

   • QUERY: a consulta que quer executar.

3. Clique em Executar.

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

Por exemplo, a seguinte consulta usa a declaração SET para definir a reserva como test-reservation na multirregião US e, em seguida, chama uma consulta básica:

SET @@reservation='projects/project1/locations/US/reservations/test-reservation';
SELECT 42;

bq

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Na Cloud Shell, execute a consulta através do comando bq query com o sinalizador --reservation_id:

   bq query --use_legacy_sql=false --reservation_id=RESERVATION_ID
   'QUERY'

   Substitua o seguinte:

   • RESERVATION_ID: a reserva na qual quer executar a consulta.

   • QUERY: a declaração SQL para a consulta.

   Por exemplo, a seguinte consulta é executada na reserva test-reservation na região múltipla US:

   bq query --reservation_id=project1.US:test-reservation 'SELECT 42;'

API

Para especificar uma reserva através da API, insira uma nova tarefa e preencha a querypropriedade de configuração da tarefa. Especifique a sua reserva no campo reservation.

Atenção: uma consulta pode usar uma reserva declarada noutro projeto. No entanto, a consulta e a reserva têm de estar na mesma organização e na mesma localização.

Atribua slots a cargas de trabalho do BigQuery ML

As secções seguintes fornecem informações sobre os requisitos de atribuição de reservas para modelos do BigQuery ML. Pode criar estas atribuições de reservas seguindo os procedimentos descritos em Atribua uma organização a uma reserva ou Atribua um projeto ou uma pasta a uma reserva.

Modelos externos

Os seguintes tipos de modelos do BigQuery ML usam serviços externos:

• Autoencoder
• AutoML
• Árvore otimizada
• Rede neural profunda (DNN)
• Floresta aleatória
• Rede Wide & Deep

Pode atribuir espaços reservados a consultas através destes serviços criando uma atribuição de reserva que use o tipo de tarefa ML_EXTERNAL. Se não for encontrada nenhuma atribuição de reserva com um ML_EXTERNALtipo de tarefa, a tarefa de consulta é executada com preços a pedido.

Para tarefas de preparação de modelos externos, os espaços na atribuição de reserva são usados para passos de pré-processamento, preparação e pós-processamento. Durante a preparação, os espaços não são preemptíveis, mas durante o pré-processamento e o pós-processamento, podem ser usados espaços inativos.

Modelos de fatorização de matrizes

Para criar um modelo de fatorização de matrizes, tem de criar uma reserva que use a edição Enterprise ou Enterprise Plus do BigQuery e, em seguida, criar uma atribuição de reserva que use o tipo de tarefa QUERY.

Outros tipos de modelos

Para modelos do BigQuery ML que não sejam modelos externos nem modelos de fatorização de matrizes, pode atribuir slots reservados a consultas que usam estes serviços criando uma atribuição de reserva que usa o tipo de tarefa QUERY. Se não for encontrada nenhuma atribuição de reserva com um tipo de tarefa QUERY, a tarefa de consulta é executada com preços a pedido.

Encontre atribuições de reservas

Autorizações necessárias

Para pesquisar uma atribuição de reserva para um determinado projeto, pasta ou organização, precisa da seguinte autorização da gestão de identidade e de acesso (IAM):

• bigquery.reservationAssignments.list no projeto de administração.

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

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor
• BigQuery Resource Viewer
• BigQuery User

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

Encontre a atribuição de reserva de um projeto

Pode saber se o seu projeto, pasta ou organização está atribuído a uma reserva através dos seguintes passos:

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. Na tabela de reservas, expanda uma reserva para ver que recursos estão atribuídos a essa reserva ou use o campo Filtro para filtrar por nome do recurso.

SQL

Para saber a que reserva as tarefas de consulta do seu projeto estão atribuídas, consulte a vista INFORMATION_SCHEMA.ASSIGNMENTS_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
       assignment_id
     FROM `region-LOCATION`.INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT
     WHERE
       assignee_id = 'PROJECT_ID'
       AND job_type = 'JOB_TYPE';

   Substitua o seguinte:

   • LOCATION: a localização das reservas a ver
   • ADMIN_PROJECT_ID: o ID do projeto do projeto de administração que detém o recurso de reserva
   • PROJECT_ID: o ID do projeto a atribuir à reserva
   • JOB_TYPE: o tipo de trabalho a atribuir a esta reserva, como QUERY, CONTINUOUS, PIPELINE, BACKGROUND ou ML_EXTERNAL

3. Clique em Executar.

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

bq

Aviso: este comando não funciona no Cloud Shell. Para usar este comando, execute-o a partir de uma linha de comando local.

Para saber a que reserva as tarefas de consulta do seu projeto estão atribuídas, use o comando bq show com a flag --reservation_assignment:

bq show \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --job_type=JOB_TYPE \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT

Substitua o seguinte:

• ADMIN_PROJECT_ID: o ID do projeto que detém o recurso de reserva
• LOCATION: a localização das reservas a ver
• JOB_TYPE: o tipo de trabalho a atribuir a esta reserva, como QUERY, CONTINUOUS, PIPELINE, BACKGROUND ou ML_EXTERNAL
• PROJECT_ID: o ID do projeto

Atualize as atribuições de reservas

Mova uma atribuição para uma reserva diferente

Pode mover uma atribuição de uma reserva para outra.

Para mover uma atribuição de reserva, precisa das seguintes autorizações de gestão de identidades e acessos (IAM) no projeto de administração e no cessionário.

• bigquery.reservationAssignments.create
• bigquery.reservationAssignments.delete

Cada uma das seguintes funções de IAM predefinidas inclui estas autorizações:

• 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.

Para mover um trabalho, use o comando bq update:

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --destination_reservation_id=DESTINATION_RESERVATION \
    ADMIN_PROJECT_ID:LOCATION.RESERVATION_NAME.ASSIGNMENT_ID

Substitua o seguinte:

• ADMIN_PROJECT_ID: o ID do projeto que detém o recurso de reserva
• LOCATION: a localização da nova reserva
• RESERVATION_NAME: a reserva a partir da qual mover a atribuição
• DESTINATION_RESERVATION: a reserva para mover a atribuição

• ASSIGNMENT_ID: o ID da atribuição

  Para obter o ID da atribuição, consulte o artigo Liste a atribuição de reserva de um projeto.

Elimine atribuições de reservas

Pode remover um projeto de uma reserva eliminando a atribuição da reserva. Se um projeto não estiver atribuído a nenhuma reserva, herda as atribuições nas respetivas pastas ou organizações principais ou, caso contrário, usa os preços a pedido se não existirem atribuições principais.

Quando elimina uma atribuição de reserva, as tarefas que estão a ser executadas com as vagas dessa reserva continuam a ser executadas até à conclusão.

Autorizações necessárias

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

• bigquery.reservationAssignments.delete no projeto de administração e no cessionário.

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

• BigQuery Admin
• BigQuery Resource Admin
• BigQuery Resource Editor

Remova um projeto de uma reserva

Para remover um projeto de 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. Na tabela de reservas, expanda a reserva para encontrar o projeto.

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

6. Clique em Eliminar.

SQL

Use a DROP ASSIGNMENT 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:

   DROP ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`;

   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
   • RESERVATION_NAME: o nome da reserva

   • ASSIGNMENT_ID: o ID da atribuição

     Para encontrar o ID da atribuição, consulte o artigo Liste a atribuição de reserva de um projeto.

3. Clique em Executar.

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

bq

Para remover um projeto de uma reserva, use o comando bq rm com a flag --reservation_assignment:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment RESERVATION_NAME.ASSIGNMENT_ID

Substitua o seguinte:

• ADMIN_PROJECT_ID: o ID do projeto que detém o recurso de reserva
• LOCATION: a localização da reserva
• RESERVATION_NAME: o nome da reserva

• ASSIGNMENT_ID: o ID da atribuição

  Para obter o ID da atribuição, consulte o artigo Encontre a atribuição de reserva de um projeto.