このページでは、Cloud Spanner インスタンスを作成、一覧表示、編集、削除する方法について説明します。
インスタンスの作成
gcloud コマンドライン ツールまたは Google Cloud Platform Console でインスタンスを作成できます。
Console
GCP Console の [インスタンスの作成] ページに移動します。
次の値を入力します。
- インスタンス名。GCP Console に表示されます。インスタンス名は、Google Cloud Platform プロジェクト内で一意である必要があります。
- インスタンス ID。インスタンスを永続的に識別します。インスタンス ID も GCP プロジェクト内で一意である必要があります。インスタンス ID は後で変更できません。
- 構成。インスタンスのノードの地理的な位置を定義し、データのレプリケート方法に影響を与えます。インスタンス構成の詳細をご覧ください。
- インスタンスのノード数。ノード数によって、インスタンス内のデータベースで利用可能な提供リソースとストレージ リソースの量が決まります。
[作成] をクリックしてインスタンスを作成します。
次のスクリーンショットは、インスタンス作成のページを示しています。
gcloud
gcloud instances create コマンドを使用します。
gcloud instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-COUNT]
次の値を指定してください。
[INSTANCE-ID]: Google Cloud Platform プロジェクト内で一意の永続的な識別子。インスタンス ID は後で変更できません。[INSTANCE-CONFIG]: インスタンス構成。インスタンスのノードの地理的な位置を定義し、データのレプリケート方法に影響を与えます。インスタンス構成の詳細をご覧ください。[INSTANCE-NAME]: GCP Console に表示されるインスタンスの名前。インスタンス名は、Google Cloud Platform プロジェクト内で一意である必要があります。[NODE-COUNT]: インスタンスのノード数。ノード数によって、インスタンス内のデータベースで利用可能な提供リソースとストレージ リソースの量が決まります。
例:
gcloud instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
次のようなメッセージが表示されます。
Creating instance...done.
インスタンスの一覧表示
Console
GCP Console の Spanner インスタンス ページに移動します。
GCP Console には、各インスタンスの ID、表示名、構成、ノード数とともに Cloud Spanner インスタンスの一覧が、表示されます。
gcloud
gcloud spanner instances list コマンドを使用します。
gcloud spanner instances list
gcloud ツールによって、各インスタンスの ID、表示名、構成、ノード数とともに Cloud Spanner インスタンスの一覧が出力されます。
インスタンスの編集
以降のセクションでは、インスタンスの表示名とノード数を変更する方法について説明します。既存のインスタンスの構成は変更できません。
表示名を変更する
Console
GCP Console の Spanner インスタンス ページに移動します。
変更するインスタンスの名前をクリックします。
[インスタンスの編集] をクリックします。
新しいインスタンス名を入力します。この名前は GCP プロジェクト内で一意である必要があります。
[保存] をクリックします。
gcloud
gcloud spanner instances update コマンドを使用します。
gcloud spanner instances update [INSTANCE-ID] --description=[INSTANCE-NAME]
次の値を指定してください。
[INSTANCE-ID]: インスタンスの永続的な識別子。[INSTANCE-NAME]: GCP Console に表示されるインスタンスの名前。インスタンス名は、Google Cloud Platform プロジェクト内で一意である必要があります。
ノード数を変更する
必要なストレージ量に合わせた十分なノード数をプロビジョニングし、CPU 使用率を推奨最大値未満に保つ必要があります。1 つのノードによって提供されるリソースに関する詳細については、Cloud Spanner の割り当てと制限をご覧ください。
インスタンス内のノード数を増やす場合は、GCP プロジェクトにノードを追加するのに十分な割り当てが必要です。
Console
GCP Console の Spanner インスタンス ページに移動します。
変更するインスタンスの名前をクリックします。
[インスタンスの編集] をクリックします。
必要なノード数を入力します。
[保存] をクリックします。
ノードをこの位置に追加するのに十分な割り当てがないというダイアログが表示された場合は、指示に従って割り当ての増加をリクエストします。
gcloud
gcloud spanner instances update コマンドを使用します。
gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]
次の値を指定してください。
[INSTANCE-ID]: インスタンスの永続的な識別子。[NODE-COUNT]: インスタンスのノード数。
インスタンスの削除
Console
GCP Console の Spanner インスタンス ページに移動します。
削除するインスタンスの名前をクリックします。
[インスタンスの削除] をクリックします。
指示に従って、インスタンスを削除することを確認します。
[削除] をクリックします。
gcloud
gcloud spanner instances delete コマンドを使用します。[INSTANCE-ID] はインスタンス ID に置き換えてください。
gcloud spanner instances delete [INSTANCE-ID]
次のステップ
- データ操作言語（DML）や
gcloudツールで、データを挿入、更新、削除する方法について学習する。 - インスタンスとそのデータベースに IAM 役割を付与する。
- Cloud Spanner スキーマの設計方法を学習する。
