Onde o Gemini no BigQuery processa seus dados

Este documento ajuda você a entender onde o Gemini no BigQuery processa seus dados. Esse comportamento se aplica aos seguintes recursos do Gemini no BigQuery:

Para esses recursos, o processamento do Gemini ocorre nos limites jurisdicionais do local da consulta ou onde o conjunto de dados do BigQuery está armazenado. Por exemplo, se o local da consulta ou o conjunto de dados do BigQuery estiver na região europe-west1, o processamento do Gemini vai ocorrer em um local dentro do limite jurisdicional EU. Esse design minimiza a movimentação de dados e segue as práticas recomendadas de governança de dados. Para mais informações sobre restrições em jurisdições disponíveis, consulte Limitações.

Para a maioria dos recursos do Gemini no BigQuery, o local de processamento do Gemini pode ser controlado por um administrador usando a configuração Local padrão global no nível do projeto ou da organização. Os usuários do BigQuery podem substituir esse local padrão global usando a configuração Local da consulta no BigQuery Studio. Nos casos em que uma configuração de local da consulta não é especificada nas configurações de configuração por um administrador ou explicitamente pelo usuário na consulta, o Gemini no BigQuery usa o local derivado da consulta que está sendo editada. Para saber mais sobre como o BigQuery determina o local da consulta, consulte Executar uma consulta.

O Gemini no BigQuery determina a jurisdição de US ou EU com base nesses controles. Se não for possível determinar uma jurisdição, o local de tratamento global será usado com base nos locais de veiculação do Gemini.

As seções a seguir explicam como gerenciar onde cada recurso do Gemini no BigQuery processa seus dados.

Editor SQL e tela de dados

Ao gerar código usando o editor de SQL ou usar a tela de dados para criar fluxos de trabalho de análise de dados, o Gemini no BigQuery usa a seguinte lógica para determinar o local de processamento:

  • Um administrador do BigQuery pode especificar um local padrão no nível da organização ou do projeto. Para saber como especificar um local padrão, consulte Especificar o local padrão no nível da organização ou do projeto.

  • Um usuário do BigQuery pode especificar um local de consulta no BigQuery Studio que substitui a configuração do administrador. Para saber como especificar uma configuração de local de consulta padrão no BigQuery, consulte Especificar locais.

  • Se não for possível determinar o local de um conjunto de dados ou se o local padrão da consulta do usuário não for especificado, o BigQuery tentará determinar o local do conjunto de dados ou da consulta com base na execução de teste. Exemplo:

    • Exemplo do editor de SQL: se sua solicitação do Gemini para Transformar SQL com o Gemini fizer referência a um conjunto de dados em europe-west1, o Gemini vai processar os dados no limite jurisdicional EU.
    • Exemplo de tela de dados: se a tela de dados visualizar informações de um conjunto de dados localizado em us-east4, todas as análises ou sugestões do Gemini no BigQuery serão processadas nos limites jurisdicionais de US.

Especificar o local padrão no nível da organização ou do projeto

Um administrador do BigQuery pode especificar um local padrão no nível da organização ou para envolvidos no projeto em que as solicitações do Gemini são processadas. O local padrão é armazenado em cache durante a sessão do usuário enquanto ele edita na guia atual do editor de SQL.

Pré-requisito

Para especificar o local padrão no nível da organização ou do projeto em que os dados são processados, um administrador do BigQuery precisa primeiro ativar o recurso do BigQuery preenchendo este formulário e depois receber um e-mail confirmando que o recurso foi ativado.

Funções exigidas

Para especificar um local padrão da organização ou do projeto, é preciso ter o papel de administrador do BigQuery (roles/bigquery.admin), que inclui a permissão bigquery.config.update necessária para especificar uma configuração. Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Definir o local padrão

Para definir um local padrão no nível da organização ou do projeto, siga estas etapas:

  1. No console do Google Cloud , acesse a página BigQuery.

    Acessar o BigQuery

  2. No painel de navegação, clique em Explorer.

  3. Selecione a organização ou o projeto para especificar um local padrão.

  4. No editor de SQL do BigQuery, insira a seguinte instrução:

    • Configurações no nível da organização: 
      ALTER ORGANIZATION SET OPTIONS(default_location='my-default-region');
    • Configurações no nível do projeto: 
      ALTER PROJECT SET OPTIONS(default_location='my-default-region');

Esse comando define o valor de default_location como my-default-region.

Verificar o local padrão para o tratamento de dados

Para verificar o local padrão do tratamento de dados de uma consulta SQL assistida pelo Gemini no BigQuery, siga estas etapas:

  1. No console do Google Cloud , acesse a página BigQuery.

    Acessar o BigQuery

  2. No editor de SQL do BigQuery Studio, execute a seguinte consulta:

    SELECT
    COALESCE(
        (
            SELECT
                option_value
            FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
            WHERE option_name = 'default_location'
        ),
        (
            SELECT
                option_value
            FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS
            WHERE option_name = 'default_location'
        ));

O resultado mostra o valor default_location definido como o valor que você definiu como my-default-region. Essa consulta retorna o local padrão do projeto, se definido. Caso contrário, a consulta vai retornar o local padrão da organização. O local em que as operações do Gemini no BigQuery são executadas não é especificado explicitamente pelo usuário.

Insights de dados do BigQuery

Para gerar insights usando insights de dados do BigQuery, execute operações de verificação de dados em tabelas e recursos de conjuntos de dados selecionados. Essas verificações são criadas no mesmo local que o recurso do conjunto de dados do BigQuery. Nas jurisdições US ou EU, o processamento do Gemini no BigQuery é restrito à jurisdição em que a verificação é executada. Fora das jurisdições US e EU, o tratamento é feito globalmente. Para saber onde o tratamento de dados globais do Gemini acontece, consulte Locais de atendimento do Gemini.

Preparação de dados do BigQuery

O local em que a preparação de dados do BigQuery processa os dados depende do recurso de preparação de dados que você está usando.

  • Para a preparação de dados independente, o local de processamento do Gemini no BigQuery é o mesmo em que o conjunto de dados do BigQuery está localizado.
  • Se você executar a preparação de dados como parte dos pipelines do Dataform ou do BigQuery, o local de processamento de dados do Gemini no BigQuery será determinado pela configuração defaultLocation do Dataform, se ela estiver definida. A configuração defaultLocation também determina o local do job do BigQuery. Isso garante que o processamento do Gemini no BigQuery seja feito dentro dos mesmos limites jurisdicionais.
  • Se defaultLocation para o Dataform ou o pipeline do BigQuery que contém sua preparação de dados não estiver definido, a região de processamento do Gemini no BigQuery será determinada usando a configuração de região do repositório. Um pipeline sem uma configuração defaultLocation especificada pode executar diferentes jobs do BigQuery em locais diferentes com base no local das tabelas usadas nos nós do pipeline. Como prática recomendada, defina defaultLocation para garantir um local de processamento consistente.

Limitações

As seguintes limitações se aplicam quando você identifica onde o Gemini no BigQuery processa dados:

  • O Gemini no BigQuery não oferece residência de dados para locais individuais. O tratamento de dados pode ser especificado para as jurisdições compatíveis com US e EU. Os dados fora dessas jurisdições são tratados globalmente.
  • O tratamento de jurisdição do Gemini no BigQuery está disponível apenas para recursos do Gemini no BigQuery com disponibilidade geral (GA). Para conferir uma lista de recursos do Gemini no BigQuery, consulte Visão geral do Gemini no BigQuery.

  • A assistência de código do notebook Python do BigQuery e o agente de ciência de dados para o Colab Enterprise no BigQuery só oferecem suporte ao processamento global do Gemini.

  • O Gemini no chat do Cloud Assist (GCA) só é compatível com o processamento global do Gemini. Para negar o acesso ao painel de chat da GCA, remova a permissão cloudaicompanion.instances.completeTask do Identity and Access Management (IAM) dos usuários. Para saber mais sobre como criar papéis personalizados, consulte Criar e gerenciar papéis personalizados.

A seguir