Query AACT with pgAdmin

pgAdmin is a free, reliable, open source graphical query tool that can be used to access any postgreSQL database. A wealth of information about pgAdmin is available on the internet including the pgAdmin III Documenation Website. Using pgAdmin necessitates that you install postgreSQL on your local machine, even though you need not download the AACT database to your local machine. Use of this tool assumes a basic understanding of SQL.


Install Database Platform: PostgreSQL

AACT is currently running on version 11.1 of PostgreSQL; it's recommended you install this version or higher. Refer to PostgreSQL Downloads for free software and installation instructions.


Install Database Query Tool: pgAdmin3

Get a current version from the pgAdmin site.

Download packages for MacOS are available here.

Download packages for Windows are available here.

The following instructions present examples for pgAdmin3 on a PC. Screenshots will appear differently for other versions and/or operating systems.


Establish a Connection to AACT

Once pgAdmin3 is installed, launch the application and click on the plug icon in the upper left of the top menu bar.

Plug icon

Enter "New Server Registration" info with the following credentials and press [OK] in the lower right of the dialog box.


Hostname: aact-db.ctti-clinicaltrials.org Port: 5432 Database name: aact User name: (sign up/in to get a username) Password: 'your AACT password'


Confirm Connection

Click the AACT server icon that was just created in the left pane and scroll to the property in the right pane to confirm that 'Connected?' status is 'Yes'.


Select the AACT Database

Double click the AACT server icon to expand the folder. Under 'Databases', click AACT. (Note: There might be a red x over the database icon when you first navigate to this structure. It should go away after being clicked.)


Open Query Window

With the AACT database selected, click the 'SQL' icon from the top menu bar.

New query

This will trigger a popout dialog tool that allows you to enter SQL queries.



Execute Query

Enter queries in the SQL Editor in the upper left, and run them against the AACT database by pressing the green triangular play button.


A simple example of a query that returns the number of studies in the AACT database: