{"record":{"id":"461a217115ae0b64","repo":"pola-rs/polars","slug":"table-name-appears-to-be-invalid-name","errorCode":null,"errorMessage":"`table_name` appears to be invalid: '{name}'","messagePattern":"`table_name` appears to be invalid: '(.+?)'","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"py-polars/src/polars/dataframe/frame.py","lineNumber":4489,"sourceCode":"            msg = f\"write_database `if_table_exists` must be one of {{{allowed}}}, got {if_table_exists!r}\"\n            raise ValueError(msg)\n\n        connection_module_root = type(connection).__module__.split(\".\", 1)[0]\n\n        if engine is None:\n            if isinstance(connection, str) or connection_module_root == \"sqlalchemy\":\n                engine = \"sqlalchemy\"\n            elif connection_module_root.startswith(\"adbc\"):\n                engine = \"adbc\"\n\n        def unpack_table_name(name: str) -> tuple[str | None, str | None, str]:\n            \"\"\"Unpack optionally qualified table name to catalog/schema/table tuple.\"\"\"\n            from csv import reader as delimited_read\n\n            components: list[str | None] = next(delimited_read([name], delimiter=\".\"))  # type: ignore[arg-type]\n            if len(components) > 3:\n                msg = f\"`table_name` appears to be invalid: '{name}'\"\n                raise ValueError(msg)\n            catalog, schema, tbl = ([None] * (3 - len(components))) + components\n            return catalog, schema, tbl  # type: ignore[return-value]\n\n        if engine == \"adbc\":\n            from polars.io.database._utils import (\n                _get_adbc_module_name_from_uri,\n                _import_optional_adbc_driver,\n                _is_adbc_snowflake_conn,\n                _open_adbc_connection,\n            )\n\n            conn, can_close_conn = (\n                (_open_adbc_connection(connection), True)\n                if isinstance(connection, str)\n                else (connection, False)\n            )\n\n            driver_manager = import_optional(\"adbc_driver_manager\")","sourceCodeStart":4471,"sourceCodeEnd":4507,"githubUrl":"https://github.com/pola-rs/polars/blob/df599052daf96e7a9cc30a3b0c6bd25d6947e3c0/py-polars/src/polars/dataframe/frame.py#L4471-L4507","documentation":"Error \"`table_name` appears to be invalid: '{name}'\" thrown in pola-rs/polars.","triggerScenarios":"Thrown at py-polars/src/polars/dataframe/frame.py:4489 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"}