GSP1075
Visão geral
Neste laboratório, você vai aprender a usar o BigQuery Omni com a AWS. O BigQuery Omni permite executar análises do BigQuery em dados armazenados no AWS S3. Você vai criar uma conexão autorizada entre o BigQuery do Google Cloud e o AWS S3, consultar dados que residem em buckets do S3 sem nenhuma movimentação de dados e gravar os resultados da consulta de volta nos buckets do AWS S3. Este laboratório é derivado de um guia do BigQuery Omni publicado pelo Google.
Arquitetura de alto nível

Objetivos
Neste laboratório, você aprenderá a fazer o seguinte:
- Criar uma conexão entre o Google Cloud e a AWS
- Autorizar o BigQuery Omni a ler dados em um bucket do AWS S3
- Criar uma tabela externa do BigQuery que faça referência aos dados brutos no bucket do AWS S3
- Executar consultas em dados do AWS S3
- Exportar os resultados das consultas para um bucket do AWS S3
Configuração e requisitos
Antes de clicar no botão Começar o Laboratório
Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.
Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.
Confira os requisitos para concluir o laboratório:
- Acesso a um navegador de Internet padrão (recomendamos o Chrome).
Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.
- Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.
Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.
Como iniciar seu laboratório e fazer login no console do Google Cloud
-
Clique no botão Começar laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento.
À direita, você encontra o painel Configuração e acesso ao laboratório com as seguintes informações:
- O botão Abrir console do Google Cloud
- As credenciais temporárias (nome de usuário e senha) que você vai usar no laboratório
- Outros dados, se necessários
O timer do laboratório fica na parte de cima da página e mostra o tempo restante.
-
Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.
O laboratório ativa os recursos e depois abre a página "Login" em outra guia.
Dica: coloque as guias em janelas separadas lado a lado.
Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.
-
Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Login.
{{{user_0.username | "Username"}}}
Você também encontra o nome de usuário no painel Configuração e acesso ao laboratório.
-
Clique em Avançar.
-
Copie a Senha abaixo e cole na caixa de diálogo Olá!.
{{{user_0.password | "Password"}}}
Você também encontra a senha no painel Configuração e acesso ao laboratório.
-
Clique em Avançar.
Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud.
Observação: se você usar sua própria conta do Google Cloud neste laboratório, talvez receba cobranças adicionais.
-
Acesse as próximas páginas:
- Aceite os Termos e Condições.
- Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
- Não se inscreva em testes sem custo financeiro.
Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.
Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.
Tarefa 1: criar uma conexão do BigQuery com a AWS
O BigQuery Omni acessa os dados do Amazon S3 por conexões autorizadas do Google Cloud. Cada conexão tem um usuário único do Identity and Access Management (IAM) da Amazon Web Services (AWS). Você concede permissões aos usuários por meio de papéis do IAM da AWS. As políticas nos papéis do IAM da AWS determinam quais dados o BigQuery pode acessar para cada conexão.
Observação: neste laboratório, você vai usar os consoles do Google Cloud e da AWS e alternar as duas guias/janelas com base nas descrições das tarefas.
Criar uma política do IAM da AWS para o BigQuery
-
Faça login no console de gerenciamento da AWS. Clique no botão Abrir console da AWS no painel do laboratório e faça login com o nome de usuário e a senha fornecidos.
-
Pesquise Amazon S3 na barra de pesquisa no topo da tela e selecione S3. Um bucket regional chamado com dados pré-preenchidos já está disponível para este laboratório. Copie o nome do bucket para usá-lo nas próximas etapas.
-
Pesquise AWS Identity and Access Management (IAM) na barra de pesquisa no topo da tela e selecione IAM.
-
No painel à esquerda, selecione Políticas e clique em bigquery-omni-connection-policy.
-
Clique na guia JSON, depois em Editar e cole o código abaixo no editor. Substitua todas as instâncias de <BUCKET_NAME> pelo nome do bucket do S3 que você copiou na etapa 2.
{
"Statement": [
{
"Action": [
"s3:ListBucket"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::<BUCKET_NAME>"
],
"Sid": "BucketLevelAccess"
},
{
"Action": [
"s3:GetObject"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::<BUCKET_NAME>",
"arn:aws:s3:::<BUCKET_NAME>/*"
],
"Sid": "ObjectLevelGetAccess"
},
{
"Action": [
"s3:PutObject"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::<BUCKET_NAME>",
"arn:aws:s3:::<BUCKET_NAME>/*"
],
"Sid": "ObjectLevelPutAccess"
}
],
"Version": "2012-10-17"
}
-
Clique em Avançar.
-
Clique em Salvar alterações.
Validar o IAM da AWS para o BigQuery
-
No painel esquerdo, selecione Papéis.
-
Clique no papel bigquery-omni-connection.
-
Copie o ARN, que estará no formato abaixo, em que <ACCOUNT_ID> é o ID da sua conta da AWS.
arn:aws:iam::<ACCOUNT_ID>:role/bigquery-omni-connection

Criar a conexão entre a AWS e o BigQuery
-
No console do Google Cloud, acesse o Menu de navegação e clique em BigQuery > Studio.
-
Acesse o painel Explorador e selecione + Adicionar dados.

-
Clique na caixa de seleção Armazenamento/data lakes. Em Fontes de dados em destaque, selecione Amazon S3 e depois Federação do BigQuery Omni.
-
No painel Fonte de dados externa, insira as seguintes informações:
- Em Tipo de conexão, selecione Lakehouse na AWS (via BigQuery Omni).
- Em ID da conexão, digite
bq-omni-aws-connector como identificador do recurso de conexão.
- Em Local da conexão, selecione
aws-us-east-1.
-
Opcional: em Nome de exibição, insira um nome fácil de usar para a conexão. Ele pode ser qualquer valor que ajude você a identificar o recurso de conexão se precisar modificá-lo mais tarde.
-
Opcional: em Descrição, insira uma descrição para o recurso de conexão.
- Em ID do papel da AWS, insira o ARN completo do papel do IAM que você copiou na etapa anterior neste formato:
arn:aws:iam::AWS_ACCOUNT_ID:role/ROLE_NAME
-
Clique em Criar conexão.
-
Volte para o BigQuery Classic Explorer, clique no menu suspenso ao lado do nome do projeto e acesse a conexão recém-criada na lista Conexões externas.

- Anote a Google Identity do BigQuery. Ela é um princípio do Google específico para cada conexão. Copie a Google Identity no BigQuery, que será usada na próxima seção.
Sua Google Identity do BigQuery será semelhante a esta:
BigQuery Google identity: 114999259451445753095
Clique em Verificar meu progresso para conferir o objetivo.
Criar a conexão entre a AWS e o BigQuery
Adicionar um relacionamento de confiança ao papel da AWS
O relacionamento de confiança permite que a conexão entre o BigQuery e a AWS use o papel e acesse os dados do S3, conforme especificado na política de papéis.
-
Volte ao console do IAM da AWS.
-
No painel esquerdo, selecione Papéis.
-
Selecione o papel bigquery-omni-connection.
-
Verifique se a Duração máxima da sessão está definida como 12 horas. Como cada consulta pode ser executada por até seis horas, essa duração permite uma nova tentativa adicional. Aumentar a duração da sessão para além de 12 horas não permitirá novas tentativas adicionais. Para mais informações, consulte o limite de tempo de execução de consulta de várias instruções.
-
Selecione a guia Relações de confiança e clique em Editar política de confiança.
-
Substitua o conteúdo da política pelo seguinte, substituindo BIGQUERY_IDENTITY pela Google Identity do BigQuery que você copiou na etapa 6 – Criar a conexão entre a AWS e o BigQuery.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "accounts.google.com"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"accounts.google.com:sub": "<BIGQUERY_IDENTITY>"
}
}
}
]
}
- Clique em Atualizar política.
A conexão está pronta para ser usada.
Observação: pode haver um atraso na propagação da atribuição de papéis na AWS. Se você receber um erro desse tipo ao usar uma nova conexão, aguardar e tentar novamente mais tarde pode resolver o problema.
Tarefa 2: executar consultas na tabela externa do AWS S3
O BigQuery Omni não gerencia dados armazenados no Amazon S3. Para acessar os dados do S3, defina uma tabela externa. Essa tabela é chamada de tabela externa porque os dados não ficam no armazenamento gerenciado do BigQuery. Para mais informações sobre tabelas externas, consulte Tabelas externas.
Criar um conjunto de dados do BigQuery
Nesta seção, você vai criar um conjunto de dados do BigQuery na mesma região do bucket do AWS S3.
-
No console do Google Cloud, acesse a página do BigQuery para criar um conjunto de dados.
-
No painel Classic Explorer, clique nos três pontos ao lado do nome do projeto e selecione Criar conjunto de dados.
-
Na página Criar conjunto de dados, insira as seguintes informações:
- Em ID do conjunto de dados, insira
bq_omni_demo.
- Em Local dos dados, selecione
aws-us-east-1.
-
Clique em Criar conjunto de dados.
Criar uma tabela externa
Nesta seção, você vai criar uma tabela externa no conjunto de dados acima.
-
No explorador do BigQuery, abra o projeto e selecione o conjunto de dados bq_omni_demo criado.
-
No painel de detalhes, clique em Criar tabela.
-
Na página Criar tabela, na seção Origem, faça o seguinte:
- Em Criar tabela de, selecione Amazon S3.
- Em Selecionar caminho do S3, insira
s3://[S3 bucket name]/taxi-data_green_trips_table.csv.
- Substitua
[S3 bucket name] por .
- Em Formato do arquivo, selecione CSV.
Observação: os formatos compatíveis são AVRO, PARQUET, ORC, CSV, NEWLINE_DELIMITED_JSON e Google Planilhas.
Importante: remova todos os espaços no caminho do S3 para evitar erros.
-
Na seção Destino da página Criar tabela, faça o seguinte:
- Em Nome do conjunto de dados, escolha
bq_omni_demo.
- No campo Nome da tabela, use
bq-omni-table.
- Verifique se o Tipo de tabela está definido como Tabela externa.
- Em ID da conexão, escolha o ID apropriado na lista suspensa.
- Na seção Esquema, marque a caixa de seleção Detectar automaticamente.
-
Clique em Criar tabela.
Observação: não é preciso especificar o esquema da tabela, pois ela é detectada automaticamente com base no arquivo de origem.
Clique em Verificar meu progresso para conferir o objetivo.
Criar um conjunto de dados e uma tabela externa do BigQuery
Tarefa 3: criar uma tabela externa e consultar dados do AWS S3
Com o BigQuery Omni, é possível consultar a tabela externa como qualquer tabela do BigQuery. O tamanho máximo do resultado para consultas interativas é 10 GB (visualização). Para mais informações, consulte Limitações. Se o resultado da consulta for maior que 10 GB, exporte-o para o Amazon S3. O resultado da consulta é armazenado em uma tabela temporária do BigQuery.
Consultar a tabela externa
-
Na página de detalhes do bq-omni-table, clique em Consulta para abrir um novo editor.
-
No editor de consultas, execute a instrução a seguir:
SELECT * FROM `{{{project_0.project_id|S3 bucket name}}}.bq_omni_demo.bq-omni-table`
- Clique em Executar.
Você verá esta resposta:

Clique em Verificar meu progresso para conferir o objetivo.
Consultar a tabela externa
Tarefa 4: exportar os resultados da consulta para o AWS S3
O BigQuery Omni permite exportar o resultado de uma consulta em uma tabela externa do BigQuery para o Amazon S3.
Exportar resultados da consulta
O BigQuery Omni grava no local especificado do Amazon S3, independentemente do conteúdo que já estiver lá. A consulta de exportação pode substituir os dados ou combinar o resultado da consulta com os dados existentes. No campo "Editor de consultas", você precisa executar uma consulta SQL padrão de exportação do Google. O SQL padrão do Google é a sintaxe padrão do console do Google Cloud. Este é um modelo do que você precisa escrever:
EXPORT DATA WITH CONNECTION `CONNECTION_REGION.CONNECTION_NAME` \
OPTIONS(uri="s3://BUCKET_NAME/PATH", format="FORMAT", ...) \
AS QUERY
Você precisa substituir o seguinte:
-
CONNECTION_REGION: a região em que a conexão foi criada.
-
CONNECTION_NAME: o nome da conexão que você criou com a permissão necessária para gravar no bucket do S3.
-
BUCKET_NAME: o bucket do Amazon S3 em que você quer gravar os dados.
-
PATH: o caminho em que você quer gravar o arquivo exportado.
-
FORMAT: os formatos aceitos são JSON, AVRO e CSV.
-
QUERY: a consulta para analisar os dados armazenados em uma tabela externa do BigQuery.
- Neste laboratório, a consulta já foi preenchida para você. Cole-a no editor:
EXPORT DATA WITH CONNECTION `aws-us-east-1.bq-omni-aws-connector`
OPTIONS(uri="s3://{{{project_0.project_id|S3 bucket name}}}/exports/*", format="CSV")
AS SELECT * FROM `{{{project_0.project_id|S3 bucket name}}}.bq_omni_demo.bq-omni-table`
- Clique em Executar.
Você verá esta resposta:
Successfully exported 15417 rows into 1 files.
- Navegue até o bucket do S3 e verifique se os dados foram exportados no diretório
exports.

Ótimo! Você executou uma consulta de exportação e criou um arquivo no bucket do S3.
Clique em Verificar meu progresso para conferir o objetivo.
Exportar os resultados da consulta para o AWS S3
Parabéns!
Neste laboratório, você criou uma conexão entre o Google Cloud e a AWS e autorizou o BigQuery Omni a ler os dados em um bucket do AWS S3. Depois, você criou uma tabela externa do BigQuery que faz referência aos dados brutos no bucket do AWS S3, executou consultas nos dados e exportou os resultados da consulta de volta para um bucket do AWS S3.
Próximas etapas/Saiba mais
Confira o seguinte para receber mais informações sobre o BigQuery Omni:
Treinamento e certificação do Google Cloud
Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.
Manual atualizado em 18 de maio de 2026
Laboratório testado em 19 de fevereiro de 2026
Copyright 2026 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.