Crear dataset de catálogo (Administración de datos)

Resumen

Crea un dataset de catálogo al que se pueden agregar conjuntos de capas, rásteres, datasets y otros elementos.

Uso

  • El dataset de catálogo se debe crear en una geodatabase.

  • Después de crear un dataset de catálogo, utilice la herramienta Agregar elementos al dataset de catálogo para rellenarlo con elementos locales. Para rellenar el dataset de catálogo con elementos almacenados en un portal corporativo, use la herramienta Agregar elementos del portal al dataset de catálogo.

  • Los campos, dominios, subtipos y reglas de atributos de los datasets de plantilla se transferirán al dataset de catálogo. Se ignorarán los campos con los mismos nombres que los campos obligatorios del dataset de catálogo.

  • La primera clase de entidad o tabla que se enumera en el parámetro Datasets de plantilla se considera el dataset principal en algunos escenarios. Si varios datasets de plantillas contienen campos con el mismo nombre, solo se creará un campo con ese nombre. También se tendrá en cuenta la propiedad hasZ de la primera clase de entidad de la lista.

  • El nombre del dataset de catálogo debe estar dentro de los límites de la geodatabase o la base de datos subyacente; por ejemplo, el nombre no puede empezar por un número.

Parámetros

EtiquetaExplicaciónTipo de datos
Ubicación del dataset de catálogo

La geodatabase de archivos o corporativa en la que se creará el dataset de catálogo de salida.

Workspace; Feature Dataset
Nombre del dataset de catálogo

El nombre del dataset de catálogo que se creará.

String
Sistema de coordenadas
(Opcional)

La referencia espacial del dataset de catálogo.

Spatial Reference
Datasets de plantilla
(Opcional)

La tabla o clase de entidad que se utilizará como plantilla para definir los campos de atributos del nuevo dataset de catálogo.

Table View
Tiene valores Z
(Opcional)

Especifica si el dataset de catálogo contendrá valores de elevación (valores z).

  • DeshabilitadoEl dataset de catálogo de salida no contendrá valores z. Esta es la opción predeterminada.
  • HabilitadoEl dataset de catálogo de salida contendrá valores z.
  • Igual que la plantillaEl dataset de catálogo de salida contendrá valores z si el dataset especificado en el parámetro Datasets de plantilla contiene valores z.
String
Alias del dataset de catálogo
(Opcional)

El nombre de alias del dataset de catálogo.

String
Palabra clave de configuración
(Opcional)

La palabra clave de configuración determina los parámetros de almacenamiento de la tabla de la base de datos. La palabra clave de configuración se aplica solamente a los datos de la geodatabase corporativa.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Dataset de catálogo de salida

El nuevo dataset de catálogo.

Feature Class

arcpy.management.CreateCatalogDataset(out_path, out_name, {spatial_reference}, {template}, {has_z}, {out_alias}, {config_keyword})
NombreExplicaciónTipo de datos
out_path

La geodatabase de archivos o corporativa en la que se creará el dataset de catálogo de salida.

Workspace; Feature Dataset
out_name

El nombre del dataset de catálogo que se creará.

String
spatial_reference
(Opcional)

La referencia espacial del dataset de catálogo.

Spatial Reference
template
[template,...]
(Opcional)

La tabla o clase de entidad que se utilizará como plantilla para definir los campos de atributos del nuevo dataset de catálogo.

Table View
has_z
(Opcional)

Especifica si el dataset de catálogo contendrá valores de elevación (valores z).

  • DISABLEDEl dataset de catálogo de salida no contendrá valores z. Esta es la opción predeterminada.
  • ENABLEDEl dataset de catálogo de salida contendrá valores z.
  • SAME_AS_TEMPLATEEl dataset de catálogo de salida contendrá valores z si el dataset especificado en el parámetro template contiene valores z.
String
out_alias
(Opcional)

El nombre de alias del dataset de catálogo.

String
config_keyword
(Opcional)

La palabra clave de configuración determina los parámetros de almacenamiento de la tabla de la base de datos. La palabra clave de configuración se aplica solamente a los datos de la geodatabase corporativa.

String

Salida derivada

NombreExplicaciónTipo de datos
out_catalog_dataset

El nuevo dataset de catálogo.

Feature Class

Muestra de código

Ejemplo 1 de CreateCatalogDataset (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función CreateCatalogDataset.

import arcpy
arcpy.env.workspace = "C:/Dataspace"
dataset = "C:/Dataspace/studyarea.gdb/StudyAreaDataset"
spatial_ref = arcpy.Describe(dataset).spatialReference
arcpy.management.CreateCatalogDataset("C:/Dataspace/studyarea.gdb", 
                                      "SampleCatalog", "SampleFeatureClass", 
                                      "DISABLED", spatial_ref, 
                                      "NewCatalogDataset", "DEFAULTS")
Ejemplo 2 de CreateCatalogDataset (script independiente)

Cree una instancia y cree un dataset de catálogo.

#Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/output.gdb"

# Set local variables
catalogName = "MyCatalogDataset"
outCatalogDataset = "C:/output/output.gdb/catalogds1"
zValuesPresent = "ENABLED"

# Run CreateCatalogDataset
arcpy.management.CreateCatalogDataset(outCatalogDataset, catalogName, " ",
                                      zValuesPresent)