快速入门:使用 HBase Shell

本页面介绍如何使用 HBase shell 连接到 Cloud Bigtable 实例、执行基本的管理任务以及读取和写入表数据。

如果您不想使用 HBase shell,则可以前往快速入门:使用 cbt 命令页面,并按其中的说明进行操作。

准备工作

  1. 在 Cloud Console 的项目选择器页面上,选择或创建 Cloud 项目。

    转到项目选择器页面

  2. 确保您的 Google Cloud 项目已启用结算功能。 了解如何确认您的项目已启用结算功能

  3. 启用 Cloud Bigtable and Cloud Bigtable Admin API。

    启用 API

创建 Cloud Bigtable 实例

  1. 在 Google Cloud Console 中打开“创建实例”页面。

    打开“创建实例”页面

    “创建实例”页面屏幕截图

  2. 实例名称部分,输入 Quickstart instance

  3. 实例 ID 部分,输入 quickstart-instance

  4. 存储类型部分,选择 SSD

  5. 集群 ID 部分,输入 quickstart-instance-c1

  6. 区域部分,选择 us-east1

  7. 对于地区,请选择 us-east1-c

  8. 点击创建以创建实例。

连接到您的实例

  1. 在 Cloud Shell 中打开一个终端窗口。

    在 Cloud Shell 中打开

  2. 如需在 Java 版的 Cloud Bigtable HBase 客户端中使用 HBase shell,您必须安装 Java 8 运行时环境。不支持其他版本的 Java。通过运行以下命令安装和设置 Java 8 环境:

    sudo apt-get update
    sudo apt-get install openjdk-8-jdk-headless
    export JAVA_HOME=$(update-alternatives --list java | tail -1 | sed -E 's/\/bin\/java//')
  3. 克隆包含 HBase shell 文件的代码库,然后切换到 HBase shell 所在的目录:

    git clone https://github.com/GoogleCloudPlatform/cloud-bigtable-examples.git
    cd cloud-bigtable-examples/quickstart
  4. 启动 HBase shell:

    ./quickstart.sh

您现在已经连接成功!

读取和写入数据

Cloud Bigtable 将数据存储在表中。这些表包含行,且每行由一个行键标识。

行中的数据以“列族”(即一组列)的形式整理。 “列限定符”用于标识列族中的单个列。

行和列交集处的值可以有多个带时间戳的版本。每个版本称为“单元格”

  1. 创建一个名为 my-table 的表和一个名为 cf1 的列族:

    create 'my-table', 'cf1'
    

    该 shell 会显示类似如下所示的输出:

    0 row(s) in 1.5210 seconds
    
    => Hbase::Table - my-table
    
  2. 列出您的表:

    list
    

    该 shell 会显示类似如下所示的输出:

    TABLE
    my-table
    1 row(s) in 1.3580 seconds
    
    => ["my-table"]
    
  3. 使用 cf1 列族和 c1 列限定符,将 test-value 值添加到 r1 行中:

    put 'my-table', 'r1', 'cf1:c1', 'test-value'
    
  4. 使用 scan 命令扫描此表并读取您添加的数据:

    scan 'my-table'
    

    该 shell 会显示类似如下所示的输出:

    ROW      COLUMN+CELL
     r1      column=cf1:c1, timestamp=1430687836046, value=test-value
    1 row(s) in 0.6260 seconds
    
  5. 删除 my-table 表。

    disable 'my-table'
    drop 'my-table'
    
  6. 输入 exit,然后按 Enter 退出 HBase shell。退出后,您将会看到一系列日志消息(这是正常情况)。

清理

为避免系统因本快速入门中使用的资源向您的 Google Cloud 帐号收取费用,请按照以下步骤操作。

  1. 在 Cloud Console 中打开 Cloud Bigtable 实例列表。

    打开实例列表

  2. 点击快速入门实例
  3. 点击删除实例

    “删除实例”窗格屏幕截图

  4. 输入 quickstart-instance,然后点击删除以删除该实例。

后续步骤