Combines multiple input datasets into a single, new output dataset. This tool can combine point, line, or polygon feature classes or tables.
Use the Append tool to combine input datasets with an existing dataset.
Illustration
Usage
- Use this tool to combine datasets from multiple sources into a new, single output dataset. All input datasets must be of the same type. For example, several point feature classes can be merged, or several tables can be merged, but a line feature class cannot be merged with a polygon feature class.
- All fields in the output dataset and the contents of those fields can be controlled using the Field Map control. Learn more about mapping fields in scripts
- This tool will not split or alter the geometries from the input datasets. All features from the input datasets will remain intact in the output dataset, even if the features overlap. To combine, or planarize, feature geometries, use the Union tool.
- If feature classes are being merged, the output dataset will be in the coordinate system of the first feature class in the Input Datasets list, unless the Output Coordinate System geoprocessing environment is set.
- This tool does not support annotation feature classes. Use the Append Annotation Feature Classes tool to combine annotation feature classes.
- This tool does not support raster datasets. Use the Mosaic To New Raster tool to merge multiple rasters into a new output raster.
Syntax
arcpy.management.Merge(inputs, output, {field_mappings})
ParameterExplanationData Type
inputs
[inputs,...]
The input datasets that will be merged together into a new output dataset. Input datasets can be point, line, or polygon feature classes or tables. The input datasets must all be of the same type.
Table View
output
The output dataset that will contain all combined input datasets.
Feature Class;Table
field_mappings
(Optional)
Controls how the attribute fields from the input datasets are mapped and transferred to the output dataset.
You can add, rename, or delete output fields as well as set properties, such as data type and merge rule.
Merge rules allow you to specify how values from two or more input fields are merged or combined into a single output value. There are several merge rules that determine how the output field is populated with values.