Duplicate Dataset From Multifile Feature Connection (GeoAnalytics Desktop)

Summary

Creates a duplicate of a multifile feature connection (MFC) dataset.

Usage

• This tool requires a MFC. To create a MFC, use the New Multifile Feature Connection dialog or Create Multifile Feature Connection tool.

• A duplicate of a MFC dataset can be useful in scenarios such as the following:

  • Your dataset contains geometry and time locations for multiple events, such as pick-up and drop-off locations for deliveries, that you want to analyze individually without creating a copy of the source dataset.
  • You want to improve processing time by reducing the number of features or attributes used in analysis without modifying your original MFC dataset.
  • You want to create a subset of your MFC dataset for a colleague while maintaining the ability to use the full dataset.

• Use the Multifile Feature Connection Dataset parameter to specify the dataset you want to duplicate.

• If the name of the output MFC dataset already exists, a number will be appended to the name to make the dataset unique (for example <inputMFCDatasetName>_2. Optionally, set the Duplicate Nameparameter to a unique name.

• This tool creates a duplicate of an existing MFC dataset. Use the following tools to modify a MFC:

  • Copy Dataset From Multifile Feature Connection—Copies a dataset from a MFC to a feature class.
  • Remove Dataset From Multifile Feature Connection—Removes a dataset from the MFC.
  • Refresh Multifile Feature Connection—Checks for any new datasets and add them to the MFC.
  • Update Multifile Feature Connection Dataset Properties—Modifies the properties of an individual MFC dataset.
  • Preview Dataset From Multifile Feature Connection—Previews the first ten features in your dataset to verify they are correctly registered.

  Additionally, if you choose to modify the properties of the duplicate, you can run the Describe Dataset tool to confirm that the dataset displays as expected.

• This geoprocessing tool is powered by Spark. See Multifile feature connections to learn more about multifile feature connections and how to use them.

Parameters

Dialog

Label	Explanation	Data Type
Multifile Feature Connection Dataset	The MFC dataset to be duplicated.	Table View
Duplicate Name (Optional)	The name of the output MFC dataset.	String

Derived Output

Label	Explanation	Data Type
Updated MFC	The .mfc file containing the input dataset and the duplicate dataset.	File

Python

arcpy.geoanalytics.DuplicateDatasetFromBDC(bdc_dataset, {duplicate_name})

Name	Explanation	Data Type
bdc_dataset	The MFC dataset to be duplicated.	Table View
duplicate_name (Optional)	The name of the output MFC dataset.	String

Derived Output

Name	Explanation	Data Type
updated_bdc	The .mfc file containing the input dataset and the duplicate dataset.	File

Code sample

DuplicateDatasetFromBDC (stand-alone script)

The following script demonstrates how to use the DuplicateDatasetFromBDC tool.

# Name: DuplicateDatasetFromBDC.py
# Description: Creates a duplicate of a multifile feature connection dataset.
#
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
bdcDataset = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc\Taxi_Locations"
newName = "taxi_pickups"

# Run Duplicate Dataset From MFC
arcpy.gapro.DuplicateDatasetFromBDC(bdcDataset, newName)

Environments

This tool does not use any geoprocessing environments.