{"record":{"id":"393bea98191dbcb4","repo":"mlflow/mlflow","slug":"invalid-parameter-value-393bea","errorCode":"INVALID_PARAMETER_VALUE","errorMessage":"The installed databricks-sdk version does not support uploading files larger than 5GB. Please upgrade the databricks-sdk package to version >= 0.45.0.","messagePattern":"The installed databricks-sdk version does not support uploading files larger than 5GB\\. Please upgrade the databricks-sdk package to version >= 0\\.45\\.0\\.","errorType":"error_code","errorClass":"MlflowException","httpStatus":null,"severity":"error","filePath":"mlflow/store/artifact/databricks_sdk_artifact_repo.py","lineNumber":82,"sourceCode":"    def files_api(self) -> \"FilesAPI\":\n        return self.wc.files\n\n    def _is_dir(self, path: str) -> bool:\n        from databricks.sdk.errors.platform import NotFound\n\n        try:\n            self.files_api.get_directory_metadata(path)\n        except NotFound:\n            return False\n        return True\n\n    def full_path(self, artifact_path: str | None) -> str:\n        return f\"{self.artifact_uri}/{artifact_path}\" if artifact_path else self.artifact_uri\n\n    def log_artifact(self, local_file: str, artifact_path: str | None = None) -> None:\n        is_large_file = Path(local_file).stat().st_size > 5 * (1024**3)\n        if is_large_file and not self._supports_large_file_uploads:\n            raise MlflowException.invalid_parameter_value(\n                \"The installed databricks-sdk version does not support uploading files larger \"\n                \"than 5GB. Please upgrade the databricks-sdk package to version >= 0.45.0.\"\n            )\n\n        with open(local_file, \"rb\") as f:\n            name = Path(local_file).name\n            self.files_api.upload(\n                self.full_path(posixpath.join(artifact_path, name) if artifact_path else name),\n                f,\n                overwrite=True,\n            )\n\n    def log_artifacts(self, local_dir: str, artifact_path: str | None = None) -> None:\n        local_dir = Path(local_dir).resolve()\n        futures: list[Future[None]] = []\n        with self._create_thread_pool() as executor:\n            for f in local_dir.rglob(\"*\"):\n                if not f.is_file():","sourceCodeStart":64,"sourceCodeEnd":100,"githubUrl":"https://github.com/mlflow/mlflow/blob/6a27f2decc0b76eb1b54af31849784addb357dbc/mlflow/store/artifact/databricks_sdk_artifact_repo.py#L64-L100","documentation":"DatabricksSdkArtifactRepo.log_artifact rejects files larger than 5GB when the installed databricks-sdk lacks large-file upload support (Workspace file upload APIs for >5GB arrived in databricks-sdk 0.45.0). The repository checks file size up front and raises INVALID_PARAMETER_VALUE to avoid a doomed upload.","triggerScenarios":"log_artifact(local_file) where Path(local_file).stat().st_size > 5*1024**3 and self._supports_large_file_uploads is False (databricks-sdk < 0.45.0 installed).","commonSituations":"Old databricks-sdk pinned in requirements while logging large model checkpoints (multi-GB weights, datasets); environments where uv/pip resolved an older SDK due to constraints; Docker images with stale SDK versions.","solutions":["Upgrade databricks-sdk to >= 0.45.0 (pip install -U 'databricks-sdk>=0.45.0').","If the SDK cannot be upgraded, split or compress the file so it is under 5GB, or store large files in DBFS/Volumes or object storage (S3/ADLS) and log a reference.","Check installed version with databricks.sdk version metadata before large uploads and fail fast with a clear message."],"exampleFix":"// before (requirements.txt)\ndatabricks-sdk==0.30.0\n\n// after\ndatabricks-sdk>=0.45.0","handlingStrategy":"validation","validationCode":"import importlib.metadata\nfrom pathlib import Path\nsdk_version = tuple(int(x) for x in importlib.metadata.version(\"databricks-sdk\").split(\".\")[:2])\nassert Path(local_file).stat().st_size <= 5 * 1024**3 or sdk_version >= (0, 45), \"upgrade databricks-sdk>=0.45.0\"","typeGuard":"def supports_large_uploads(size_bytes: int, sdk_version: tuple[int, int]) -> bool:\n    return size_bytes <= 5 * 1024**3 or sdk_version >= (0, 45)","tryCatchPattern":"try:\n    repo.log_artifact(large_file)\nexcept MlflowException as e:\n    if e.error_code == \"INVALID_PARAMETER_VALUE\" and \"5GB\" in str(e):\n        log_to_object_storage_and_reference(large_file)  # e.g. DBFS/Volumes or S3 + log URI","preventionTips":["Pin databricks-sdk>=0.45.0 in requirements/CI images.","Pre-check file sizes before uploads to Databricks-backed repos.","Keep 7-day package cooldown in mind but don't pin old SDKs indefinitely."],"tags":["databricks","artifacts","file-size-limit","dependency-version"],"backgroundTag":"sdk-version-too-old","analyzedSha":"6a27f2decc0b76eb1b54af31849784addb357dbc","analyzedAt":"2026-08-29T20:54:51.419Z","schemaVersion":2},"datasetVersion":"2026-08-29T22:17:34.462Z"}