Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Throw Exception When Invalid URI with Databricks Scheme Provided #4877

Merged
merged 9 commits into from
Oct 12, 2021

Conversation

yunpark93
Copy link
Collaborator

@yunpark93 yunpark93 commented Oct 7, 2021

Signed-off-by: Yun Park yun@databricks.com

What changes are proposed in this pull request?

When a user uses a single slash in the URI when referencing the registry URI in Databricks, e.g. databricks:/profile:prefix, it incorrectly references the local registry. The user most likely intended to not use the local registry but the registry provided with a correctly formatted URI.

Screen Shot 2021-10-07 at 1 57 44 PM

How is this patch tested?

(Details)

Release Notes

Is this a user-facing change?

  • No. You can skip the rest of this section.
  • Yes. Give a description of this change to be included in the release notes for MLflow users.

Tracking and registry URIs provided to the client that reference a Databricks endpoint (useing the databricks URI scheme) must be correctly formatted using 2 slashes after the colon instead of 1. Previously, if URIs such as databricks://, databricks:/, databricks:/default or databricks:/scope:prefix were provided, they defaulted to the local profile (in Databricks, this would be the default tracking server or registry in the workspace). This will no longer be the case, and you will instead get an error about an incorrectly formatted URI.

What component(s), interfaces, languages, and integrations does this PR affect?

Components

  • area/artifacts: Artifact stores and artifact logging
  • area/build: Build and test infrastructure for MLflow
  • area/docs: MLflow documentation pages
  • area/examples: Example code
  • area/model-registry: Model Registry service, APIs, and the fluent client calls for Model Registry
  • area/models: MLmodel format, model serialization/deserialization, flavors
  • area/projects: MLproject format, project running backends
  • area/scoring: MLflow Model server, model deployment tools, Spark UDFs
  • [] area/server-infra: MLflow Tracking server backend
  • area/tracking: Tracking Service, tracking client APIs, autologging

Interface

  • area/uiux: Front-end, user experience, plotting, JavaScript, JavaScript dev server
  • area/docker: Docker use across MLflow's components, such as MLflow Projects and MLflow Models
  • area/sqlalchemy: Use of SQLAlchemy in the Tracking Service or Model Registry
  • area/windows: Windows support

Language

  • language/r: R APIs and clients
  • language/java: Java APIs and clients
  • language/new: Proposals for new client languages

Integrations

  • integrations/azure: Azure and Azure ML integrations
  • integrations/sagemaker: SageMaker integrations
  • integrations/databricks: Databricks integrations

How should the PR be classified in the release notes? Choose one:

  • rn/breaking-change - The PR will be mentioned in the "Breaking Changes" section
  • rn/none - No description will be included. The PR will be mentioned only by the PR number in the "Small Bugfixes and Documentation Updates" section
  • rn/feature - A new user-facing feature worth mentioning in the release notes
  • rn/bug-fix - A user-facing bug fix worth mentioning in the release notes
  • rn/documentation - A user-facing documentation change worth mentioning in the release notes

Signed-off-by: Yun Park <yun@databricks.com>
@github-actions github-actions bot added area/model-registry Model registry, model registry APIs, and the fluent client calls for model registry area/tracking Tracking service, tracking client APIs, autologging labels Oct 7, 2021
@github-actions github-actions bot added the rn/bug-fix Mention under Bug Fixes in Changelogs. label Oct 7, 2021
Signed-off-by: Yun Park <yun@databricks.com>
Copy link
Collaborator

@ankit-db ankit-db left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One small unit test I'd recommend adding

tests/utils/test_uri.py Show resolved Hide resolved
Signed-off-by: Yun Park <yun@databricks.com>
Signed-off-by: Yun Park <yun@databricks.com>
Signed-off-by: Yun Park <yun@databricks.com>
Signed-off-by: Yun Park <yun@databricks.com>
Signed-off-by: Yun Park <yun@databricks.com>
Signed-off-by: Yun Park <yun@databricks.com>
@@ -48,7 +48,6 @@ def test_extract_db_type_from_uri():
("nondatabricks://profile:prefix", (None, None)),
("databricks://profile", ("profile", None)),
("databricks://profile/", ("profile", None)),
("databricks://", ("", None)),
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ankit-db @sueann - Btw, there seems to be some tests that indicate this should work. Are these just tests that actually should not work (this is an unsupported case right)?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we were technically allowing this case to be ~= "databricks", because of the bug/loophole that was the source of the problem this PR is fixing (we just default to the default profile if there is no netloc).

@github-actions github-actions bot added area/artifacts Artifact stores and artifact logging rn/breaking-change Mention under Breaking Changes in Changelogs. labels Oct 12, 2021
Copy link
Contributor

@sueann sueann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we add in the release notes which cases used to work (sort of as intended) but will now be given an error instead? I think databricks:/ databricks:// and databricks:/default (or databricks:/databricks ??) might be those? (should confirm the last two though)

@@ -68,6 +68,9 @@ def get_db_info_from_uri(uri):
"""
parsed_uri = urllib.parse.urlparse(uri)
if parsed_uri.scheme == "databricks":
# netloc should not be an empty string unless URI is formatted incorrectly.
if parsed_uri.netloc == "":
raise MlflowException("URI is formatted incorrectly: no netloc in URI '%s'." % uri)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggest that it may be because they only have one slash?

@@ -48,7 +48,6 @@ def test_extract_db_type_from_uri():
("nondatabricks://profile:prefix", (None, None)),
("databricks://profile", ("profile", None)),
("databricks://profile/", ("profile", None)),
("databricks://", ("", None)),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we were technically allowing this case to be ~= "databricks", because of the bug/loophole that was the source of the problem this PR is fixing (we just default to the default profile if there is no netloc).

Signed-off-by: Yun Park <yun@databricks.com>
@yunpark93
Copy link
Collaborator Author

@sueann - Addressed your comments!

@yunpark93 yunpark93 merged commit 73c7b79 into mlflow:master Oct 12, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/artifacts Artifact stores and artifact logging area/model-registry Model registry, model registry APIs, and the fluent client calls for model registry area/tracking Tracking service, tracking client APIs, autologging rn/breaking-change Mention under Breaking Changes in Changelogs. rn/bug-fix Mention under Bug Fixes in Changelogs.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants