Etiqueta | Explicación | Tipo de datos |
Capa de entrada | Las capas de entrada que se consolidarán. | Layer |
Carpeta de salida | Carpeta de salida que contendrá los archivos de capa y los datos consolidados. Si la carpeta especificada no existe, se creará una nueva carpeta. | Folder |
Convertir datos a geodatabase de archivos (Opcional) | Especifica si las capas de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.
| Boolean |
Se incluyen los datos de la geodatabase corporativa en lugar de hacer referencia a los datos (Opcional) | Especifica si las capas de geodatabase corporativa de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.
| Boolean |
Extensión (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
| Extent |
Aplicar extensión sólo a las capas de geodatabase corporativa (Opcional) | Indica si la extensión especificada se aplicará a todas las capas o a las capas de una geodatabase corporativa únicamente.
| Boolean |
Solo esquema (Opcional) | Especifica si solo se consolidará o empaquetará el esquema de las capas de entrada.
| Boolean |
Conservar solo las filas relacionadas con las entidades dentro de la extensión (Opcional) | Determina si la extensión especificada se aplicará a fuentes de datos relacionadas.
| Boolean |
Conservar geodatabase móvil (Opcional) | Especifica si los datos de geodatabase móvil de entrada se conservarán en la salida o si se escribirán en formato de geodatabase de archivos. Si los datos de entrada corresponden a un dataset de red de geodatabase móvil, la salida será una geodatabase móvil. Este parámetro invalida el parámetro Convertir datos a geodatabase de archivos cuando los datos de entrada son una geodatabase móvil.
| Boolean |
Excluir dataset de red (Opcional) | Para las capas de análisis de red, especifica si también se consolidará el dataset de red.
| Boolean |
Resumen
Consolida una o más capas al copiar todas las fuentes de datos de referencia en una sola carpeta.
Uso
Se emite una advertencia cuando esta herramienta encuentra un tipo de capa no admitido. La capa no permitida no se escribirá en la salida.
Cuando el parámetro Convertir datos a geodatabase de archivos está activado, ocurre lo siguiente:
- Cada fuente de datos única tendrá una geodatabase de archivos creada en la carpeta o paquete consolidado.
- Los formatos ráster y vectoriales comprimidos se convertirán a una geodatabase de archivos, y se perderá la compresión.
- Los datos de la geodatabase corporativa no se consolidarán. Para convertir los datos de la geodatabase corporativa a una geodatabase de archivos, active el parámetro Incluir datos de geodatabase corporativa en vez de hacer referencia a los datos.
Cuando el parámetro Convertir datos a geodatabase de archivos no está activado, ocurre lo siguiente:
- Se conservará el formato de la fuente de datos de las capas de entrada siempre que sea posible.
- Los formatos ráster ADRG, CADRG/ECRG, CIB y RPF se convertirán a rásteres de geodatabase de archivos. ArcGIS no puede escribir estos formatos de forma nativa. Se convertirán a rásteres de geodatabase de archivos para una mayor eficiencia.
- En la estructura de carpeta de salida, las geodatabases de archivos se consolidarán en una carpeta específica de cada versión, y los demás formatos se consolidarán en la carpeta commonData.
- Los formatos ráster y vectoriales comprimidos no se recortarán aunque se especifique una extensión en el parámetro Extensión.
Para las capas que contienen una unión o que participan en una clase de relación, todas las fuentes de datos unidas o relacionadas se consolidarán en la carpeta de salida. De manera predeterminada, las fuentes de datos unidas o relacionadas se consolidarán en su totalidad o en función del valor del parámetro Seleccionar filas relacionadas, según la extensión especificada para el parámetro Extensión.
En las capas de entidades, se utiliza el parámetro Extensión para seleccionar las entidades que se consolidarán. Para las capas ráster, el parámetro Extensión se utiliza para recortar los datasets ráster.
Algunos datasets hacen referencia a otros datasets. Por ejemplo, puede tener un dataset de topología que haga referencia a cuatro clases de entidad. Las redes geométricas, las redes y los localizadores son otros ejemplos de datasets que hacen referencia a otros datasets. Al consolidar o empaquetar una capa en base a estos tipos de datasets, los datasets participantes también se consolidarán o empaquetarán.
Si el parámetro Solo esquema está activado, únicamente el esquema de las fuentes de datos de entrada se consolidarán o empaquetarán. Un esquema es la estructura o el diseño de una clase de entidad o una tabla integrada por definiciones de campo y de tabla, propiedades del sistema de coordenadas, simbología, consultas de definición, etc. Los datos o registros no se consolidarán o empaquetarán.
Las fuentes de datos que no admiten el parámetro Solo esquema no se consolidarán ni empaquetarán. Si el parámetro Solo esquema está activado y la herramienta encuentra una capa que no es compatible con este parámetro, aparece un mensaje de advertencia y esa capa se omitirá. Si la única capa especificada no es compatible con Solo esquema, la herramienta fallará.
Parámetros
arcpy.management.ConsolidateLayer(in_layer, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {select_related_rows}, {preserve_sqlite}, {exclude_network_dataset})
Nombre | Explicación | Tipo de datos |
in_layer [in_layer,...] | Las capas de entrada que se consolidarán. | Layer |
output_folder | Carpeta de salida que contendrá los archivos de capa y los datos consolidados. Si la carpeta especificada no existe, se creará una nueva carpeta. | Folder |
convert_data (Opcional) | Especifica si las capas de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.
| Boolean |
convert_arcsde_data (Opcional) | Especifica si las capas de geodatabase corporativa de entrada se convertirán en una geodatabase de archivos o conservarán el formato original.
| Boolean |
extent (Opcional) | Especifica la extensión que se utilizará para seleccionar o recortar entidades.
| Extent |
apply_extent_to_arcsde (Opcional) | Indica si la extensión especificada se aplicará a todas las capas o a las capas de una geodatabase corporativa únicamente.
| Boolean |
schema_only (Opcional) | Especifica si solo se consolidará o empaquetará el esquema de las capas de entrada.
| Boolean |
select_related_rows (Opcional) | Determina si la extensión especificada se aplicará a fuentes de datos relacionadas.
| Boolean |
preserve_sqlite (Opcional) | Especifica si los datos de geodatabase móvil se conservarán en la salida o si se escribirán en formato de geodatabase de archivos. Si los datos de entrada corresponden a un dataset de red de geodatabase móvil, la salida será una geodatabase móvil. Este parámetro invalida el parámetro convert_data cuando los datos de entrada son una geodatabase móvil.
| Boolean |
exclude_network_dataset (Opcional) | Para las capas de análisis de red, especifica si también se consolidará el dataset de red.
| Boolean |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función ConsolidateLayer de modo inmediato.
import arcpy
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers'
arcpy.management.ConsolidateLayer('Parcels.lyr', 'Consolidated_folder', 'PRESERVE', 'CONVERT_ARCSDE')
Busque y cree carpetas consolidadas individuales para todos los archivos de capa que se encuentran en una carpeta especificada.
# Import system modules
import os
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers'
# Loop through the workspace, find all the layer files (.lyr) and create a consolidated folder for each
# layer file found using the same name as the original layer file.
for lyr in arcpy.ListFiles('*.lyr'):
print('Consolidating {}'.format(lyr))
arcpy.management.ConsolidateLayer(lyr, os.path.splitext(lyr)[0], 'PRESERVE', 'CONVERT_ARCSDE')
Entornos
Casos especiales
- Factor de procesamiento en paralelo
Si no se especifica el entorno, la herramienta usará la mitad de los núcleos disponibles.