{"record":{"id":"da3b8a6897715bd7","repo":"mlflow/mlflow","slug":"creating-trace-location-is-not-supported-on-this-b","errorCode":null,"errorMessage":"Creating trace location is not supported on this backend.","messagePattern":"Creating trace location is not supported on this backend\\.","errorType":"exception","errorClass":"MlflowException","httpStatus":null,"severity":"error","filePath":"mlflow/tracing/client.py","lineNumber":855,"sourceCode":"                sql_warehouse_id=sql_warehouse_id,\n            )\n        raise MlflowException(\n            \"Setting storage location is not supported on non-Databricks backends.\"\n        )\n\n    def _get_trace_location(self, telemetry_profile_id: str) -> UnityCatalog:\n        if is_databricks_uri(self.tracking_uri) and hasattr(self.store, \"get_trace_location\"):\n            return self.store.get_trace_location(telemetry_profile_id)\n        raise MlflowException(\"Getting trace location by ID is not supported on this backend.\")\n\n    def _create_or_get_trace_location(\n        self, location: UnityCatalog, sql_warehouse_id: str | None = None\n    ) -> UnityCatalog:\n        if is_databricks_uri(self.tracking_uri) and hasattr(\n            self.store, \"create_or_get_trace_location\"\n        ):\n            return self.store.create_or_get_trace_location(location, sql_warehouse_id)\n        raise MlflowException(\"Creating trace location is not supported on this backend.\")\n\n    def _link_trace_location(self, experiment_id: str, location: UnityCatalog) -> None:\n        if is_databricks_uri(self.tracking_uri) and hasattr(self.store, \"link_trace_location\"):\n            self.store.link_trace_location(experiment_id, location)\n            return\n        raise MlflowException(\"Linking trace location is not supported on this backend.\")\n\n    def _unset_experiment_trace_location(\n        self, experiment_id: str, location: UCSchemaLocation | UnityCatalog\n    ) -> None:\n        if is_databricks_uri(self.tracking_uri):\n            self.store.unset_experiment_trace_location(str(experiment_id), location)\n        else:\n            raise MlflowException(\n                \"Clearing storage location is not supported on non-Databricks backends.\"\n            )\n\n    def _create_issue(","sourceCodeStart":837,"sourceCodeEnd":873,"githubUrl":"https://github.com/mlflow/mlflow/blob/6a27f2decc0b76eb1b54af31849784addb357dbc/mlflow/tracing/client.py#L837-L873","documentation":"_create_or_get_trace_location requires a Databricks tracking URI and a store implementing create_or_get_trace_location (Unity Catalog location creation). Otherwise the client raises this MlflowException instead of attempting the call.","triggerScenarios":"Calling _resolve_experiment_to_trace_location (which invokes _create_or_get_trace_location) while the tracking URI is local/SQL/non-Databricks, or the store lacks the method.","commonSituations":"Configuring UC trace destinations in an environment not authenticated/pointed at Databricks; older server versions without the API.","solutions":["Set the tracking URI to Databricks before resolving trace locations.","Upgrade the MLflow server so the Databricks store supports create_or_get_trace_location.","Skip UC trace-location resolution when running on non-Databricks backends."],"exampleFix":"null","handlingStrategy":"validation","validationCode":"import mlflow\nfrom mlflow.tracking._tracking_service.utils import is_databricks_uri\nif not is_databricks_uri(mlflow.get_tracking_uri()):\n    raise RuntimeError(\"create_or_get_trace_location requires Databricks\")","typeGuard":null,"tryCatchPattern":"try:\n    loc = client._create_or_get_trace_location(location, sql_warehouse_id)\nexcept MlflowException as e:\n    log.error(\"UC trace location creation unsupported: %s\", e)\n    raise","preventionTips":["Point the tracking URI at Databricks before UC location operations","Upgrade the tracking server if the store lacks the method","Skip UC location resolution on non-Databricks deployments"],"tags":["mlflow","tracing","databricks","unity-catalog","unsupported-operation"],"backgroundTag":"backend-not-supported","analyzedSha":"6a27f2decc0b76eb1b54af31849784addb357dbc","analyzedAt":"2026-08-29T20:54:51.419Z","schemaVersion":2},"datasetVersion":"2026-08-29T22:17:34.462Z"}