创建数据库序列 (数据管理)

摘要

在地理数据库中创建数据库序列。 可以在访问地理数据库的自定义应用程序中使用序列。

使用情况

  • 此工具可用于 IBM Db2Microsoft SQL ServerOraclePostgreSQLSAP HANA 中的文件地理数据库、移动地理数据库和企业级地理数据库。

  • 可使用 ListDatabaseSequences 函数获取文件地理数据库中的数据库序列列表。 由于序列名称必须唯一,因此,为避免重命,需要在创建新序列之前获取现有序列列表。

参数

标注说明数据类型
输入工作空间

文件、移动或企业级地理数据库,将在其中创建序列。 对于企业级地理数据库,工作空间是用于连接到要在其中创建序列的企业级地理数据库的数据库连接文件 (.sde),或文件地理数据库的路径(包括文件地理数据库名称)。

对于数据库连接,在数据库连接中指定的用户将是序列的所有者,并且必须在数据库中具有以下权限:

  • Db2 - 对其方案的 CREATEIN 权限
  • Oracle - CREATE SEQUENCE 系统权限
  • PostgreSQL - 对其方案的权限
  • SAP HANA - 必须是标准用户
  • SQL Server - CREATE SEQUENCE 权限以及对其方案的 ALTER OR CONTROL 权限

Workspace
序列名称

将被分配给数据库序列的名称。 对于企业级地理数据库,该名称必须符合当前使用的数据库平台的序列名称要求,并且在数据库中必须唯一。 对于文件地理数据库,该名称在文件地理数据库中必须唯一。 牢记此名称,因为在自定义应用程序和表达式中调用序列时小使用该名称。

String
序列起始 ID
(可选)

序列的起始编号。 如果未提供起始编号,则序列从 1 开始。 如果您确实提供了起始编号,则其必须大于 0。

Long
序列增量值
(可选)

描述序号的递增方式。 例如,如果序列从 10 开始且增量值为 5,则序列中的下一个值为 15,之后下一个值为 20。 如果未指定增量值,则序列增量值将为 1。

Long

派生输出

标注说明数据类型
地理数据库中已创建的序列

已更新的输入工作空间。

Workspace

arcpy.management.CreateDatabaseSequence(in_workspace, seq_name, {seq_start_id}, {seq_inc_value})
名称说明数据类型
in_workspace

文件、移动或企业级地理数据库,将在其中创建序列。 对于企业级地理数据库,工作空间是用于连接到要在其中创建序列的企业级地理数据库的数据库连接文件 (.sde),或文件地理数据库的路径(包括文件地理数据库名称)。

对于数据库连接,在数据库连接中指定的用户将是序列的所有者,并且必须在数据库中具有以下权限:

  • Db2 - 对其方案的 CREATEIN 权限
  • Oracle - CREATE SEQUENCE 系统权限
  • PostgreSQL - 对其方案的权限
  • SAP HANA - 必须是标准用户
  • SQL Server - CREATE SEQUENCE 权限以及对其方案的 ALTER OR CONTROL 权限

Workspace
seq_name

将被分配给数据库序列的名称。 对于企业级地理数据库,该名称必须符合当前使用的数据库平台的序列名称要求,并且在数据库中必须唯一。 对于文件地理数据库,该名称在文件地理数据库中必须唯一。 牢记此名称,因为在自定义应用程序和表达式中调用序列时小使用该名称。

String
seq_start_id
(可选)

序列的起始编号。 如果未提供起始编号,则序列从 1 开始。 如果您确实提供了起始编号,则其必须大于 0。

Long
seq_inc_value
(可选)

描述序号的递增方式。 例如,如果序列从 10 开始且增量值为 5,则序列中的下一个值为 15,之后下一个值为 20。 如果未指定增量值,则序列增量值将为 1。

Long

派生输出

名称说明数据类型
out_workspace

已更新的输入工作空间。

Workspace

代码示例

CreateDatabaseSequence 示例(Python 窗口)

创建名为 custom_sequence 的数据库序列,从 1 开始并且增量值为 1。

import arcpy
arcpy.management.CreateDatabaseSequence(r"C:/myconnections/mygdb.sde", 
                                        "custom_sequence", 1, 1)
CreateDatabaseSequence 示例(Python 窗口)

在 myfilegdb 的文件地理数据库中,创建名为 my_ids 的数据库序列,该序列以 1 开头,增量为 1。

import arcpy
arcpy.management.CreateDatabaseSequence(r"C:/geodatabases/myfilegdb.gdb", 
                                        "my_ids", 1, 1)

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题