Коды ошибок запросов

Елена Дворядкина

На странице Queries ADQM Control позволяет фильтровать запросы по предопределенным наборам возможных ошибок выполнения запросов, которые можно выбрать на вкладке Presets фильтра в столбце Exception code.

Вкладка Presets в фильтре запросов по кодам ошибок
Вкладка Presets в фильтре запросов по кодам ошибок

Syntax Processing

Ошибки в тексте запроса или в структуре абстрактного синтаксического дерева (Abstract Syntax Tree, AST).

 

Синтаксис и грамматика
Код ошибки Ошибка

6

CANNOT_PARSE_TEXT

62

SYNTAX_ERROR

80

INCORRECT_QUERY

211

EMPTY_QUERY

417

EXPECTED_ALL_OR_ANY

558

EXPECTED_ALL_OR_DISTINCT
Структура и ограничения AST
Код ошибки Ошибка

37

UNKNOWN_ELEMENT_IN_AST

167

TOO_DEEP_AST

168

TOO_BIG_AST

229

QUERY_IS_TOO_LARGE
Парсинг значений
Код ошибки Ошибка

38

CANNOT_PARSE_DATE

41

CANNOT_PARSE_DATETIME

72

CANNOT_PARSE_NUMBER

376

CANNOT_PARSE_UUID

675/676

CANNOT_PARSE_IPV4/IPV6

Semantics

Семантические ошибки в запросе, такие как:

  • обращение к объекту (столбцу, таблице, базе данных), не существующему в текущем контексте;

  • неверное использование функции (например, если функция не существует, передаются недопустимые аргументы или вызывается агрегатная функция в контексте, где выполнение агрегации невозможно);

  • неверное использование типа данных (например, назначается несуществующий тип данных или осуществляется попытка выполнения операции между значениями разных типов, которые не могут быть преобразованы автоматически);

  • ошибки при использовании JOIN (например, неверно указан ключ соединения или тип JOIN) или операторов для работы с множествами.

 

Неоднозначность идентификаторов
Код ошибки Ошибка

16

NO_SUCH_COLUMN_IN_TABLE

47

UNKNOWN_IDENTIFIER

60

UNKNOWN_TABLE

81

UNKNOWN_DATABASE

174

CYCLIC_ALIASES

207

AMBIGUOUS_IDENTIFIER

352

AMBIGUOUS_COLUMN_NAME
Функции и агрегирование
Код ошибки Ошибка

36

BAD_ARGUMENTS

42

NUMBER_OF_ARGUMENTS_DOESNT_MATCH

46

UNKNOWN_FUNCTION

63

UNKNOWN_AGGREGATE_FUNCTION

184

ILLEGAL_AGGREGATION

527

NO_SUITABLE_FUNCTION_IMPLEMENTATION
Система типов и типы данных
Код ошибки Ошибка

50

UNKNOWN_TYPE

53

TYPE_MISMATCH

70

CANNOT_CONVERT_TYPE

321

VALUE_IS_OUT_OF_RANGE_OF_DATA_TYPE

386

NO_COMMON_TYPE
Oператор JOIN, подзапросы и операции над множествами
Код ошибки Ошибка

121

UNSUPPORTED_JOIN_KEYS

162

TOO_DEEP_SUBQUERIES

264

INCOMPATIBLE_TYPE_OF_JOIN

418

UNKNOWN_JOIN

596

INTERSECT_OR_EXCEPT_RESULT_STRUCTURES_MISMATCH

Runtime Operations

Ошибки при выполнении арифметических вычислений и runtime-операций, например:

  • попытка вставить значение NULL в столбец типа non-Nullable;

  • регулярное выражение не может быть обработано;

  • ошибки низкого уровня во время выполнения пользовательских функций (User-Defined Function, UDF).

 

Вычисление и логика
Код ошибки Ошибка

153

ILLEGAL_DIVISION

407

DECIMAL_OVERFLOW

503

AGGREGATE_FUNCTION_THROW
Runtime-операции
Код ошибки Ошибка

349

CANNOT_INSERT_NULL_IN_ORDINARY_COLUMN

427

CANNOT_COMPILE_REGEXP

447

HYPERSCAN_CANNOT_SCAN_TEXT

754

UDF_EXECUTION_FAILED

Resource Governing

Проблемы, связанные с производительностью и использованием ресурсов при выполнении запроса, такие как:

  • запрос или фоновый процесс потребляет больше оперативной памяти, чем разрешено;

  • для выполнения запроса недостаточно места на диске;

  • запрос выполняется слишком долго или время выполнения запроса превышает установленный лимит;

  • для выполнения запроса необходимо обработать слишком много данных (большое количество строк/байтов, кусков данных, партиций и т.д.), что может привести к замедлению работы и перегрузке системы;

  • превышено максимальное разрешенное количество одновременно выполняемых запросов или максимальное число одновременных подключений.

 

Память и дисковое пространство
Код ошибки Ошибка

173

CANNOT_ALLOCATE_MEMORY

241

MEMORY_LIMIT_EXCEEDED

243

NOT_ENOUGH_SPACE
Время и скорость выполнения запросов
Код ошибки Ошибка

159

TIMEOUT_EXCEEDED

160

TOO_SLOW
Объем и сложность данных
Код ошибки Ошибка

158

TOO_MANY_ROWS

252

TOO_MANY_PARTS

307

TOO_MANY_BYTES

396

TOO_MANY_ROWS_OR_BYTES

565

TOO_MANY_PARTITIONS

692

TOO_MANY_MUTATIONS
Параллельное выполнение запросов, квоты, количество соединений
Код ошибки Ошибка

201

QUOTA_EXCEEDED

202

TOO_MANY_SIMULTANEOUS_QUERIES

203

NO_FREE_CONNECTION

745

SERVER_OVERLOADED

749

TCP_CONNECTION_LIMIT_REACHED

Filesystem

Ошибки при обращении к файлам и каталогам файловой системы, например:

  • при выполнении запроса невозможно считать/записать/найти данные в файле;

  • файл/каталог не существует или уже существует.

 

Операции чтения/записи/поиска
Код ошибки Ошибка

3

UNEXPECTED_END_OF_FILE

32

ATTEMPT_TO_READ_AFTER_EOF

33

CANNOT_READ_ALL_DATA

74/75

CANNOT_READ/WRITE_TO_FILE_DESCRIPTOR

87

CANNOT_SEEK_THROUGH_FILE

294

CANNOT_WRITE_TO_FILE
Управление файлами и каталогами
Код ошибки Ошибка

76

CANNOT_OPEN_FILE

83/84

DIRECTORY_DOESNT_EXIST/ALREADY_EXISTS

107

FILE_DOESNT_EXIST

172

CANNOT_CREATE_DIRECTORY

504

FILE_ALREADY_EXISTS

521

ATOMIC_RENAME_FAIL
Системные вызовы и механизмы ввода/вывода
Код ошибки Ошибка

204

CANNOT_FSYNC

274/275

AIO_READ/WRITE_ERROR

400

CANNOT_STAT

678/679

IO_URING_INIT_FAILED/SUBMIT_ERROR

Data Health

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

 

Повреждение данных и контрольные суммы
Код ошибки Ошибка

40

CHECKSUM_DOESNT_MATCH

117

INCORRECT_DATA

246

CORRUPTED_DATA

740

POTENTIALLY_BROKEN_DATA_PART
Структура столбцов и блоков
Код ошибки Ошибка

7

INCORRECT_NUMBER_OF_COLUMNS

9

SIZES_OF_COLUMNS_DOESNT_MATCH

91

SIZES_OF_MARKS_FILES_ARE_INCONSISTENT

366

SIZES_OF_NESTED_COLUMNS_ARE_INCONSISTENT

Data Shaping

Ошибки, связанные с алгоритмами сжатия и форматами, применяемыми к данным.

 

Алгоритмы сжатия
Код ошибки Ошибка

89

UNKNOWN_COMPRESSION_METHOD

270

CANNOT_COMPRESS

271

CANNOT_DECOMPRESS

354/355

ZLIB_INFLATE/DEFLATE_FAILED

448/449

BROTLI_READ/WRITE_FAILED

553/554

LZMA_STREAM_ENCODER/DECODER_FAILED

560/561

ZSTD_ENCODER/DECODER_FAILED

617/618

LZ4_ENCODER/DECODER_FAILED

638/639

SNAPPY_UNCOMPRESS/COMPRESS_FAILED
Форматы
Код ошибки Ошибка

73

UNKNOWN_FORMAT

85

FORMAT_IS_NOT_SUITABLE_FOR_INPUT

715

CANNOT_DETECT_FORMAT
Определенные форматы
Код ошибки Ошибка

434

CANNOT_PARSE_PROTOBUF_SCHEMA

436

PROTOBUF_BAD_CAST

622

CANNOT_PARSE_CAPN_PROTO_SCHEMA

723

PARQUET_EXCEPTION

748

AVRO_EXCEPTION

Networking

Проблемы, связанные с сетевыми соединениями, например:

  • клиент не смог установить соединение с сервером;

  • соединение не успело установиться или данные не успели передаться в отведенное время;

  • невозможно найти IP-адрес по имени хоста;

  • клиент пытается подключиться к серверу ClickHouse, используя неверный порт или протокол.

 

Соединение и сокет
Код ошибки Ошибка

95/96

CANNOT_READ/WRITE_TO_SOCKET

198

DNS_ERROR

209

SOCKET_TIMEOUT

210

NETWORK_ERROR

279

ALL_CONNECTION_TRIES_FAILED
Протокол и пакеты
Код ошибки Ошибка

99–102

UNEXPECTED/UNKNOWN PACKET FROM CLIENT/SERVER

217

CLIENT_HAS_CONNECTED_TO_WRONG_PORT

902

PROTOCOL_VERSION_MISMATCH

Distributed Execution

Проблемы с сервисом координации, репликацией, выполнением распределенных запросов.

 

Координация
Код ошибки Ошибка

225

NO_ZOOKEEPER

244

UNEXPECTED_ZOOKEEPER_ERROR

308

UNEXPECTED_NODE_IN_ZOOKEEPER

568

RAFT_ERROR

999

KEEPER_EXCEPTION
Статус и управление репликами
Код ошибки Ошибка

251

NO_SUCH_REPLICA

254

NO_ACTIVE_REPLICAS

369

ALL_REPLICAS_ARE_STALE

415

ALL_REPLICAS_LOST

529

NOT_A_LEADER

571

DATABASE_REPLICATION_FAILED
Кворум и согласованность
Код ошибки Ошибка

285

TOO_FEW_LIVE_REPLICAS

286

UNSATISFIED_QUORUM_FOR_PREVIOUS_WRITE

289

REPLICA_IS_NOT_IN_QUORUM
Выполнение распределенных запросов
Код ошибки Ошибка

297

SHARD_HAS_NO_CONNECTIONS

519

NO_REMOTE_SHARD_AVAILABLE

574

DISTRIBUTED_TOO_MANY_PENDING_BYTES

581

TOO_LARGE_DISTRIBUTED_DEPTH

Core Storage

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

 

Управление кусками данных (data part)
Код ошибки Ошибка

226/227

NO_FILE_IN/UNEXPECTED_FILE_IN_DATA_PART

232

NO_SUCH_DATA_PART

235

DUPLICATE_DATA_PART
Метаданные и структура
Код ошибки Ошибка

238

FORMAT_VERSION_TOO_OLD

342

METADATA_MISMATCH

345

TABLE_DIFFERS_TOO_MUCH

741

TABLE_UUID_MISMATCH
Блокировка и фоновые операции
Код ошибки Ошибка

384

PART_IS_TEMPORARILY_LOCKED

388

CANNOT_ASSIGN_OPTIMIZE

389

INSERT_WAS_DEDUPLICATED

450

BAD_TTL_EXPRESSION

System Governance

Ошибки при выполнении DDL-операций (создание баз данных и таблиц) или работе со словарями, а также проблемы, связанные с настройкой конфигурационных параметров (например, если настраивается несуществующий параметр конфигурации или сервер не может обработать свои конфигурационные файлы).

 

DDL-операции
Код ошибки Ошибка

57

TABLE_ALREADY_EXISTS

82

DATABASE_ALREADY_EXISTS

219

DATABASE_NOT_EMPTY

517

CANNOT_ASSIGN_ALTER

524

ALTER_OF_COLUMN_IS_FORBIDDEN

609

FUNCTION_ALREADY_EXISTS
Конфигурация и настройки
Код ошибки Ошибка

115

UNKNOWN_SETTING

137

UNKNOWN_ELEMENT_IN_CONFIG

318

INVALID_CONFIG_PARAMETER

347

CANNOT_LOAD_CONFIG

452

SETTING_CONSTRAINT_VIOLATION

472

READONLY_SETTING
Словари
Код ошибки Ошибка

156

DICTIONARIES_WAS_NOT_LOADED

387

DICTIONARY_ALREADY_EXISTS

489

INCORRECT_DICTIONARY_DEFINITION

Access Control

Ошибки аутентификации, авторизации и шифрования, такие как:

  • указан неизвестный пользователь или неверный пароль пользователя;

  • учетные данные пользователя устарели;

  • доступ к серверу с указанного IP-адреса запрещен;

  • у пользователя нет прав доступа к базе данных/таблице.

 

Аутентификация
Код ошибки Ошибка

192

UNKNOWN_USER

193

WRONG_PASSWORD

195

IP_ADDRESS_NOT_ALLOWED

516

AUTHENTICATION_FAILED

532

LDAP_ERROR

576

KERBEROS_ERROR

720

USER_EXPIRED
Авторизация
Код ошибки Ошибка

164

READONLY

291

DATABASE_ACCESS_DENIED

497

ACCESS_DENIED

509

INVALID_GRANT

511

UNKNOWN_ROLE
Шифрование
Код ошибки Ошибка

454

OPENSSL_ERROR

592

DATA_ENCRYPTION_ERROR

761

ACME_ERROR

Integrations

Проблемы при интеграции с внешними хранилищами данных.

 

Облачные объектные хранилища
Код ошибки Ошибка

499

S3_ERROR

500

AZURE_BLOB_STORAGE_ERROR

693

AWS_ERROR

707

GCP_ERROR

737

GOOGLE_CLOUD_ERROR
Базы данных и протоколы
Код ошибки Ошибка

538

MYSQL_SYNTAX_ERROR

614

POSTGRESQL_CONNECTION_FAILURE

484

INTERNAL_REDIS_ERROR

634

MONGODB_ERROR

750–753

ARROWFLIGHT_*
Очереди сообщений и другое
Код ошибки Ошибка

530

CANNOT_CONNECT_RABBITMQ

660

HDFS_ERROR

665

CANNOT_CONNECT_NATS
Форматы озер данных
Код ошибки Ошибка

640

NO_HIVEMETASTORE

742

DELTA_KERNEL_ERROR

743

ICEBERG_SPECIFICATION_VIOLATION

Features

Ошибки, связанные с такими функциональными возможностями ADQM/ClickHouse, как резервное копирование и восстановление данных, проекции, кеширование запросов, транзакции, машинное обучение.

 

Резервное копирование и восстановление
Код ошибки Ошибка

598

BACKUP_ALREADY_EXISTS

599

BACKUP_NOT_FOUND

601

BACKUP_DAMAGED

654

WRONG_BACKUP_SETTINGS
Проекции
Код ошибки Ошибка

582

NO_SUCH_PROJECTION_IN_TABLE

583

ILLEGAL_PROJECTION

713

BROKEN_PROJECTION
Кеш запросов
Код ошибки Ошибка

704

QUERY_CACHE_USED_WITH_NONDETERMINISTIC_FUNCTIONS

719

QUERY_CACHE_USED_WITH_SYSTEM_TABLE
Транзакции
Код ошибки Ошибка

649

INVALID_TRANSACTION

659

UNKNOWN_STATUS_OF_TRANSACTION
Машинное обучение
Код ошибки Ошибка

382/383

CANNOT_LOAD/APPLY_CATBOOST_MODEL

System Errors

Ошибки на уровне операционной системы и внутренних состояний, а также общие исключения.

 

Логические ошибки и внутреннее состояние
Код ошибки Ошибка

1

UNSUPPORTED_METHOD

48

NOT_IMPLEMENTED

49

LOGICAL_ERROR

269

INFINITE_LOOP

668

INVALID_STATE
Вызовы операционной системы
Код ошибки Ошибка

114

CANNOT_CLOCK_GETTIME

239/240

CANNOT_MUNMAP/MREMAP

299

CANNOT_FORK

411

PTHREAD_ERROR

425

SYSTEM_ERROR

445

CANNOT_MPROTECT

459

CANNOT_SET_THREAD_PRIORITY
Общие исключения
Код ошибки Ошибка

236

ABORTED

394

QUERY_WAS_CANCELLED

677

THREAD_WAS_CANCELED

1000

POCO_EXCEPTION

1001

STD_EXCEPTION

1002

UNKNOWN_EXCEPTION
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней