Связаться с намиПопробовать бесплатно

Управление шардами Sharded PostgreSQL

Статья создана
Обновлена 25 декабря 2025 г.

Примечание

Сервис находится на стадии Preview.

Создать шард

Шарды Sharded PostgreSQL создаются на основе существующих кластеров Yandex Managed Service for PostgreSQL, расположенных в том же каталоге и в той же облачной сети, что и кластер Sharded PostgreSQL.

  1. Перейдите на страницу каталога и выберите сервис Yandex Managed Service for Sharded PostgreSQL.
  2. Нажмите на имя нужного кластера и выберите вкладку Шарды.
  3. Нажмите кнопку Создать шард.
  4. Укажите имя шарда и выберите кластер PostgreSQL, хосты которого будут использоваться в качестве хостов с данными в кластере Sharded PostgreSQL.
  5. Нажмите кнопку Создать.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"

  2. Воспользуйтесь методом Cluster.AddShard и выполните запрос, например с помощью cURL:

    curl \
  --request POST \
  --header "Authorization: Bearer $IAM_TOKEN" \
  --header "Content-Type: application/json" \
  --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters/<идентификатор_кластера>/shards' \
  --data '{
            "shardSpec": {
              "shardName": "<имя_шарда>",
              "mdbPostgresql": {
                "clusterId": "<идентификатор_кластера_PostgreSQL>"
              }
            }
          }'

    Где mdbPostgresql.clusterId — идентификатор кластера Managed Service for PostgreSQL в составе шарда.

  3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"

  2. Клонируйте репозиторий cloudapi:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi

    Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

  3. Воспользуйтесь вызовом ClusterService.AddShard и выполните запрос, например с помощью gRPCurl:

    grpcurl \
  -format json \
  -import-path ~/cloudapi/ \
  -import-path ~/cloudapi/third_party/googleapis/ \
  -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \
  -rpc-header "Authorization: Bearer $IAM_TOKEN" \
  -d '{
        "cluster_id": <идентификатор_кластера>
        "shard_spec": {
          "shard_name": "<имя_шарда>",
          "mdb_postgresql": {
            "cluster_id": "<идентификатор_кластера_PostgreSQL>"
          }
        }
      }' \
  mdb.api.yandexcloud.kz:443 \
  yandex.cloud.mdb.spqr.v1.ClusterService.AddShard

    Где mdb_postgresql.cluster_id — идентификатор кластера Managed Service for PostgreSQL в составе шарда.

Удалить шард

При удалении шарда Sharded PostgreSQL кластер Managed Service for PostgreSQL не удаляется.

  1. Перейдите на страницу каталога и выберите сервис Yandex Managed Service for Sharded PostgreSQL.
  2. Нажмите на имя нужного кластера и выберите вкладку Шарды.
  3. Нажмите на значок в строке нужного шарда и выберите пункт Удалить.
  4. В открывшемся окне нажмите кнопку Удалить.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"

  2. Воспользуйтесь методом Cluster.DeleteShard и выполните запрос, например с помощью cURL:

    curl \
  --request DELETE \
  --header "Authorization: Bearer $IAM_TOKEN" \
  --header "Content-Type: application/json" \
  --url 'https://mdb.api.yandexcloud.kz/managed-spqr/v1/clusters/<идентификатор_кластера>/shards/<имя_шарда>'

  3. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"

  2. Клонируйте репозиторий cloudapi:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi

    Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

  3. Воспользуйтесь вызовом ClusterService.DeleteShard и выполните запрос, например с помощью gRPCurl:

    grpcurl \
  -format json \
  -import-path ~/cloudapi/ \
  -import-path ~/cloudapi/third_party/googleapis/ \
  -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \
  -rpc-header "Authorization: Bearer $IAM_TOKEN" \
  -d '{
        "cluster_id": <идентификатор_кластера>,
        "shard_name": "<имя_шарда>"
      }' \
  mdb.api.yandexcloud.kz:443 \
  yandex.cloud.mdb.spqr.v1.ClusterService.DeleteShard

  4. Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Предыдущая
Изменение кластера
Следующая
Удаление кластера