jfbiswajit/php-bigquery

PHP BigQuery for Laravel 是一个无缝集成包,允许您轻松地将 Google BigQuery 的强大功能集成到 Laravel 应用程序中。无需配置,即可使用此库在大型数据集上执行高速查询和高级分析。

1.0.0 2023-08-02 18:02 UTC

This package is auto-updated.

Last update: 2024-08-31 00:35:58 UTC


README

PHP BigQuery

描述

PHP BigQuery 是一个 Laravel 包,它使用 google/cloud-bigquery 库提供与 Google BigQuery 的无缝集成。此包允许您轻松地与 BigQuery 交互,并在数据集和表上执行各种操作。

安装

要在 Laravel 项目中开始使用 PHP BigQuery,请按照以下步骤操作

  1. 使用 Composer 安装包
composer require jfbiswajit/php-bigquery
  1. 为您的 Google Cloud 项目生成服务帐户密钥。按照以下步骤创建和下载 JSON 格式的密钥

生成服务密钥

  1. 通过访问 https://console.cloud.google.com/ 进入 Google Cloud 控制台,并使用您的 Google 帐户登录。

  2. 从页面顶部的项目选择器中选择您的 BigQuery 数据所在的项目。

  3. 在左侧菜单中,点击“IAM & Admin”,然后从子菜单中选择“服务帐户”。

  4. 点击“创建服务帐户”按钮以创建新的服务帐户。

  5. 输入服务帐户的名称和描述。将“服务帐户 ID”字段保留为默认值,因为它将自动生成。

  6. 在“角色”下拉菜单中,选择赋予服务帐户访问您 BigQuery 数据所需权限的适当角色。例如,您可以选择“BigQuery User”角色以对数据集和表进行读取访问。

  7. 点击“创建”按钮以创建服务帐户。

  8. 在“服务帐户”页面找到新创建的服务帐户。点击服务帐户条目右侧的三个点(垂直省略号),然后点击“创建密钥”。

  9. 选择“JSON”密钥类型,然后点击“创建”按钮。这将下载包含服务帐户密钥的 JSON 文件到您的计算机。

  10. 将下载的 JSON 密钥文件移动到 Laravel 项目中的一个安全位置。常见的做法是将它存储在“storage”目录中,文件名为“bigquery-credentials.json”,但您可以选择任何合适的地点。只需确保该文件不在您的 Web 服务器上公开访问,以保持您的凭据安全。

查找项目 ID

要查找您的 Google Cloud 项目 ID,请按照以下步骤操作

  1. 通过访问 https://console.cloud.google.com/ 进入 Google Cloud 控制台,并使用您的 Google 帐户登录。

  2. 如果您尚未进入项目,请使用页面顶部的项目选择器选择您的 BigQuery 数据所在的项目。

  3. 选择正确的项目后,您将在 Cloud Console 的右上角看到项目名称。

  4. 点击页面左上角的项目名称(如果显示在名称旁边,则点击项目 ID)。这将打开项目详细信息页面。

  5. 在项目详细信息页面上,您将在“项目信息”部分找到“项目 ID”。

项目 ID 是您的 Google Cloud 项目的唯一标识符,用于各种目的,包括访问 API、管理资源以及设置如我们讨论的 BigQuery 凭据。

配置

一旦您获得了服务帐户密钥和项目 ID,您可以在 Laravel 项目的 .env 文件中设置以下环境变量

GOOGLE_APPLICATION_CREDENTIALS=/path/to/your/bigquery-credentials.json
GOOGLE_CLOUD_PROJECT_ID=your-project-id

用法

将PHP BigQuery集成到您的Laravel项目中后,您可以使用此包与Google BigQuery进行交互并执行各种数据操作。该包提供了一个易于使用的门面来访问功能。

// Example code to retrieve data from BigQuery
use JfBiswajit\PHPBigQuery\Facades\BigQuery;

$results = BigQuery::query('SELECT * FROM your_dataset.your_table');

有关详细用法和可用方法,请参阅包文档。

贡献

我们非常感激您对这个项目的贡献。如果您遇到任何错误,有功能请求或想要为代码库做出贡献,请随时提交拉取请求或打开GitHub上的问题。

许可

此包是开源软件,受MIT许可的许可。

作者

感谢您选择PHP BigQuery为Laravel!我们希望这个包简化了您的BigQuery集成和数据管理任务。如果您有任何问题或需要帮助,请随时联系作者或社区以获得支持。祝您编码愉快!