使用 cbt 的快速入門導覽課程

本頁面說明如何使用 cbt 指令連線至 Cloud BigTable 執行個體、執行基本的管理工作,以及在資料表中讀取及寫入資料。

如果您已能熟練使用 HBase,您可能會想改為參閱使用 HBase shell 的快速入門導覽課程

事前準備

  1. 在 GCP Console 的專案選擇器頁面中,選取或建立 GCP 專案。

    前往專案選取器頁面

  2. 請確認您已啟用 Google Cloud Platform 專案的計費功能。瞭解如何確認您已啟用專案的計費功能

  3. 啟用Cloud Bigtable and Cloud Bigtable Admin必要的 API。

    啟用 API

建立 Cloud Bigtable 執行個體

  1. 在 Google Cloud Platform 主控台中開啟「建立執行個體」頁面。

    開啟「建立執行個體」頁面。

    「建立執行個體」頁面的截圖

  2. 在「Instance name」(執行個體名稱) 部分輸入 Quickstart instance

  3. 在「Instance ID」(執行個體 ID) 部分輸入 quickstart-instance

  4. 在「執行個體類型」部分,請選擇「開發」

  5. 在「儲存類型」部分,請選擇「SSD」

  6. 在「Cluster ID」(叢集 ID) 部分輸入 quickstart-instance-c1

  7. 在「地區」部分,請選擇「us-east1」

  8. 在「區域」部分,請選擇「us-east1-c」

  9. 按一下 [建立],以建立執行個體。

連線至執行個體

  1. 請先安裝 Cloud SDK

  2. 在本機或以 Cloud Shell 開啟終端機視窗:

    開啟 Cloud Shell

  3. 安裝 cbt 指令:

    gcloud components update
    gcloud components install cbt
    
  4. 建立一個 .cbtrc 檔案,將 [PROJECT_ID] 替換成您建立 Cloud Bigtable 執行個體用的專案 ID,以配置 cbt 使用您的專案和執行個體:

    echo project = [PROJECT_ID] > ~/.cbtrc
    echo instance = quickstart-instance >> ~/.cbtrc
    

現在您可以使用 cbt 指令來操作您的執行個體了!

讀取和寫入資料

Cloud Bigtable 將資料儲存於「資料表」中,資料表則包含「資料列」。 每一資料列係由一「資料列索引鍵」識別。

資料列中的資料會組織成「資料欄系列」,即為資料欄的群組。「資料欄限定詞」識別資料欄系列中的單一資料欄。

「儲存格」 是資料列和資料欄的交叉點。在 Cloud Bigtable 中,資料列與資料欄的交集可以有多個儲存格,這些儲存格是該交集的不同值版本。每個儲存格都有一個時間戳記,可以與該交集的其他儲存格區別。

  1. 建立一個名為 my-table 的資料表。

    cbt createtable my-table
    
  2. 列出您的資料表︰

    cbt ls
    

    此指令會顯示類似下面內容的輸出:

    my-table
    
  3. 新增一個叫做 cf1 的資料欄系列︰

    cbt createfamily my-table cf1
    
  4. 列出您的資料欄系列︰

    cbt ls my-table
    

    此指令會顯示類似下面內容的輸出:

    Family Name     GC Policy
    -----------     ---------
    cf1             <never>
    
  5. 使用資料欄系列 cf1 和資料欄限定詞 c1,將 test-value 這個值放在第 r1 列:

    cbt set my-table r1 cf1:c1=test-value
    
  6. 使用 cbt read 指令讀取您在資料表中新增的資料︰

    cbt read my-table
    

    shell 會顯示類似以下內容的輸出︰

    ----------------------------------------
    r1
      cf1:c1                                   @ 2019/03/26-15:05:38.840000
        "test-value"
    
  7. 刪除 my-table 資料表:

    cbt deletetable my-table
    

清除

如要避免系統向您的 GCP 帳戶收取您在本快速入門導覽課程中所用資源的相關費用:

  1. 在 GCP 主控台中開啟 Cloud Bigtable 執行個體清單。

    開啟執行個體清單

  2. 按一下 [Quickstart instance]
  3. 按一下 [刪除執行個體]

    「刪除執行個體」窗格的截圖

  4. 輸入 quickstart-instance,然後按一下 [Delete] (刪除) 以刪除執行個體。
  5. 在您的終端機視窗中刪除 .cbtrc 檔案:
    rm ~/.cbtrc

相關資源

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Bigtable 說明文件