建立及設定應用程式設定檔

注意：本文件包含僅適用於 Enterprise Plus 版本的詳情請參閱「版本總覽」。

Bigtable 應用程式設定檔 (應用程式設定檔) 可讓您為傳入的用戶端要求指定轉送政策、運算選項和工作負載隔離設定。您可以將流量導向已佈建的叢集節點、使用 Data Boost 無伺服器運算執行獨立的高處理量讀取作業，或將點讀取作業轉送至 Enterprise Plus 執行個體的記憶體內層 (預先發布版)。

事前準備

建立或設定應用程式設定檔前，請先參閱下列說明文件：

• 請參閱「應用程式設定檔總覽」，瞭解應用程式設定檔的運作方式，以及標準運算的標準應用程式設定檔，與無伺服器高處理量讀取工作的 Data Boost 應用程式設定檔之間的差異。如要進一步瞭解 Data Boost 與使用佈建叢集節點的運算有何不同，請參閱「Bigtable Data Boost 總覽」。
• 如果您使用標準應用程式設定檔來設定複製功能，請參閱「複製功能總覽」和「複製設定範例」，決定最適合您用途的設定。
• 如果您使用的是記憶體內層應用程式設定檔，請參閱「記憶體內層總覽」。

必要的角色

如要取得建立、設定或刪除應用程式設定檔所需的權限，請要求管理員授予您執行個體的 Bigtable 系統管理員 (roles/bigtable.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

建立應用程式設定檔

您可以為每個執行個體建立多個不同的自訂應用程式設定檔。您可以透過自訂應用程式設定檔，針對不同應用程式或是應用程式中的不同功能來進行控管。舉例來說，您可以針對批次應用程式使用一個應用程式設定檔，將其流量隔離至單一叢集，並使用不同的應用程式設定檔，為另一個應用程式提供高可用性。

建立標準應用程式設定檔

如要建立標準應用程式設定檔，請按照下列步驟操作：

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

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

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

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

5. 選取「標準」。

6. 點選「下一步」。

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

   應用程式設定檔 ID 是應用程式的永久辨識碼。應用程式連線至 Bigtable 時，會提供這個 ID。

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

9. 在「Cluster routing」(叢集轉送) 下方，選取單一叢集轉送或多叢集轉送。瞭解詳情。

10. 如果選擇「單一叢集」：

    1. 在「Cluster」(叢集) 清單中，選取要將要求轉送至哪個叢集。

    2. 如需啟用單一資料列交易，請勾選「Allow single-row transactions」(允許單一資料列交易) 核取方塊。

11. 如果選擇「多叢集」：

    1. 在「Cluster group」(叢集群組) 清單中，選取「Any cluster」(任何叢集)，將要求轉送至執行個體中的任何叢集。
    2. 如要將要求轉送限制在執行個體中的部分叢集 (叢集群組轉送)，請選取要納入轉送群組的每個叢集，然後按一下「OK」(確定)。
    3. 如要依據要求的資料列索引鍵，將單一資料列的讀寫要求轉送至特定叢集，請選取「Enable row affinity」(啟用資料列相依性)。

12. 在「Select a routing priority」(選取轉送優先順序) 下方，選取下列其中一項，為要求指派轉送優先順序：

    • 高：用於容易受延遲影響的要求
    • 中：用於一般用途要求
    • 低：用於背景工作或時間較不緊迫的操作

13. 如要建立應用程式設定檔，請按一下「Create」(建立)。

14. 更新應用程式連至 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] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...] \
       [--route-to=CLUSTER_ID] \
       [--transactional-writes] \
       [--priority=PRIORITY] \
       [--row-affinity]
   

   提供下列資訊：

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

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

   • --description=DESCRIPTION：應用程式設定檔的詳細說明。
   • --force：忽略潛在問題和與其他應用程式設定檔衝突的警告。

   • --route-any：啟用多叢集轉送功能，將要求轉送至任何可用的叢集。

     這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...：要求應轉送至的叢集清單。如要將要求轉送至執行個體中的部分叢集，請使用這個選項。

     這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

   • --route-to=CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。

     這個旗標無法與 --route-any 旗標合併使用。

   • --transactional-writes：在應用程式設定檔中啟用單列交易。

     這個旗標無法與 --route-any 或 --restrict-to 旗標合併使用。

   • --priority=PRIORITY：應用程式設定檔應使用的優先順序等級。可接受的值為 PRIORITY_HIGH、PRIORITY_MEDIUM 或 PRIORITY_LOW。

   • --row-affinity：在應用程式設定檔中啟用資料列相依性轉送。

     這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

3. 更新應用程式連至 Bigtable 的程式碼，改用新的應用程式設定檔。

建立記憶體內層應用程式設定檔

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

如要在已啟用記憶體內層級的叢集上建立應用程式設定檔，請按照下列步驟操作：

注意：您無法為採用記憶體內層級的應用程式設定檔啟用資料列相依性轉送功能。

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

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

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

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

5. 選取「記憶體內層」。

6. 點選「下一步」。

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

   應用程式設定檔 ID 是應用程式的永久辨識碼。應用程式連線至 Bigtable 時，會提供這個 ID。

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

9. 在「叢集轉送」下方，選取已啟用記憶體內層的叢集。

   記憶體內層叢集必須使用單一叢集轉送機制。

10. 如需啟用單一資料列交易，請選取「Allow single-row transactions」(允許單一資料列交易)。

11. 在「Select a routing priority」(選取轉送優先順序) 下方，選取下列其中一項，為要求指派轉送優先順序：

    • 高：用於容易受延遲影響的要求
    • 中：用於一般用途要求
    • 低：用於背景工作或時間較不緊迫的操作

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

13. 更新應用程式連至 Bigtable 的程式碼，改用新的應用程式設定檔。

gcloud

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

   gcloud bigtable instances list
   

2. 使用 gcloud beta bigtable app-profiles create 指令建立應用程式設定檔：

   gcloud beta bigtable app-profiles create APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID \
       --use-memory-layer \
       [--description=DESCRIPTION] \
       [--transactional-writes] \
       [--priority=PRIORITY]
   

   提供下列資訊：

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

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

   • --route-to=CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。
   • --use-memory-layer：使用這個應用程式設定檔，將要求轉送至記憶體內層。這個旗標僅限 Enterprise Plus 版本和單一叢集轉送使用。
   • --description=DESCRIPTION：應用程式設定檔的詳細說明。
   • --transactional-writes：在應用程式設定檔中啟用單列交易。
   • --priority=PRIORITY：使用應用程式設定檔傳送的要求優先順序。可接受的值為 PRIORITY_HIGH、PRIORITY_MEDIUM 或 PRIORITY_LOW。要求的優先順序，不會影響可直接在記憶體中處理的要求。

3. 更新應用程式連至 Bigtable 的程式碼，改用新的應用程式設定檔。

建立 Data Boost 應用程式設定檔

如要建立 Data Boost 應用程式設定檔 (使用 Data Boost 無伺服器運算的應用程式設定檔)，請按照下列步驟操作。為確保工作負載與 Data Boost 相容，請詳閱限制。

注意：如要使用進階 Data Boost 功能，執行個體必須採用 Enterprise Plus 版本。

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

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

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

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

5. 選取「Data Boost」。

6. 點選「下一步」。

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

   應用程式設定檔 ID 是應用程式的永久辨識碼。應用程式連線至 Bigtable 時，會提供這個 ID。

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

9. 在「叢集轉送」下方，選取要轉送要求的叢集。

10. 按一下「Create app profile」(建立應用程式設定檔)，建立應用程式設定檔。

11. 更新應用程式連至 Bigtable 的程式碼，改用新的應用程式設定檔。

gcloud

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

   gcloud bigtable instances list
   

2. 使用 gcloud beta bigtable app-profiles create 指令建立應用程式設定檔：

   gcloud bigtable app-profiles create APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --data-boost \
       --data-boost-compute-billing-owner=HOST_PAYS \
       --route-to=CLUSTER_ID
   

   提供下列資訊：

   • APP_PROFILE_ID：應用程式設定檔的永久 ID。
   • INSTANCE_ID：執行個體的永久 ID
   • CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。

使用自訂應用程式設定檔連結

建立自訂應用程式設定檔後，您可以更新程式碼，讓應用程式在連線至 Bigtable 時使用該設定檔。

以下範例說明如何在應用程式建立 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)

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]')

更新應用程式設定檔

您隨時可以查看執行個體的應用程式設定檔，並更新相關設定。如果更新可能導致行為發生非預期的變化，Bigtable 會發出警告。

重要事項：應用程式設定檔的變更會立即生效，並套用至使用該設定檔的所有應用程式。如果需要進行不應立即生效的變更，請改為建立新的應用程式設定檔，並更新應用程式，使用新的應用程式設定檔連線至 Bigtable。

如要瞭解如何將應用程式設定檔從標準轉換為 Data Boost，或從 Data Boost 轉換為標準，請參閱「轉換應用程式設定檔」。

更新標準應用程式設定檔

如要更新標準應用程式設定檔，請按照下列步驟操作：

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

2. 按一下要更新應用程式設定檔的執行個體。

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

4. 針對要更新的應用程式設定檔，按一下「 Edit application profile」(編輯應用程式設定檔)。

5. 視需要更新設定。

6. 按一下「儲存」，或按一下「取消」，不儲存直接退出。

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] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes] \
       [--row-affinity]
   

   提供下列資訊：

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

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

   • --description=DESCRIPTION：應用程式設定檔的詳細說明。
   • --force：忽略潛在問題和與其他應用程式設定檔衝突的警告。

   • --route-any：啟用多叢集轉送功能，將要求轉送至任何可用的叢集。

     這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

   • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...：要求應轉送至的叢集清單。如要將要求轉送至執行個體中的部分叢集，請使用這個選項。

     這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

   • --route-to=CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。

     這個旗標無法與 --route-any 旗標合併使用。

   • --transactional-writes：在應用程式設定檔中啟用單列交易。

     這個旗標無法與 --route-any 旗標合併使用。

   • --priority=PRIORITY：應用程式設定檔使用的優先順序層級。可接受的值為 PRIORITY_HIGH、PRIORITY_MEDIUM 或 PRIORITY_LOW。

更新記憶體內層應用程式設定檔

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

如要在已啟用記憶體內層的叢集上更新應用程式設定檔，請按照下列步驟操作：

控制台

注意：您無法在 Google Cloud 控制台中，為具有記憶體內層級的應用程式設定檔啟用資料列親和性轉送。

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

2. 按一下要更新應用程式設定檔的執行個體。

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

4. 針對要更新的應用程式設定檔，按一下「 Edit application profile」(編輯應用程式設定檔)。

5. 視需要更新設定。

6. 按一下「儲存」，或按一下「取消」，不儲存直接退出。

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. 選用：使用 gcloud bigtable app-profiles describe 指令查看應用程式設定檔的設定：

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

   提供下列資訊：

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

4. 使用 gcloud beta bigtable app-profiles update 指令更新應用程式設定檔：

   gcloud beta bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID \
       [--description=DESCRIPTION] \
       [--transactional-writes] \
       [--priority=PRIORITY] \
       [--use-memory-layer] \
       [--no-use-memory-layer]
   

   提供下列資訊：

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

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

   • --description=DESCRIPTION：應用程式設定檔的詳細說明。
   • --route-to=CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。
   • --transactional-writes：在應用程式設定檔中啟用單列交易。
   • --priority=PRIORITY：應用程式設定檔使用的優先順序層級。可接受的值為 PRIORITY_HIGH、PRIORITY_MEDIUM 或 PRIORITY_LOW。
   • --use-memory-layer：使用這個應用程式設定檔，將要求轉送至記憶體內層。使用 --no-use-memory-layer 停用這個應用程式設定檔的記憶體內層轉送功能。這個旗標僅限 Enterprise Plus 版本和單一叢集轉送使用。

更新 Data Boost 應用程式設定檔

如要更新 Data Boost 應用程式設定檔讀取的叢集，請按照下列步驟操作：

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

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

   如果找不到要編輯的應用程式設定檔，請按一下執行個體名稱，然後點選左側窗格中的「Application profiles」(應用程式設定檔)，即可查看完整清單。

3. 選取流量應轉送至的新叢集，然後按一下「Save」(儲存)。

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. 選用：使用 gcloud bigtable app-profiles describe 指令查看應用程式設定檔的設定：

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

   提供下列資訊：

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

4. 使用 gcloud beta bigtable app-profiles update 指令更新應用程式設定檔：

   gcloud beta bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID
   

   提供下列資訊：

   • APP_PROFILE_ID：應用程式設定檔的永久 ID。
   • INSTANCE_ID：執行個體的永久 ID
   • CLUSTER_ID：要讀取的新叢集 ID

轉換應用程式設定檔

您可以將標準應用程式設定檔轉換為 Data Boost 應用程式設定檔，或將 Data Boost 應用程式設定檔轉換為標準應用程式設定檔。轉換應用程式設定檔前，請參閱「應用程式設定檔變更」一節的指南。

從標準模式轉換為 Data Boost

將應用程式設定檔從標準 (佈建運算節點) 更新為 Data Boost 無伺服器運算之前，請先查看 Data Boost 條件指標。此外，您也應瞭解 Data Boost 限制。

注意：如要使用進階 Data Boost 功能，執行個體必須採用 Enterprise Plus 版本。

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

2. 在「Application profiles」(應用程式設定檔) 欄中，按一下要更新的應用程式設定檔。

   如果找不到要編輯的應用程式設定檔，您可以按一下執行個體的名稱，再按一下左側窗格的 [Application profiles] (應用程式設定檔)，即可查看完整清單。

3. 選取「Data Boost」。

4. 選取要求應轉送至的叢集。

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 describe 指令查看應用程式設定檔的設定：

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

   提供下列資訊：

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

4. 使用 gcloud beta bigtable app-profiles update 指令，將應用程式設定檔從標準轉換為 Data Boost：

   gcloud bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --data-boost \
       --data-boost-compute-billing-owner=HOST_PAYS \
       --route-to=CLUSTER_ID
   

   提供下列資訊：

   • APP_PROFILE_ID：應用程式設定檔的永久 ID。
   • INSTANCE_ID：執行個體的永久 ID
   • CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。

從 Data Boost 轉換為標準模式

如要將應用程式設定檔從使用 Data Boost (無伺服器運算) 變更為標準 (佈建的運算節點)，請按照下列步驟操作：

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

2. 在「Application profiles」(應用程式設定檔) 欄中，按一下要更新的應用程式設定檔。

   如果找不到要編輯的應用程式設定檔，您可以按一下執行個體的名稱，再按一下左側窗格的 [Application profiles] (應用程式設定檔)，即可查看完整清單。

3. 選取「標準」。

4. 點選「下一步」。

5. 選用：編輯應用程式設定檔說明。

6. 在「Cluster routing」(叢集轉送) 下方，選取單一叢集轉送或多叢集轉送。瞭解詳情。

7. 如果選擇「單一叢集」：

   1. 在「Cluster」(叢集) 清單中，選取要將要求轉送至哪個叢集。

   2. 如需啟用單一資料列交易，請勾選「Allow single-row transactions」(允許單一資料列交易) 核取方塊。

8. 如果選擇「多叢集」：

   1. 在「Cluster group」(叢集群組) 清單中，選取「Any cluster」(任何叢集)，將要求轉送至執行個體中的任何叢集。
   2. 如要將要求轉送限制在執行個體中的部分叢集 (叢集群組轉送)，請選取要納入轉送群組的每個叢集，然後按一下「OK」(確定)。
   3. 如要依據要求的資料列索引鍵，將單一資料列的讀寫要求轉送至特定叢集，請選取「Enable row affinity」(啟用資料列相依性)。

9. 在「Select a routing priority」(選取轉送優先順序) 下方，選取下列其中一項，為要求指派轉送優先順序：

   • 高：用於容易受延遲影響的要求
   • 中：用於一般用途要求
   • 低：用於背景工作或時間較不緊迫的操作

10. 按一下「儲存」。

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
   

4. 使用 gcloud beta bigtable app-profiles update 指令轉換應用程式設定檔：

   gcloud bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --standard \
       [--route-any] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes]
   

提供下列資訊：

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

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

• --route-any：啟用多叢集轉送功能，將要求轉送至任何可用的叢集。

  這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

• --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...：要求應轉送至的叢集清單。如要將要求轉送至執行個體中的部分叢集，請使用這個選項。

  這個旗標無法與 --route-to 或 --transactional-writes 旗標合併使用。

• --route-to=CLUSTER_ID：所有要求應該轉送到這個叢集的叢集 ID。這個旗標會啟用單一叢集轉送。

  這個旗標無法與 --route-any 旗標合併使用。

• --transactional-writes：在應用程式設定檔中啟用單列交易。

  這個旗標無法與 --route-any 或 --restrict-to 旗標合併使用。

刪除應用程式設定檔

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

警告：請勿刪除應用程式仍在使用中的自訂應用程式設定檔。刪除自訂應用程式設定檔後，使用該設定檔的所有要求都會失敗。

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

控制台

1. 在 Google Cloud 控制台中，開啟 Bigtable 執行個體清單。

   開啟執行個體清單

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

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

4. 開啟「更多動作」選單 ，然後按一下「刪除應用程式設定檔」。即會顯示確認對話方塊。

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：忽略潛在問題和與其他應用程式設定檔衝突的警告。