ListUsers (arcpy)

Резюме

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

Обсуждение

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

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

Синтаксис

ListUsers (sde_workspace)

Параметр	Объяснение	Тип данных
sde_workspace	Многопользовательская база геоданных (файл подключения sde). Свойства подключения, заданные в многопользовательской базе геоданных, должны иметь права администратора, которые бы позволяли пользователю отключать другие подключения.	String

Возвращено значение

Тип данных

Объяснение

tuple

Функция ListUsers возвращает список именованных кортежей. Каждый из возвращаемых кортежей имеет следующие пять элементов: Имя (Name) Datatype Описание ClientName Строка Имя клиентской машины (Client Machine), с которой осуществляется подключение. ConnectionTime Дата и время Время, когда пользователь выполнил начальное подключение к базе геоданных. Идентификатор Целочисленное (Integer) Идентификатор SDE подключения. Для идентификации пользователей, которых вы хотите отключить, используйте это значение для функции DisconnectUser. IsDirectConnection Логический Возвращает True, если подключение является прямым (двухуровневым, two-tier). Возвращает False, если подключение является подключением к серверу приложений (трехуровневым, three-tier). Имя (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

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

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)