Mis on PostgreSQL ühendusstring?

PostgreSQL ühendusstring on vormindatud tekstijupp, mis koondab kõik andmebaasiga ühendamiseks vajalikud andmed — hostinimi, port, mandaadid, andmebaasi nimi ja SSL-i seaded — üheks väärtuseks. Rakendused, ORM-id ja käsurea tööriistad kasutavad ühendusstringe andmebaasi seansside loomiseks ilma, et iga parameeter oleks vaja eraldi konfigureerida. On kaks levinud vormingut: URI-vorming (postgresql://user:password@host:port/dbname) ja libpq võtme=väärtuse vorming (host=localhost port=5432 dbname=mydb). Mõlemaid vorminguid toetavad praktiliselt kõik PostgreSQL kliendi teegid.

Tööriista kirjeldus

See tööriist loob kehtivaid PostgreSQL ühendusstringe üksikutest parameetritest. Täitke host, port, mandaadid, andmebaasi nimi ja SSL-i režiim, ja see loob koheselt kolm kasutamisvalmis väljundit: ühendus-URL, psql käsk ja libpq võtme=väärtuse string.

Näited

Sisend:

Väli Väärtus
Host db.example.com
Port 5432
Kasutajanimi alice
Parool s3cr3t
Andmebaas production
SSL-i režiim require

Ühendus-URL:

postgresql://alice:s3cr3t@db.example.com/production?sslmode=require

psql käsk:

psql "postgresql://alice:s3cr3t@db.example.com/production?sslmode=require"

libpq võtme=väärtuse string:

host=db.example.com port=5432 dbname=production user=alice password=s3cr3t sslmode=require

Funktsioonid

  • Kolm väljundvormingut: Loob samaaegselt ühendus-URL-i, psql shell-käsu ja libpq võtme=väärtuse stringi
  • SSL-i režiimi valija: Toetab kõiki kuut PostgreSQL SSL-i režiimi — disable, allow, prefer, require, verify-ca ja verify-full
  • Nutikad vaikeväärtused: Jätab välja vaikeväärtused (port 5432, sslmode=prefer), et hoida väljundit puhtana ja minimaalsena
  • URL-i kodeerimine: Kodeerib automaatselt protsendiga kasutajanimed, paroolid ja andmebaasi nimed, mis sisaldavad erimärke
  • Pordi valideerimine: Kontrollib, et port on arv vahemikus 1 kuni 65535

Kasutamise juhtumid

  • Rakenduse konfigureerimine: Looge DATABASE_URL keskkonna muutuja raamistikele nagu Django, Rails või mis tahes rakendusele, mis kasutab ühendusstringe
  • Kiire CLI juurdepääs: Looge valmis käitatav psql käsk kaugandmebaasiga ühendamiseks ilma URI-süntaksi meeldejätmiseta
  • Ühenduse silumine: Looge libpq string ühenduste testimiseks madala taseme draiverite või tööriistadega, mis ei aktsepteeri URI-vormingut

SSL-i režiimid selgitatud

Režiim Kirjeldus
disable SSL puudub. Ühendus on krüpteerimata.
allow Kasutab SSL-i, kui server seda nõuab; muul juhul ühendub ilma SSL-ita.
prefer Proovib esmalt SSL-i; langeb tagasi krüpteerimata ühendusele (vaikimisi).
require Nõuab SSL-i, kuid ei kontrolli serveri sertifikaati.
verify-ca Nõuab SSL-i ja kontrollib, et serveri sertifikaat on allkirjastatud usaldusväärse CA-ga.
verify-full Nõuab SSL-i, kontrollib CA-d ja kontrollib ka, et hostinimi vastab sertifikaadile.