このページでは、Cloud SQL for MySQL インスタンスを作成する方法について説明します。
すべてのインスタンスの設定について詳しくは、インスタンスの設定をご覧ください。
インスタンスの作成時に、単一のデータベースがインスタンスに追加されます。データベースを作成またはインポートすると、さらにデータベースを追加できます。
始める前に
- Google アカウントにログインします。
Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。
- Cloud SDK をインストールして初期化します。
-
ユーザー アカウントに Cloud SQL 管理者のロールと Compute 閲覧者のロールがあることを確認します。
ロールと権限について詳細を確認します。
MySQL インスタンスの作成
MySQL インスタンスを作成するには:
Console
- Google Cloud Console の Cloud SQL インスタンス ページに移動します。
- [インスタンスを作成] をクリックします。
- [MySQL] を選択して [次へ] をクリックします。
- 名前を入力します。
インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。
'root'@'%'ユーザーのパスワードを入力します。- [ロケーション] で、インスタンスのリージョンとゾーンを選択します。
インスタンスにアクセスするリソースと同じリージョンにインスタンスを配置します。選択したリージョンは後から変更できません。ほとんどの場合、ゾーンを指定する必要はありません。
- [構成オプション] で、インスタンスの設定を更新します。
設定 備考 データベースのバージョン インスタンスの作成後にデータベースのバージョンを編集することはできません。 データベースのバージョン Console: MySQL 8.0、MySQL 5.7（デフォルト）、MySQL 5.6
API: MYSQL_8_0、MYSQL_5_7（デフォルト）、MYSQL_5_6接続 プライベート IP インスタンスのプライベート IP アドレスを追加します。インスタンスへの接続を有効にするには、追加の構成が必要です。 パブリック IP インスタンスのパブリック IP アドレスを追加します。インスタンスへの接続を有効にするには、追加の構成が必要です。 マシンタイプとストレージ マシンタイプ マシンタイプ（「層」とも呼ばれる）によって、CPU の数とインスタンスのメモリ量が決まります。 詳しくはこちらをご覧ください。 ストレージの種類 インスタンスで SSD または HDD のどちらのストレージを使用するかを指定します。詳しくは、こちらをご覧ください。 ストレージ容量 インスタンスにプロビジョニングされているストレージ容量。 詳細 ストレージの自動増量 空き領域が少なくなったときに、Cloud SQL が自動的にインスタンス用のストレージを増やすかどうかを指定します。詳しくは、こちらをご覧ください。 高可用性 高可用性向けにインスタンスを構成する必要がある場合は、[高可用性（リージョン）] チェックボックスをオンにする必要があります。詳しくは、こちらをご覧ください。 自動バックアップ バックアップを開始する時間枠。詳しくはこちらをご覧ください。 バイナリ ロギング バイナリログを使用すると、レプリケーションとポイントインタイム リカバリが可能になります。詳しくはこちらをご覧ください。 データベース フラグの追加 データベース フラグ データベース フラグを使用して、インスタンスの設定とパラメータを制御できます。詳しくは、こちらをご覧ください。 メンテナンス スケジュール メンテナンスの時間枠 Cloud SQL がインスタンスに対し、中断メンテナンスを実行できる 1 時間の時間枠を指定します。この時間枠を設定しない場合、任意の時間に中断メンテナンスが行われる可能性があります。詳細 メンテナンスのタイミング 希望するインスタンス更新のタイミング。同じプロジェクトの他のインスタンスとの相対的なタイミングです。詳しくはこちらをご覧ください。 詳しくはインスタンスの設定をご覧ください。
- [作成] をクリックします。
gcloud
gcloud コマンドライン ツールのインストール方法と使用方法については、Cloud SDK のインストールをご覧ください。Cloud Shell の起動方法については、Cloud Shell のドキュメントをご覧ください。
- 使用できるマシンタイプの一覧を表示します。
gcloud sql tiers list
「
db-」で始まるタイプがあります。第 2 世代インスタンスを作成するには、このタイプのマシンを選択する必要があります。各マシンタイプ、それぞれの機能、インスタンスの料金に対する影響については、料金ページをご覧ください。
- インスタンスを作成します。
gcloud sql instances create INSTANCE_NAME --tier=MACHINE_TYPE --region=REGION
インスタンス名には機密情報や個人を特定できる情報を含めないでください。インスタンス名は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。MACHINE_TYPE は、前のステップで取得した値のうち、
db-で始まるものです。たとえば、次のコマンドは、ロンドン リージョンに、マシンタイプが
db-n1-standard-2で、instance1 という名前の第 2 世代インスタンスを作成します。gcloud sql instances create instance1 --tier=db-n1-standard-2 --region=europe-west2
パラメータを追加して、他のインスタンス設定を指定できます。
設定 パラメータ 備考 必須パラメータ データベースのバージョン --database-versionMYSQL_8_0、MYSQL_5_7（デフォルト）またはMYSQL_5_6リージョン --region有効な値を参照してください。 接続 プライベート IP --networkこのインスタンスに使用する VPC ネットワーク名を指定します。このネットワークに対して、プライベート サービス アクセスがすでに構成されている必要があります。ベータ版のコマンド（ gcloud beta sql instances create）でのみ使用できます。詳細パブリック IP --authorized-networksパブリック IP 接続の場合は、承認済みネットワークからのみ、インスタンスに接続できます。詳細 マシンタイプとストレージ マシンタイプ --tierマシンのタイプによって、CPU の数とインスタンスのメモリ量が決まります。デフォルト値を確認してください。カスタム マシンタイプを作成することもできます。詳しくはこちらをご覧ください。 ストレージの種類 --storage-typeインスタンスで SSD または HDD のどちらのストレージを使用するかを指定します。詳しくは、こちらをご覧ください。 ストレージ容量 --storage-sizeインスタンスにプロビジョニングされているストレージ容量（GB 単位）。詳しくはこちらをご覧ください。 ストレージの自動増量 --storage-auto-increase空き領域が少なくなったときに、Cloud SQL が自動的にインスタンス用のストレージを増やすかどうかを指定します。詳細 ストレージの自動増量の上限 --storage-auto-increase-limitCloud SQL が自動的に増量できるストレージ容量の上限を指定します。ベータ版のコマンド（ gcloud beta sql instances create）でのみ使用できます。詳細自動バックアップと高可用性 高可用性 --availability-type高可用性インスタンスの場合は、 REGIONALに設定します。詳しくはこちらをご覧ください。自動バックアップ --backup-start-timeバックアップを開始する時間枠。詳しくはこちらをご覧ください。 バイナリ ロギング --enable-bin-logバイナリログを使用すると、レプリケーションとポイントインタイム リカバリが可能になります。詳しくはこちらをご覧ください。 データベース フラグの追加 データベース フラグ --database-flagsデータベース フラグを使用して、インスタンスの設定とパラメータを制御できます。データベース フラグの詳細をご確認ください。このパラメータの設定方法の詳細をご確認ください。 メンテナンス スケジュール メンテナンスの時間枠 --maintenance-window-day,--maintenance-window-hourCloud SQL がインスタンスに対し、中断メンテナンスを実行できる 1 時間の時間枠を指定します。この時間枠を設定しない場合、任意の時間に中断メンテナンスが行われる可能性があります。詳しくはこちらをご覧ください。 メンテナンスのタイミング --maintenance-release-channel希望するインスタンス更新のタイミング。同じプロジェクトの他のインスタンスとの相対的なタイミングです。他のインスタンスより前に更新する場合は previewを使用し、後に更新する場合はproductionを使用します。詳しくはこちらをご覧ください。 - 自動的に割り当てられた IP アドレスをメモします。
Cloud SQL Proxy を使用していない場合、アプリケーションまたはツールがインスタンスに接続するためのホストアドレスとしてこのアドレスが使用されます。
- "root@%" MySQL ユーザーのパスワードを設定します。
gcloud sql users set-password root --host=% --instance INSTANCE_NAME --password PASSWORD
REST v1beta4
インスタンスを作成する
この例では、バックアップおよびバイナリログを有効にしたインスタンスを作成します。これらの設定は任意です。この呼び出しのパラメータの一覧については、Instances:insert ページをご覧ください。リージョンやマシンタイプの有効な値など、インスタンスの設定の詳細については、インスタンスの設定をご覧ください。
インスタンス ID には機密情報や個人を特定できる情報を含めないでください。インスタンス ID は外部から閲覧可能です。
インスタンス名にプロジェクト ID を含める必要はありません。この処理は必要に応じて自動的に行われます（ログファイルの場合など）。
後述のリクエスト データは、次のように置き換えてから使用します。
- project-id: プロジェクト ID
- instance-id: 目的のインスタンス ID
- database-version: データベース バージョンの列挙型文字列。例:
MYSQL_5_7 - region: 目的のリージョン
- machine-type: 目的のマシンタイプ
HTTP メソッドと URL:
POST https://www.googleapis.com/sql/v1beta4/projects/project-id/instances
JSON 本文のリクエスト:
{
"name": "instance-id",
"region": "region",
"databaseVersion": "database-version",
"settings": {
"tier": "machine-type",
"backupConfiguration": {
"binaryLogEnabled": true,
"enabled": true
}
}
}
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{
"kind": "sql#operation",
"targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2019-09-25T22:19:33.735Z",
"operationType": "CREATE",
"name": "operation-id",
"targetId": "instance-id",
"selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
レスポンスは長時間実行オペレーションのため、完了まで数分かかる場合があります。
root のパスワードを更新します。
インスタンスの初期化が完了したら、root のパスワードを更新します。
後述のリクエスト データは、次のように置き換えてから使用します。
- project-id: プロジェクト ID
- instance-id: 前のステップで作成したインスタンス ID
- root-password: 目的の root パスワード
HTTP メソッドと URL:
PUT https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=root
JSON 本文のリクエスト:
{
"name": "root",
"host": "%",
"password": "root-password"
}
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{
"kind": "sql#operation",
"targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
"status": "DONE",
"user": "user@example.com",
"insertTime": "2019-09-26T14:32:30.592Z",
"startTime": "2019-09-26T14:32:30.594Z",
"endTime": "2019-09-26T14:32:33.518Z",
"operationType": "UPDATE_USER",
"name": "operation-id",
"targetId": "instance-id",
"selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
レスポンスは長時間実行オペレーションのため、完了まで数分かかる場合があります。
IPv4 アドレスを取得する
新しいインスタンスに自動的に割り当てられる IPv4 アドレスを取得します。
後述のリクエスト データは、次のように置き換えてから使用します。
- project-id: プロジェクト ID
- instance-id: 前のステップで作成したインスタンス ID
HTTP メソッドと URL:
GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "MYSQL_5_7",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-f1-micro",
"kind": "sql#settings",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"ipv4Enabled": true
},
"locationPreference": {
"zone": "us-west1-a",
"kind": "sql#locationPreference"
},
"dataDiskType": "PD_SSD",
"backupConfiguration": {
"startTime": "18:00",
"kind": "sql#backupConfiguration",
"enabled": true,
"binaryLogEnabled": true
},
"settingsVersion": "1",
"storageAutoResizeLimit": "0",
"storageAutoResize": true,
"dataDiskSizeGb": "10"
},
"etag": "--redacted--",
"ipAddresses": [
{
"type": "PRIMARY",
"ipAddress": "10.0.0.1"
}
],
"serverCaCert": {
...
},
"instanceType": "CLOUD_SQL_INSTANCE",
"project": "project-id",
"serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
"backendType": "SECOND_GEN",
"selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
"connectionName": "project-id:region:instance-id",
"name": "instance-id",
"region": "us-west1",
"gceZone": "us-west1-a"
}
レスポンスで ipAddress フィールドを探します。
マシンタイプの例
カスタム マシンタイプを使用することにより、メモリと CPU を必要なだけ搭載したインスタンスを構成できます。ただし、メモリと CPU の値にはいくつかの制限があります。
- vCPU は 1 または 2～96 の間の偶数にする必要があります。
- メモリは次の条件を満たす必要があります。
- vCPU あたり 0.9～6.5 GB
- 256 MB の倍数
- 3.75 GB（3,840 MB）以上
以下に、MySQL インスタンスに使用できる定義済みのマシンタイプに基づいて、マシンタイプ値の例を示します。
| 事前定義されたマシンタイプ | vCPU | メモリ（MB） | API 層文字列 |
|---|---|---|---|
| db-n1-standard-1 | 1 | 3840 | db-custom-1-3840 |
| db-n1-standard-2 | 2 | 7680 | db-custom-2-7680 |
| db-n1-standard-4 | 4 | 15360 | db-custom-4-15360 |
| db-n1-standard-8 | 8 | 30720 | db-custom-8-30720 |
| db-n1-standard-16 | 16 | 61440 | db-custom-16-61440 |
| db-n1-standard-32 | 32 | 122880 | db-custom-32-122880 |
| db-n1-standard-64 | 64 | 245760 | db-custom-64-245760 |
| db-n1-standard-96 | 96 | 368640 | db-custom-96-368640 |
| db-n1-highmem-2 | 2 | 13312 | db-custom-2-13312 |
| db-n1-highmem-4 | 4 | 26624 | db-custom-4-26624 |
| db-n1-highmem-8 | 8 | 53248 | db-custom-8-53248 |
| db-n1-highmem-16 | 16 | 106496 | db-custom-16-106496 |
| db-n1-highmem-32 | 32 | 212992 | db-custom-32-212992 |
| db-n1-highmem-64 | 64 | 425984 | db-custom-64-425984 |
| db-n1-highmem-96 | 96 | 638976 | db-custom-96-638976 |
トラブルシューティング
表内のリンクをクリックすると、詳細が表示されます。
| この問題については... | 次のような問題が考えられます... | 次のことを試します... |
|---|---|---|
Internal error。 |
サービス ネットワーキングのサービス アカウントがありません。 | Service
Networking API を無効にしてから再度有効にします。 |
| Terraform インスタンスの作成に失敗した。 | Terraform 構成エラー。 | Terraform 構成ファイルを調べて修復します。 |
Terraform スクリプトの HTTP Error 409。 |
別のオペレーションがすでに進行中です。 | 各オペレーションが完了するまで待機するように Terraform スクリプトを修正します。 |
Unknown error |
最近削除したインスタンスと同じ名前のインスタンスを作成しようとしています。または、使用されている新しいプライベート IP 範囲で同時に複数のインスタンスを作成しようとしています。 | インスタンスに別の名前を使用するか、インスタンスが削除されてから 1 週間経過するまで待ちます。異なる名前を使用して、連続的に失敗したインスタンスを再作成します。 |
内部エラー
エラー メッセージ {"ResourceType":"sqladmin.v1beta4.instance",
"ResourceErrorCode":"INTERNAL_ERROR","ResourceErrorMessage":null} が表示されます。
次のような問題が考えられます
サービス プロジェクトに、この機能に必要なサービス ネットワーキング サービス アカウントがない可能性があります。
次の方法をお試しください
サービスの権限を修復するには、Service Networking API を無効にして 5 分待ち、再度有効にします。
Terraform インスタンスの作成に失敗した
Terraform インスタンスの作成に失敗しました。
次のような問題が考えられます
これは通常、Terraform スクリプト自体の問題です。
次の方法をお試しください
Terraform 構成ファイルを調べて修復します。
Terraform スクリプトの 409 エラー
Terraform スクリプトにエラー メッセージ HTTP Error 409 が表示されます。
次のような問題が考えられます
Operation failed because another operation was already in progress
次の方法をお試しください
スクリプトを修正して、各インスタンスのオペレーションが完了するまで実行を停止します。スクリプトをポーリングして、前のオペレーション ID の 200 が返されるまで待ってから、次のステップに進みます。
不明なエラー
インスタンスを作成しようとすると、Cloud SQL
creation failed, error UNKNOWN のようなエラー メッセージが表示されます。
次のような問題が考えられます
最近削除したインスタンスの名前を再利用しようとしている可能性があります。インスタンス名を削除した後、1 週間は再利用できません。または、最初のインスタンスのみが作成され、他のインスタンスが Unknown error で失敗したときに、新しいプライベート IP 範囲を使用して複数のインスタンスを同時に作成しようとしています。
次の方法をお試しください
インスタンスに別の名前を使用するか、その名前を使用して新しいインスタンスを作成します。複数のインスタンスを同時に作成するのではなく、連続して作成します。
次のステップ
- インスタンスへのアクセスを構成します。
- MySQL クライアントでインスタンスに接続する。
- インスタンスに MySQL データベースを作成する。
- インスタンスにデータをインポートします。
- インスタンスに MySQL ユーザーを作成する。
- インスタンスの設定について学習します。