Skip to content

Commit b539f41

Browse files
authored
Merge pull request #112591 from nibaccam/patch-4
Move pip install
2 parents 97dd46d + 7f01000 commit b539f41

File tree

1 file changed

+17
-14
lines changed

1 file changed

+17
-14
lines changed

articles/machine-learning/resource-known-issues.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,23 @@ Learn about the [resource quotas](how-to-manage-quotas.md) you might encounter w
3535

3636
## Installation and import
3737

38+
* **Pip Installation: Dependencies are not guaranteed to be consistent with single line installation**:
39+
40+
This is a known limitation of pip, as it does not have a functioning dependency resolver when you install as a single line. The first unique dependency is the only one it looks at.
41+
42+
In the following code `azure-ml-datadrift` and `azureml-train-automl` are both installed using a single line pip install.
43+
```
44+
pip install azure-ml-datadrift, azureml-train-automl
45+
```
46+
For this example, let's say `azure-ml-datadrift` requires version > 1.0 and `azureml-train-automl` requires version < 1.2. If the latest version of `azure-ml-datadrift` is 1.3, then both packages get upgraded to 1.3, regardless of the `azureml-train-automl` package requirement for an older version.
47+
48+
To ensure the appropriate versions are installed for your packages, install using multiple lines like in the following code. Order isn't an issue here, since pip explicitly downgrades as part of the next line call. And so, the appropriate version dependencies are applied.
49+
50+
```
51+
pip install azure-ml-datadrift
52+
pip install azureml-train-automl
53+
```
54+
3855
* **Error message: Cannot uninstall 'PyYAML'**
3956
4057
Azure Machine Learning SDK for Python: PyYAML is a `distutils` installed project. Therefore, we cannot accurately determine which files belong to it if there is a partial uninstall. To continue installing the SDK while ignoring this error, use:
@@ -78,20 +95,6 @@ Learn about the [resource quotas](how-to-manage-quotas.md) you might encounter w
7895
* Add `azureml-dataprep` version 1.1.8 or above.
7996
* Add `pyarrow` version 0.11 or above.
8097
81-
* **Pip Installation: Dependecies are not guaranteed to be consistent with single line installation**: This is a known limitation of pip as it does not have a functioning dependency resolver when you install as a single line. The first unique dependency is the only one it looks at. For example, if you are installing azure-ml-datadrift which requires version > 1.0 and azureml-train-automl which requires version < 1.2 and if the latest version is 1.3, when the user installs the packages in a single line as shown below, everything gets upgraded to 1.3 even though the azureml-train-automl package requires an older version.
82-
83-
* You will see inconsistent dependecies with single line installation.
84-
```python
85-
pip install azure-ml-datadrift, azureml-train-automl
86-
```
87-
88-
* To ensure the appropriate versions are installed for your packages, install using multiple lines like in the following code. Order doesn't matter here.
89-
90-
```python
91-
pip install azure-ml-datadrift
92-
pip install azureml-train-automl
93-
```
94-
9598
## Create and manage workspaces
9699
97100
> [!WARNING]

0 commit comments

Comments
 (0)