用于创建目录数据集，可以向其中添加图层、栅格、数据集和其他项目的集合。
必须在地理数据库中创建目录数据集。
创建目录数据集后，借助将项目添加至目录数据集工具，可以使用基于本地的项目对其进行填充。 要使用存储在企业门户中的项目填充目录数据集，请使用将门户项目添加至目录数据集工具。
会将模板数据集的字段、属性域、子类型和属性规则传输到目录数据集。 将忽略与目录数据集的必填字段同名的字段。
模板数据集参数中列出的第一个要素类或表将视为某些方案的主要数据集。 如果多个模板数据集包含同名字段，则将仅创建一个具有该名称的字段。 还将考虑列表中第一个要素类的 hasZ 属性。
目录数据集的名称必须符合地理数据库或基础数据库的限制；例如，名称不能以数字开头。
| 标注 | 说明 | 数据类型 |
目录数据集位置 | 将在其中创建输出目录数据集的企业级、移动或文件地理数据库。 | Workspace; Feature Dataset |
目录数据集名称 | 将创建的目录数据集的名称。 | String |
坐标系 (可选) | 目录数据集的空间参考。 | Spatial Reference |
模板数据集 (可选) | 将用作模板以定义新目录数据集的属性字段的要素类或表。 | Table View |
包含 Z 值 (可选) | 指定目录数据集是否将包含高程值（z 值）。
| String |
目录数据集别名 (可选) | 目录数据集的别名。 | String |
配置关键字 (可选) | 配置关键字用于确定数据库表的存储参数。 配置关键字仅适用于企业级数据。 | String |
| 标注 | 说明 | 数据类型 |
| 输出目录数据集 | 新目录数据集。 | Feature Class |
arcpy.management.CreateCatalogDataset(out_path, out_name, {spatial_reference}, {template}, {has_z}, {out_alias}, {config_keyword})| 名称 | 说明 | 数据类型 |
out_path | 将在其中创建输出目录数据集的企业级、移动或文件地理数据库。 | Workspace; Feature Dataset |
out_name | 将创建的目录数据集的名称。 | String |
spatial_reference (可选) | 目录数据集的空间参考。 | Spatial Reference |
template [template,...] (可选) | 将用作模板以定义新目录数据集的属性字段的要素类或表。 | Table View |
has_z (可选) | 指定目录数据集是否将包含高程值（z 值）。
| String |
out_alias (可选) | 目录数据集的别名。 | String |
config_keyword (可选) | 配置关键字用于确定数据库表的存储参数。 配置关键字仅适用于企业级数据。 | String |
| 名称 | 说明 | 数据类型 |
| out_catalog_dataset | 新目录数据集。 | Feature Class |
以下 Python 窗口脚本演示了如何使用 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")实例化并创建一个目录数据集。
# 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)