ラベルの作成と管理

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

このページでは、Cloud Bigtable インスタンスでラベルを使用する方法について説明します。また、インスタンスのラベルを追加、更新、削除する方法についても説明します。

ラベルとは

ラベルとは、Google Cloud Platform の Cloud Bigtable インスタンスを整理するのに役立つ Key-Value ペアのことです。各リソースにラベルを設定し、そのラベルに基づいてリソースをフィルタリングできます。ラベルに関する情報は課金システムに転送されるため、ラベルを基準に請求料金を分析することもできます。

ラベルの一般的な用途

タイムスタンプやすべての API 呼び出しに個別に値を作成するなど、一意のラベルを多数作成することはおすすめしません。次に、ラベルの一般的な使用例を示します。

  • チームまたはコストセンターのラベル: 各チームが所有する Cloud Bigtable インスタンスを区別するために、チームやコストセンターに基づいてラベルを追加します(team:researchteam:analytics など)。このタイプのラベルは、費用計算または予算作成に使用できます。

  • コンポーネント ラベル: component:rediscomponent:frontendcomponent:ingestcomponent:dashboard など。

  • 環境またはステージのラベル: environment:productionenvironment:test など。

  • 状態のラベル: state:activestate:readytodeletestate:archive など。

ラベルの要件

リソースに適用するラベルは、次の要件を満たす必要があります。

  • 1 つのリソースには、最大 64 個のラベルを適用できます。
  • ラベルは、Key-Value ペアでなければなりません。
  • キーは 1 文字以上、63 文字までにする必要があります。空にすることはできません。値は 63 文字以下にします。空にすることもできます。
  • キーと値には、小文字、数字、アンダースコア、ダッシュのみを使用できます。すべての文字は UTF-8 でエンコードする必要があります。国際文字も使用できます。
  • ラベルのキー部分は一意でなければなりません。ただし、複数のリソースで同じキーを使用できます。
  • キーは、小文字または国際文字で始める必要があります。

インスタンスのラベルを追加または更新する

Cloud Bigtable インスタンスを作成したら、Google Cloud Platform Console を使用してインスタンスにラベルを追加したり、既存のラベルを更新したりできます。また、RPC Admin API または REST Admin API を使用してラベルを追加または更新することもできます。

GCP Console を使用して Cloud Bigtable インスタンスのラベルを追加または更新するには、次の手順を実行します。

  1. GCP Console で Cloud Bigtable インスタンスのリストを開きます。

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

  2. ラベルを変更する各インスタンスの横にあるチェックボックスをオンにします。

  3. [ラベル] パネルが表示されていない場合は、右上の [情報パネルを表示] をクリックして開きます。

  4. 必要に応じてラベルを追加および更新します。

    新しいラベルを追加するには、[ラベルを追加] をクリックし、ラベルのキーと値を入力します。

    既存のラベルを変更するには、値を更新します。既存のラベルのキーは変更できません。

  5. [保存] をクリックして、変更を保存します。

インスタンスからラベルを削除する

GCP Console を使用して Cloud Bigtable インスタンスからラベルを削除するには、次の手順を実行します。

  1. GCP Console で Cloud Bigtable インスタンスのリストを開きます。

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

  2. ラベルを削除する各インスタンスの横にあるチェックボックスをオンにします。

  3. [ラベル] パネルが表示されていない場合は、右上の [情報パネルを表示] をクリックして開きます。

  4. 削除する各ラベルの横にある [X] をクリックします。

  5. [保存] をクリックして、変更を保存します。

次のステップ

Cloud Bigtable インスタンスのその他のプロパティを変更する方法について学習します。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Cloud Bigtable ドキュメント