---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/ydb-sdk/ydb-status-codes.md
  - https://ydb.tech/docs/ru/reference/ydb-sdk/ydb-status-codes.md
  - href: ru/reference/ydb-sdk/ydb-status-codes.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/reference/ydb-sdk/ydb-status-codes.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Статусы завершения сервера YDB

[//]: # (Information from https://GitHub.com/ydb-platform/ydb-go-sdk/blob/master/retry/errors_data_test.go)

#|
||
Код
|
Статус
|
Возможность повтора
|
Стратегия задержек
|
Пересоздать сессию
||

||
[400000](#success)
|
[SUCCESS](#success)
|
–
|
–
|
–
||

||
[400010](#bad-request)
|
[BAD_REQUEST](#bad-request)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400020](#unauthorized)
|
[UNAUTHORIZED](#unauthorized)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400030](#internal-error)
|
[INTERNAL_ERROR](#internal-error)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400040](#aborted)
|
[ABORTED](#aborted)
|
[повторяемый](*retryable)
|
[короткая](*fastbackoff)
|
нет
||

||
[400050](#unavailable)
|
[UNAVAILABLE](#unavailable)
|
[повторяемый](*retryable)
|
[короткая](*fastbackoff)
|
нет
||

||
[400060](#overloaded)
|
[OVERLOADED](#overloaded)
|
[повторяемый](*retryable)
|
[большая](*slowbackoff)
|
нет
||

||
[400070](#scheme-error)
|
[SCHEME_ERROR](#scheme-error)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400080](#generic-error)
|
[GENERIC_ERROR](#generic-error)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400090](#timeout)
|
[TIMEOUT](#timeout)
|
[неповторяемый](*nonretryable)
<!-- conditionally-retryable -->
<!-- TODO: Why is it non-retryable ? -->
|
–
|
нет
||

||
[400100](#bad-session)
|
[BAD_SESSION](#bad-session)
|
[повторяемый](*retryable)
|
[моментально](*instant)
|
да
||

||
[400120](#precondition-failed)
|
[PRECONDITION_FAILED](#precondition-failed)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400130](#already-exists)
|
[ALREADY_EXISTS](#already-exists)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400140](#not-found)
|
[NOT_FOUND](#not-found)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400150](#session-expired)
|
[SESSION_EXPIRED](#session-expired)
|
[повторяемый](*retryable)
|
[моментально](*instant)
|
да
||

||
[400160](#cancelled)
|
[CANCELLED](#cancelled)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400170](#undetermined)
|
[UNDETERMINED](#undetermined)
|
[условно повторяемый](*condretryable)
|
[короткая](*fastbackoff)
|
нет
||

||
[400180](#unsupported)
|
[UNSUPPORTED](#unsupported)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||

||
[400190](#session-busy)
|
[SESSION_BUSY](#session-busy)
|
[повторяемый](*retryable)
|
[короткая](*fastbackoff)
|
да
||

||
[400200](#external-error)
|
[EXTERNAL_ERROR](#external-error)
|
[неповторяемый](*nonretryable)
|
–
|
нет
||
|#

## 400000: SUCCESS {#success}

Не является ошибкой — запрос успешно обработан.

<div class="tags_list">

## 400010: BAD_REQUEST {#bad-request}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Ошибка в синтаксисе запроса, пропущены обязательные поля.

Проверьте запрос.

<div class="tags_list">

## 400020: UNAUTHORIZED {#unauthorized}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Отсутствует доступ к запрашиваемому схемному объекту (таблица, директория).

Запросите доступ у администратора базы данных.

<div class="tags_list">

## 400030: INTERNAL_ERROR {#internal-error}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Неизвестная внутренняя ошибка.

Зарегистрируйте проблему на [GitHub](https://github.com/ydb-platform/ydb/issues/new) или обратитесь к технической поддержке YDB.

<div class="tags_list">

## 400040: ABORTED {#aborted}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "practice-tag tags-shape tags-color-text"> [Повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Короткая задержка </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Операция не выполнена (например, по причине инвалидации локов, `TRANSACTION_LOCKS_INVALIDATED` в подробных сообщениях об ошибке).

Повторите всю транзакцию.

<div class="tags_list">

## 400050: UNAVAILABLE {#unavailable}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "practice-tag tags-shape tags-color-text"> [Повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Короткая задержка </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Часть системы недоступна.

Повторите последнее действие (запрос).

<div class="tags_list">

## 400060: OVERLOADED {#overloaded}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "practice-tag tags-shape tags-color-text"> [Повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Большая задержка </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Часть системы перегружена.

Повторите последнее действие (запрос), снизьте интенсивность потока запросов.

<div class="tags_list">

## 400070: SCHEME_ERROR {#scheme-error}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Запрос не соответствует схеме.

Исправьте запрос или схему.

<div class="tags_list">

## 400080: GENERIC_ERROR {#generic-error}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Неклассифицируемая ошибка, возможно, связанная с запросом.

Ознакомьтесь с подробным сообщением об ошибке. При необходимости зарегистрируйте проблему на [GitHub](https://github.com/ydb-platform/ydb/issues/new) или обратитесь к технической поддержке YDB.

<div class="tags_list">

## 400090: TIMEOUT {#timeout}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "use_cases-tag tags-shape tags-color-text"> [Условно повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Моментально </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Запрос не выполнен за отведённое время.

Можно повторить для идемпотентных запросов.

<div class="tags_list">

## 400100: BAD_SESSION {#bad-session}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "practice-tag tags-shape tags-color-text"> [Повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Моментально </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Данная сессия больше недоступна.

Пересоздайте сессию.

<div class="tags_list">

## 400120: PRECONDITION_FAILED {#precondition-failed}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Запрос не может быть выполнен в текущем состоянии (например, вставка в таблицу с существующим ключом).

Исправьте состояние или запрос и повторите попытку.

<div class="tags_list">

## 400130: ALREADY_EXISTS {#already-exists}

[//]: # (TODO: Verify the description)
<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Объект базы данных, который создаётся, уже существует в кластере YDB.

Ответ зависит от логики приложения.

<div class="tags_list">

## 400140: NOT_FOUND {#not-found}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Объект базы данных не найден в YDB.

Ответ зависит от логики приложения.

<div class="tags_list">

## 400150: SESSION_EXPIRED {#session-expired}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "use_cases-tag tags-shape tags-color-text"> [Условно повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Моментально </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Срок действия сессии уже истёк.

Пересоздать сессию.

<div class="tags_list">

## 400160: CANCELLED {#cancelled}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Запрос был отменён на сервере. Например, пользователь отменил запрос во [встроенном UI](https://ydb.tech/docs/ru/reference/embedded-ui/index.md), который выполнялся слишком долго, или запрос был сделан с опцией таймаута [cancel_after](https://ydb.tech/docs/ru/dev/timeouts.md#cancel).

Если выполнение запроса заняло слишком много времени, попробуйте оптимизировать запрос. Если использовалась опция таймаута `cancel_after`, увеличьте её значение.

<div class="tags_list">

## 400170: UNDETERMINED {#undetermined}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "use_cases-tag tags-shape tags-color-text"> [Условно повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Короткая задержка </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Состояние транзакции неизвестно. В результате выполнения запроса произошёл сбой, из-за которого невозможно определить состояние транзакции. На запросы, завершившиеся с таким статусом, распространяются гарантии целостности и атомарности транзакции. То есть либо все изменения зафиксированы, либо вся транзакция отменена.

Для идемпотентных транзакций можно повторить всю транзакцию с небольшой задержкой. В противном случае реакция зависит от логики приложения.

<div class="tags_list">

## 400180: UNSUPPORTED {#unsupported}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Запрос не поддерживается YDB, либо потому, что обработка таких запросов ещё не реализована в данной версии YDB, либо потому, что поддержка таких запросов не включена в конфигурации YDB.

Исправьте запрос или включите поддержку подобных запросов в конфигурации YDB.

<div class="tags_list">

## 400190: SESSION_BUSY {#session-busy}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "practice-tag tags-shape tags-color-text"> [Повторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) | Короткая задержка </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Сессия занята.

Пересоздайте сессию.

<div class="tags_list">

## 400200: EXTERNAL_ERROR {#external-error}

<!-- source: ru/reference/ydb-sdk/_includes/tags.md -->
 <span class = "overview-tag tags-shape tags-color-text"> [Неповторяемый](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md) </span>
<!-- endsource: ru/reference/ydb-sdk/_includes/tags.md -->

</div>

Произошла ошибка во внешней системе, например, при обработке федеративного запроса или при импорте данных из внешнего источника.

Проанализируйте подробное сообщение об ошибке. При необходимости зарегистрируйте проблему на [GitHub](https://github.com/ydb-platform/ydb/issues/new) или обратитесь к технической поддержке YDB.

## Смотрите также

[Ошибки](https://ydb.tech/docs/ru/faq/errors.md)

[*instant]: **Немедленный повтор** – одна из стратегий задержек, применяемых в SDK при повторе запросов, завершившихся ошибкой.<br/>
Повторные попытки при такой стратегии совершаются немедленно.<br/>
См. подробнее в статье [Обработка временных сбоев (retryable errors)](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md#handling-retryable-errors).

[*fastbackoff]: **Короткая экспоненциальная задержка** – одна из стратегий задержек, применяемых в SDK при повторе запросов, завершившихся ошибкой.<br/>
Первоначальный интервал при такой задержке составляет несколько **миллисекунд**. Для каждой последующей попытки интервал увеличивается экспоненциально.<br/>
См. подробнее в статье [Обработка временных сбоев (retryable errors)](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md#handling-retryable-errors).

[*slowbackoff]: **Большая экспоненциальная задержка** – одна из стратегий задержек, применяемых в SDK при повторе запросов, завершившихся ошибкой.<br/>
Первоначальный интервал при такой задержке составляет несколько **секунд**. Для каждой последующей попытки интервал увеличивается по экспоненциальному закону.<br/>
См. подробнее в статье [Обработка временных сбоев (retryable errors)](https://ydb.tech/docs/ru/reference/ydb-sdk/error_handling.md#handling-retryable-errors).

[*retryable]: **Временные сбои** (retryable). Включают кратковременную потерю сетевого соединения, временную недоступность или перегруженность одной из подсистем YDB, а также неспособность YDB ответить на запрос в течение установленного времени ожидания. В случае возникновения таких ошибок повторный запрос через некоторый промежуток времени с высокой вероятностью будет выполнен успешно.

[*nonretryable]: **Ошибки, которые не могут быть исправлены с помощью повтора** (non-retryable). Включают некорректно сформированные запросы, внутренние ошибки YDB, а также запросы, не соответствующие схеме данных. В такой ситуации нет необходимости повторять запрос, требуется дополнительное вмешательство разработчика.

[*condretryable]: **Ошибки, которые, предположительно, могут быть исправлены с помощью повтора после реакции клиентского приложения** (conditionally retryable). Возникают при идемпотентных операциях, таких как отсутствие ответа в течение отведённого времени или запрос аутентификации.