创建目录数据集 (数据管理)

摘要

用于创建目录数据集，可以向其中添加图层、栅格、数据集和其他项目的集合。

使用情况

• 必须在地理数据库中创建目录数据集。

• 创建目录数据集后，借助将项目添加至目录数据集工具，可以使用基于本地的项目对其进行填充。 要使用存储在企业门户中的项目填充目录数据集，请使用将门户项目添加至目录数据集工具。

• 会将模板数据集的字段、域、子类型和属性规则传输到目录数据集。 将忽略与目录数据集的必填字段同名的字段。

• 模板数据集参数中列出的第一个要素类或表将视为某些方案的主要数据集。 如果多个模板数据集包含同名字段，则将仅创建一个具有该名称的字段。 还将考虑列表中第一个要素类的 hasZ 属性。

• 目录数据集的名称必须符合地理数据库或基础数据库的限制；例如，名称不能以数字开头。

参数

对话框

标注	说明	数据类型
目录数据集位置	将在其中创建输出目录数据集的企业级或文件地理数据库。	Workspace; Feature Dataset
目录数据集名称	将创建的目录数据集的名称。	String
坐标系 (可选)	目录数据集的空间参考。	Spatial Reference
模板数据集 (可选)	将用作模板以定义新目录数据集的属性字段的要素类或表。	Table View
包含 Z 值 (可选)	指定目录数据集是否将包含高程值（z 值）。 已禁用—输出目录数据集将不包含 z 值。 这是默认设置。 已启用—输出目录数据集将包含 z 值。 与模板相同—如果在模板数据集参数中指定的数据集包含 z 值，则输出目录数据集将包含 z 值。	String
目录数据集别名 (可选)	目录数据集的别名。	String
配置关键字 (可选)	配置关键字用于确定数据库表的存储参数。 配置关键字仅适用于企业级数据。	String

派生输出

标注	说明	数据类型
输出目录数据集	新目录数据集。	Feature Class

Python

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 值）。 DISABLED—输出目录数据集将不包含 z 值。 这是默认设置。 ENABLED—输出目录数据集将包含 z 值。 SAME_AS_TEMPLATE—如果在 template 参数中指定的数据集包含 z 值，则输出目录数据集将包含 z 值。	String
out_alias (可选)	目录数据集的别名。	String
config_keyword (可选)	配置关键字用于确定数据库表的存储参数。 配置关键字仅适用于企业级数据。	String

派生输出

名称	说明	数据类型
out_catalog_dataset	新目录数据集。	Feature Class

代码示例

CreateCatalogDataset 示例 1（Python 窗口）

以下 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")

CreateCatalogDataset 示例 2（独立脚本）

实例化并创建一个目录数据集。

#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)

环境

输出坐标系, 地理变换, 输出配置关键字, 输出 XY 域, XY 分辨率, XY 容差, 默认输出 Z 值, 输出包含 Z 值, Z 分辨率, Z 容差, 传输字段域、子类型和属性规则