読み取りプールを作成して管理する

このページでは、大規模な読み取りワークロードの読み取りプールを作成して管理する方法について説明します。

始める前に

  1. 読み取りプールには、プライマリ インスタンスのコピーが含まれています。まだ作成していない場合は、Cloud SQL Enterprise Plus エディションのプライマリ インスタンスを作成します。読み取りプールはパブリック IP 接続をサポートしていますが、このガイドでは、プライベート IP（PSA）接続を使用してプライマリ インスタンスを作成します。プライマリ インスタンスとレプリケーションの詳細については、Cloud SQL でのレプリケーションをご覧ください。
  2. プライマリ インスタンスの作成後、root ユーザーのパスワードを選択し、次のコマンドを実行してプライマリ インスタンスにパスワードを設定します。後で読み取りプールに接続するときに使用するため、このパスワードは忘れないようにしてください。
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    次のように置き換えます。

    • PROJECT: プライマリ インスタンスと読み取りプールを配置するプロジェクトの名前。
    • PRIMARY_INSTANCE_NAME: プライマリ インスタンスの名前。

読み取りプールを作成する

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances create コマンドを使用して、複数の読み取りプールノードを含む読み取りプールを作成します。

      gcloud sql instances create READ_POOL_NAME \
      --tier=TIER --edition=ENTERPRISE_PLUS \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
      --master-instance-name=PRIMARY_INSTANCE_NAME

次のように置き換えます。

  • READ_POOL_NAME: 読み取りプールに使用する名前。
  • TIER: 読み取りプール内の各読み取りプールノードに使用するマシンタイプ（db-perf-optimized-N-4 など）。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。
  • PRIMARY_INSTANCE_NAME: 読み取りプールに関連付けられているプライマリ インスタンスの名前（my-primary-instance など）。

Terraform

リードプールを作成するには、Terraform リソースを使用します。次に、instance_type 属性を "READ_POOL_INSTANCE" に設定し、node_count 属性を使用するノードの数に設定します。

次の例には、プライマリ インスタンスと読み取りプールのリソースが含まれています。


resource "google_sql_database_instance" "primary" {
  name             = "mysql-primary"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled            = true
      binary_log_enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "mysql-replica"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

変更を適用する

Google Cloud プロジェクトで Terraform 構成を適用するには、次のセクションの手順を完了します。

Cloud Shell を準備する

  1. Cloud Shell を起動します。

  2. Terraform 構成を適用するデフォルトの Google Cloud プロジェクトを設定します。

    このコマンドは、プロジェクトごとに 1 回だけ実行する必要があります。これは任意のディレクトリで実行できます。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Terraform 構成ファイルに明示的な値を設定すると、環境変数がオーバーライドされます。

ディレクトリを準備する

Terraform 構成ファイルには独自のディレクトリ（ルート モジュールとも呼ばれます）が必要です。

  1. Cloud Shell で、ディレクトリを作成し、そのディレクトリ内に新しいファイルを作成します。ファイルの拡張子は .tf にする必要があります（例: main.tf）。このチュートリアルでは、このファイルを main.tf とします。 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. チュートリアルを使用している場合は、各セクションまたはステップのサンプルコードをコピーできます。

    新しく作成した main.tf にサンプルコードをコピーします。

    必要に応じて、GitHub からコードをコピーします。Terraform スニペットがエンドツーエンドのソリューションの一部である場合は、この方法をおすすめします。

  3. 環境に適用するサンプル パラメータを確認し、変更します。
  4. 変更を保存します。
  5. Terraform を初期化します。これは、ディレクトリごとに 1 回だけ行います。
    terraform init

    最新バージョンの Google プロバイダを使用する場合は、-upgrade オプションを使用します。

    terraform init -upgrade

変更を適用する

  1. 構成を確認して、Terraform が作成または更新するリソースが想定どおりであることを確認します。
    terraform plan

    必要に応じて構成を修正します。

  2. 次のコマンドを実行します。プロンプトで「yes」と入力して、Terraform 構成を適用します。
    terraform apply

    Terraform に「Apply complete!」というメッセージが表示されるまで待ちます。

  3. Google Cloud プロジェクトを開いて結果を表示します。 Google Cloud コンソールの UI でリソースに移動して、Terraform によって作成または更新されたことを確認します。

変更を削除する

変更を削除するには、次の手順を行います。

  1. 削除の保護を無効にするには、Terraform 構成ファイルで deletion_protection 引数を false に設定します。
    deletion_protection =  "false"
  2. 次のコマンドを実行します。プロンプトで「yes」と入力して、更新された Terraform 構成を適用します。
    terraform apply

  1. 次のコマンドを実行します。プロンプトで「yes」と入力して、以前に Terraform 構成で適用されたリソースを削除します。

    terraform destroy

REST v1

インスタンス リソースの insert メソッドを使用して、複数の読み取りプールノードを含む読み取りプールを作成します。databaseVersion プロパティはプライマリと同じにする必要があります。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: プライマリ インスタンスと読み取りプールを配置するプロジェクトの名前。
  • REGION: 読み取りプールのリージョン（us-east1 など）。リージョンはプライマリ インスタンスと同じにする必要があります。
  • TIER: 読み取りプールの各ノードに使用するマシンタイプ（db-perf-optimized-N-4 など）。
  • PRIMARY_INSTANCE_NAME: プライマリ インスタンスの名前。
  • READ_POOL_NAME: 読み取りプールに使用する名前（my-read-pool など）。
  • DATABASE_VERSION: 使用するデータベース バージョン。例: MYSQL_8_0_37。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。
  • FULL_NETWORK_NAME: 読み取りプールを配置するネットワークのフルパス（projects/vpc-host-project/global/networks/my-network-name など）。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

リクエストの本文（JSON）: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

インスタンス リソースの insert メソッドを使用して、複数の読み取りプールノードを含む読み取りプールを作成します。databaseVersion プロパティはプライマリと同じにする必要があります。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: プライマリ インスタンスと読み取りプールを配置するプロジェクトの名前。
  • REGION: 読み取りプールのリージョン（us-east1 など）。リージョンはプライマリ インスタンスと同じにする必要があります。
  • TIER: 読み取りプールの各ノードに使用するマシンタイプ（db-perf-optimized-N-4 など）。
  • PRIMARY_INSTANCE_NAME: プライマリ インスタンスの名前。
  • READ_POOL_NAME: 読み取りプールに使用する名前（my-read-pool など）。
  • DATABASE_VERSION: 使用するデータベース バージョン。例: MYSQL_8_0_37。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。
  • FULL_NETWORK_NAME: 読み取りプールを配置するネットワークのフルパス（projects/vpc-host-project/global/networks/my-network-name など）。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances

リクエストの本文（JSON）: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

リードレプリカを読み取りプールに変換する

既存の Cloud SQL Enterprise Plus エディションのリードレプリカを読み取りプールに変換するには、プール内のノード数を指定します。この変換プロセスでは、レプリカ IP が読み取りプール IP（読み取りエンドポイント）になるため、既存のクライアントは再構成なしでプールに接続できます。

新しく作成された読み取りプールノードは、元のリードレプリカと同じマシンタイプと構成になります。このマシンタイプまたは構成を変更するには、別のオペレーションが必要です。このオペレーションは、ゾーン リードレプリカでのみサポートされています。高可用性（HA）リードレプリカを読み取りプールに変換するには、まずゾーン リードレプリカに変換する必要があります。

詳細については、読み取りプール構成を編集するをご覧ください。

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances patch コマンドを使用して、読み取りプールで使用するリードレプリカを変換します。

      gcloud sql instances patch READ_REPLICA_NAME \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT

次のように置き換えます。

  • READ_REPLICA_NAME: 変換するリードレプリカの名前。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。

Terraform

リードレプリカを読み取りプールに変換するには、Terraform リソースを使用します。マニフェストは、リードレプリカを作成するで使用したマニフェストと似ています。その後、次の手順を行います。

  • instance_type 属性を "READ_REPLICA_INSTANCE" から "READ_POOL_INSTANCE" に変更し、node_count 属性を使用するノードの数に変更します。
  • 以前に設定した場合は、settings.availability_type 属性をクリアします。

REST v1

インスタンス リソースの patch メソッドを使用して、リードレプリカを読み取りプールに変換します。

リクエストのデータを使用する前に、次のように置き換えます。

  • READ_REPLICA_NAME: 変換するリードレプリカの名前（例: my-read-replica）。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME

リクエストの本文（JSON）: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

インスタンス リソースの patch メソッドを使用して、リードレプリカを読み取りプールに変換します。

リクエストのデータを使用する前に、次のように置き換えます。

  • READ_REPLICA_NAME: 変換するリードレプリカの名前（例: my-read-replica）。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME

リクエストの本文（JSON）: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

読み取りプールをリードレプリカに変換する

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances patch コマンドを使用して、読み取りプールで使用するリードレプリカを変換します。

      gcloud sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE --availability-type=ZONAL

次のように置き換えます。

  • READ_POOL_NAME: 変換する読み取りプールの名前。

Terraform

読み取りプールをリードレプリカに変換するには、Terraform リソースを使用します。マニフェストは、読み取りプールを作成するで使用したマニフェストと似ています。次に、instance_type 属性を "READ_POOL_INSTANCE" から "READ_REPLICA_INSTANCE" に変更し、node_count 属性をクリアして、settings.availability_type 属性を ZONAL に設定します。

REST v1

インスタンス リソースの patch メソッドを使用して、読み取りプールをリードレプリカに変換します。

リクエストのデータを使用する前に、次のように置き換えます。

  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

リクエストの本文（JSON）: 

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

インスタンス リソースの patch メソッドを使用して、読み取りプールをリードレプリカに変換します。

リクエストのデータを使用する前に、次のように置き換えます。

  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

リクエストの本文（JSON）: 

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

読み取りプールの情報を表示する

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances describe コマンドを使用して、読み取りプールの説明を取得します。

      gcloud sql instances describe READ_POOL_NAME

次のように置き換えます。

  • READ_POOL_NAME: 説明を取得する読み取りプールの名前。

IP アドレスとノード情報を含むレスポンスの例は次のようになります。

      ...
      connectionName: my-project:us-central1:read-pool
      ipAddresses:
      - ipAddress: 10.3.0.108
        type: PRIVATE
      nodeCount: 2
      nodes:
      - dnsName: c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-f
        ipAddresses:
        - ipAddress: 10.3.0.112
          type: PRIVATE
        name: read-pool-node-01
        state: RUNNABLE
      - dnsName: 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-c
        ipAddresses:
        - ipAddress: 10.3.0.113
          type: PRIVATE
        name: read-pool-node-02
        state: RUNNABLE

REST v1

get メソッドを使用して、読み取りプールの詳細を表示します。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

get メソッドを使用して、読み取りプールの詳細を表示します。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  [...],
  "connectionName": "my-project:us-central1:read-pool",
  "ipAddresses": [
    {
      "type": "PRIVATE",
      "ipAddress": "10.3.0.108"
    }
  ],
  "nodeCount": 2,
  "nodes": [
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.112"
        }
      ],                                                                                                                 
      "name": "read-pool-node-01",
      "gceZone": "us-central1-f",
      "dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    },
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.113"
        }
      ],
      "name": "read-pool-node-02",
      "gceZone": "us-central1-c",
      "dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    }
  ]
}

読み取りプールノードの追加または削除

次の手順では、読み取りプール内の読み取りプールノードの数を変更して、読み取りプールをスケールインまたはスケールアウトします。操作にはいくつかの制限があります。詳細については、読み取りプールの制限事項をご覧ください。

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances patch コマンドを使用して、読み取りプールをスケーリングします。

      gcloud sql instances patch READ_POOL_NAME \
      --node-count=NODE_COUNT

次のように置き換えます。

  • READ_POOL_NAME: 読み取りプールの名前。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。

Terraform

リードプールノードの数を変更するには、既存の Terraform リソースを更新します。マニフェストは、読み取りプールを作成するで使用したマニフェストと似ています。次に、node_count 属性を使用するノードの数に変更します。

REST v1

patch メソッドを使用して、読み取りプール内の読み取りプールノードの数を変更することで、読み取りプールをスケールインまたはスケールアウトします。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

リクエストの本文（JSON）: 

{
  "nodeCount": NODE_COUNT
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

patch メソッドを使用して、読み取りプール内の読み取りプールノードの数を変更することで、読み取りプールをスケールインまたはスケールアウトします。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • NODE_COUNT: 読み取りプールに必要な読み取りプールノードの数。1～20 の任意の数値を指定します。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

リクエストの本文（JSON）: 

{
  "nodeCount": NODE_COUNT
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

読み取りプール構成を編集する

読み取りプールの構成を編集する手順は次のとおりです。詳細については、インスタンスの設定についてとインスタンスを編集するをご覧ください。

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances patch コマンドを使用して、マシンタイプを変更するなど、読み取りプールを垂直方向にスケーリングします。

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

次のように置き換えます。

  • READ_POOL_NAME: 読み取りプールの名前。
  • TIER: 読み取りプールの各ノードに適用するマシンタイプ（db-perf-optimized-N-8 など）。

Terraform

リードプールの構成を編集するには、既存の Terraform リソースを更新します。マニフェストは、読み取りプールを作成するで使用したマニフェストと似ています。次に、settings フィールドで変更する属性を更新します。たとえば、settings.tier 属性を別のマシンタイプに変更します。

REST v1

読み取りプールノードの構成を変更するには、patch メソッドを使用します。設定は、読み取りプール内のすべての読み取りプールノードに一律に適用されます。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • TIER: 読み取りプールの各ノードに使用するマシンタイプ（db-perf-optimized-N-4 など）。
  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

リクエストの本文（JSON）: 

{
  "settings": {
    "tier": "TIER"
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

読み取りプールノードの構成を変更するには、patch メソッドを使用します。設定は、読み取りプール内のすべての読み取りプールノードに一律に適用されます。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • TIER: 読み取りプールの各ノードに使用するマシンタイプ（db-perf-optimized-N-4 など）。
  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

リクエストの本文（JSON）: 

{
  "settings": {
    "tier": "TIER"
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

読み取りプールに接続する

読み取りプールに接続する方法は多数あります。次の手順では、同じ VPC ネットワークに VM を作成して接続元として使用し、プライベート IP アドレスを使用して読み取りプールに接続する方法を示します。

Cloud SQL インスタンスへの接続を構成するその他の方法については、Cloud SQL 接続についてをご覧ください。通常、接続方法では、まずインスタンスの IP アドレスまたは接続名を取得する必要があります。これについては、読み取りプール情報を確認するで説明しています。読み取りプールは、他の Cloud SQL インスタンスで使用可能な接続方法のほとんどをサポートしていますが、いくつかの制限事項があります。

Cloud SQL Auth Proxy または Cloud SQL コネクタを使用して接続する場合は、最新バージョンに更新してください。読み取りプールをサポートするために必要な最小バージョンは次のとおりです。

  • Cloud SQL Auth Proxy: v2.15.2
  • Cloud SQL Python コネクタ: v1.18.0
  • Cloud SQL Go コネクタ: v1.16.0
  • Cloud SQL Node コネクタ: v1.7.0
  • Cloud SQL Java コネクタ: v1.24.0

コンソール

読み取りプールに接続する手順は次のとおりです。

  1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

    Cloud SQL の [インスタンス] に移動

    インスタンスの概要ページが表示されます。新しい読み取りプールをクリックして、プライベート IP アドレスなどの詳細を表示します。[このインスタンスに接続] セクションで、インスタンスの接続名をコピーして保存します。connection name の形式は projectID:region:instanceID です。後で Cloud SQL Auth Proxy を起動する際に、この connection name を使用します。
  2. Compute Engine VM を作成します。
  3. Compute Engine VM に対して 2 つの SSH 接続を開きます。これらは、Cloud SQL Auth Proxy の実行とデータベース クライアントの実行を行う後続の手順で使用されます。
  4. クライアントをインストールします。
  5. Cloud SQL Auth Proxy をインストールします。
  6. Cloud SQL Auth Proxy を起動します。
  7. Cloud SQL インスタンスに接続します。

詳細については、プライベート IP を使用して Cloud SQL インスタンスに接続するをご覧ください。

読み取りプールを削除する

gcloud

gcloud CLI のインストールと使用開始については、gcloud CLI をインストールするをご覧ください。Cloud Shell の起動については、Cloud Shell を使用するをご覧ください。

次の gcloud sql instances delete コマンドを使用して、読み取りプールを削除します。

      gcloud sql instances delete READ_POOL_NAME

次のように置き換えます。

  • READ_POOL_NAME: 削除する読み取りプールの名前。

REST v1

読み取りプールを削除するには、delete メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

REST v1beta4

読み取りプールを削除するには、delete メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT: 読み取りプールが存在するプロジェクトの名前。
  • READ_POOL_NAME: 読み取りプールの名前（my-read-pool など）。

HTTP メソッドと URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

次のステップ