ArcMap

ListUsers

Краткая информация

Возвращает список именованных кортежей, содержащих информацию о пользователях, подключенных в данный момент к многопользовательской базе геоданных.

Описание

Функция ListUsers используется пользователем-администратором для идентификации пользователей, которые в настоящий момент подключены к многопользовательской базе геоданных.

  • Функция ListUsers должна использовать административное подключение к базе данных.
  • Если эту функцию пытается выполнить не пользователь-администратор, функция завершается с ошибкой.

Синтаксис

ListUsers (sde_workspace)
ПараметрОбъяснениеТип данных
sde_workspace

Многопользовательская база геоданных (файл подключения sde).

Свойства подключения, заданные в многопользовательской базе геоданных, должны иметь права администратора, которые бы позволяли пользователю отключать другие подключения.

String

Значение отраженного сигнала

Тип данныхОбъяснение
tuple

Функция ListUsers возвращает список именованных кортежей. Каждый из возвращаемых кортежей имеет следующие пять элементов:

ИмяТип данныхОписание

ClientName

String

Имя клиентской машины, с которой осуществляется подключение.

ConnectionTime

Дата и время

Время, когда пользователь выполнил начальное подключение к базе геоданных.

ID

Integer

Идентификатор SDE подключения. Для идентификации пользователей, которых вы хотите отключить, используйте это значение для DisconnectUser.

IsDirectConnection

Boolean

Возвращает True, если подключение является прямым (двухуровневым, two-tier). Возвращает False, если подключение является подключением к серверу приложений (трехуровневым, three-tier).

Name

String

Имя пользователя, подключенного к базе данных.

Пример кода

Пример 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

Следующий пример демонстрирует, как создать новый список только идентификаторов SDE из списка, возвращенного с помощью ListUsers.

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)

Связанные разделы