jfbiswajit / php-bigquery
PHP BigQuery for Laravel 是一个无缝集成包,允许您轻松地将 Google BigQuery 的强大功能集成到 Laravel 应用程序中。无需配置,即可使用此库在大型数据集上执行高速查询和高级分析。
Requires
- google/cloud-bigquery: ^1.25
This package is auto-updated.
Last update: 2024-08-31 00:35:58 UTC
README
描述
PHP BigQuery 是一个 Laravel 包,它使用 google/cloud-bigquery
库提供与 Google BigQuery 的无缝集成。此包允许您轻松地与 BigQuery 交互,并在数据集和表上执行各种操作。
安装
要在 Laravel 项目中开始使用 PHP BigQuery,请按照以下步骤操作
- 使用 Composer 安装包
composer require jfbiswajit/php-bigquery
- 为您的 Google Cloud 项目生成服务帐户密钥。按照以下步骤创建和下载 JSON 格式的密钥
生成服务密钥
-
通过访问 https://console.cloud.google.com/ 进入 Google Cloud 控制台,并使用您的 Google 帐户登录。
-
从页面顶部的项目选择器中选择您的 BigQuery 数据所在的项目。
-
在左侧菜单中,点击“IAM & Admin”,然后从子菜单中选择“服务帐户”。
-
点击“创建服务帐户”按钮以创建新的服务帐户。
-
输入服务帐户的名称和描述。将“服务帐户 ID”字段保留为默认值,因为它将自动生成。
-
在“角色”下拉菜单中,选择赋予服务帐户访问您 BigQuery 数据所需权限的适当角色。例如,您可以选择“BigQuery User”角色以对数据集和表进行读取访问。
-
点击“创建”按钮以创建服务帐户。
-
在“服务帐户”页面找到新创建的服务帐户。点击服务帐户条目右侧的三个点(垂直省略号),然后点击“创建密钥”。
-
选择“JSON”密钥类型,然后点击“创建”按钮。这将下载包含服务帐户密钥的 JSON 文件到您的计算机。
-
将下载的 JSON 密钥文件移动到 Laravel 项目中的一个安全位置。常见的做法是将它存储在“storage”目录中,文件名为“bigquery-credentials.json”,但您可以选择任何合适的地点。只需确保该文件不在您的 Web 服务器上公开访问,以保持您的凭据安全。
查找项目 ID
要查找您的 Google Cloud 项目 ID,请按照以下步骤操作
-
通过访问 https://console.cloud.google.com/ 进入 Google Cloud 控制台,并使用您的 Google 帐户登录。
-
如果您尚未进入项目,请使用页面顶部的项目选择器选择您的 BigQuery 数据所在的项目。
-
选择正确的项目后,您将在 Cloud Console 的右上角看到项目名称。
-
点击页面左上角的项目名称(如果显示在名称旁边,则点击项目 ID)。这将打开项目详细信息页面。
-
在项目详细信息页面上,您将在“项目信息”部分找到“项目 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许可的许可。
作者
- 姓名:Biswajit Biswas
- 电子邮件: jfbiswajit@gmail.com
感谢您选择PHP BigQuery为Laravel!我们希望这个包简化了您的BigQuery集成和数据管理任务。如果您有任何问题或需要帮助,请随时联系作者或社区以获得支持。祝您编码愉快!