Faça a gestão das dependências da API BigQuery

Este documento descreve os Google Cloud serviços e as APIs dos quais o BigQuery depende. Também explica os efeitos no comportamento do BigQuery quando desativa esses serviços. Reveja este documento antes de ativar ou desativar serviços no seu projeto.

Alguns serviços estão ativados por predefinição em todos os Google Cloud projetos que criar. Outras APIs são ativadas automaticamente para todos os Google Cloud projetos que usam o BigQuery. Os restantes serviços têm de ser ativados explicitamente antes de poder usar a respetiva funcionalidade. Para mais informações, consulte os seguintes recursos:

• Serviços ativados por predefinição
• Ativar e desativar serviços

Este documento destina-se a administradores.

Serviços ativados por predefinição

Os seguintes serviços estão ativados por predefinição para todos os novos Google Cloud projetos:

Serviço	Que funcionalidades dependem dele	Efeitos da desativação deste serviço
analyticshub.googleapis.com	Publique trocas de dados Publicar fichas e gerir subscrições Salas limpas de dados	Não pode criar nem gerir trocas de dados, fichas, salas de limpeza de dados nem subscrições. Não pode pesquisar nem explorar trocas ou fichas criadas por outros fornecedores. As subscrições criadas persistem, mas não são acessíveis. Os conjuntos de dados associados estão acessíveis desde que a API BigQuery esteja ativada. Não pode criar novas subscrições
bigqueryconnection.googleapis.com	Consultas federadas a dados armazenados fora do BigQuery Tabelas e conjuntos de dados externos BigQuery metastore	Não pode gerir ligações externas. Não pode criar modelos remotos. Não pode criar funções remotas. Não pode consultar tabelas do BigLake nem tabelas de objetos.
bigquerymigration.googleapis.com	Avaliação da migração de dados Tradução de consultas SQL	Não pode criar tarefas nem avaliações de migração. As tarefas ou as avaliações existentes não estão disponíveis. Nota: normalmente, pode desativar este serviço após concluir a migração de dados.
bigquerydatapolicy.googleapis.com	Masking de dados	Não pode gerir as suas políticas de ocultação de dados. As políticas de ocultação de dados não são eliminadas, mas as consultas a tabelas com ocultação de dados aplicada falham.
bigqueryreservation.googleapis.com	Gestão da carga de trabalho baseada na capacidade	Não pode criar nem gerir compromissos de capacidade, reservas nem atribuições. Não pode monitorizar a utilização de espaços. A comutação por falha de recuperação de desastres não está disponível. A escalabilidade automática de faixas horárias é interrompida.
bigquerystorage.googleapis.com	Carregamento de dados de streaming Carregamento de dados em lote Altere a captura de dados	Não pode usar a API Storage Read nem a API Storage Write para aceder aos seus dados do BigQuery.
dataform.googleapis.com	O Dataform fornece repositórios de código que são usados pelas seguintes funcionalidades: Pipelines do BigQuery Consultas guardadas Blocos de notas do Colab Dataform Preparação de dados Canvas de dados	Não pode criar pipelines, consultas guardadas, blocos de notas do Colab, telas de dados, preparações de dados nem projetos do Dataform. As pipelines, os blocos de notas ou os projetos do Dataform agendados existentes são interrompidos. Todos os pipelines existentes, consultas guardadas, blocos de notas do Colab, telas de dados, preparações de dados ou projetos do Dataform tornam-se inacessíveis.
dataplex.googleapis.com	O catálogo universal do Dataplex oferece capacidades de catalogação e administração de dados que são usadas pelo seguinte: Explorador de recursos no BigQuery Studio Preenchimento automático no editor de SQL do BigQuery Studio Pesquise partilhas do BigQuery (anteriormente Analytics Hub) para anúncios Estatísticas do perfil Análises de qualidade de dados Visualização da linhagem de dados Estatísticas de tabelas e conjuntos de dados Canvas de dados	A pesquisa de recursos de dados do BigQuery não está disponível. A pesquisa de fichas partilhadas está indisponível. Não pode criar nem aceder a estatísticas de perfis criadas anteriormente, análises de qualidade de dados ou sugestões de consultas. Não pode ver os detalhes dos recursos de dados num gráfico de linhagem. Não pode pesquisar recursos de dados na tela de dados.

Efeito da desativação da API BigQuery

A desativação da API BigQuery também desativa os seguintes serviços que dependem da API BigQuery:

• binaryauthorization.googleapis.com
• container.googleapis.com
• cloudapis.googleapis.com
• dataprep.googleapis.com
• servicebroker.googleapis.com
• telecomdatafabric.googleapis.com

Serviços ativados pela API unificada do BigQuery

A API Unified do BigQuery (bigqueryunified.googleapis.com) inclui uma coleção organizada de serviços necessários para o funcionamento de várias funcionalidades do BigQuery. Se ativar a API unificada do BigQuery, todos estes serviços são ativados simultaneamente. A Google pode atualizar os serviços nesta coleção e esses serviços são ativados automaticamente em projetos com esta API ativada. Pode desativar serviços e APIs individuais.

Para ver instruções sobre como ativar o bigqueryunified.googleapis.com, consulte o artigo Ativar e desativar serviços.

Serviço	Que funcionalidades dependem dele	Efeitos da desativação deste serviço
aiplatform.googleapis.com	Blocos de notas do Colab Modelos remotos do BigQuery ML	Não poderá executar os seus blocos de notas. Todos os modelos remotos do BigQuery ML existentes deixam de funcionar. Os seus blocos de notas existentes permanecem acessíveis para edição.
bigqueryunified.googleapis.com	Oferece uma ativação com um clique dos serviços dependentes do BigQuery indicados neste documento, excluindo as APIs cloudaicompanion, composer e datalineage. Garante que as novas dependências do BigQuery estão ativadas no seu projeto.	As dependências futuras não são ativadas automaticamente no seu projeto.
compute.googleapis.com	O Google Compute Engine oferece um ambiente de tempo de execução para todas as funcionalidades fornecidas pelo Dataproc e pela Vertex AI.	Os blocos de notas do Colab, os modelos de ML remotos, os trabalhos do Apache Spark, SparkSQL e PySpark param. O código-fonte permanece disponível. A API Dataproc é desativada.
dataproc.googleapis.com	Consultar dados com motores de código aberto, como o Apache Spark. Use o Spark SQL ou o PySpark com o Google Cloud Serverless para Apache Spark. Use procedimentos armazenados para o Spark.	Não pode criar clusters do Dataproc para executar a análise de dados de código aberto. Não pode executar cargas de trabalho sem servidor para o Apache Spark. Não pode executar o Spark em cargas de trabalho do BigQuery.
datastream.googleapis.com	Oferece captura de dados de alterações e replicação para o BigQuery.	Todas as streams de dados são pausadas e não estão acessíveis.

Serviços desativados por predefinição

Tem de ativar manualmente os seguintes serviços para que as capacidades correspondentes fiquem disponíveis:

Serviço	Que funcionalidades dependem dele	Efeitos da desativação deste serviço
cloudaicompanion.googleapis.com	Funcionalidades do Gemini no BigQuery	As funcionalidades de conclusão, geração e explicação de código deixam de funcionar. Saiba como desativar o Gemini no BigQuery.
composer.googleapis.com	Agende cargas de trabalho	Os DAGs do Cloud Composer existentes não são apresentados na página Agendamento e param. Os ambientes do Cloud Composer existentes ficam inoperacionais, deixam de funcionar e devolvem um estado de erro.
datalineage.googleapis.com	Captura e visualização da linhagem de dados	A linhagem de dados não é capturada para o seu projeto. Não pode ver o gráfico de linhagem.

Ative manualmente os recursos de código do BigQuery

Para gerir recursos de código no BigQuery, como blocos de notas e consultas guardadas, tem de ativar as seguintes APIs:

• A API Compute Engine
• A API Dataform
• A API Vertex AI

Antes de março de 2024, estas APIs não eram ativadas automaticamente por predefinição. Se tiver scripts de automatização de antes de março de 2024 que dependiam do estado destas APIs, pode ter de os atualizar. Se já tiver estas APIs ativadas, vai ver novas pastas Notebooks e Queries no painel Explorador do BigQuery.

Antes de começar

Para ativar manualmente a gestão de recursos de código, tem de ter a função de proprietário (roles/owner) do Identity and Access Management (IAM).

Ative manualmente os recursos de código do BigQuery

Para ativar as dependências de API necessárias para recursos de código, siga estes passos:

1. Aceda à página do BigQuery.

   Aceda ao BigQuery

2. No Studio, na barra de separadores do painel do editor, clique no menu pendente junto ao sinal +, passe o cursor do rato sobre Bloco de notas e, de seguida, selecione Modelo do BigQuery.

3. No banner apresentado abaixo da barra de separadores do painel do editor, clique em Ativar.

   Se não vir a faixa, verifique se tem a função de proprietário do IAM necessária.

4. No painel Ativar funcionalidades, na secção APIs de funcionalidades essenciais, faça o seguinte:

   1. Para ativar o histórico de versões e a partilha de recursos de código, na secção Histórico de versões e partilha, clique em Ativar.
   2. Para ativar os blocos de notas, em Blocos de notas Python, clique em Ativar tudo.
   3. Quando as APIs estiverem ativadas, clique em Seguinte.

5. Opcional: defina as autorizações do utilizador na secção Autorizações:

   • Para conceder aos principais a capacidade de criar recursos de código e de ler, editar e definir autorizações para os recursos de código que criaram, escreva os respetivos nomes de utilizadores ou grupos no campo Criador.
   • Para conceder aos responsáveis a capacidade de ler, editar e definir autorizações para todos os recursos de código partilhados com eles, escreva os respetivos nomes de utilizador ou grupos no campo Proprietário.

6. Clicar em Seguinte.

7. Opcional: na secção APIs adicionais, clique em Ativar tudo para ativar as APIs de que precisa para criar procedimentos remotos do BigQuery através de BigQuery DataFrames.

8. Se optou por não ativar as APIs adicionais, clique em Fechar para fechar o painel Ativar funcionalidades.

Restrinja o acesso a recursos de código

Pode ajudar a impedir a ativação de APIs adicionais definindo a restrição da política da organização Restrict Resource Service Usage. Pode desativar APIs selecionadas em qualquer altura.

O que se segue?

• Para saber como gerir os Google Cloud serviços, consulte o artigo Ativar e desativar serviços.
• Para saber como gerir o acesso à API ao nível detalhado com restrições da política da organização, consulte o artigo Restringir a utilização de recursos.
• Para saber como controlar o acesso aos serviços com funções e autorizações de gestão de identidade e acesso (IAM) para o BigQuery, consulte o artigo Funções e autorizações de IAM do BigQuery.