ListUsers

描述

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

讨论

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

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

语法

ListUsers (sde_workspace)

参数	说明	数据类型
sde_workspace	企业级地理数据库（sde 连接文件）。 在企业级地理数据库中指定的连接文件必须具有允许用户断开其他连接的管理权限。	String

返回值

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

代码示例

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)