設定應用程式設定檔

此頁面說明如何建立及管理 Cloud Bigtable 執行個體的應用程式設定檔。同時亦說明該如何使用自定義應用程式設定檔來連結 Cloud Bigtable。

在閱讀此頁面之前,您需要先瞭解何謂應用程式設定檔及運作方式。如果您是使用應用程式設定檔來設定複製功能,請務必詳閱 Cloud BigTable 複製總覽的內容及複製功能設定範例,並決定哪些設定最適合您的用途。

建立自定義應用程式設定檔

您可以針對每一個執行個體建立許多不同的客製化應用程式設定檔。您可以透過自訂應用程式設定檔,針對不同應用程式或是應用程式中的不同功能來進行控管。例如,您可將單一應用程式設定檔用於批次處理應用程式,來將流量區隔至單一的叢集中,或使用不同的應用程式設定檔,為其他應用程式提供可用性。

如要建立自訂應用程式設定檔,請進行以下操作:

主控台

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

    開啟執行個體清單

  2. 點擊您要建立應用程式設定檔的執行個體。

  3. 按一下左側窗格中的 [Application profiles] (應用程式設定檔)。

  4. 點擊 [建立應用程式設定檔]

  5. 輸入應用程式設定的 ID。

    應用程式設定檔 ID 是應用程式的永久辨識碼。當您的應用程式與 Cloud Bigtable 連結時,即會提供該 ID。

  6. 輸入應用程式設定檔的說明。

  7. 在 [叢集發送]下,選擇您要使用單叢集發送的叢集 ID,或是使用多叢集發送的任一叢集瞭解詳情

  8. 當您需要啟用單一資料列交易時,請在 [單一資料列交易] 底下選擇 [允許單一資料列交易] 勾選方塊。 瞭解詳情

    若要啟用單一資料列交易,您必須使用單一叢集發送。

  9. 點擊建立以建立應用程式設定檔。

  10. 請更新您的應用程式設定代碼以連結至 Cloud Bigtable,以便使用新的應用程式設定檔。

gcloud

  1. 如果您不知道執行個體 ID,請使用 bigtable instances list 指令查看專案的執行個體清單:

    gcloud bigtable instances list
    
  2. 使用 bigtable app-profiles create 指令建立一個應用程式設定檔:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

    提供下列這些值:

    • APP_PROFILE_ID:應用程式設定檔的永久 ID。
    • INSTANCE_ID:執行個體的永久 ID。

    該指令接受下列選用標記:

    • --description=DESCRIPTION:應用程式設定檔的詳細說明。
    • --force:忽略關於潛在問題的警告,以及與其他應用程式設定檔的衝突。
    • --route-any:啟用多叢集轉送功能,將要求轉送到任何可用的叢集。

      您無法將此標記與 --route-to--transactional-writes 標記組合在一起。

    • --route-to=CLUSTER_ID:所有請求應轉送至此叢集 ID。這個標記可啟用單叢集轉送

      您無法將此標記與 --route-any 標記組合在一起。

    • --transactional-writes:在應用程式設定檔中啟用單一資料列交易

      您無法將此標記與 --route-any 標記組合在一起。

  3. 請更新您的應用程式設定代碼以連結至 Cloud Bigtable,以便使用新的應用程式設定檔。

與自定義應用程式設定檔連結

在您建立自定義應用程式設定檔之後,您可以更新您的代碼,以便在應用程式與 Cloud Bigtable 連結時得以使用自定義應用程式設定檔。

以下的範例說明當您的應用程式建立 Cloud Bigtable 用戶端並連線至執行個體時,應如何指定應用程式設定檔。將 [APP_PROFILE_ID] 替換為適合的值。

C#

var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");

Go

clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)

HappyBase

HappyBase 客戶端函式庫不支援自定義應用程式設定檔。此客戶端函式庫一律使用預設應用程式設定檔。

HBase Java

// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");

// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");

// If using system properties, set "google.bigtable.app.profile.id" to
// "[APP_PROFILE_ID]"

// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
                         "[APP_PROFILE_ID]");

Node.js

const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});

Python

from google.cloud import bigtable

client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')

更新應用程式設定檔

您可以隨時查看執行個體的應用程式設定檔並更新設定。Cloud Bigtable 警告您,任何更新皆可能導致不可預期的行為改變。

若要查看或更新現有的應用程式設定檔,請進行以下操作:

主控台

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

    開啟執行個體清單

  2. 請在 [應用程式設定檔] 資料欄中點選您想要查看或更新的應用程式設定檔。

    若您沒有看到您想要編輯的應用程式設定檔,您可以點擊執行個體的名稱,接著在左側窗格中點擊 [應用程式設定檔],以查看完整的清單。

  3. 更新所需的設定後,點擊 [儲存] 或點擊 [取消] 不保存設定即退出。

gcloud

  1. 如果您不知道執行個體 ID,請使用 bigtable instances list 指令查看專案的執行個體清單:

    gcloud bigtable instances list
    
  2. 如果您不知道應用程式設定檔的 ID,請使用 bigtable app-profiles list 指令查看執行個體的應用程式設定檔清單:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    INSTANCE_ID 替換為執行個體的永久 ID。

  3. (選用) 使用 bigtable app-profiles describe 指令查看應用程式設定檔的設定:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    提供下列這些值:

    • APP_PROFILE_ID:應用程式設定檔的永久 ID。
    • INSTANCE_ID:執行個體的永久 ID。
  4. 使用 bigtable app-profiles update 指令更新應用程式設定檔的設定:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

    提供下列這些值:

    • APP_PROFILE_ID:應用程式設定檔的永久 ID。
    • INSTANCE_ID:執行個體的永久 ID。

    該指令接受下列選用標記:

    • --description=DESCRIPTION:應用程式設定檔的詳細說明。
    • --force:忽略關於潛在問題的警告,以及與其他應用程式設定檔的衝突。
    • --route-any:啟用多叢集轉送功能,將要求轉送到任何可用的叢集。

      您無法將此標記與 --route-to--transactional-writes 標記組合在一起。

    • --route-to=CLUSTER_ID:所有請求應轉送至此叢集 ID。這個標記可啟用單叢集轉送

      您無法將此標記與 --route-any 標記組合在一起。

    • --transactional-writes:在應用程式設定檔中啟用單一資料列交易

      您無法將此標記與 --route-any 標記組合在一起。

刪除自定義應用程式設定檔

您可以刪除執行個體的自定義應用程式設定檔,但是無法刪除預設的應用程式設定檔。

若要刪除自定義應用程式設定檔,請進行以下操作:

主控台

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

    開啟執行個體清單

  2. 點擊包含您所要刪除之應用程式設定檔的執行個體。

  3. 按一下左側窗格中的 [Application profiles] (應用程式設定檔)。

  4. 開啟更多動作選單 ,然後按一下 [Delete application profile] (刪除應用程式設定檔) 即會顯示確認對話方塊。

  5. 按照確認對話方塊的說明進行操作並點擊 [刪除]

gcloud

  1. 如果您不知道執行個體 ID,請使用 bigtable instances list 指令查看專案的執行個體清單:

    gcloud bigtable instances list
    
  2. 如果您不知道應用程式設定檔的 ID,請使用 bigtable app-profiles list 指令查看執行個體的應用程式設定檔清單:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    INSTANCE_ID 替換為執行個體的永久 ID。

  3. 使用 bigtable app-profiles delete 指令刪除應用程式設定檔:

    gcloud bigtable app-profiles delete APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--force]
    

    提供下列這些值:

    • APP_PROFILE_ID:應用程式設定檔的永久 ID。
    • INSTANCE_ID:執行個體的永久 ID。

    該指令接受以下的可選標記:

    --force:忽略關於潛在問題的警告,以及與其他應用程式設定檔的衝突。

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

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

這個網頁
Cloud Bigtable 說明文件