ArcMap

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("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/tenone@sde.sde"

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

相关主题