Подключиться
Войти
Yandex Managed Service for ClickHouse

Метод update

Изменяет указанного пользователя ClickHouse.

HTTP-запрос

PATCH https://mdb.api.cloud.yandex.net/managed-clickhouse/v1/clusters/{clusterId}/users/{userName}

Path-параметры

Параметр Описание
clusterId Обязательное поле. Идентификатор кластера ClickHouse, к которому принадлежит пользователь. Чтобы получить идентификатор кластера, используйте запрос list. Максимальная длина строки в символах — 50.
userName Обязательное поле. Имя пользователя, которого следует изменить. Чтобы получить имя пользователя, используйте запрос list. Максимальная длина строки в символах — 63. Значение должно соответствовать регулярному выражению [a-zA-Z0-9_]*.

Параметры в теле запроса

{
  "updateMask": "string",
  "password": "string",
  "permissions": [
    {
      "databaseName": "string"
    }
  ],
  "settings": {
    "readonly": "integer",
    "allowDdl": true,
    "insertQuorum": "integer",
    "insertQuorumTimeout": "integer",
    "selectSequentialConsistency": true,
    "maxReplicaDelayForDistributedQueries": "integer",
    "fallbackToStaleReplicasForDistributedQueries": true,
    "maxThreads": "integer",
    "maxBlockSize": "integer",
    "maxInsertBlockSize": "integer",
    "maxMemoryUsage": "integer",
    "maxMemoryUsageForUser": "integer",
    "maxRowsToRead": "integer",
    "maxBytesToRead": "integer",
    "readOverflowMode": "string",
    "maxRowsToGroupBy": "integer",
    "groupByOverflowMode": "string",
    "maxRowsToSort": "integer",
    "maxBytesToSort": "integer",
    "sortOverflowMode": "string",
    "maxResultRows": "integer",
    "maxResultBytes": "integer",
    "resultOverflowMode": "string",
    "maxRowsInDistinct": "integer",
    "maxBytesInDistinct": "integer",
    "distinctOverflowMode": "string",
    "maxRowsToTransfer": "integer",
    "maxBytesToTransfer": "integer",
    "transferOverflowMode": "string",
    "maxExecutionTime": "integer",
    "timeoutOverflowMode": "string",
    "maxColumnsToRead": "integer",
    "maxTemporaryColumns": "integer",
    "maxTemporaryNonConstColumns": "integer",
    "maxQuerySize": "integer",
    "maxAstDepth": "integer",
    "maxAstElements": "integer",
    "maxExpandedAstElements": "integer"
  }
}
Поле Описание
updateMask string

Маска, которая указывает, какие атрибуты пользователя ClickHouse должны быть изменены.

Имена всех обновляемых полей, разделенные запятыми. Только значения указанных полей будут изменены. Остальные останутся нетронутыми. Если поле указано в параметре updateMask и в запросе не было отправлено значение для этого поля, значение поля будет сброшено на значение по умолчанию. Значение по умолчанию для большинства полей — null или 0.

Если в запросе не передается updateMask, значения всех полей будут обновлены. Для полей, указанных в запросе, будут использованы переданные значения. Значения остальных полей будут сброшены на значения по умолчанию.
password string

Новый пароль для пользователя.

Длина строки в символах должна быть от 8 до 128.
permissions[] object

Новый набор разрешений для пользователя.
permissions[].
databaseName		 string

Имя базы данных, к которой предоставляет доступ разрешение.
settings object

Пользовательские настройки ClickHouse. Поддерживаемые параметры входят в число параметров, описанных в разделе документации ClickHouse.
settings.
readonly		 integer (int64)

См. подробное описание в документации ClickHouse.

Допустимые значения — от 0 до 2 включительно.
settings.
allowDdl		 boolean (boolean)

См. подробное описание в документации ClickHouse.
settings.
insertQuorum		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
insertQuorumTimeout		 integer (int64)

Время ожидания записи для кворума в миллисекундах. Значение по умолчанию: 60000. См. подробное описание в документации ClickHouse.

Минимальное значение — 1000.
settings.
selectSequentialConsistency		 boolean (boolean)

См. подробное описание в документации ClickHouse.
settings.
maxReplicaDelayForDistributedQueries		 integer (int64)

Максимальная задержка реплики в миллисекундах. Если реплика отстает на значение больше установленного, реплика перестает использоваться. Значение по умолчанию: 300000. См. подробное описание в документации ClickHouse.

Минимальное значение — 1000.
settings.
fallbackToStaleReplicasForDistributedQueries		 boolean (boolean)

См. подробное описание в документации ClickHouse.
settings.
maxThreads		 integer (int64)

См. подробное описание в документации ClickHouse.

Значение должно быть больше 0.
settings.
maxBlockSize		 integer (int64)

См. подробное описание в документации ClickHouse.

Значение должно быть больше 0.
settings.
maxInsertBlockSize		 integer (int64)

См. подробное описание в документации ClickHouse.

Значение должно быть больше 0.
settings.
maxMemoryUsage		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxMemoryUsageForUser		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxRowsToRead		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxBytesToRead		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
readOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxRowsToGroupBy		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
groupByOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxRowsToSort		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxBytesToSort		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
sortOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxResultRows		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxResultBytes		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
resultOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxRowsInDistinct		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxBytesInDistinct		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
distinctOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxRowsToTransfer		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxBytesToTransfer		 integer (int64)

См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
transferOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxExecutionTime		 integer (int64)

Максимальное время выполнения запроса в миллисекундах. См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
timeoutOverflowMode		 string

См. подробное описание в документации ClickHouse.
settings.
maxColumnsToRead		 integer (int64)

Максимальное количество столбцов, которые можно прочитать из таблицы в одном запросе. См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxTemporaryColumns		 integer (int64)

Максимальное количество временных столбцов, которые должны храниться в оперативной памяти одновременно при выполнении запроса, включая постоянные столбцы. См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxTemporaryNonConstColumns		 integer (int64)

Максимальное количество временных столбцов, которые должны храниться в оперативной памяти одновременно при выполнении запроса, за исключением постоянных столбцов. См. подробное описание в документации ClickHouse.

Минимальное значение — 0.
settings.
maxQuerySize		 integer (int64)

Наибольшая часть запроса, которая может быть передана в RAM для разбора с помощью анализатора SQL, в байтах. Значение по умолчанию: 262144. См. подробное описание в документации ClickHouse.

Значение должно быть больше 0.
settings.
maxAstDepth		 integer (int64)

Максимальная глубина синтаксического дерева запроса. Значение по умолчанию: 1000. См. подробное описание в документации ClickHouse.

Значение должно быть больше 0.
settings.
maxAstElements		 integer (int64)

Максимальный размер синтаксического дерева запроса в количестве узлов. Значение по умолчанию: 50000. См. подробное описание в документации ClickHouse.

Значение должно быть больше 0.
settings.
maxExpandedAstElements		 integer (int64)

Максимальный размер синтаксического дерева запроса в количестве узлов после раскрытия псевдонимов и звездочки. Значение по умолчанию: 500000.

Значение должно быть больше 0.

Ответ

HTTP Code: 200 - OK

{
  "id": "string",
  "description": "string",
  "createdAt": "string",
  "createdBy": "string",
  "modifiedAt": "string",
  "done": true,
  "metadata": "object",

  //  включает только одно из полей `error`, `response`
  "error": {
    "code": "integer",
    "message": "string",
    "details": [
      "object"
    ]
  },
  "response": "object",
  // конец списка возможных полей

}

Ресурс Operation. Дополнительные сведения см. в разделе Объект Operation.

Поле Описание
id string

Идентификатор операции.
description string

Описание операции. Длина описания должна быть от 0 до 256 символов.
createdAt string (date-time)

Время создания ресурса в формате в RFC3339.

Строка в формате RFC3339.
createdBy string

Идентификатор пользователя или сервисного аккаунта, инициировавшего операцию.
modifiedAt string (date-time)

Время, когда ресурс Operation последний раз обновлялся. Значение в формате RFC3339.

Строка в формате RFC3339.
done boolean (boolean)

Если значение равно false — операция еще выполняется. Если true — операция завершена, и задано значение одного из полей error или response.
metadata object

Метаданные операции. Обычно в поле содержится идентификатор ресурса, над которым выполняется операция. Если метод возвращает ресурс Operation, в описании метода приведена структура соответствующего ему поля metadata.
error object
Описание ошибки в случае сбоя или отмены операции.
включает только одно из полей error, response

Описание ошибки в случае сбоя или отмены операции.
error.
code		 integer (int32)

Код ошибки. Значение из списка google.rpc.Code.
error.
message		 string

Текст ошибки.
error.
details[]		 object

Список сообщений с подробными сведениями об ошибке.
response object
включает только одно из полей error, response

Результат операции в случае успешного завершения. Если исходный метод не возвращает никаких данных при успешном завершении, например метод Delete, поле содержит объект google.protobuf.Empty. Если исходный метод — это стандартный метод Create / Update, поле содержит целевой ресурс операции. Если метод возвращает ресурс Operation, в описании метода приведена структура соответствующего ему поля response.