cbt CLI でインスタンスを作成してデータを書き込む
Bigtable について学習する場合は、クイックスタートに一通り目を通しておくと、本番環境で大規模に使用することになる基礎を実際に体験できます。
このクイックスタートでは、次のアクションを実行します。
- Bigtable インスタンスに接続する
- 基本的な管理タスクを実行する
- テーブルにデータを書き込む
- テーブルからデータを読み取る
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- 次のコマンドを実行して
cbt
CLI をインストールします。gcloud components install cbt
Bigtable インスタンスを作成する
Google Cloud Console で [インスタンスの作成] ページを開きます。
[インスタンス名] に「
Quickstart instance
」と入力します。[インスタンス ID] に「
quickstart-instance
」と入力します。[続行] をクリックします。
[ストレージの種類] で [SSD] を選択します。
[続行] をクリックします。
[クラスタ ID] に「
quickstart-instance-c1
」と入力します。[リージョン] で、お近くのリージョンを選択します。
[ゾーン] で [すべて] を選択します。
[ノード スケーリング モード] で [手動で割り当てる] を選択します。
[数量] で [1] を選択します。
[作成] をクリックしてインスタンスを作成します。
インスタンスへの接続
プロジェクトとインスタンスを使用するように
cbt
CLI を構成するため、.cbtrc
ファイルを作成し、PROJECT_ID
を Bigtable インスタンスの作成先であるプロジェクトの ID に置き換えます。echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
.cbtrc
ファイルを正しく設定したことを確認します。cat ~/.cbtrc
ターミナルに
.cbtrc
ファイルの内容が次のように表示されます。project = PROJECT_ID instance = quickstart-instance
これで、インスタンスで
cbt
CLI を使用できるようになりました。
データの読み取りと書き込み
Bigtable では、いくつもの行で構成されたテーブルにデータが格納されます。各行は行キーによって識別されます。
各行内のデータは、列のグループである「列ファミリー」に整理されます。列ファミリー内の個々の列は列修飾子によって識別されます。
行と列が交差する部分に、タイムスタンプ付きのセルが複数存在することがあります。
テーブルを
my-table
という名前で作成します。cbt createtable my-table
テーブルの一覧を表示します。
cbt ls
コマンドによって次のような出力が表示されます。
my-table
1 つの列ファミリーを
cf1
という名前で追加します。cbt createfamily my-table cf1
列ファミリーを一覧表示します。
cbt ls my-table
コマンドによって次のような出力が表示されます。
Family Name GC Policy ----------- --------- cf1 <never>
列ファミリー
cf1
と列修飾子c1
を使用して、値test-value1
とtest-value2
を行r1
に書き込みます。cbt set my-table r1 cf1:c1=test-value1 cbt set my-table r1 cf1:c1=test-value2
cbt read
コマンドを使用して、テーブルに追加したデータを読み取ります。cbt read my-table
Shell によって次のような出力が表示されます。
---------------------------------------- r1 cf1:c1 @ 2023/03/22-06:56:11.323000 "test-value1" cf1:c1 @ 2023/03/22-06:56:04.361000 "test-value2"
タイムスタンプが同じ 2 つの値が、同じ列の
r1
行に格納されます。
クリーンアップ
このクイックスタートで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、インスタンスを削除します。.cbtrc
ファイルを削除すると、別のプロジェクトで作業できるようになります。
テーブル
my-table
を削除します。cbt deletetable my-table
インスタンスを削除します。
cbt deleteinstance quickstart-instance
ファイル
.cbtrc
を削除します。rm ~/.cbtrc
(省略可)gcloud CLI から認証情報を取り消します。
gcloud auth revoke
次のステップ
- Bigtable Codelab に取り組む。
cbt
CLI リファレンス ドキュメントを表示します。- 不正行為の検出のユースケースのサンプル ソースコードを見る。
- C#、C++、Go、Java、Node.js、PHP、Python、Ruby で、または Java 用 HBase クライアントを使用して Hello World アプリケーションを作成する。