Navigation

Deprecation: legacy connection strings

Two years ago we made an upgrade to our edge infrastructure that enabled better performance and reliability for your database connections.

A small number of databases are still using connection strings from before this change. In the coming weeks we are working on deprecating the usage of these strings and getting everyone upgraded.

Does this impact my database?

We are sending emails to all account admins for databases which are still connecting via legacy strings.

You may also check the hostname for your connection string. If it shows the ID for the database branch, then it is a legacy string.

Examples:

How to update my connection string?

To update your connection string, go to the PlanetScale dashboard -> your database -> settings -> passwords.

Create a new password and update the hostname, username and password in your application.

What happens if I do not upgrade?

We will be performing multiple brownout periods starting September 3rd, 2024. During these, connections to your database will stop working.

The purpose of the brownout periods is to help alert anyone who is still unintentionally using a legacy connection string.

After several brownout periods, we will re-evaluate usage again and send final notices to anyone still using a legacy connection string before fully deprecating.

pscale CLI

If you are using an old version of the pscale CLI, you may see the following message when trying to use pscale shell or pscale connect.

Your version of pscale is too old and is using a deprecated connection method. Please update your CLI version.

If this impacts you, please update pscale to the latest version.

Need help?

We want this process to be simple and painless for everyone. If this causes any difficulties for you, please reach out to our support team.

Read more