{"id":2945,"library":"fabric-analytics-notebook-plugin","title":"FABRIC SDK Notebook Analytics Plugin","description":"This package is identified as a plugin for the FABRIC SDK, specifically designed for use within Microsoft Fabric's online Spark/Python Notebook environments and Spark Job Definitions (SJDs). It appears to be an internal component that enables or integrates analytics capabilities within the broader Fabric platform, rather than a library intended for direct user-level imports and interactions. Microsoft Fabric is an end-to-end data analytics platform offering data engineering, data science, data warehousing, and real-time analytics. The current version is 0.0.3.post4.","status":"active","version":"0.0.3.post4","language":"en","source_language":"en","source_url":"https://pypi.org/project/fabric-analytics-notebook-plugin/","tags":["microsoft-fabric","notebook","analytics","spark","plugin","azure"],"install":[{"cmd":"pip install fabric-analytics-notebook-plugin","lang":"bash","label":"PyPI Installation"},{"cmd":"%pip install fabric-analytics-notebook-plugin","lang":"python","label":"Fabric Notebook (Session-scoped)"}],"dependencies":[{"reason":"Runtime dependency as specified on PyPI.","package":"python","version":"<3.15,>=3.10"}],"imports":[],"quickstart":{"code":"import pyspark.sql.functions as F\n\n# This package is an internal plugin for the Fabric Notebook environment.\n# Direct import of 'fabric_analytics_notebook_plugin' is not typically done by users.\n# Instead, users interact with the Fabric environment and built-in utilities like notebookutils.\n\n# Example of typical analytics operation in a Fabric Python Notebook\n# Read data from a Lakehouse table (replace 'YourLakehouse' and 'YourTable' with actual names)\n# Assume 'spark' object is pre-initialized in Fabric notebooks\n# You might need to attach a Lakehouse to your notebook first.\n\n# Example: Reading a Delta table from the default Lakehouse\ntry:\n    df = spark.read.format(\"delta\").load(\"Files/YourTable\")\n    print(f\"DataFrame schema: {df.schema.simpleString()}\")\n    df.show(5)\n    \n    # Example using built-in Fabric notebook utilities (formerly mssparkutils)\n    # from notebookutils import mssparkutils # Older syntax, still compatible for now\n    from notebookutils import notebook, fs\n\n    # List files in the default Lakehouse's 'Files' section\n    print(\"\\nListing files in 'Files/' directory:\")\n    files = fs.ls(\"Files/\")\n    for file_info in files:\n        print(f\"  - {file_info.name} (size: {file_info.size} bytes)\")\n\nexcept Exception as e:\n    print(f\"Error during quickstart execution: {e}\")\n    print(\"Please ensure you are running this in a Microsoft Fabric Notebook\")\n    print(\"and have a Lakehouse attached with a 'YourTable' Delta table and some files.\")","lang":"python","description":"This quickstart demonstrates common patterns for interacting with data and built-in utilities within a Microsoft Fabric Python Notebook environment, as the `fabric-analytics-notebook-plugin` itself is not designed for direct user-level imports. It shows how to read data using PySpark and how to use the `notebookutils` (formerly `mssparkutils`) package to interact with the file system, which are core operations in Fabric analytics workflows."},"warnings":[{"fix":"Users should focus on using the standard Fabric notebook capabilities, including PySpark, Python libraries, and the built-in `notebookutils` package, rather than attempting to directly import this plugin.","message":"The `fabric-analytics-notebook-plugin` package appears to be an internal Microsoft Fabric component. Direct user-level imports or explicit quickstart guides for this specific package are not available in public documentation. Its role is likely to provide underlying functionality for analytics within the Fabric notebook environment.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Update imports from `from mssparkutils import ...` to `from notebookutils import ...` and adopt `notebookutils` for all new development to ensure future compatibility and access to new features.","message":"The `mssparkutils` package, a common utility in Fabric and Synapse notebooks, has been officially renamed to `notebookutils`. While existing `mssparkutils` code remains backward compatible, the `mssparkutils` namespace will be retired in the future. All new features are exclusively supported under `notebookutils`.","severity":"breaking","affected_versions":"All versions, with future breaking change expected for `mssparkutils` usage."},{"fix":"Regularly save your notebooks. Configure session timeout durations in Workspace settings under 'Data Engineering/Science Spark settings' if you have the necessary permissions. Be aware of capacity limits that might pause your workspace.","message":"Microsoft Fabric notebook sessions can time out due to inactivity or capacity limits, leading to lost work if not saved or if long-running operations are interrupted.","severity":"gotcha","affected_versions":"All versions of Fabric notebooks"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}