ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

ListUsers

  • Summary
  • Discussion
  • Syntax
  • Code sample

Summary

Returns a list of named tuples containing information for users who are connected to an enterprise geodatabase.

Discussion

The ListUsers function is used by an administrative user to identify users who are currently connected to an enterprise geodatabase.

  • The ListUsers function must utilize an administrative connection to the database.
  • This function will fail if attempted by a nonadministrative user.

Syntax

ListUsers (sde_workspace)
ParameterExplanationData Type
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

Return Value

Data TypeExplanation
tuple

The ListUsers function returns a list of named tuples. The named tuples returned each have the following five items:

NameDatatypeDescription

ClientName

String

Name of the client machine from where the connection is being made.

ConnectionTime

Datetime

The time when the user made the initial connection to the geodatabase.

ID

Integer

The SDE connection identifier. This is the value that can be used in the DisconnectUser function to identify the user to disconnect.

IsDirectConnection

Boolean

True if the connection is a direct connection (two-tier). False if the connection is an application server connection (three-tier).

Name

String

The name of the user who is connected to the database.

Code sample

ListUsers example 1
import arcpy

arcpy.ListUsers("C:\\MyProject\\admin.sde")
ListUsers example 2

The following example demonstrates how to print a list of connected users along with their connection time.

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 example 3

The following example demonstrates how to generate a new list of only SDE IDs from the list returned by 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)

Related topics

  • AcceptConnections
  • DisconnectUser

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2021 Esri. | Privacy | Legal