diff --git a/docs/data-engineering/media/spark-arcgis-geoanalytics/enable-arcgis-capacity.png b/docs/data-engineering/media/spark-arcgis-geoanalytics/enable-arcgis-capacity.png new file mode 100644 index 0000000000..1cacf7143c Binary files /dev/null and b/docs/data-engineering/media/spark-arcgis-geoanalytics/enable-arcgis-capacity.png differ diff --git a/docs/data-engineering/media/spark-arcgis-geoanalytics/enable-arcgis-tenant.png b/docs/data-engineering/media/spark-arcgis-geoanalytics/enable-arcgis-tenant.png new file mode 100644 index 0000000000..36a0748898 Binary files /dev/null and b/docs/data-engineering/media/spark-arcgis-geoanalytics/enable-arcgis-tenant.png differ diff --git a/docs/data-engineering/spark-arcgis-geoanalytics.md b/docs/data-engineering/spark-arcgis-geoanalytics.md index 55747a1adf..98d2d9bd30 100644 --- a/docs/data-engineering/spark-arcgis-geoanalytics.md +++ b/docs/data-engineering/spark-arcgis-geoanalytics.md @@ -1,53 +1,42 @@ --- -title: ArcGIS GeoAnalytics for Microsoft Fabric (Public Preview) +title: ArcGIS GeoAnalytics for Microsoft Fabric (Generally Available) description: Learn how to use the ArcGIS GeoAnalytics library in Microsoft Fabric, including data import, enrichment, visualization, and support resources. ms.reviewer: sngun -ms.author: eur -author: eric-urban +ms.author: arali +author: ms-arali ms.topic: concept-article -ms.date: 11/19/2024 +ms.date: 10/31/2025 #customer intent: As a data scientist or Spark developer, I want to use ArcGIS GeoAnalytics in Microsoft Fabric to perform spatial data transformation and analysis. --- -# ArcGIS GeoAnalytics for Microsoft Fabric (Public preview) +# ArcGIS GeoAnalytics for Microsoft Fabric (Generally Available) -Microsoft and [Esri](https://www.esri.com/) have partnered to integrate spatial analytics into Microsoft Fabric. A new ArcGIS GeoAnalytics library is available in Fabric. This library enables spatial analytics in Spark notebooks and Spark Job Definitions for Data Engineering and Data Science. This integration allows Spark developers and data scientists to use Esri's ArcGIS GeoAnalytics functions and tools within Fabric Spark for spatial data transformation and analysis. You don't need any separate installation to use this capability. +Microsoft and [Esri](https://www.esri.com/) have partnered to integrate spatial analytics into Microsoft Fabric. The ArcGIS GeoAnalytics library is available in Fabric. This library enables spatial analytics in Spark notebooks and Spark Job Definitions for Data Engineering and Data Science workloads. This integration allows Spark developers and data scientists to use Esri's ArcGIS GeoAnalytics functions and tools within Fabric Spark for spatial data transformation and analysis. You don't need any separate installation to use these capabilities. ## Enable ArcGIS GeoAnalytics -Tenant administrators can enable or disable the ArcGIS GeoAnalytics library in the Fabric Runtime for all users. To do so, sign in to the Fabric portal and navigate to **Settings** > **Admin Portal**. In the **Tenant settings**, enable **ArcGIS GeoAnalytics in Fabric Runtime (preview)**. When disabled, it won't be available in Spark notebooks or Spark job definitions. +Tenant administrators can enable or disable the ArcGIS GeoAnalytics library in the Fabric Runtime for all users. To do so, sign in to the Fabric portal and navigate to **Settings** > **Admin Portal**. In the **Tenant settings**, enable **ArcGIS GeoAnalytics for Fabric Runtime**. When disabled, it won't be available in Spark notebooks or Spark job definitions. -:::image type="content" source="media\spark-arcgis-geoanalytics\enable-arcgis.png" alt-text="Screenshot showing how to enable ArcGIS geo analytics from tenant settings." lightbox="media/spark-arcgis-geoanalytics/enable-arcgis.png"::: +:::image type="content" source="media\spark-arcgis-geoanalytics\enable-arcgis-tenant.png" alt-text="Screenshot showing how to enable ArcGIS GeoAnalytics from Tenant settings." lightbox="media/spark-arcgis-geoanalytics/enable-arcgis-tenant.png"::: + +Additionally, if you are a Capacity administrator you can enable or disable the ArcGIS GeoAnalytics library in the Fabric Runtime for all users using your specific capacity. By default, capacity level settings are inherited from tenant level settings however you as a capacity administrator can choose to override it at the capacity level by navigating to **Settings** > **Admin Portal** > **Capacity settings** and choose your capacity. Next, under **Delegated tenant settings** > **Integration settings**, you can override and enable or disable **ArcGIS GeoAnalytics for Fabric Runtime**. + +:::image type="content" source="media\spark-arcgis-geoanalytics\enable-arcgis-capacity.png" alt-text="Screenshot showing how to enable ArcGIS GeoAnalytics from Capacity settings." lightbox="media/spark-arcgis-geoanalytics/enable-arcgis-capacity.png"::: ## Licensing and cost -ArcGIS GeoAnalytics for Microsoft Fabric is free to use during the public preview, with no license required. +ArcGIS GeoAnalytics for Microsoft Fabric is a proprietary technology from Esri. Though this library has been natively integrated into Microsoft Fabric Spark to reduce the friction in onboarding, you need to bring your own license to use these capabilities within Microsoft Fabric. You can learn more about licensing and cost from [Marketplace offering](https://go.esri.com/arcgis-geoanalytics-for-fabric-marketplace) page. > [!NOTE] -> ArcGIS is a non-Microsoft product, and you understand and agree that use of ArcGIS is subject to the Esri [Master Agreement](https://www.esri.com/content/dam/esrisites/media/legal/ma-full/ma-full.pdf) and [Privacy Statement](https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement). The current integration is offered and governed under marketplace terms and conditions. +> ArcGIS GeoAnalytics is a non-Microsoft product, and you understand and agree that use of ArcGIS is subject to the Esri [Master Agreement](https://www.esri.com/content/dam/esrisites/media/legal/ma-full/ma-full.pdf) and [Privacy Statement](https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement). The current integration is offered and governed under marketplace terms and conditions. ## Authentication -The ArcGIS GeoAnalytics library is currently available only in [Fabric Runtime 1.3](runtime-1-3.md). During the public preview, no authentication is required. The library is preinstalled and preconfigured, so you can import the modules and start using it. - -# [Python](#tab/python) - -```python -import geoanalytics_fabric -import geoanalytics_fabric.sql.functions as ST -``` - -# [Scala](#tab/scala) +Though ArcGIS GeoAnalytics library is preinstalled and preconfigured and you can import the modules to start using it immediately, the usage must be authorized with a valid license before running any function or tool. You can authorize the module with a GeoAnalytics for Microsoft Fabric username and password, or an API key provided by Esri. If the module is not authorized, functions and tools will fail to run with the following error: `com.esri.geoanalytics.internal.AuthError: Not authorized.` Here you can learn more about [Authorization](https://developers.arcgis.com/geoanalytics-fabric/authorization/). -```scala -import com.esri.geoanalytics._ -import com.esri.geoanalytics.sql.{functions => ST} -``` ---- +## ArcGIS GeoAnalytics Capabilities -## ArcGIS capabilities - -ArcGIS provides extensive geospatial capabilities for various applications. Esri is integrating the ArcGIS spatial analytics capabilities into Microsoft Fabric, offering ArcGIS GeoAnalytics functions and tools in the Fabric Spark environment. This integration to help you analyze events, visualize spatial relationships, and gain insights from your data. These capabilities enable the following tasks: +ArcGIS provides extensive geospatial capabilities for various applications. Esri is integrating ArcGIS spatial analytics capabilities into Microsoft Fabric, offering ArcGIS GeoAnalytics functions and tools in the Fabric Spark environment. This integration can help you analyze events, visualize spatial relationships, and gain insights from your data. These capabilities enable a variety of spatiotemporal analytics, including the following tasks: | Task type | Description | |---------|---------| @@ -94,7 +83,7 @@ These capabilities help organizations use geographic context for better decision You can find code templates and examples in the [ArcGIS GeoAnalytics Developer Documentation](https://developers.arcgis.com/geoanalytics-fabric/), the [Esri Community for GeoAnalytics for Fabric](https://community.esri.com/t5/arcgis-geoanalytics-for-microsoft-fabric/ct-p/arcgis-geoanalytics-for-microsoft-fabric), and Fabric Data Engineering samples. -Here's an example showing how to do hot spot analysis by importing the *FinfHotSopts* library and setting the parameters: +Here's an example showing how to do hot spot analysis by importing the *FindHotSpots* library and setting the parameters: ```python # import the Find Hot Spots tool @@ -143,13 +132,7 @@ df.st.plot(basemap="light", geometry="shape", facecolor="yellow", edgecolor="bla Support for ArcGIS GeoAnalytics can be found through the [Esri Community](https://community.esri.com/t5/arcgis-geoanalytics-for-microsoft-fabric/ct-p/arcgis-geoanalytics-for-microsoft-fabric), and the [Developer Documentation](https://developers.arcgis.com/geoanalytics-fabric/). -### Current limitations - -Currently, this integrated library has the following known limitations: - -* ArcGIS GeoAnalytics doesn't currently work with [Native Execution Engine (NEE)](native-execution-engine-overview.md) - -* During the public preview, Scala support is available for ArcGIS GeoAnalytics functions but not tools. +### Consideration * There's read/write support for spatial data as geometries, however, not all output formats support geometry type. @@ -157,10 +140,13 @@ Currently, this integrated library has the following known limitations: * When writing to Delta, ArcGIS GeoAnalytics converts geometry to a well-known binary format. When reading these Delta tables, check the column type and use functions like [ST_GeomFromBinary](https://developers.arcgis.com/geoanalytics-fabric/sql-functions/st_geom_from_binary/) to convert back to geometry. +* For authentication and usage tracking, the ArcGIS GeoAnalytics engine makes calls to Esri services outside of Fabric and hence currently it is not supported when [Outbound Access Protection](https://learn.microsoft.com/fabric/security/workspace-outbound-access-protection-overview) is enabled. + ### Related content * [Apache Spark runtime in Fabric](runtime.md) * [How to use notebooks](how-to-use-notebook.md) -* [ArcGIS for Microsoft Fabric](https://go.esri.com/geoanalytics-in-ms-fabric-overview) +* [Native Execution Engine (NEE)](native-execution-engine-overview.md) +* [ArcGIS GeoAnalytics for Microsoft Fabric](https://go.esri.com/geoanalytics-in-ms-fabric-overview) * [Developer documentation for ArcGIS GeoAnalytics for Microsoft Fabric](https://developers.arcgis.com/geoanalytics-fabric) * [ArcGIS GeoAnalytics for Microsoft Fabric Community](https://community.esri.com/t5/arcgis-geoanalytics-for-microsoft-fabric/ct-p/arcgis-geoanalytics-for-microsoft-fabric) \ No newline at end of file diff --git a/docs/data-engineering/toc.yml b/docs/data-engineering/toc.yml index f84f4febdb..6871f53498 100644 --- a/docs/data-engineering/toc.yml +++ b/docs/data-engineering/toc.yml @@ -451,7 +451,7 @@ items: href: graphql-faq.yml - name: Partner integration items: - - name: Esri - ArcGIS GeoAnalytics (preview) + - name: Esri - ArcGIS GeoAnalytics href: spark-arcgis-geoanalytics.md - name: User data functions items: