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

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

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 PHP:

    mkdir bigquery-php-quickstart \
        && touch \
        bigquery-php-quickstart/app.php
    

    Este comando cria um projeto PHP com o nome bigquery-php-quickstart e um ficheiro com o nome app.php.

  2. Abra o editor do Cloud Shell:

    cloudshell workspace bigquery-php-quickstart
    

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 bigquery-php-quickstart
    
  3. Instale a biblioteca de cliente PHP do BigQuery:

    composer require google/cloud-bigquery
    

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

    Running composer update google/cloud-bigquery
    Loading composer repositories with package information
    Updating dependencies
    ...
    No security vulnerability advisories found
    Using version ^1.24 for google/cloud-bigquery
    

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. Clique em Abrir editor.

  2. No painel Explorador, localize o projeto BIGQUERY-PHP-QUICKSTART.

  3. Clique no ficheiro app.php para o abrir.

  4. 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, copie o seguinte código para o ficheiro app.php:

    <?php
    # ...
    
    require __DIR__ . '/vendor/autoload.php';
    
    use Google\Cloud\BigQuery\BigQueryClient;
    
    
    $bigQuery = new BigQueryClient();
    $query = <<<ENDSQL
    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;
    ENDSQL;
    $queryJobConfig = $bigQuery->query($query);
    $queryResults = $bigQuery->runQuery($queryJobConfig);
    
    if ($queryResults->isComplete()) {
        $i = 0;
        $rows = $queryResults->rows();
        foreach ($rows as $row) {
            printf('--- Row %s ---' . PHP_EOL, ++$i);
            printf('url: %s, %s views' . PHP_EOL, $row['url'], $row['view_count']);
        }
        printf('Found %s row(s)' . PHP_EOL, $i);
    } else {
        throw new Exception('The query failed to complete');
    }

  5. Clique em Abrir terminal.

  6. No terminal, execute o script app.php. Se lhe for pedido que autorize o Cloud Shell e aceite os termos, clique em Autorizar.

    php app.php
    

    O resultado é semelhante ao seguinte:

    --- Row 1 ---
    url: https://stackoverflow.com/questions/35159967, 170023 views
    --- Row 2 ---
    url: https://stackoverflow.com/questions/22879669, 142581 views
    --- Row 3 ---
    url: https://stackoverflow.com/questions/10604135, 132406 views
    --- Row 4 ---
    url: https://stackoverflow.com/questions/44564887, 128781 views
    --- Row 5 ---
    url: https://stackoverflow.com/questions/27060396, 127008 views
    --- Row 6 ---
    url: https://stackoverflow.com/questions/12482637, 120766 views
    --- Row 7 ---
    url: https://stackoverflow.com/questions/20673986, 115720 views
    --- Row 8 ---
    url: https://stackoverflow.com/questions/39109817, 108368 views
    --- Row 9 ---
    url: https://stackoverflow.com/questions/11057219, 105175 views
    --- Row 10 ---
    url: https://stackoverflow.com/questions/43195143, 101878 views
    Found 10 row(s)
    

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

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 elimine os recursos que criou neste tutorial.

Elimine o projeto

Se criou um novo projeto para saber mais sobre o BigQuery e já no precisa 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 bigquery-php-quickstart que criou:

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

    cd ..
    
  2. Elimine os recursos que criou:

    rm -R bigquery-php-quickstart
    

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