Carregar e consultar dados

Comece a usar o BigQuery criando um conjunto de dados, carregando dados em uma tabela e consultando a tabela.

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientação:

Orientações

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Se este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissões necessárias.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Se este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissões necessárias.

  6. Enable the BigQuery API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    Para novos projetos, a API BigQuery é ativada automaticamente.

  7. Opcional: ative o faturamento do projeto. Se você não quiser ativar o faturamento ou informar um cartão de crédito, as etapas deste documento ainda funcionarão. O BigQuery fornece um sandbox para executar as etapas. Para mais informações, consulte Ativar o sandbox do BigQuery.

    8. Funções exigidas

    Para receber as permissões necessárias para criar um conjunto de dados, uma tabela, carregar e consultar dados, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

    Criar um conjunto de dados do BigQuery

    Use o console do Google Cloud para criar um conjunto de dados que armazene os dados. Você cria o conjunto de dados no local multirregional dos EUA. Para informações sobre regiões e multirregiões do BigQuery, consulte Locais.

    1. No console do Google Cloud , abra a página do BigQuery.
      2. Acessar o BigQuery
    2. No painel à esquerda, clique em Explorer.
    3. No painel Explorador,, clique no nome do seu projeto.
    4. Clique em Ver ações.
    5. Selecione Criar conjunto de dados.
    6. Na página Criar conjunto de dados, faça o seguinte:
      1. Para o código do conjunto de dados, insira babynames.
      2. Em Tipo de local, selecione Multirregião e escolha EUA (várias regiões nos Estados Unidos). Os conjuntos de dados públicos são armazenados no local multirregional us. Para simplificar, armazene seus conjuntos de dados no mesmo local.
      3. Mantenha as configurações padrão restantes e clique em Criar conjunto de dados.

    Fazer o download do arquivo que contém os dados de origem

    Você está fazendo o download de um arquivo que tem aproximadamente 7 MB de dados com os nomes mais comuns de bebês. Ele é fornecido pela Administração da Previdência Social dos EUA.

    Para mais informações sobre os dados, consulte as Informações básicas sobre nomes populares da Administração da Previdência Social.

    1. Faça o download dos dados da Administração de Previdência Social dos EUA abrindo o URL a seguir em uma nova guia do navegador:

      https://www.ssa.gov/OACT/babynames/names.zip

    2. Extraia o arquivo.

      Para mais informações sobre o esquema do conjunto de dados, consulte o arquivo zip NationalReadMe.pdf.

    3. Para conferir os dados, abra o arquivo yob2024.txt. Esse arquivo contém valores separados por vírgula para nome, sexo atribuído no nascimento e número de crianças com esse nome. O arquivo não tem linha de cabeçalho.

    4. Observe o local do arquivo yob2024.txt para encontrá-lo mais tarde.

    Carrega dados em uma tabela

    Em seguida, carregue os dados em uma nova tabela.

    1. No painel à esquerda, clique em Explorer.
    2. No painel Explorer selecione o nome do seu projeto.
    3. Clique em Conjuntos de dados e, ao lado do conjunto babynames, clique em Ver ações e selecione Abrir.
    4. Clique em Criar tabela.

      A menos que indicado de outra forma, use os valores padrão para todas as configurações.

    5. Na página Criar tabela, faça o seguinte:
      1. Na seção Origem, em Criar tabela de, escolha Fazer upload na lista.
      2. No campo Selecionar arquivo, clique em Procurar.
      3. Navegue até o arquivo yob2024.txt local e clique em Abrir.
      4. Na lista Formato do arquivo, selecione CSV.
      5. Na seção Destino, no campo Tabela, insira names_2024.
      6. Na seção Esquema, clique no botão ativar/desativar Editar como texto e cole a seguinte definição de esquema no campo de texto:
        7. name:string,assigned_sex_at_birth:string,count:integer
      7. Clique em Criar tabela.

        Aguarde o BigQuery criar a tabela e carregar os dados.

    Visualizar dados da tabela

    Para visualizar os dados da tabela, siga estas etapas:

    1. No painel à esquerda, clique em Explorer.
    2. No painel Explorer, expanda o projeto e clique em Conjuntos de dados.
    3. Clique no conjunto de dados babynames e selecione a tabela names_2024.
    4. Clique na guia Visualização. O BigQuery mostra as primeiras linhas da tabela.
      5. A guia de visualização da tabela.
    A guia Visualização não está disponível para todos os tipos de tabela. Por exemplo, a guia Visualização não é exibida em tabelas ou visualizações externas.

    Consultar os dados da tabela

    Em seguida, consulte a tabela.

    1. Ao lado da guia names_2024, clique na opção Consulta SQL. Uma nova guia do editor será aberta.
    2. No editor de consultas, cole o conteúdo abaixo. Essa consulta retorna os cinco nomes masculinos mais comuns de bebês nascidos nos EUA em 2024.
      
  SELECT
    name,
    count
  FROM
    `babynames.names_2024`
  WHERE
    assigned_sex_at_birth = 'M'
  ORDER BY
    count DESC
  LIMIT
    5;
    3. Clique em Executar. Os resultados são exibidos na seção Resultados da consulta.
      O painel de resultados da consulta

    Você consultou uma tabela em um conjunto de dados público e depois carregou os dados de amostra no BigQuery usando o console do Google Cloud .

    Limpar

    Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

    1. No console do Google Cloud , abra a página do BigQuery.
      2. Acessar o BigQuery
    2. No painel à esquerda, clique em Explorer.
    3. No painel Explorer, clique em Conjuntos de dados e depois no conjunto babynames que você criou.
    4. Expanda a opção Ver ações e clique em Excluir.
    5. Na caixa de diálogo Excluir conjunto de dados, confirme o comando de exclusão: digite a palavra delete e clique em Excluir.

    A seguir