更新时间：2026-10-16 GMT+08:00
异常类说明
SDK在调用LakeFormation/OBS等外部服务，或进行内部处理（类型推断、UDF打包）失败时，会抛出对应的异常类。您可以通过异常类别，快速判断是服务问题、存储问题、参数问题还是类型问题。SDK异常均继承自基类AIDatalakeCatalogError。
| 异常类 | 说明 | 关键属性 |
|---|---|---|
| AIDatalakeCatalogError | 所有SDK异常的基类。 | - |
| LakeFormationAPIError | LakeFormation REST API调用失败。 | status_code、function_name |
| OBSOperationError | OBS上传/删除操作失败。 | obs_uri |
| TypeMappingError | Python/LakeFormation/Aura/Arrow类型无法映射。 | - |
| FunctionNotFoundError | LakeFormation中未找到指定函数。 | function_name、database |
| FunctionAlreadyExistsError | LakeFormation中已存在同名函数。 | function_name、database |
| SignatureInferenceError | 从可调用对象推断签名失败。 | callable_name |
| UDFPackagingError | UDF打包（生成zip）失败。 | - |
参数校验类错误（如函数名非法、资源参数越界等）直接以ValueError抛出，不归属上述SDK异常层级。
父主题： Catalog SDK
