Can't Figure Out DB URI Postgres Azure


I recently spun up a Postgres database on Azure and I’m having a lot of trouble figuring out my DB URI. The creds look something like:


User (admin role): admin@name

Password: mypassword

DB name: postgres

So I’m trying to use psql and pass in the connection string, psql postgresql://admin@name:[email protected]:5432/postgres

But it’s giving me an error

psql: could not translate host name “name” to address: nodename nor
servname provided, or not known

Interestingly enough, this works:

psql -h -p 5432 -U admin@name postgres

The reason why I ask is because I want to use Python and sqlalchemy and want to pass in the DB uri string.

Asked By: Vincent



Per my experience, the error of using connection url as connection string for psql was caused by the psql connection string parser using Greed-Pattern algorithm.

According to the subsection 31.1.2. Parameter Key Words for psql connection string, the user parameter key word is defined as below.


PostgreSQL user name to connect as. Defaults to be the same as the operating system name of the user running the application.

The user naming need to match the regular expression
configured via the NAME_REGEX configuration variable, as below, please see the document Linux Username Conventions to know the details.


User and group names are checked against this regular
expression. If the name doesnt match this regexp, user and
group creation in adduser is refused unless –force-badname is
set. With –force-badname set, only weak checks are performed.
The default is the most conservative ^[a-z][-a-z0-9]*$.

So the postgres user name on Azure is not a standard Unix-like name, which match Azure user naming pattern username@servname for Azure services, such as FTP for Azure App service, Azure SQL Database, and Postgres on Azure, etc.

The above cause that the Azure postgres connection url is not Compatible with psql tool, but don’t worry about using Python with psycopg2, you can refer to the offical tutorial Azure Database for PostgreSQL: Use Python to connect and query data to know it.

Answered By: Peter Pan

Ok at least for me, this works. Posting here in case others run into the same issue.

  1. For connecting to SQLAlchemy passing in this DB URI worked for me:
    postgresql://user:password@hostname:port/dbname. For example,

postgresql://admin@name:[email protected]:5432/postgres

  1. For using psql in command line, the following worked for me:
    psql “dbname=postgres user=admin@name password=password port=5432”

Note, be careful to escape any special characters (e.g. for your password). For example, I’m using a bash shell and having special characters threw some weird oddities.

  1. For connecting to psycopg2 I followed the instructions here:

You can also parse a URL following the instructions here: Connect to an URI in postgres

Answered By: Vincent

I was running into issues where this was hard using rfc3986_parser in a Docker image I had to use. So in the end I just URLEncoded the first @, in the URL. %40 seemed to make it through the parser and was able to connect then. Guess the Parser splits by @.

Answered By: Beararmy
Categories: questions Tags: , , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.