{"id":5127,"library":"azureml-dataprep-native","title":"AzureML DataPrep Native Extensions","description":"This package provides the underlying native extensions for Azure Machine Learning's Data Preparation capabilities. It is typically consumed as a dependency by higher-level AzureML SDK components like `azureml-dataprep` or `azureml.core`, rather than being directly imported by end-users. The current version is 42.1.0, and its release cadence is tied to the broader AzureML SDK.","status":"active","version":"42.1.0","language":"en","source_language":"en","source_url":"https://github.com/Azure/azure-sdk-for-python","tags":["azure","machine-learning","dataprep","native","sdk","internal-dependency"],"install":[{"cmd":"pip install azureml-dataprep-native","lang":"bash","label":"Install core native extensions"}],"dependencies":[],"imports":[{"note":"This package provides native extensions and is not intended for direct Python-level imports by end-users. Attempting to directly import symbols from `azureml-dataprep-native` is not a typical or supported workflow.","symbol":"NoDirectUserImports","correct":"Functionality is exposed via azureml.dataprep or azureml.core.Dataset"}],"quickstart":{"code":"# Install azureml-dataprep-native to make its native components available.\n# Users typically interact with the higher-level azureml.dataprep or\n# azureml.core.Dataset APIs, which leverage this package internally.\n# No direct user-facing imports are typically made from azureml-dataprep-native.\n# To use data prep functionality, install azureml-dataprep:\n# pip install azureml-dataprep\n\n# Example of how functionality (implicitly powered by this library) is accessed:\nimport pandas as pd\nfrom azureml.dataprep import read_csv, Dataflow\nimport os\n\n# Create a dummy CSV file\ncsv_content = \"id,name\\n1,Alice\\n2,Bob\\n3,Charlie\"\nwith open(\"sample.csv\", \"w\") as f:\n    f.write(csv_content)\n\n# Read data using azureml.dataprep (which uses azureml-dataprep-native internally)\n# This code will only run if azureml-dataprep is also installed.\n# To run this code, ensure you have: pip install azureml-dataprep\ntry:\n    dataflow: Dataflow = read_csv(\"sample.csv\")\n    print(\"Dataflow created successfully (backed by azureml-dataprep-native).\")\n    # Further operations would typically follow, e.g., dataflow.to_pandas_dataframe()\n    # For demonstration, let's just show the schema\n    print(dataflow.get_profile().schema_summary)\nexcept ImportError:\n    print(\"azureml-dataprep not installed. Please install it to use data prep features:\")\n    print(\"pip install azureml-dataprep\")\nexcept Exception as e:\n    print(f\"An error occurred during data prep operation: {e}\")\nfinally:\n    # Clean up the dummy file\n    if os.path.exists(\"sample.csv\"):\n        os.remove(\"sample.csv\")\n\nprint(\"\\nazureml-dataprep-native is primarily an underlying dependency.\")\n","lang":"python","description":"Demonstrates that `azureml-dataprep-native` is an underlying dependency for `azureml-dataprep`. The quickstart shows how to use `azureml-dataprep` to perform a basic data read operation, implicitly leveraging the native extensions provided by this package. Users typically do not directly import or interact with `azureml-dataprep-native`."},"warnings":[{"fix":"Always interact with AzureML Data Prep features via `azureml.dataprep` or `azureml.core.Dataset`. Do not attempt direct imports from `azureml-dataprep-native`.","message":"This package is a native extension component and is not designed for direct user-level Python imports. Functionality it provides is exposed through higher-level SDK packages like `azureml-dataprep` or `azureml.core.Dataset`.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Refer to the official AzureML SDK documentation for supported operating systems and Python versions. Ensure your environment meets these prerequisites before installing.","message":"Due to its native components (C++/Rust), `azureml-dataprep-native` has specific platform (OS) and Python version requirements. Installation may fail or lead to runtime issues on unsupported environments.","severity":"breaking","affected_versions":"All versions"},{"fix":"Install `pip install azureml-dataprep` (or `pip install azureml-sdk[data]`) to get the full Data Prep experience. `azureml-dataprep-native` will be installed as a dependency.","message":"Installing `azureml-dataprep-native` alone does not provide a complete data preparation solution. It must be used in conjunction with `azureml-dataprep` or other AzureML SDK components to access user-facing APIs.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-13T00:00:00.000Z","next_check":"2026-07-12T00:00:00.000Z"}