Hva er en PostgreSQL-tilkoblingstreng?

En PostgreSQL-tilkoblingstreng er en formatert tekstbit som samler all informasjonen som trengs for å koble til en database — vertsnavn, port, legitimasjon, databasenavn og SSL-innstillinger — i en enkelt verdi. Applikasjoner, ORMer og kommandolinjeverktøy bruker tilkoblingsstrengen til å etablere databaseøkter uten at hver parameter må konfigureres separat. Det finnes to vanlige formater: URI-formatet (postgresql://user:password@host:port/dbname) og libpq nøkkel=verdi-formatet (host=localhost port=5432 dbname=mydb). Begge formater støttes av praktisk talt alle PostgreSQL-klientbiblioteker.

Verktøybeskrivelse

Dette verktøyet genererer gyldige PostgreSQL-tilkoblingsstrengen fra individuelle parametere. Fyll inn verten, porten, legitimasjonen, databasenavnet og SSL-modus, og det produserer umiddelbart tre klare utganger: en tilkoblings-URL, en psql-kommando og en libpq nøkkel=verdi-streng.

Eksempler

Inndata:

Felt Verdi
Vert db.example.com
Port 5432
Brukernavn alice
Passord s3cr3t
Database production
SSL-modus require

Tilkoblings-URL:

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

psql-kommando:

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

libpq nøkkel=verdi-streng:

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

Funksjoner

  • Tre utdataformater: Genererer en tilkoblings-URL, psql shell-kommando og libpq nøkkel=verdi-streng samtidig
  • SSL-modusvelger: Støtter alle seks PostgreSQL SSL-moduser — disable, allow, prefer, require, verify-ca og verify-full
  • Smarte standarder: Utelater standardverdier (port 5432, sslmode=prefer) for å holde utdataene ren og minimal
  • URL-koding: Koder automatisk prosent brukernavn, passord og databasenavn som inneholder spesialtegn
  • Portvalidering: Validerer at porten er et tall mellom 1 og 65535

Brukstilfeller

  • Applikasjonskonfigurering: Generer en DATABASE_URL-miljøvariabel for rammeverk som Django, Rails eller enhver app som bruker en tilkoblingstreng
  • Rask CLI-tilgang: Produser en klar psql-kommando for å koble til en ekstern database uten å måtte huske URI-syntaks
  • Tilkoblingsfeilsøking: Bygg en libpq-streng for å teste tilkoblinger med lavnivådrivere eller verktøy som ikke godtar URI-format

SSL-moduser forklart

Modus Beskrivelse
disable Ingen SSL. Tilkoblingen er ukryptert.
allow Bruker SSL hvis serveren krever det; ellers kobler til uten SSL.
prefer Prøver SSL først; faller tilbake til ukryptert (standard).
require Krever SSL men verifiserer ikke serverens sertifikat.
verify-ca Krever SSL og verifiserer at serverens sertifikat er signert av en pålitelig CA.
verify-full Krever SSL, verifiserer CA-en, og sjekker også at vertsnavn samsvarer med sertifikatet.