Alguns recursos do Gemini no BigQuery estão disponíveis
sem custo financeiro adicional, enquanto outros exigem uma cota,
que é conquistada usando a capacidade de computação. Para saber mais sobre o uso
dos recursos do Gemini no BigQuery, consulte Preços do Gemini
no BigQuery.
Ativar as APIs necessárias e conceder perfis
Para usar o Gemini no BigQuery,
ative as APIs exigidas e conceda os perfis necessários do Identity and Access Management
(IAM). Normalmente, essa etapa é realizada por um administrador
de serviços ou proprietário do projeto com
a permissão serviceusage.services.enable do IAM. Para uma lista de APIs e serviços usados
pelo BigQuery, consulte Gerenciar dependências da API BigQuery.
No console Google Cloud , com seu projeto selecionado, acesse a página
BigQuery Studio.
Confira um recurso do Gemini no BigQuery no
console Google Cloud . Por exemplo, no BigQuery Studio, passe o cursor
sobre o ícone
pen_sparkarrow_drop_downGemini.
Você vai receber uma solicitação para ativar outras APIs do Google Cloud.
Clique em Continuar para começar a ativar as APIs
do Google Cloud necessárias. Um painel lateral lista as APIs necessárias
para usar o Gemini no BigQuery.
Para cada uma delas, clique em Ativar para ativar a API no projeto
atual e clique em Próxima.
Para conceder às entidades principais os perfis do IAM necessários para usar
o Gemini no BigQuery, insira os nomes de usuário deles.
Os seguintes perfis concedem as permissões necessárias para usar o Gemini:
Se você é um analista de dados, cientista de dados ou desenvolvedor que quer usar
recursos específicos do Gemini no BigQuery para escrever
consultas SQL e código Python, ative o recurso no
console Google Cloud . Para saber como ativar os recursos, consulte
Antes de começar em
"Escrever consultas com a assistência do Gemini".
Os usuários com os perfis ou permissões do IAM necessários podem acessar
os recursos do Gemini no BigQuery que você ativou
para o projeto Google Cloud . Para mais informações, consulte
Visão geral do Gemini para Google Cloud .
Usar insights de dados e recursos de geração automática de metadados
Os insights de dados do BigQuery e os recursos de geração automática de metadados
estão disponíveis para clientes que usam o BigQuery on demand para computação,
a edição Enterprise ou a edição Enterprise Plus. A cota de
verificações de insights de dados e geração de metadados se baseia no uso desses
modelos de computação no
nível da organização. Para informações sobre cotas desses recursos, consulte
Cotas do Gemini no BigQuery.
Ativar os recursos em fase de pré-lançamento do Gemini no BigQuery
Alguns recursos do Gemini no BigQuery em
fase de pré-lançamento
fazem parte do programa Trusted Tester. Para solicitar acesso a esses recursos,
um administrador precisa preencher o
formulário de inscrição para pré-GA do Gemini no BigQuery.
O acesso aos recursos do Gemini no BigQuery em pré-GA é
ativado periodicamente em lotes.
Recursos em fase de pré-lançamento que exigem inscrição no
Gemini no BigQuery:
Conclusão de consultas SQL (pré-lançamento)
Geração automática de metadados para insights de dados (pré-lançamento)
Expressões em linguagem natural no SQL (experimental)
Insights de conjuntos de dados com o mecanismo de conhecimento do BigQuery (pré-lançamento)
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eTo use Gemini in BigQuery, you must purchase either the Enterprise Plus edition or Gemini Code Assist Enterprise edition.\u003c/p\u003e\n"],["\u003cp\u003eEnabling Gemini in BigQuery requires enabling the Gemini for Google Cloud API and, optionally, the Recommender API for certain features.\u003c/p\u003e\n"],["\u003cp\u003eGranting users access to Gemini in BigQuery involves assigning them the Gemini for Google Cloud User IAM role, along with other feature-specific roles if needed.\u003c/p\u003e\n"],["\u003cp\u003eCertain preview features, like SQL query completion and Apache Spark assisted troubleshooting, require signing up through the Gemini in BigQuery Pre-GA Sign-up form.\u003c/p\u003e\n"],["\u003cp\u003eData analysts, scientists, or developers need to turn on Gemini in BigQuery features in the Google Cloud console to utilize AI-assisted SQL query and Python code writing.\u003c/p\u003e\n"]]],[],null,["# Set up Gemini in BigQuery\n\nBefore you can use\n[Gemini in BigQuery](/gemini/docs/bigquery/overview), which\noffers AI-powered assistance for your data analytics, your team must do\nthe following:\n\n1. [Enable necessary APIs and grant roles.](#enable-api)\n2. [Turn on Gemini in BigQuery features in\n the Google Cloud console.](#use)\n\nSome Gemini in BigQuery features are available at no\nadditional charge while other features require [quota](/gemini/docs/quotas#bigquery)\nwhich is earned by using compute capacity. To learn more about using\nGemini in BigQuery features, see [Gemini\nin BigQuery pricing](/gemini/pricing#gemini-in-bigquery-pricing).\n| **Note** : Gemini in BigQuery is part of Gemini for Google Cloud and doesn't support the same compliance and security offerings as BigQuery. You should only set up Gemini in BigQuery for BigQuery projects that don't require [compliance offerings that aren't supported by Gemini for Google Cloud](/gemini/docs/discover/certifications). For information about how to turn off or prevent access to Gemini in BigQuery, see [Turn off Gemini for Google Cloud products](/gemini/docs/turn-off-gemini).\n\nEnable necessary APIs and grant roles\n-------------------------------------\n\nTo use Gemini in BigQuery,\nyou must enable required APIs and grant necessary Identity and Access Management (IAM)\nroles. A service administrator or project\nowner with the [`serviceusage.services.enable` IAM permission](/service-usage/docs/access-control#predefined_roles)\ntypically performs this step. For a list of APIs and services used by\nBigQuery, see [Manage BigQuery API dependencies](/bigquery/docs/service-dependencies).\n\n1. In the the Google Cloud console, with your project selected, go to the\n **BigQuery Studio** page.\n\n [Go to BigQuery Studio](https://console.cloud.google.com/bigquery)\n2. View a Gemini in BigQuery feature in the\n the Google Cloud console. For example, in BigQuery Studio hover\n over the\n pen_sparkarrow_drop_down**Gemini**\n icon.\n\n You are prompted to enable additional Google Cloud APIs.\n3. Click **Continue** to get started enabling required\n Google Cloud APIs. A side panel lists the required APIs\n required to use Gemini in BigQuery.\n\n4. For each required API, click **Enable** to enable the API for the current\n project, and then click **Next**.\n\n5. To grant principals the IAM roles that are required to use\n Gemini in BigQuery, enter their user names.\n The following roles grant the permissions required to use Gemini:\n\n - [BigQuery Studio User](/bigquery/docs/access-control#bigquery.studioUser)\n - [BigQuery Studio Admin](/bigquery/docs/access-control#bigquery.studioAdmin)\n6. Click **Done**.\n\nTurn on Gemini in BigQuery features\n-----------------------------------\n\nIf you're a data analyst, data scientist, or developer who wants to use\nspecific Gemini in BigQuery features to write\nSQL queries and Python code, then you need to turn on the feature in\nthe Google Cloud console. To learn how to turn on features, see\n[Before you begin](/bigquery/docs/write-sql-gemini#before_you_begin) in\n\"Write queries with Gemini assistance.\"\nUsers who have the necessary IAM roles or permissions can then access\nthe Gemini in BigQuery features that you enabled\nfor their Google Cloud project. For more information, see\n[Gemini for Google Cloud overview](/gemini/docs/overview).\n\n### Use data insights and automated metadata generation features\n\nBigQuery data insights and automated metadata generation features\nare available to customers using BigQuery on-demand compute,\nEnterprise edition, or Enterprise Plus edition. The quota for\ndata insights scans and metadata generation is based on the use of these\ncompute models at the\norganization level. For information about quotas for these features, see\n[Quotas for Gemini in BigQuery](/gemini/docs/quotas#bigquery).\n\nIf your organization is using BigQuery Standard edition\nfor compute only, then you can use Gemini Code Assist Standard, which\nincludes data insights and automated metadata generation capabilities in\naddition to features listed in [Gemini Code Assist Standard and\nEnterprise pricing\noverview](/products/gemini/pricing#gemini_code_assist_standard_and_enterprise_pricing_overview).\nTo learn how to purchase Gemini Code Assist Standard, see [Purchase a\nGemini Code Assist Standard\nsubscription](/gemini/docs/discover/set-up-gemini#purchase-subscription) and\nfollow the instructions to purchase Standard edition.\n\n### Enable Gemini in BigQuery preview features\n\nCertain Gemini in BigQuery features in\n[Preview](/products#product-launch-stages)\nare part of the trusted tester program. To request access to these features,\nan administrator must complete the\n[Gemini in BigQuery Pre-GA Sign-up form](https://goo.gle/gemini-in-bq-preview).\nGemini in BigQuery pre-GA feature access is\nenabled periodically in batches.\n\nPreview features that require Gemini in BigQuery\nsign-up include the following:\n\n- SQL query completion (Preview)\n- Automated metadata generation for data insights (Preview)\n- Natural language expressions in SQL (Experimental)\n- Dataset insights with BigQuery knowledge engine (Preview)\n\nWhat's next\n-----------\n\n- Learn more about the [types of generative AI assistance available in Gemini for Google Cloud](/gemini/docs/overview).\n- Learn [how Gemini for Google Cloud uses your data](/gemini/docs/discover/data-governance).\n- Learn [how to access and manage Gemini administrator controls](/gemini/docs/admin)."]]
