ListUsers

摘要

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

说明

管理用户使用 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 整型 企业级数据库连接标识符。 此标识符可在 DisconnectUser 函数中用于确定断开连接的用户。 IsDirectConnection 布尔 如果连接是直接连接（两层），则为 True。 如果连接为应用程序服务器连接（三层），则为 False。 名称 字符串 连接到数据库的用户的名称。

代码示例

ListUsers 示例 1

import arcpy

arcpy.ListUsers("C:\\MyProject\\admin.sde")

ListUsers 示例 2

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

import arcpy

users = arcpy.ListUsers("C:\\MyProject\\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 = "C:\\MyProject\\admin.sde"
admin = arcpy.env.workspace

# Create a list of users
users = arcpy.ListUsers(admin)

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