{"record":{"id":"368208b073e7c979","repo":"pola-rs/polars","slug":"failed-to-load-catalog-for-fn-name-error","errorCode":null,"errorMessage":"failed to load catalog for {fn_name}() ({error = }). Configure the default PyIceberg catalog, or pass a catalog via the 'catalog' parameter, or pass a PyIceberg table object instead of the name.{static_metadata_hint}","messagePattern":"failed to load catalog for (.+?)\\(\\) \\((.+?)\\)\\. Configure the default PyIceberg catalog, or pass a catalog via the 'catalog' parameter, or pass a PyIceberg table object instead of the name\\.(.+?)","errorType":"exception","errorClass":"ComputeError","httpStatus":null,"severity":"error","filePath":"py-polars/src/polars/io/iceberg/_dataset.py","lineNumber":191,"sourceCode":"            except Exception as error:\n                static_metadata_hint = (\n                    (\n                        \" \"\n                        \"If you intended to pass a static metadata path, \"\n                        \"ensure it is an absolute path.\"\n                    )\n                    if fn_name == \"scan_iceberg\"\n                    else \"\"\n                )\n\n                msg = (\n                    f\"failed to load catalog for {fn_name}() ({error = }). \"\n                    \"Configure the default PyIceberg catalog, or pass \"\n                    \"a catalog via the 'catalog' parameter, or pass a PyIceberg \"\n                    \"table object instead of the name.\"\n                    f\"{static_metadata_hint}\"\n                )\n                raise ComputeError(msg) from error\n\n            catalog_config = IcebergCatalogConfig.from_catalog(default_catalog)\n\n        if catalog_config.class_ == NoopCatalog:\n            msg = f\"cannot use NoopCatalog with {fn_name}()\"\n            raise TypeError(msg)\n\n        return catalog_config\n\n\n@dataclass(kw_only=True)\nclass IcebergScanResolver:\n    \"\"\"\n    Iceberg scan resolver.\n\n    Defers scan resolution to run during IR resolution.\n    \"\"\"\n","sourceCodeStart":173,"sourceCodeEnd":209,"githubUrl":"https://github.com/pola-rs/polars/blob/df599052daf96e7a9cc30a3b0c6bd25d6947e3c0/py-polars/src/polars/io/iceberg/_dataset.py#L173-L209","documentation":"Error \"failed to load catalog for {fn_name}() ({error = }). Configure the default PyIceberg catalog, or pass a catalog via the 'catalog' parameter, or pass a PyIceberg table object instead of the name.{static_metadata_hint}\" thrown in pola-rs/polars.","triggerScenarios":"Thrown at py-polars/src/polars/io/iceberg/_dataset.py:191 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"df599052daf96e7a9cc30a3b0c6bd25d6947e3c0","analyzedAt":"2026-08-16T12:10:03.978Z","schemaVersion":2},"datasetVersion":"2026-08-16T13:17:31.715Z"}