このページでは、Cloud Spanner インスタンスを作成、一覧表示、編集、削除する方法について説明します。
インスタンスを作成する
インスタンスを作成するには、Google Cloud CLI または Google Cloud コンソールとクライアント ライブラリを使用します。また、オプションの読み取り専用レプリカを追加して、カスタム インスタンス構成でインスタンスを作成することもできます。
Console
Google Cloud コンソールで [インスタンスの作成] ページに移動します。
次の値を入力します。
- Google Cloud コンソールに表示するインスタンス名。インスタンス名は、Google Cloud プロジェクト内で一意である必要があります。
- インスタンス ID。インスタンスを永続的に識別します。インスタンス ID は Google Cloud プロジェクト内で一意にする必要があります。インスタンス ID は後で変更できません。
- 構成を選択することで、インスタンスの地理的位置を定義し、データのレプリケート方法に影響を与えます。
選択した構成に読み取り専用レプリカのロケーションがあり、読み取り専用レプリカをインスタンス構成に追加する場合は、[読み取り専用レプリカを追加] をクリックし、リージョンと番号を選択します。オプションの読み取り専用レプリカを追加して読み取りをスケーリングし、低レイテンシのステイル読み取りをサポートします。(Google Cloud コンソールを使用して読み取り専用レプリカを作成し、インスタンス構成に追加すると、カスタム インスタンス構成が自動的に作成されます)。
インスタンスのコンピューティング容量の量。コンピューティング容量によって、インスタンス内のデータベースで利用可能なサービス リソースとストレージ リソースの量が決まります。コンピューティング容量を指定するには、測定単位(処理単位またはノード)を選択し、数量を入力します。処理単位を使用する場合は、1000 までの数量については 100 の倍数(100、200、300 など)を、それよりも多い数量については 1,000 の倍数(1000、2000、3000 など)を入力します。各ノードの処理単位は 1,000 です。詳しくは、処理単位とノードをご覧ください。
[作成] をクリックしてインスタンスを作成します。
gcloud
gcloud spanner instances create
コマンドを使用します。このコマンドを使用するときは、コンピューティング容量をノードまたは処理単位として指定します。
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --nodes=[NODE-COUNT]
または
gcloud spanner instances create [INSTANCE-ID] --config=[INSTANCE-CONFIG] \
--description="[INSTANCE-NAME]" --processing-units=[PROCESSING-UNIT-COUNT]
次の値を指定します。
[INSTANCE-ID]
: Google Cloud プロジェクト内で一意の永続的な識別子。インスタンス ID は後で変更できません。[INSTANCE-CONFIG]
: インスタンス構成の永続的な識別子。インスタンスの地理的位置を定義し、データのレプリケート方法に影響を与えます。カスタム インスタンス構成の場合、custom-
で始まります。詳細については、インスタンス構成をご覧ください。[INSTANCE-NAME]
: Google Cloud コンソールに表示されるインスタンスの名前。インスタンス名は、Google Cloud プロジェクト内で一意である必要があります。[NODE-COUNT]
: ノード数で表されるインスタンスのコンピューティング容量。各ノードの処理単位は 1,000 です。[PROCESSING-UNIT-COUNT]
: 処理単位数で表されるインスタンスのコンピューティング容量。1,000 までの数量については 100 の倍数(100、200、300 など)を、それより多い数量については 1,000 の倍数(1,000、2,000、3,000 など)を入力します。
基本リージョン インスタンス構成 us-central1
でインスタンス test-instance
を作成するには、次のコマンドを実行します。
gcloud spanner instances create test-instance --config=regional-us-central1 \
--description="Test Instance" --nodes=1
カスタム マルチリージョン インスタンス構成 custom-eur6
でインスタンス custom-eur6-instance
を作成するには、まずカスタム インスタンス構成を作成します。次のコマンドを実行します。
gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
--description="Instance with custom read-only" --nodes=1
上記のいずれかのコマンドを実行すると、次の例のようなメッセージが表示されます。
Creating instance...done.
C++
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
C#
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
Go
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
Java
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
Node.js
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
PHP
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
Python
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
Ruby
Spanner 用のクライアント ライブラリをインストールして使用する方法については、Spanner クライアント ライブラリをご覧ください。
インスタンスの一覧を取得する
Spanner インスタンスのリストを表示できます。
Console
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
Google Cloud コンソールには、Spanner インスタンスのリスト、各インスタンスの ID、表示名、構成、処理単位とノードの両方で表されたコンピューティング容量が表示されます。
gcloud
gcloud spanner instances list
コマンドを使用します。
gcloud spanner instances list
gcloud CLI によって、各インスタンスの ID、表示名、構成、コンピューティング容量とともに Spanner インスタンスの一覧が出力されます。
インスタンスの編集
以降のセクションでは、インスタンスの表示名とコンピューティング容量を変更する方法について説明します。インスタンス ID やインスタンス構成は変更できません。
表示名を変更する
Console
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
変更するインスタンスの名前をクリックします。
[インスタンスの編集] をクリックします。
新しいインスタンス名を入力します。この名前は、Google Cloud プロジェクト内で一意である必要があります。
[保存] をクリックします。
gcloud
gcloud spanner instances update
コマンドを使用します。
gcloud spanner instances update [INSTANCE-ID] --description=[INSTANCE-NAME]
次の値を指定します。
[INSTANCE-ID]
: インスタンスの永続的な識別子。[INSTANCE-NAME]
: Google Cloud コンソールに表示されるインスタンスの名前。インスタンス名は、Google Cloud プロジェクト内で一意である必要があります。
コンピューティング容量を変更する
CPU 使用率とストレージ使用率が推奨最大値を超えないように、十分なコンピューティング容量をプロビジョニングする必要があります。詳細については、Spanner の割り当てと上限をご覧ください。
既存のインスタンスのコンピューティング容量を削減できない場合があります。
- コンピューティング容量を削除するには、1,000 処理単位(1 ノード)あたり 4 TB を超えるデータを格納する必要があります。
- 過去の使用パターンに基づいて、Spanner はインスタンスのデータのスプリットを多数作成しました。まれにコンピューティング容量を削除した後はスプリットを管理できないことがあります。
後者の場合、Cloud Spanner でインスタンスのすべてのスプリットを管理するのに必要な最小容量が見つかるまで、コンピューティング容量を徐々に減らすことができます。使用パターンの変化により、インスタンスでそれほど多くのスプリットが必要なくなった場合、Cloud Spanner は最終的に一部のスプリットをマージし、1 ~ 2 週間後にインスタンスのコンピューティング容量を削減してみることができます。
コンピューティング容量を削除するときは、Cloud Monitoring で CPU 使用率とリクエスト レイテンシをモニタリングし、リージョンのインスタンスで CPU 使用率が 65% を下回り、マルチリージョンのインスタンスの各リージョンで 45% を下回らないようにしてください。コンピューティング容量の削除中に、リクエストのレイテンシが一時的に増加する場合があります。
インスタンスのコンピューティング容量を増やすには、コンピューティング容量を追加するだけの十分な割り当てが Google Cloud プロジェクトに必要です。
Console
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
変更するインスタンスの名前をクリックします。
[インスタンスの編集] をクリックします。
コンピューティング容量を変更するには、測定単位(処理単位またはノード)を選択し、数量を入力します。処理単位を使用する場合は、1,000 までの数量については 100 の倍数(100、200、300 など)を、それより多い数量については 1,000 の倍数(1000、2000、3000 など)を入力します。各ノードの処理単位は 1,000 です。
[保存] をクリックします。
コンピューティング容量をこの位置に追加するのに十分な割り当てがないというダイアログが表示された場合は、指示に従って割り当ての増加をリクエストします。
gcloud
gcloud spanner instances update
コマンドを使用します。このコマンドを使用するときは、コンピューティング容量をノード数または処理単位として指定します。
gcloud spanner instances update [INSTANCE-ID] --nodes=[NODE-COUNT]
または
gcloud spanner instances update [INSTANCE-ID] --processing-units=[PROCESSING-UNIT-COUNT]
次の値を指定します。
[INSTANCE-ID]
: インスタンスの永続的な識別子。[NODE-COUNT]
: ノード数で表されるインスタンスのコンピューティング容量。各ノードの処理単位は 1,000 です。[PROCESSING-UNIT-COUNT]
: 処理単位数で表されるインスタンスのコンピューティング容量。1,000 までの数量については 100 の倍数(100、200、300 など)を、それより多い数量については 1,000 の倍数(1,000、2,000、3,000 など)を入力します。
インスタンスにラベルを付ける
ラベルはリソースを整理するのに役立ちます。
Console
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
インスタンスのチェックボックスをオンにします。ページの右側に情報パネルが表示されます。
[情報パネル] で [ラベル] タブをクリックします。これで、Spanner インスタンスのラベルを追加、削除、または更新できるようになります。
インスタンスを移動する
インスタンスをインスタンス構成から他のインスタンス構成(リージョン構成とマルチリージョン構成を含む)に移動する方法については、インスタンスを移動するをご覧ください。
インスタンスを削除する
Console
Google Cloud コンソールで、[Spanner インスタンス] ページに移動します。
削除するインスタンスの名前をクリックします。
[インスタンスの削除] をクリックします。
指示に従って、インスタンスを削除することを確認します。
[削除] をクリックします。
gcloud
gcloud spanner instances delete
コマンドを使用します。[INSTANCE-ID]
の部分はインスタンス ID で置き換えてください。
gcloud spanner instances delete [INSTANCE-ID]
インスタンスを停止または再起動する
Spanner はフルマネージド データベース サービスであり、独自の基本的なタスクやリソースを監視します。これには、プロセスをモニタリングして、必要に応じてダウンタイムなしで再起動することも含まれます。特定のインスタンスを手動で停止または再起動する必要がないため、Spanner にはそのための手段は用意されていません。
次のステップ
- データ操作言語(DML)や gcloud CLI で、データを挿入、更新、削除する方法について学習する。
- インスタンスとそのデータベースに IAM 役割を付与する。
- Spanner スキーマの設計方法について学習する。