Consulte um conjunto de dados público com a biblioteca cliente do BigQuery C#

Consulte um conjunto de dados público com a biblioteca cliente do BigQuery C#

Saiba como:

  1. Ativar o Cloud Shell num Google Cloud projeto.
  2. Abrir o editor do Cloud Shell.
  3. Preparar ficheiros para consultas.
  4. Consultar um conjunto de dados público no BigQuery.
  5. Limpar.

Tempo estimado para concluir:

Clique em Iniciar para começar.

Ative o Cloud Shell num Google Cloud projeto

  1. Se não ativar a faturação para um projeto, trabalha automaticamente no sandbox do BigQuery. O sandbox do BigQuery permite-lhe aprender a usar o BigQuery com um conjunto limitado de funcionalidades do BigQuery sem custo financeiro. Se não planear usar o seu projeto para além deste documento, recomendamos que use o sandbox do BigQuery.

  2. Clique em Ativar Cloud Shell. Mostrar-me

Para saber como abrir o editor do Cloud Shell, clique em Seguinte.

Abra o editor do Cloud Shell

  1. No Cloud Shell, crie um novo projeto e ficheiro C#:

    dotnet new console -n BigQueryCsharpDemo
    

    O resultado é semelhante ao seguinte. São omitidas várias linhas para simplificar o resultado.

    Welcome to .NET 6.0!
    ---------------------
    SDK Version: 6.0.407
    ...
    The template "Console App" was created successfully.
    ...
    

    Este comando cria um projeto C# com o nome BigQueryCsharpDemo e um ficheiro com o nome Program.cs.

  2. Abra o editor do Cloud Shell:

    cloudshell workspace BigQueryCsharpDemo
    

Para saber como preparar ficheiros para consultas, clique em Seguinte.

Prepare ficheiros para consultas

  1. Para abrir um terminal no editor do Cloud Shell, clique em Abrir terminal.

  2. Abra o diretório do projeto:

    cd BigQueryCsharpDemo
    
  3. Instale a biblioteca cliente do BigQuery para C#:

    dotnet add package Google.Cloud.BigQuery.V2
    

    O resultado é semelhante ao seguinte. São omitidas várias linhas para simplificar o resultado.

    Determining projects to restore...
    Writing /tmp/tmpF7EKSd.tmp
    ...
    info : Writing assets file to disk.
    ...
    

Para saber como consultar um conjunto de dados público no BigQuery, clique em Seguinte.

Consulte um conjunto de dados público no BigQuery

  1. Defina a variável GOOGLE_PROJECT_ID com o valor GOOGLE_CLOUD_PROJECT e exporte a variável:

    export GOOGLE_PROJECT_ID=$GOOGLE_CLOUD_PROJECT
    
  2. Clique em Abrir editor.

  3. No painel Explorador, localize o projeto BIGQUERYCSHARPDEMO.

  4. Clique no ficheiro Program.cs para o abrir.

  5. Para criar uma consulta no conjunto de dados bigquery-public-data.stackoverflow que devolva as 10 páginas do Stack Overflow mais vistas e as respetivas contagens de visualizações, substitua o conteúdo do ficheiro pelo seguinte código:

    
    using System;
    using Google.Cloud.BigQuery.V2;
    
    namespace GoogleCloudSamples
    {
        public class Program
        {
            public static void Main(string[] args)
            {
                string projectId = Environment.GetEnvironmentVariable("GOOGLE_PROJECT_ID");
                var client = BigQueryClient.Create(projectId);
                string query = @"SELECT
                    CONCAT(
                        'https://stackoverflow.com/questions/',
                        CAST(id as STRING)) as url, view_count
                    FROM `bigquery-public-data.stackoverflow.posts_questions`
                    WHERE tags like '%google-bigquery%'
                    ORDER BY view_count DESC
                    LIMIT 10";
                var result = client.ExecuteQuery(query, parameters: null);
                Console.Write("\nQuery Results:\n------------\n");
                foreach (var row in result)
                {
                    Console.WriteLine($"{row["url"]}: {row["view_count"]} views");
                }
            }
        }
    }
    

  6. Clique em Abrir terminal.

  7. No terminal, execute o script Program.cs. Se lhe for pedido que autorize o Cloud Shell e aceite os termos, clique em Autorizar.

    dotnet run
    

    O resultado é semelhante ao seguinte:

    Query Results:
    ------------
    https://stackoverflow.com/questions/35159967: 170023 views
    https://stackoverflow.com/questions/22879669: 142581 views
    https://stackoverflow.com/questions/10604135: 132406 views
    https://stackoverflow.com/questions/44564887: 128781 views
    https://stackoverflow.com/questions/27060396: 127008 views
    https://stackoverflow.com/questions/12482637: 120766 views
    https://stackoverflow.com/questions/20673986: 115720 views
    https://stackoverflow.com/questions/39109817: 108368 views
    https://stackoverflow.com/questions/11057219: 105175 views
    https://stackoverflow.com/questions/43195143: 101878 views
    

Consultou com êxito um conjunto de dados público com a biblioteca cliente do BigQuery C#.

Para evitar custos na sua conta e saber mais sobre os passos seguintes, clique em Seguinte.

Passos seguintes

Mantenha os recursos que criou e faça mais com o BigQuery ou limpe para evitar cobranças de faturação.

Faça mais com o BigQuery

Limpe

Para evitar custos na sua Google Cloud conta, elimine o seu Google Cloud projeto ou os recursos que criou neste tutorial.

Elimine o projeto

Se criou um novo projeto para saber mais sobre o BigQuery e já no precisar do projeto, elimine-o. Tenha em atenção que a eliminação de um projeto elimina tudo no projeto e os IDs de projetos personalizados são perdidos.

Elimine os recursos

Se usou um projeto existente, elimine a pasta BigQueryCsharpDemo que criou:

  1. No Cloud Shell, avance um diretório:

    cd ..
    
  2. Elimine os recursos que criou:

    rm -R BigQueryCsharpDemo
    

    A opção -R elimina todos os recursos numa pasta.