Zpracování chyb ingestování nubusem

Tato stránka popisuje kódy chyb vrácené rozhraním API Ingestu Zerobus a způsob, jakým je mají klienti zpracovávat. Tento odkaz použijte při diagnostice neúspěšných požadavků nebo implementaci logiky zpracování chyb v integraci.

Formát odpovědi na chybu

Mezi chybové odpovědi patří strojově čitelný kód chyby a zpráva čitelná pro člověka doručovaná ve formátu vhodném pro váš protokol.

REST (JSON)

Chybové odpovědi se vrátí jako JSON s odpovídajícím stavovým kódem HTTP:

{
  "error_code": "NOT_FOUND",
  "message": "Table \"catalog.schema.table\" cannot be found."
}

Pole	Type	Description
kód_chyby	řetězec	Strojově čitelný kód chyby identifikující kategorii selhání. Tento postup slouží k určení způsobu zpracování chyby prostřednictvím kódu programu.
zpráva	řetězec	Popis chyby čitelný člověkem. Může obsahovat další diagnostické informace pro řešení potíží. Toto pole neanalyšujte programově – jeho formát se může bez předchozího upozornění změnit.

gRPC

Chybové odpovědi používají standardní stavové kódy gRPC doručené prostřednictvím přívěsů odpovědí:

Ukázka	Description
grpc-status	Číselný stavový kód (např 3 . pro INVALID_ARGUMENT). Tento postup slouží k určení způsobu zpracování chyby prostřednictvím kódu programu.
grpc-message	Popis chyby čitelný člověkem. Může obsahovat další diagnostické informace pro řešení potíží. Toto pole neanalyšujte programově – jeho formát se může bez předchozího upozornění změnit.

Kódy chyb

Následující části popisují kódy chyb vrácené rozhraním API Ingestu Zerobus, odpovídající kódy na úrovni protokolu a doporučené chování klienta.

Chyby klienta

Tyto chyby značí problém s požadavkem. Nepokusujte to znovu beze změny požadavku.

Kód chyby (REST)	Kód gRPC	Stav PROTOKOLU HTTP	Description	Doporučená akce
INVALID_PARAMETER_VALUE	INVALID_ARGUMENT(3)	400	Požadavek obsahuje neplatný nebo poškozený vstup, například chybějící povinné pole, neplatné schéma nebo nepodporovaný formát záznamu.	Opravte požadavek a znovu odešlete. message Zkontrolujte v poli podrobnosti o tom, který parametr je neplatný.
NOT_FOUND	NOT_FOUND(5)	404	Požadovaný prostředek neexistuje. Zadaná tabulka se například nenašla.	Ověřte, že je název prostředku správný a že existuje.
NOT_IMPLEMENTED	UNIMPLEMENTED(12)	501	Požadovaná operace není podporována. Tabulka například používá nepodporovanou funkci nebo formát dat.	Neopakujte. message V poli vyhledejte podrobnosti o nepodporovaném souboru.

Chyby ověřování a autorizace

Tyto chyby značí problémy s identitou nebo oprávněními volajícího. Nepokoušejte se znovu se stejnými přihlašovacími údaji.

Kód chyby (REST)	Kód gRPC	Stav PROTOKOLU HTTP	Description	Doporučená akce
UNAUTHENTICATED	UNAUTHENTICATED(16)	401	Požadavek nemá platné ověřovací přihlašovací údaje. Token může chybět, prázdný, vypršela jeho platnost nebo je neplatný.	Aktualizujte nebo zadejte platný ověřovací token a zkuste to znovu.
PERMISSION_DENIED	PERMISSION_DENIED(7)	403	Volající nemá dostatečná oprávnění k provedení požadované operace u zadaného prostředku.	Ověřte, že volající má požadovaná oprávnění (např MODIFY. , SELECT, USE_CATALOG, USE_SCHEMA) pro cílový prostředek.

Chyby serveru

Tyto chyby značí problém na straně serveru. Opakujte pokus s exponenciálním zpožděním a výkyvy.

Kód chyby (REST)	Kód gRPC	Stav PROTOKOLU HTTP	Description	Doporučená akce
UNAVAILABLE	UNAVAILABLE(14)	503	Služba dočasně nemůže zpracovat požadavek. Obvykle se jedná o přechodný stav.	Opakujte pokus s exponenciálním zpožděním a výkyvy.
RESOURCE_EXHAUSTED	RESOURCE_EXHAUSTED(8)	429	Služba odmítá požadavky kvůli limitům prostředků.	Pokud je to možné, snižte souběžnost požadavků. Opakujte pokus s exponenciálním zpožděním a výkyvy.
INTERNAL_ERROR	INTERNAL(13)	500	Došlo k neočekávané vnitřní chybě.	Neopakujte. Obraťte se na technickou podporu a poskytněte úplnou zprávu o chybě pro diagnostiku.