ArcMap

ListUsers

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

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

Описание

Функция 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/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)

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