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

Пример кода

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

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

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)