google/cloud-bigtable

Cloud Bigtable PHP客户端

v2.3.0 2024-09-13 22:45 UTC

README

Google Cloud Bigtable的PHP客户端,遵循PHP语言风格。

Latest Stable Version Packagist

注意:此存储库是Google Cloud PHP项目的一部分。任何支持请求、错误报告或开发贡献应直接提交到该项目。

适用于大型分析性和操作工作负载的高性能NoSQL数据库服务。

安装

首先,安装PHP首选依赖项管理器Composer

现在安装此组件

$ composer require google/cloud-bigtable

此组件支持HTTP/1.1和gRPC。为了利用gRPC(如流式方法)提供的优势,请参阅我们的gRPC安装指南

客户端显著差异

此包提供的手动客户端与google-cloud-php中提供的其他客户端相比,更直接地封装了我们的生成客户端。这意味着您可能习惯的一些惯用语法和配置选项可能会有所不同。以下列出了最显著的不同之处

  • 现在通过credentials配置选项提供密钥文件,而不是keyFilekeyFilePath
  • 现在对重试逻辑有更细粒度的控制。请参阅bigtable_client_config.json文件以获取示例配置,该配置可在构造客户端时传递。
  • 网络级别的异常触发现在使用基本类Google\ApiCore\ApiException,而不是Google\Cloud\Core\ServiceException
  • authHttpHandlerhttpHandler客户端配置选项现在分别通过$credentialsConfig['authHttpHandler']$transportConfig['httpHandler']提供。此外,请注意,现在httpHandler应返回Guzzle的PromiseInterface实现。

身份验证

请参阅我们的身份验证指南以获取有关身份验证客户端的更多信息。一旦认证,您就可以开始发出请求。

在阅读身份验证指南时,请注意,此包的手动客户端将更紧密地遵循为生成客户端指定的约定。

示例

require 'vendor/autoload.php';

use Google\Cloud\Bigtable\BigtableClient;

$bigtable = new BigtableClient();
$table = $bigtable->table('my-instance', 'my-table');
$rows = $table->readRows();

foreach ($rows as $row) {
    print_r($row) . PHP_EOL;
}

版本

此组件被认为是GA(通常可用)。因此,它不会在任何次要或修补程序版本中引入不兼容的更改。我们将以最高优先级解决问题和请求。

请参阅迁移指南以从库的V1版升级到V2版。

下一步

查看并理解官方文档