ListUsers (arcpy)

摘要

返回一组指定的元组，其中包含连接到企业级地理数据库的所有用户的信息。

讨论

管理用户使用 ListUsers 函数来确定当前连接到企业级地理数据库的用户。

• ListUsers 函数必须使用数据库的管理连接。
• 如果由非管理员用户尝试进行使用，则该函数将失败。

语法

ListUsers (sde_workspace)

参数	说明	数据类型
sde_workspace	An enterprise geodatabase (sde connection file). The connection properties specified in the enterprise geodatabase must have administrative rights that allow the user to disconnect other connections.	String

返回值

数据类型	说明
tuple	ListUsers 函数可返回指定元组列表。返回的指定元组分别包含以下五项： 名称 数据类型 说明 客户端名称 字符串 建立连接的客户端计算机的名称。 连接时间 日期时间 用户与地理数据库建立初始连接的时间。 ID 整型 SDE 连接标识符。此标识符可在 DisconnectUser 函数中用于确定断开连接的用户。 IsDirectConnection 布尔型 如果连接为直连（两层），则为 True。如果连接为应用程序服务器连接（三层），则为 False。 名称 字符串 连接到数据库的用户的名称。

代码实例

ListUsers 示例 1

import arcpy

arcpy.ListUsers("Database Connections/admin.sde")

ListUsers 示例 2

以下示例说明如何连同连接时间一起输出连接用户的列表。

import arcpy

users = arcpy.ListUsers("Database Connections/admin.sde")
for user in users:
    print("Username: {0}, Connected at: {1}".format(
        user.Name, user.ConnectionTime))

ListUsers 示例 3

以下示例说明如何从 ListUsers 返回的列表中生成一个新的仅含有 SDE ID 的列表。

import arcpy

# Set the admistrative workspace connection
arcpy.env.workspace = "Database Connections/[e-mail]"

# Create a list of users
'''
NOTE: When the arcpy.env.workspace environment is set, a workspace
does not need to be provided to the function.
'''
users = arcpy.ListUsers()

# Create a list of SDE ID's.
# Use a list comprehension to get the ID values in a new list.
id_users = [user.ID for user in users]
print(id_users)