用于创建多文件要素连接文件 (.mfc) 和项目。 在多文件要素连接 (MFC) 中注册的数据集可用作 GeoAnalytics Desktop 工具和其他地理处理工具的输入。
使用此工具可以建立与一个或多个数据集的连接，您可以将其用作地理处理工具的输入。
您可以选择使用新建多文件要素连接对话框来创建多文件要素连接。
多文件要素连接支持以下数据集：
仅支持未加密的 parquet 文件。 不支持 GeoParquet 文件。
要了解有关受支持的文件类型的详细信息，请参阅多文件要素连接。
要将数据集用作 MFC 中的输入，必须正确构建数据。 要准备 MFC 的数据，需要将数据集格式化为您所注册的单个源文件夹下的子文件夹。 在此源文件夹中，子文件夹的名称表示数据集名称。
上图显示了 MFC 的正确结构。 源文件夹已注册，且源文件夹中的每个子文件夹都表示一个数据集。 在本示例中，您将注册源文件夹以及将包含在 MFC 中的三个数据集：Dataset-1、Dataset-2 和 Dataset-3。
使用数据源文件夹参数指定您要从中创建 MFC 的源位置。
MFC 可以存储在本地计算机或网络驱动器上。 如果要共享 MFC，请确保所有用户都可以访问所使用的源位置。 建议您不要将 MFC 存储在源文件夹中。
要访问工程中的 MFC，请将存储 MFC 的位置添加为文件夹连接。
设置几何或时间可见性不会从数据集中移除几何或时间。 应始终应用时间和几何设置。 例如，如果您点数据集中的几何由两个字段（latitude 和 longitude）表示，则以下情况概述了可见性设置将如何与数据集搭配使用：
在这两种情况下，数据集中的几何都将由 latitude 和 longitude 字段定义。
当使用长字符串值（例如 WKT）表示几何时，建议将几何字段设置为“不可见”。
不建议手动修改 .mfc 文件。 .mfc 文件包含以下属性：
工具消息将包含以下发现的数据集及其状态的相关信息：
在 MFC 中发现数据集时，您可能会遇到以下两个问题之一：
| 问题 | 解决方案 | 示例 |
|---|---|---|
数据集未采用预期格式。 | 打开文件，以查看其是否按预期显示。 如果数据结构不正确，请更新并重试。 | .csv 文件只有很少的几行以及一个数据摘要，之后将仅为空行。 |
文件夹中的数据集方案不匹配。 | 数据集文件夹中的所有文件必须具有相同方案。 打开文件，对方案进行比较。 解决所有不匹配的方案，然后重新尝试注册数据集。 | 您有一个包含 10 个字段的 .csv 文件，而另一个文件包含 8 个字段。 |
文件夹中数据集的文件类型不匹配。 | 数据集文件夹中的所有文件都必须具有相同的扩展名（文件类型）。 检查数据源位置的文件类型，然后移除或重新放置任何放错位置的文件。 | Shapefile 数据集与 parquet 文件位于同一文件夹中。 |
存在无法识别的字段格式。 | 这不太可能发生，但是如果 ORC 和 parquet 使用异常格式，则可能会发生此类情况。 确保使用有效的字段格式。 | 存在包含未知字段格式的 parquet 文件。 |
创建 MFC 后，可以使用以下工具修改连接信息和数据集：
此地理处理工具由 Spark 作为支持。 有关多文件要素连接及其使用方法的详细信息，请参阅多文件要素连接。
| 标注 | 说明 | 数据类型 |
多文件要素连接输出位置 (可选) | 将在其中创建 .mfc 文件的文件夹。 | Folder |
输出多文件要素连接名称 | 要创建的 .mfc 文件的名称。 | String |
连接类型 | 指定要创建的连接类型。
| String |
数据源文件夹 (可选) | 包含要在 MFC 中注册的数据集的文件夹。 | Folder |
可见几何字段 (可选) | 指定当 MFC 文件用作其他地理处理工具的输入时，用于指定几何的字段是否作为字段可见。 当几何字段不可见时，几何仍应用于数据集。 可以在 MFC 中修改几何可见性设置。
| Boolean |
可见时间字段 (可选) | 指定当 MFC 文件用作其他地理处理工具的输入时，用于指定时间的字段是否作为字段可见。 当时间字段不可见时，时间仍应用于数据集。 可以在 MFC 中修改时间可见性设置。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 输出 MFC | .mfc 文件已创建。 | File |
arcpy.gapro.CreateBDC({bdc_location}, bdc_name, connection_type, {data_source_folder}, {visible_geometry}, {visible_time})| 名称 | 说明 | 数据类型 |
bdc_location (可选) | 将在其中创建 .mfc 文件的文件夹。 | Folder |
bdc_name | 要创建的 .mfc 文件的名称。 | String |
connection_type | 指定要创建的连接类型。
| String |
data_source_folder (可选) | 包含要在 MFC 中注册的数据集的文件夹。 | Folder |
visible_geometry (可选) | 指定当 MFC 文件用作其他地理处理工具的输入时，用于指定几何的字段是否作为字段可见。 当几何字段不可见时，几何仍应用于数据集。 可以在 MFC 中修改几何可见性设置。
| Boolean |
visible_time (可选) | 指定当 MFC 文件用作其他地理处理工具的输入时，用于指定时间的字段是否作为字段可见。 当时间字段不可见时，时间仍应用于数据集。 可以在 MFC 中修改时间可见性设置。
| Boolean |
| 名称 | 说明 | 数据类型 |
| output_bdc | .mfc 文件已创建。 | File |
以下 Python 脚本演示了如何使用 CreateBDC 函数。
# Name: CreateBigDataConnection.py
# Description: Establishes a connection to a folder location containing one or
# more datasets. Datasets will be used as input to GeoAnalytics
# Desktop Tools.
#
# Requirements: ArcGIS Pro Advanced License
# Import system modules
import arcpy
# Set local variables
sourceFolder = r"\\FileShare\MyLargeDatasets"
outName = "my_new_MultifileFeatureConnection"
outFolder = r"c:\Projects\MyProjectFolder"
time = "TIME_NOT_VISIBLE"
geometry = "GEOMETRY_VISIBLE"
# Run Create Multifile Feature Connection
arcpy.gapro.CreateBDC(outFolder, outName, "FOLDER", sourceFolder, geometry, time)