インスタンスの変更

Bigtable インスタンスを作成した後、ダウンタイムなしで次の設定を更新できます。

• エディション

  Enterprise Plus にアップグレードするか、Enterprise にダウングレードできます。

• インメモリ （プレビュー）

  インスタンス内のクラスタのインメモリ ティアを有効または無効にできます。

• 自動スケーリング

  インスタンスのクラスタの自動スケーリングを有効または無効にするか、すでに自動スケーリングが有効になっているクラスタの設定を構成できます。

• 手動でスケーリングされるクラスタ内のノード数

  ノードの追加や削除を行うと、クラスタのパフォーマンスが最適化されるまで、負荷のかかった状態が通常は数分間続きます。

• インスタンス内のクラスタの数。

  クラスタを追加すると、Bigtable がその新しいクラスタにデータをレプリケートするまで時間がかかります。新しいクラスタは、インスタンス内で地理的に最も近いクラスタからレプリケートされます。一般に、距離が遠いほどレプリケーションにかかる時間は長くなります。

• インスタンスのアプリ プロファイル（レプリケーション設定が含まれている）

• データのロケーション

• インスタンスのラベル（インスタンスに関するメタデータを提供する）

• インスタンスの表示名

クラスタ ID を変更するには、クラスタを削除して再作成するしかありません。

以下のいずれかの設定を変更するには、目的の設定で新しいインスタンスを作成し、古いインスタンスからデータをエクスポートして、新しいインスタンスにデータをインポートした後に古いインスタンスを削除する必要があります。

• インスタンス ID

• ストレージ タイプ（SSD または HDD）

• 顧客管理の暗号鍵（CMEK）の構成

始める前に

Bigtable 用のコマンドライン インターフェースを使用する場合は、Google Cloud CLI をインストールし、まだインストールしていない場合は cbt CLI もインストールします。

エディションを変更する

エディションを変更するには、Enterprise Plus にアップグレードするか、Enterprise にダウングレードします。

Enterprise Plus へのアップグレード

エディションを変更すると、Bigtable は自動的に課金を更新し、Enterprise Plus の機能にすぐにアクセスできるようになります。

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. アップグレードする Enterprise インスタンスをクリックし、[インスタンスの編集] をクリックします。

3. [エディション] セクションで、[Enterprise Plus] を選択します。

4. [保存] をクリックします。

5. 省略可: インメモリ階層を有効にします。

gcloud

bigtable instances update コマンドを使用して、エディションを変更します。

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE_PLUS

次のフィールドを入力します。

• INSTANCE_ID: インスタンスの永続的な識別子。

Enterprise にダウングレードする

Enterprise Plus から Enterprise にダウングレードするには、Enterprise Plus 専用の機能を無効にする必要があります。エディションを変更すると、Bigtable は自動的に課金を更新し、Enterprise Plus の機能にアクセスできなくなります。

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. ダウングレードする Enterprise インスタンスをクリックし、[インスタンスの編集] をクリックします。

3. [エディション] セクションで、[Enterprise] を選択します。

4. [保存] をクリックします。

gcloud

bigtable instances update コマンドを使用して、エディションを変更します。

gcloud bigtable instances update INSTANCE_ID \
    --edition=ENTERPRISE

次のフィールドを入力します。

• INSTANCE_ID: インスタンスの永続的な識別子。

インメモリを構成する

プレビュー

この機能は、サービス固有規約の「一般サービス規約」セクションの「一般提供前のサービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

インメモリ ティアを有効または無効にしたり、インメモリ ティアに関する情報を表示したりできます。

必要なロール

インメモリ ティアを構成するために必要な権限を取得するには、インスタンスに対する Bigtable 管理者（roles/bigtable.admin）の Identity and Access Management（IAM）ロールを付与するよう管理者に依頼してください。

この事前定義ロールには、インメモリ階層を操作するために Bigtable が必要とする権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

• bigtable.memoryLayer.get
• bigtable.memoryLayer.list
• bigtable.memoryLayer.update

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

Bigtable のロールと権限の詳細については、IAM によるアクセス制御をご覧ください。

インメモリ階層を有効にする

Enterprise Plus エディションでは、クラスタでインメモリ階層を有効にできます。インメモリ ティアを使用するには、インメモリ用に構成したアプリ プロファイルを使用する必要があります。詳細については、インメモリの概要をご覧ください。

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 更新する Enterprise インスタンスをクリックし、[インスタンスの編集] をクリックします。

3. インメモリ ティアを有効にするクラスタの [クラスタを編集] をクリックします。

4. [インメモリを有効にする] を選択します。

5. [保存] をクリックします。

gcloud

Enterprise Plus エディションで、クラスタのインメモリ ティアを有効にするには、gcloud beta bigtable memory-layers update コマンドを使用します。

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --enable

次のフィールドを入力します。

• CLUSTER_ID: クラスタの永続的な識別子。
• INSTANCE_ID: インスタンスの永続的な識別子。

インメモリ ティアを無効にする

Enterprise Plus から Enterprise にダウングレードする前に、インメモリ ティアを無効にする必要があります。

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 更新する Enterprise インスタンスをクリックし、[インスタンスの編集] をクリックします。

3. インメモリ ティアを無効にするクラスタの [クラスタを編集] をクリックします。

4. [インメモリを有効にする] をオフにします。

5. [保存] をクリックします。

gcloud

クラスタのインメモリ ティアを無効にするには、gcloud beta bigtable memory-layers update コマンドを使用します。

gcloud beta bigtable memory-layers update CLUSTER_ID \
    --instance=INSTANCE_ID --disable

次のフィールドを入力します。

• CLUSTER_ID: クラスタの永続的な識別子。
• INSTANCE_ID: インスタンスの永続的な識別子。

インメモリ ティアに関する情報を表示する

クラスタのインメモリ ティアのステータスと容量を確認できます。

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 表示するクラスタがあるインスタンスの ID をクリックします。

3. クラスタ テーブルで、クラスタの [インメモリ] 列を確認します。

gcloud

クラスタのインメモリ階層に関する情報（インメモリ状態など）を表示するには、gcloud beta bigtable memory-layers describe コマンドを使用します。

gcloud beta bigtable memory-layers describe CLUSTER_ID \
    --instance=INSTANCE_ID

次のフィールドを入力します。

• CLUSTER_ID: クラスタの永続的な識別子。
• INSTANCE_ID: インスタンスの永続的な識別子。

自動スケーリングを構成する

既存のクラスタでは、自動スケーリングを有効または無効にできます。クラスタの CPU 使用率のターゲット、最小ノード数、最大ノード数を変更することもできます。自動スケーリングの設定を選択する方法については、自動スケーリングをご覧ください。cbt CLI を使用して自動スケーリングを構成することはできません。

自動スケーリングの有効化

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. [クラスタの構成] で、更新するクラスタの [編集] をクリックします。

4. [自動スケーリング] を選択します。

5. 次の値を入力します。

   • ノードの最小数
   • ノードの最大数
   • CPU 使用率の目標値
   • ストレージ使用率の目標値

6. [保存] をクリックします。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. インスタンスのクラスタ ID がわからない場合は、bigtable clusters list コマンドを使用して、インスタンスのクラスタのリストを表示します。

   gcloud bigtable clusters list --instances=INSTANCE_ID
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. bigtable clusters update コマンドを使用して、自動スケーリングを有効にします。

   gcloud bigtable clusters update CLUSTER_ID \
       --instance=INSTANCE_ID \
       --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \
       --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \
       --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
       --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET
   

   次のフィールドを入力します。

   • CLUSTER_ID: クラスタの永続的な識別子。
   • INSTANCE_ID: インスタンスの永続的な識別子。
   • AUTOSCALING_MAX_NODES: ノードの最小数
   • AUTOSCALING_MIN_NODES: ノードの最大数
   • AUTOSCALING_CPU_TARGET: ノードを追加または削除することで Bigtable が維持する CPU 使用率の目標値の割合。値は 10～80 にする必要があります。

   • AUTOSCALING_STORAGE_TARGET: ノードを追加または削除することで Bigtable が維持するノードあたりのストレージ使用率の目標値（GiB 単位）

     多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

自動スケーリングを無効にする

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. [クラスタの構成] で、更新するクラスタの [] をクリックします。

4. [手動ノード割り当て] を選択します。

5. [数量] フィールドに、クラスタのノード数を入力します。

   多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

6. [保存] をクリックします。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. インスタンスのクラスタ ID がわからない場合は、bigtable clusters list コマンドを使用して、インスタンスのクラスタのリストを表示します。

   gcloud bigtable clusters list --instances=INSTANCE_ID
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. bigtable clusters update コマンドを使用して自動スケーリングを無効にし、一定数のノードを構成します。

   gcloud bigtable clusters update CLUSTER_ID \
       --instance=INSTANCE_ID \
       --num-nodes=NUM_NODES --disable-autoscaling
   

   次のフィールドを入力します。

   • CLUSTER_ID: クラスタの永続的な識別子。
   • INSTANCE_ID: インスタンスの永続的な識別子。

   • NUM_NODES: このフィールドは省略可能です。値が設定されていない場合、Bigtable はデータ使用量に基づいてノードを自動的に割り当て、50% のストレージ使用率になるよう最適化します。クラスタ内のノード数を制御する場合は、NUM_NODES の値を更新します。ノード数がゼロ以外の値に設定されていることを確認します。

     多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

自動スケーリングの設定を変更する

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. [クラスタの構成] で、更新するクラスタの [] をクリックします。

4. 次の変更する新しい値を入力します。

   • ノードの最小数
   • ノードの最大数
   • CPU 使用率の目標値
   • ストレージ使用率の目標値

5. [保存] をクリックします。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. インスタンスのクラスタ ID がわからない場合は、bigtable clusters list コマンドを使用して、インスタンスのクラスタのリストを表示します。

   gcloud bigtable clusters list --instances=INSTANCE_ID
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. bigtable clusters update コマンドを使用して、自動スケーリングの設定を更新します。

   gcloud bigtable clusters update CLUSTER_ID \
       --instance=INSTANCE_ID \
       --autoscaling-max-nodes=AUTOSCALING_MAX_NODES \
       --autoscaling-min-nodes=AUTOSCALING_MIN_NODES \
       --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
       --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET
   

   次のフィールドを入力します。

   • CLUSTER_ID: クラスタの永続的な識別子。
   • INSTANCE_ID: インスタンスの永続的な識別子。

   このコマンドは、省略可能な自動スケーリング フラグを受け入れます。すべてのフラグを使用することも、変更する値のフラグだけを使用することもできます。

   • AUTOSCALING_MAX_NODES: ノードの最小数
   • AUTOSCALING_MIN_NODES: ノードの最大数
   • AUTOSCALING_CPU_TARGET: ノードを追加または削除することで Bigtable が維持する CPU 使用率の目標値の割合。値は 10～80 にする必要があります。

   • AUTOSCALING_STORAGE_TARGET: ノードを追加または削除することで Bigtable が維持するノードあたりのストレージ使用率の目標値（GiB 単位）

     多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

ノードを手動で追加または削除する

ほとんどの場合、自動スケーリングを有効にすることをおすすめします。有効にせずに、クラスタのノード スケーリング モードが手動の場合、ノードの追加や削除は可能ですが、再度変更するまでノード数は一定に保たれます。それぞれのプロジェクトのゾーン 1 つあたりのデフォルトのノードの割り当てについては、ノードの割り当てをご覧ください。 Google Cloud デフォルトよりも多くのノードをプロビジョニングする必要がある場合は、追加をリクエストできます。

注意: パフォーマンスの問題を回避するため、10 分間は 10% を超えるクラスタサイズの縮小は行わないでください。詳細については、スケールダウンが速すぎることによるレイテンシの増加をご覧ください。

手動スケーリングを使用するクラスタ内のノードの数を変更するには:

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. [クラスタの構成] で、更新するクラスタの [編集] をクリックします。

4. [手動ノード割り当て] セクションで、[数量] フィールドにクラスタのノード数を入力します。

   多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

5. [保存] をクリックします。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. インスタンスのクラスタ ID がわからない場合は、bigtable clusters list コマンドを使用して、インスタンスのクラスタのリストを表示します。

   gcloud bigtable clusters list --instances=INSTANCE_ID
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. ノードの数を変更するには、bigtable clusters update コマンドを使用します。

   gcloud bigtable clusters update CLUSTER_ID \
       --instance=INSTANCE_ID \
       --num-nodes=NUM_NODES
   

   次のフィールドを入力します。

   • CLUSTER_ID: クラスタの永続的な識別子。
   • INSTANCE_ID: インスタンスの永続的な識別子。

   • NUM_NODES: このフィールドは省略可能です。値が設定されていない場合、Bigtable はデータ使用量に基づいてノードを自動的に割り当て、50% のストレージ使用率になるよう最適化します。クラスタ内のノード数を制御する場合は、NUM_NODES の値を更新します。ノード数がゼロ以外の値に設定されていることを確認します。

     多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

cbt

1. インスタンス ID がわからない場合は、listinstances コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   cbt listinstances
   

2. インスタンスのクラスタ ID がわからない場合は、listclusters コマンドを使用して、インスタンスのクラスタのリストを表示します。

   cbt -instance=INSTANCE_ID listclusters
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. ノードの数を変更するには、updatecluster コマンドを使用します。

   cbt -instance=INSTANCE_ID updatecluster CLUSTER_ID NUM_NODES
   

   次のフィールドを入力します。

   • INSTANCE_ID: インスタンスの永続的な識別子。
   • CLUSTER_ID: クラスタの永続的な識別子。

   • NUM_NODES: このフィールドは省略可能です。値が設定されていない場合、Bigtable はデータ使用量に基づいてノードを自動的に割り当て、50% のストレージ使用率になるよう最適化します。クラスタ内のノード数を制御する場合は、NUM_NODES の値を更新します。ノード数がゼロ以外の値に設定されていることを確認します。

     多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

クラスタの追加

既存のインスタンスにクラスタを追加できます。 インスタンスでは、Bigtable が使用可能なリージョンを 8 個まで使用できます。各リージョン内のそれぞれのゾーンに配置できるクラスタは 1 つのみです。クラスタを追加するのに最適なロケーションは、ユースケースによって異なります。

インスタンスが CMEK で保護されている場合、新しいクラスタは、クラスタと同じリージョンにある CMEK 鍵を使用する必要があります。CMEK で保護されたインスタンスに新しいクラスタを追加する前に、クラスタを配置する予定のリージョンで CMEK 鍵を作成するか、作成してください。

単一クラスタのインスタンスにクラスタを追加する場合は、その前に、レプリケートされたテーブルの garbage-collection policies を変更する際に適用される制限事項をお読みください。また、推奨されるレプリケーション設定の例もご覧ください。

インスタンスにクラスタを追加するには:

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. [クラスタの構成] で、[クラスタを追加] をクリックします。

   このボタンが無効になっている場合、インスタンスにはすでに最大数のクラスタがあります。

4. 最初のクラスタのクラスタ ID を入力します。

   クラスタ ID は、クラスタの永続的な識別子です。

5. 最初のクラスタを実行するリージョンとゾーンを選択します。

6. 省略可: クラスタが常に 2 ノード単位でスケールインするように構成するには、[2 倍のノード スケーリングを有効にする] を選択します。詳細については、ノードのスケーリング ファクタをご覧ください。

7. クラスタのノード スケーリング モードを選択します。ほとんどの場合、自動スケーリングを選択します。スケーリングのガイダンスについては、自動スケーリングをご覧ください。

   1. [手動ノード割り当て] で、最初のクラスタの Bigtable ノード数を入力します。必要なノードの数がわからない場合は、デフォルトの設定を使用します。後でノードを追加することもできます。
   2. [自動スケーリング] に次の値を入力します。
      • ノードの最小数
      • ノードの最大数
      • CPU 使用率の目標値
      • ストレージ使用率の目標値

8. 省略可: デフォルトの Google 管理の暗号化ではなく CMEK を使用してインスタンスを保護する場合は、次の操作を行います。

   1. [暗号化オプションを表示する] をクリックします。
   2. [顧客管理の暗号鍵（CMEK）] の横にあるラジオボタンを選択します。
   3. クラスタに使用する CMEK 鍵のリソース名を選択または入力します。これは後から追加できません。
   4. CMEK 鍵のサービス アカウントに権限を付与するように求められたら、[付与] をクリックします。このタスクを完了するには、ユーザー アカウントに Cloud KMS 管理者のロールが付与されている必要があります。
   5. [保存] をクリックします。

9. クラスタのノード数を入力します。

   多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

10. インスタンスが CMEK で保護されている場合は、顧客管理の暗号鍵を選択または入力します。CMEK 鍵は、クラスタと同じリージョンに存在する必要があります。

11. [追加] をクリックします。

12. 追加するクラスタごとに上記の手順を繰り返します。その後、[保存] をクリックします。Bigtable はクラスタを作成し、新しいクラスタへのデータのレプリケーションを開始します。レプリケーションが開始されると、CPU 使用率が増加する場合があります。

    注: Bigtable が新しいクラスタへの初期コピーを完了するまでは、そのクラスタ内のデータにアクセスできません。新しいクラスタ内でレプリケートされたテーブルが利用可能になったかどうかを確認するには、左側のペインにある [テーブル] をクリックしてください。

13. デフォルトのアプリ プロファイルでレプリケーションの設定を見直して、それらの設定がレプリケーションのユースケースに適しているかどうかを確認します。デフォルトのアプリ プロファイルの更新やカスタムアプリ プロファイルの作成が必要になることがあります。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. インスタンスのクラスタ ID がわからない場合は、bigtable clusters list コマンドを使用して、インスタンスのクラスタのリストを表示します。

   gcloud bigtable clusters list --instances=INSTANCE_ID
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. クラスタを追加するには、bigtable clusters create コマンドを使用します。

   gcloud bigtable clusters create CLUSTER_ID \
       --async \
       --instance=INSTANCE_ID \
       --zone=ZONE \
       [--num-nodes=NUM_NODES] \
       [--autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \
       --autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \
       --autoscaling-cpu-target=AUTOSCALING_CPU_TARGET \
       --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET] \
       [--kms-key=KMS_KEY --kms-keyring=KMS_KEYRING \
       --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] \
   

   次のフィールドを入力します。

   • CLUSTER_ID: クラスタの永続的な識別子。
   • INSTANCE_ID: インスタンスの永続的な識別子。

   • ZONE: クラスタが実行されるゾーン。

     各リージョン内のそれぞれのゾーンに配置できるクラスタは 1 つのみです。たとえば、インスタンスのクラスタが us-east1-b にある場合は、同じリージョン内の別のゾーン（例 us-east1-c）、または別のリージョンのゾーン（例: europe-west2-a）にクラスタを追加できます。ゾーンのリストを表示します。

   --async フラグは必要ではありませんが、強く推奨されています。このフラグがない場合、オペレーションが完了する前にコマンドがタイムアウトすることがあります。Bigtable は引き続きバックグラウンドでクラスタを作成します。

   コマンドには、以下の任意のフラグを指定できます。

   • --kms-key=KMS_KEY: クラスタによって使用されている CMEK の鍵。CMEK クラスタは、すでに CMEK で保護されているインスタンスにのみ追加できます。
   • --kms-keyring=KMS_KEYRING: 鍵の KMS キーリング ID。
   • --kms-location=KMS_LOCATION: 鍵の Google Cloud ロケーション。
   • --kms-project=KMS_PROJECT: 鍵の Google Cloud プロジェクト ID。
   • --storage-type=STORAGE_TYPE: クラスタで使用するストレージのタイプ。インスタンス内の各クラスタは、同じストレージ タイプを使用する必要があります。指定できる値は SSD と HDD です。デフォルト値は SSD です。
   • --node-scaling-factor=node-scaling-factor-2x: 2 倍のノード スケーリングを有効にするフラグ。この機能は、手動スケーリングと自動スケーリングの両方で有効にできます。

   2 倍のノード スケーリングに使用できない Bigtable ゾーンのリストを表示するには、ノード スケーリング ファクタの制限事項をご覧ください。

   --num-nodes オプションの値が設定されていない場合、Bigtable はデータ使用量に基づいてノードをクラスタに自動的に割り当て、50% のストレージ使用率になるよう最適化します。このノードの自動割り当ては料金に影響します。クラスタ内のノード数を自分で制御する場合は、NUM_NODES の値を変更してください。ノード数にはゼロ以外の値を設定してください。多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

   自動スケーリングの場合は、すべての autoscaling- フラグを指定します。num-nodes は使用しません。自動スケーリング設定の値の選択方法については、自動スケーリングをご覧ください。次のように置き換えます。

   • AUTOSCALING_MIN_NODES: クラスタの最小ノード数。
   • AUTOSCALING_MAX_NODES: クラスタノードの最大数。
   • AUTOSCALING_CPU_TARGET: クラスタのターゲット CPU 使用率。値は 10～80 にする必要があります。
   • AUTOSCALING_STORAGE_TARGET: ノードを追加または削除することで Bigtable が維持するストレージ使用率の目標値（GiB 単位）。

4. デフォルトのアプリ プロファイルでレプリケーションの設定を見直して、それらの設定がレプリケーションのユースケースに適しているかどうかを確認します。デフォルトのアプリ プロファイルの更新やカスタムアプリ プロファイルの作成が必要になることがあります。

cbt

注: CMEK で保護されたリソースを作成したり、cbt CLI を使用して自動スケーリングを構成したりすることはできません。

1. インスタンス ID がわからない場合は、listinstances コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   cbt listinstances
   

2. インスタンスのクラスタ ID がわからない場合は、listclusters コマンドを使用して、インスタンスのクラスタのリストを表示します。

   cbt -instance=INSTANCE_ID listclusters
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. クラスタを追加するには、createcluster コマンドを使用します。

   
   cbt -instance=INSTANCE_ID \
   createcluster CLUSTER_ID \
   ZONE \
   NUM_NODES \
   STORAGE_TYPE
   
   

   次のフィールドを入力します。

   • INSTANCE_ID: インスタンスの永続的な識別子。
   • CLUSTER_ID: クラスタの永続的な識別子。

   • ZONE: クラスタが実行されるゾーン。

     各リージョン内のそれぞれのゾーンに配置できるクラスタは 1 つのみです。たとえば、インスタンスのクラスタが us-east1-b にある場合は、同じリージョン内の別のゾーン（例 us-east1-c）、または別のリージョンのゾーン（例: europe-west2-a）にクラスタを追加できます。ゾーンのリストを表示します。

   • NUM_NODES: このフィールドは省略可能です。値が設定されていない場合、Bigtable はデータ使用量に基づいてノードを自動的に割り当て、50% のストレージ使用率になるよう最適化します。クラスタ内のノード数を制御する場合は、NUM_NODES の値を更新します。ノード数がゼロ以外の値に設定されていることを確認します。

     多くの場合、インスタンス内の各クラスタのノード数は同じである必要がありますが、例外もあります。ノードとレプリケーションの詳細をご覧ください。

   • STORAGE_TYPE: クラスタで使用するストレージのタイプ。インスタンス内の各クラスタは、同じストレージ タイプを使用する必要があります。指定できる値は SSD と HDD です。

4. デフォルトのアプリ プロファイルでレプリケーションの設定を見直して、それらの設定がレプリケーションのユースケースに適しているかどうかを確認します。デフォルトのアプリ プロファイルの更新やカスタムアプリ プロファイルの作成が必要になることがあります。

クラスタの削除

インスタンスに複数のクラスタがある場合、そのうちの 1 つを除くすべてのクラスタを削除できます。1 つを除くすべてのクラスタを削除すると、自動的にレプリケーションが無効になります。

注: クラスタを削除する時点で、そのクラスタへの書き込みに、まだレプリケートされていないものがある場合、Bigtable でレプリケーション プロセスを完了した後に、削除されたクラスタのデータのコピーが削除されます。残りのクラスタは、レプリケーション プロセスが完了するまで、引き続き受信した書き込みと CPU 使用率を表示します。

場合によっては、Bigtable でクラスタを削除できないことがあります。

• アプリケーション プロファイルのいずれかがすべてのトラフィックを 1 つのクラスタにルーティングしている場合、Bigtable ではそのクラスタを削除できません。クラスタを削除できるようにするには、その前にアプリケーション プロファイルを編集または削除する必要があります。
• 既存のインスタンスに新しいクラスタを追加する場合、新しいクラスタへの初期のデータコピーが完了するまでは、そのインスタンスの既存のクラスタを削除できません。

インスタンスからクラスタを削除するには:

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. [クラスタの構成] で、削除するクラスタの [クラスタを削除] をクリックします。

4. 削除操作をキャンセルするには、[元に戻す] をクリックします。これは、[保存] をクリックするまで選択可能です。そのまま削除する場合は、[保存] をクリックします。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. インスタンスのクラスタ ID がわからない場合は、bigtable clusters list コマンドを使用して、インスタンスのクラスタのリストを表示します。

   gcloud bigtable clusters list --instances=INSTANCE_ID
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. クラスタを削除するには、bigtable clusters delete コマンドを使用します。

   gcloud bigtable clusters delete CLUSTER_ID \
       --instance=INSTANCE_ID
   

   次のフィールドを入力します。

   • CLUSTER_ID: クラスタの永続的な識別子。
   • INSTANCE_ID: インスタンスの永続的な識別子。

cbt

1. インスタンス ID がわからない場合は、listinstances コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   cbt listinstances
   

2. インスタンスのクラスタ ID がわからない場合は、listclusters コマンドを使用して、インスタンスのクラスタのリストを表示します。

   cbt -instance=INSTANCE_ID listclusters
   

   INSTANCE_ID はインスタンスの永続的な識別子に置き換えます。

3. クラスタを削除するには、deletecluster コマンドを使用します。

   cbt -instance=INSTANCE_ID deletecluster CLUSTER_ID
   

   次のフィールドを入力します。

   • INSTANCE_ID: インスタンスの永続的な識別子。
   • CLUSTER_ID: クラスタの永続的な識別子。

データを新しいロケーションに移動する

Bigtable インスタンスのデータを新しいゾーンまたはリージョンに移動するには、移動先のロケーションに新しいクラスタを追加して、移動元のロケーションのクラスタを削除します。削除されたクラスタは、新しいクラスタにデータがレプリケートされるまで使用できるため、リクエストの失敗を心配する必要はありません。Bigtable は、すべてのデータを自動的に新しいクラスタに複製します。

アプリ プロファイルを管理する

アプリケーション プロファイル（アプリ プロファイル）は、レプリケーションを使用するインスタンスにアプリケーションがどのように接続するかを制御します。複数のクラスタがあるすべてのインスタンスには、独自のデフォルトのアプリ プロファイルがあります。また、インスタンスごとに異なる多数のカスタムアプリ プロファイルを作成できます。この場合、実行するアプリケーションの種類ごとに異なるアプリ プロファイルを使用します。

インスタンスのアプリ プロファイルを設定する方法については、アプリ プロファイルの構成をご覧ください。 一般的な使用例で使用できる設定の例については、レプリケーション構成の例をご覧ください。

ラベルを管理

ラベルとは、関連するインスタンスをグループ化し、インスタンスに関するメタデータを保存する場合に使用できる Key-Value ペアのことです。

ラベルを管理する方法については、インスタンスのラベルを追加または更新するとインスタンスからラベルを削除するをご覧ください。

インスタンスの表示名を変更する

Google Cloud コンソールでインスタンスの識別に使用されるインスタンスの表示名を変更するには:

コンソール

1. Google Cloud コンソールで Bigtable インスタンスのリストを開きます。

   インスタンスのリストを開く

2. 変更するインスタンスをクリックしてから、[インスタンスの編集] をクリックします。

3. インスタンス名を編集してから、[保存] をクリックします。

gcloud

1. インスタンス ID がわからない場合は、bigtable instances list コマンドを使用して、プロジェクトのインスタンスのリストを表示します。

   gcloud bigtable instances list
   

2. 表示名を更新するには、bigtable instances updateコマンドを使用します。

   gcloud bigtable instances update INSTANCE_ID \
       --display-name=DISPLAY_NAME
   

   次のフィールドを入力します。

   • INSTANCE_ID: インスタンスの永続的な識別子。
   • DISPLAY_NAME: Google Cloud コンソールでインスタンスを識別するための判読可能な名前。

cbt

この機能は cbt CLI では使用できません。

次のステップ

• インスタンスのラベルを追加、更新、削除する方法を学ぶ。
• インスタンスのアプリ プロファイルを作成および更新する方法を確認する。アプリ プロファイルにはレプリケーションの設定が含まれます。