大数据文件共享入门—ArcGIS GeoAnalytics Server

注：

在 10.9.1 或更高版本中，可以通过门户内容页面注册大数据文件共享。建议使用此方法来注册大数据文件共享。如果您的大数据文件共享是使用 Server Manager 创建的，并且您尚未将其替换为门户中的大数据文件共享，则只能使用 Server Manager 进行编辑。

大数据文件共享是在门户中创建的项目，可以将可用位置引用到 ArcGIS GeoAnalytics Server。大数据文件共享位置可用作 GeoAnalytics 工具中要素数据（点、线、面和表格数据）的输入和输出。通过门户内容页面创建大数据文件共享时，至少会在门户中创建两个项目：

数据存储（大数据文件共享）项目
大数据文件共享项目
数据存储（云存储位置）项目（如果您要为大数据文件共享注册云存储数据存储）

大数据文件共享项目指向大数据目录服务，该服务概述了大数据文件共享中的数据集及其方案，包括几何和时间信息，以及已注册的输出格式（称为模板）。将大数据文件共享用于 ArcGIS GeoAnalytics Server 工具的输入时，您可以浏览到大数据文件共享项目以运行数据集分析。

注：

仅当门户管理员启用 GeoAnalytics Server 后，才能使用大数据文件共享。有关启用 GeoAnalytics Server 的详细信息，请参阅设置 ArcGIS GeoAnalytics Server。

大数据文件共享

使用大数据文件共享存在诸多益处：

在可以开始执行分析前，您可以将数据保存在您可访问的位置。大数据文件共享可用于在运行分析时访问数据，以便您可以继续将数据添加到大数据文件共享的现有数据集，而无需重新注册或发布数据。
您还可以修改清单以移除、添加或更新大数据文件共享中的数据集。
大数据文件共享在时间和几何的定义方式上极其灵活，允许在单个数据集上使用多种时间格式。
大数据文件共享还可用于对数据集进行分区，同时仍将多个分区视为一个数据集。
针对输出数据使用大数据文件共享，允许您将结果存储为可用于其他工作流的格式，例如可用于进一步分析或存储的 Parquet 文件。

注：

仅当您运行 GeoAnalytics Tools 时，才能访问大数据文件共享。这意味着您只能浏览大数据文件和将其添加到您的分析中；无法在地图上显示该数据。

大数据文件共享可以引用以下输入数据源：

文件共享 - 本地磁盘或网络共享上的数据集目录。
Apache Hadoop Distributed File System (HDFS) - 数据集的 HDFS 目录。
Apache Hive - Hive 元数据存储数据库。
云存储 - 包含数据集目录的 Amazon Simple Storage Service (S3) 存储段、Microsoft Azure Blob 容器或 Microsoft Azure Data Lake Storage Gen2 存储。

将结果写入大数据文件共享时，您可以使用以下 GeoAnalytics Tools 输出：

文件共享
HDFS
云存储位置

在大数据文件共享中支持将以下文件类型作为输入和输出数据集：

分隔文件（例如 .csv、.tsv 和 .txt）
Shapefile (.shp)
Parquet 文件 (.parquet)
注：
仅支持未加密的 parquet 文件。
ORC 文件 (.orc)

大数据文件共享是 GeoAnalytics Tools 访问数据的多种方式之一，GeoAnalytics Tools 没有此项要求。有关可能使用的 GeoAnalytics Tools 数据输入和输出的列表，请参阅在 Map Viewer Classic 中使用 GeoAnalytics Tools。

您可以根据需要注册多个大数据文件共享。每个大数据文件共享可以包含任意数量的数据集。有关将大数据文件共享注册到 GeoAnalytics Server 站点的说明，请参阅添加大数据文件共享。

下表概述了讨论大数据文件共享时的一些重要术语。


术语	描述
大数据文件共享	注册到 GeoAnalytics Server 的位置可用作 GeoAnalytics Tools 的数据集输入或输出，也可以同时用作输入和输出。
大数据目录服务	该服务概述了大数据文件共享的输入数据集和方案以及输出模板名称。该服务是在注册大数据文件共享及创建清单时创建的。有关大数据目录服务的详细信息，请参阅 ArcGIS Services REST API 帮助中的大数据目录服务文档。
大数据文件共享项目	门户中引用大数据目录服务的项目。您可以通过在门户中共享此项目来控制哪些用户有权将您的大数据文件共享用作 GeoAnalytics 的输入。
清单	JSON 文件概述了大数据文件共享中的可用数据集和输入方案。注册大数据文件共享时会自动生成清单，您可以通过编辑或使用提示文件对该清单进行修改。单个大数据文件共享具有一个清单。
输出模板	将结果写入大数据文件共享时，可概述文件类型和可选格式的一个或多个模板。例如，模板可以指定将结果写入 shapefile。大数据文件共享可以不包含输出模板，也可以包含一个或多个输出模板。
大数据文件共享类型	您正在注册的位置类型。例如，您可能拥有大数据文件共享或类型 HDFS。
大数据文件共享数据集格式	您正在读取或写入的数据格式。例如，文件类型可以是 shapefile。
提示文件	该文件为可选文件，可用于帮助生成用作输入的分隔文件的清单。

准备要注册为大数据文件共享的数据

要将数据集用作大数据文件共享的输入，请确保已正确格式化数据。有关基于大数据文件共享类型的格式，请参阅以下内容。

文件共享和 HDFS

要准备进行大数据文件共享的数据，必须将数据集格式化为将注册的单个父文件夹下的子文件夹。在要注册的该父文件夹中，子文件夹的名称表示数据集名称。如果子文件夹包含多个文件夹或文件，则所有顶级子文件夹的内容将读取为一个数据集，且必须共享同一个方案。下面的示例演示了如何注册包含三个数据集（即 Earthquakes、Hurricanes 和 GlobalOceans）的文件夹 FileShareFolder。在注册父文件夹时，指定的该文件夹下的所有子目录也将被注册到 GeoAnalytics Server。始终注册包含一个或多个单个数据集文件夹的父文件夹（例如 \\machinename\FileShareFolder）。

包含三个数据集的大数据文件共享示例：Earthquakes、Hurricanes 和 GlobalOceans。


|---FileShareFolder                 < -- The top-level folder is what is registered as a big data file share
   |---Earthquakes                  < -- A dataset "Earthquakes", composed of 4 csvs with the same schema
      |---1960
         |---01_1960.csv
         |---02_1960.csv
      |---1961
         |---01_1961.csv
         |---02_1961.csv
   |---Hurricanes                   < -- The dataset "Hurricanes", composed of 3 shapefiles with the same schema
      |---atlantic_hur.shp
      |---pacific_hur.shp
      |---otherhurricanes.shp
   |---GlobalOceans                 < -- The dataset "GlobalOceans", composed of a single shapefile
      |---oceans.shp

尽管术语不同，但文件共享和 HDFS 均采用该相同结构。在文件共享中，存在一个顶级文件夹或目录，数据集通过子目录表示。在 HDFS 中，文件共享位置已注册并包含数据集。下表概述了区别：


	文件共享	HDFS
大数据文件共享位置	文件夹或目录	HDFS 路径
数据集	顶级子文件夹	HDFS 路径内的数据集

将数据组织为包含数据集子文件夹的文件夹后，按照使数据可供 ArcGIS Server访问中的步骤操作并通过门户注册数据集文件夹或 HDFS 路径，以使数据可供 GeoAnalytics Server 访问。

Hive

在 Hive 中，数据库中的所有表格将识别为大数据文件共享中的数据集。在下面的示例中，存在包含两个数据库（default 和 CityData）的元数据存储。注册 Hive 大数据文件共享时，只能选择一个数据库。在此示例中，如果选择了 CityData 数据库，则大数据文件共享中将存在两个数据集，即 FireData 和 LandParcels。


|---HiveMetastore                 < -- The top-level folder is what is registered as a big data file share
   |---default                    < -- A database
      |---Earthquakes
      |---Hurricanes
      |---GlobalOceans
   |---CityData				            < -- A database that is registered (specified in Server Manager)
      |---FireData
      |---LandParcels

云存储数据存储

要在云存储位置中准备大数据文件共享的数据，需要将数据集格式化为单个父文件夹下的子文件夹。

以下是如何构建数据的示例：本示例将注册父文件夹 FileShareFolder，其中包含三个数据集：Earthquakes、Hurricanes 和 GlobalOceans。在注册父文件夹时，指定的该文件夹下的所有子目录也将被注册到 GeoAnalytics Server。

以下是如何在云存储位置中构建将用作大数据文件共享的数据的示例：此大数据文件包含三个数据集：Earthquakes、Hurricanes 和 GlobalOceans。


|---Cloud Store                          < -- The cloud storage location being registered
   |---Container or S3 Bucket Name       < -- The container (Azure) or bucket (Amazon) being registered as part of the cloud storage data store
      |---FileShareFolder                < -- The parent folder that is registered as the 'folder' during cloud storage registration
         |---Earthquakes                 < -- The dataset "Earthquakes", composed of 4 csvs with the same schema
            |---1960
               |---01_1960.csv
               |---02_1960.csv
            |---1961
               |---01_1961.csv
               |---02_1961.csv
         |---Hurricanes                  < -- The dataset "Hurricanes", composed of 3 shapefiles with the same schema
            |---atlantic_hur.shp
            |---pacific_hur.shp
            |---otherhurricanes.shp
         |---GlobalOceans                < -- The dataset "GlobalOceans", composed of 1 shapefile
            |---oceans.shp

在门户中管理大数据文件共享

创建大数据文件共享后，您可以查看其中的数据集和模板，该模板概述了如何写入保存到大数据文件共享的结果。

修改大数据文件共享

创建大数据文件共享项目时，将自动生成并上传输入数据的清单。在生成清单的过程中，可能无法始终正确估算表示几何和时间的字段，您可能需要应用编辑。要编辑清单和数据集的表示方式，请遵循编辑大数据文件共享中的步骤操作。有关大数据文件共享清单的详细信息，请参阅 ArcGIS Server 帮助中的大数据文件共享清单。

如果您在 ArcGIS Server 中使用 Manager 创建了大数据文件共享，请按照在 Server Manager 中编辑大数据文件共享清单中的步骤操作。

修改大数据文件共享的输出模板

当您选择将大数据文件共享用作输出位置时，将自动生成输出模板。这些模板概述了输出分析结果的格式，例如文件类型以及时间和几何的注册方式。要修改几何或时间格式，或添加、删除模板，可通过修改模板来实现。要编辑输出模板，请按照创建、编辑和查看输出模板中的步骤操作。关于输出模板的详细信息，请参阅大数据文件共享中的输出模板。

如果您在 ArcGIS Server 中使用 Manager 创建了大数据文件共享，请按照在 Server Manager 中编辑大数据文件共享清单中的步骤操作。

将在 Server Manager 中创建的大数据文件共享迁移至门户

相对于在 Server Manager 中创建的大数据文件共享，使用门户创建的大数据文件共享具有许多优势，例如：

用户体验更佳，数据集编辑更加容易。
注册大数据文件共享的体验更加简洁。
项目使用门户凭据存储和共享

建议您为在 Server Manager 中创建的大数据文件共享创建数据存储项目。在某些情况下，这是必要操作。在以下情况下，必须将大数据文件共享迁移为门户中的数据存储项目，才能继续使用它们：

大数据文件共享基于 Microsoft Azure Data Lake Storage Gen1 云存储数据存储。

要将您在 Server Manager 中创建的大数据文件共享迁移至门户数据存储项目，请确保您具备以下条件：

已配置的大数据文件共享的凭据和文件位置。
如果适用，需要已配置的云存储数据存储的凭据和文件位置。

得知凭据后，请完成以下步骤：

在 GeoAnalytics Server 站点上登录到 Server Manager。
转至站点 > 数据存储。单击要迁移的大数据文件共享上的编辑按钮。
转到高级 > 清单。单击下载按钮以保存清单。
如果存在提示文件，请对提示文件完成相同的步骤。单击提示下载以保存提示文件。将文件扩展名从 .dat 重命名为 .txt.txt。
如果在高级输出模板部分下有输出模板，请复制文本并将其保存在文本文件中。
可以使用之前所用的相同类型和输入位置在门户内容页面中创建大数据文件共享。
如果您不知道凭据，您的管理员可以在 Server Administrator 中针对大数据文件共享和云存储数据存储项目使用 decrypt=true 选项找到凭据。
按照添加数据存储项目中的步骤进行操作，并使用与现有大数据文件共享相同的凭据和位置。
创建大数据文件共享项目后，单击数据集，然后打开显示高级选项。
单击清单部分中的上传以上传之前保存的清单。浏览至之前保存的清单 JSON 文件，然后单击上传。单击同步按钮以反映更改。
如果存在要上传的提示文件，请完成同样的步骤并在显示高级选项 > 提示 > 上传选项下上传提示文件。单击同步按钮以反映更改。
要上传输出模板，请执行以下操作之一：
- 使用大数据文件共享项目的输出 > 添加输出模板手动添加输出模板。
- 通过 ArcGIS Server Administrator Directory 对大数据文件共享项目的 JSON 文件执行编辑。仅建议熟悉 JSON 文件编辑的用户执行此操作。

现在，您的大数据文件共享和大数据文件共享项目的清单已在门户中。您可以更新工作流以使用或指向此大数据文件共享。当您确信其如预期运行时，可删除 Server Manager 中的原始大数据文件共享。

在大数据文件共享中运行分析

可通过支持 GeoAnalytics Server 的任何客户端在大数据文件共享中的数据集上运行分析，具体包括：

ArcGIS Pro
Map Viewer Classic
ArcGIS REST API
ArcGIS API for Python

要通过 ArcGIS Pro 或 Map Viewer Classic 在大数据文件共享上运行分析，请选择要使用的 GeoAnalytics Tools。对于工具的输入，请浏览到 ArcGIS Pro 的门户下或 Map Viewer Classic 的浏览图层对话框中数据所在位置。如果您之前注册了数据，则该数据将位于我的内容中。否则，请在群组或所有门户中查找。请注意，为分析选择的大数据文件共享图层不会显示在地图中。

注：

确保您登录时使用的门户帐户具有已注册的大数据文件共享的访问权限。可使用项 bigDataFileShare* 搜索门户以快速查找您可以访问的所有大数据文件共享。

要通过 ArcGIS REST API 在大数据文件共享上运行分析，需要使用大数据目录服务 URL 作为输入。如果大数据文件共享在门户中创建，其格式将为 {"url":" https://webadaptorhost.domain.com/webadaptorname/rest/DataStoreCatalogs/bigDataFileShares_filesharename/"}。例如，如果计算机名为 example、域名为 esri、Web Adaptor 名为 server、大数据文件共享名为 MyData 且数据集名为 Earthquakes，则 URL 将为：{"url":" https://example.esri.com/server/rest/DataStoreCatalogs/bigDataFileShares_MyData/Earthquakes_uniqueID"}。如果大数据文件共享在 Server Manager 中创建，其格式将为 {"url":"https://webadaptorhost.domain.com/webadaptorname/rest/DataStoreCatalogs/bigDataFileShares_filesharename/BigDataCatalogServer/dataset"}。

有关通过 REST 的大数据分析输入的详细信息，请参阅 ArcGIS Services REST API 文档中的要素输入主题。

将结果保存到大数据文件共享

您可以针对数据集（大数据文件共享或其他输入）运行分析，并将结果保存到大数据文件共享。可以通过以下客户端执行此操作：

Map Viewer Classic
ArcGIS REST API
ArcGIS API for Python

将结果写入大数据文件共享时，输入清单将更新，以包含刚刚保存的数据集。现在，已写入大数据文件共享的结果可在下次运行工具时作为输入。将结果保存到大数据文件共享时，您无法将其可视化。

有关此主题的反馈?

注：

注：