pgbouncer – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pgbouncer – leichter Verbindungspooler für PostgreSQL

ZUSAMMENFASSUNG

pgbouncer [-d][-R][-v][-u Benutzer]
pgbouncer -V|-h

Auf Windows-Computern gibt es folgende Optionen:

pgbouncer.exe [-v][-u Benutzer]
pgbouncer.exe -V|-h

Zusätzliche Möglichkeiten zum Einrichten eines Windows-Dienstes:

pgbouncer.exe --regservice
pgbouncer.exe --unregservice

BESCHREIBUNG

pgbouncer ist ein PostgreSQL-Verbindungspooler. Es kann eine Verbindung zu jeder Zielanwendung hergestellt werden
pgbouncer als wäre es ein PostgreSQL-Server, und pgbouncer wird eine Verbindung zum herstellen
tatsächlicher Server, oder es wird eine seiner vorhandenen Verbindungen wiederverwenden.

Das Ziel pgbouncer besteht darin, die Auswirkungen auf die Leistung durch das Öffnen neuer Verbindungen zu verringern
PostgreSQL

Um die Transaktionssemantik für das Verbindungspooling nicht zu gefährden, pgbouncer
unterstützt verschiedene Arten von Pooling beim Rotieren von Verbindungen:

Session Pooling
Höflichste Methode. Wenn der Client eine Verbindung herstellt, wird ihm eine Serververbindung zugewiesen
Es bleibt für die gesamte Dauer der Verbindung des Clients bestehen. Wenn der Client die Verbindung trennt,
Die Serververbindung wird wieder in den Pool aufgenommen. Dies ist die Standardmethode.

Transaktion Pooling
Eine Serververbindung wird dem Client nur während einer Transaktion zugewiesen. Wenn
Wenn PgBouncer feststellt, dass die Transaktion beendet ist, wird die Serververbindung wiederhergestellt
in den Pool.

Erklärung Pooling
Die aggressivste Methode. Die Serververbindung wird wieder in den Pool gestellt
unmittelbar nach Abschluss einer Abfrage. Transaktionen mit mehreren Kontoauszügen sind nicht zulässig
diesen Modus, da sie kaputt gehen würden.

Die Administrationsoberfläche von pgbouncer besteht aus einigen neuen SHOW Befehle verfügbar
bei Verbindung mit einer speziellen „virtuellen“ Datenbank pgbouncer.

SCHNELLSTART

Grundlegende Einrichtung und Verwendung wie folgt.

1. Erstellen Sie eine pgbouncer.ini-Datei. Details in pgbouncer(5). Einfaches Beispiel:

[Datenbanken]
template1 = host=127.0.0.1 port=5432 dbname=template1

[pgbouncer]
listen_port = 6543
listen_addr = 127.0.0.1
auth_type = md5
auth_file = Benutzer.txt
logfile = pgbouncer.log
pidfile = pgbouncer.pid
admin_users = someuser

2. Erstellen user.txt Datei, die Benutzer enthält, die zugelassen sind in:

„someuser“ „same_password_as_in_server“

3. Starten pgbouncer:

$ pgbouncer -d pgbouncer.ini

4. Lassen Sie Ihre Bewerbung (bzw psql Client) eine Verbindung herstellen pgbouncer statt direkt zu
PostgreSQL-Server:

$ psql -p 6543 -U someuser template1

5. Verwalten pgbouncer durch Verbindung mit der speziellen Verwaltungsdatenbank pgbouncer und
Ausgabe erklären Hilfe; beginnen:

$ psql -p 6543 -U someuser pgbouncer
pgbouncer=# Hilfe anzeigen;
HINWEIS: Konsolennutzung
DETAIL:
SHOW [HILFE|KONFIGURATION|DATENBANKEN|FDS|POOLS|CLIENTS|SERVER|SOCKETS|LISTEN|VERSION]
SET-Taste = arg
NEU LADEN
PAUSE
AUSSETZEN
LEBENSLAUF
Schließung

6. Wenn Sie Änderungen an der Datei pgbouncer.ini vorgenommen haben, können Sie sie neu laden mit:

pgbouncer=# RELOAD;

COMMAND LINE SWITCHES

-d Im Hintergrund laufen. Ohne sie läuft der Prozess im Vordergrund. Hinweis: Nicht möglich
Arbeiten unter Windows, pgbouncer muss dort als Dienst laufen.

-R Führen Sie einen Online-Neustart durch. Das bedeutet, dass Sie eine Verbindung zum laufenden Prozess herstellen und den laden
Öffnen Sie daraus Sockets und verwenden Sie sie dann. Wenn kein aktiver Prozess vorhanden ist, starten Sie
normalerweise. Hinweis: Funktioniert nur, wenn das Betriebssystem Unix-Sockets unterstützt unix_socket_dir is
in der Konfiguration nicht deaktiviert. Funktioniert nicht auf Windows-Rechnern. Funktioniert nicht mit TLS
Verbindungen werden gelöscht.

-u Benutzer
Wechseln Sie beim Start zum angegebenen Benutzer.

-v Erhöhen Sie die Ausführlichkeit. Kann mehrfach verwendet werden.

-q Seien Sie ruhig – melden Sie sich nicht bei stdout an. Beachten Sie, dass sich dies nicht nur auf die Ausführlichkeit der Protokollierung auswirkt
Diese Standardausgabe darf nicht verwendet werden. Zur Verwendung in init.d-Skripten.

-V Version anzeigen.

-h Kurzhilfe anzeigen.

--regservice
Win32: Registrieren Sie pgbouncer zur Ausführung als Windows-Dienst. Der Dienstname Config
Der Parameterwert wird als Name für die Registrierung verwendet.

--unregservice
Win32: Registrierung des Windows-Dienstes aufheben.

ADMINISTRATOR KONSOLE

Die Konsole ist verfügbar, indem wie gewohnt eine Verbindung zur Datenbank hergestellt wird pgbouncer:

$ psql -p 6543 pgbouncer

Nur in den Konfigurationsparametern aufgeführte Benutzer admin_users or stats_users dürfen
Melden Sie sich an der Konsole an. (Ausser wenn auth_mode=any, dann ist jeder Benutzer als zugelassen
stats_user.)

Zusätzlich der Benutzername pgbouncer ist es erlaubt, sich ohne Passwort anzumelden, wenn die Anmeldung erfolgt ist
kommt über einen Unix-Socket und der Client hat dieselbe Unix-Benutzer-UID wie der laufende Prozess.

Anzeigen Befehle
Die SHOW Befehle geben Informationen aus. Jeder Befehl wird unten beschrieben.

SHOW STATISTIKEN;
Zeigt Statistiken an.

Datenbank
Statistiken werden pro Datenbank angezeigt.

total_requests
Gesamtzahl der gepoolten SQL-Anfragen pgbouncer.

total_received
Gesamtvolumen des empfangenen Netzwerkverkehrs in Bytes pgbouncer.

total_gesendet
Gesamtvolumen des gesendeten Netzwerkverkehrs in Bytes pgbouncer.

total_query_time
Gesamtzahl der Mikrosekunden, die von verbracht wurden pgbouncer wenn aktiv verbunden mit
PostgreSQL

avg_req
Durchschnittliche Anfragen pro Sekunde im letzten Statistikzeitraum.

avg_recv
Durchschnittlich empfangene (von Clients) Bytes pro Sekunde.

avg_sent
Durchschnittlich gesendete (an Clients) Bytes pro Sekunde.

avg_query
Durchschnittliche Abfragedauer in Mikrosekunden.

SHOW Server;
tippe S, für Server.

Benutzer Benutzername pgbouncer Wird verwendet, um eine Verbindung zum Server herzustellen.

Datenbank
Name der Datenbank.

Zustand Status der pgbouncer-Serververbindung, einer von aktiv, benutzt or Leerlauf.

Adr IP-Adresse des PostgreSQL-Servers.

port Port des PostgreSQL-Servers.

local_addr
Verbindungsstartadresse auf dem lokalen Computer.

lokaler_port
Verbindungsstartport auf dem lokalen Computer.

connect_time
Als die Verbindung hergestellt wurde.

request_time
Wann die letzte Anfrage gestellt wurde.

ptr Adresse des internen Objekts für diese Verbindung. Wird als eindeutige ID verwendet.

Link Adresse der Clientverbindung, mit der der Server gekoppelt ist.

remote_pid
Pid des Backend-Serverprozesses. Falls die Verbindung über einen Unix-Socket und ein Betriebssystem erfolgt
Unterstützt das Abrufen von Prozess-ID-Informationen, es ist die Betriebssystem-PID. Andernfalls wird es extrahiert
Vom Server gesendete Pakete abbrechen. Dies sollte eine PID sein, falls der Server Postgres ist, aber das ist der Fall
eine Zufallszahl für den Fall, dass der Server einen anderen PgBouncer verwendet.

SHOW KUNDEN;
tippe C, für Kunde.

Benutzer Mit dem Client verbundener Benutzer.

Datenbank
Name der Datenbank.

Zustand Status der Clientverbindung, einer von aktiv, benutzt, gewartet or Leerlauf.

Adr IP-Adresse des Clients.

port Port, mit dem der Client verbunden ist.

local_addr
Verbindungsendadresse auf dem lokalen Computer.

lokaler_port
Verbindungsendport auf dem lokalen Computer.

connect_time
Zeitstempel der Verbindungszeit.

request_time
Zeitstempel der letzten Clientanfrage.

ptr Adresse des internen Objekts für diese Verbindung. Wird als eindeutige ID verwendet.

Link Adresse der Serververbindung, mit der der Client gekoppelt ist.

remote_pid
Prozess-ID, falls der Client eine Verbindung über einen UNIX-Socket herstellt und das Betriebssystem den Abruf unterstützt.

SHOW POOLS;
Für jedes Paar (Datenbank, Benutzer) wird ein neuer Pooleintrag erstellt.

Datenbank
Name der Datenbank.

Benutzer Nutzername.

cl_active
Clientverbindungen, die mit der Serververbindung verknüpft sind und Abfragen verarbeiten können.

cl_waiting
Clientverbindungen haben Anfragen gesendet, aber noch keine Serververbindung erhalten.

sv_active
Serververbindungen, die mit dem Client verknüpft sind.

sv_idle
Serververbindungen, die ungenutzt und sofort für Client-Anfragen nutzbar sind.

sv_used
Serververbindungen, die mehr als inaktiv waren server_check_delay, also brauchen sie
server_check_query darauf ausgeführt werden, bevor es verwendet werden kann.

sv_tested
Serververbindungen, die derzeit ausgeführt werden server_reset_query or
server_check_query.

sv_login
Serververbindungen werden derzeit angemeldet.

maxwait
Wie lange der erste (älteste) Client in der Warteschlange gewartet hat, in Sekunden. Wenn das anfängt
zunimmt, verarbeitet der aktuelle Serverpool Anfragen nicht schnell genug.
Der Grund kann entweder ein überlasteter Server oder einfach ein zu kleiner Server sein Pool Größe Einstellung.

pool_mode
Der verwendete Pooling-Modus.

SHOW LISTEN;
Folgende interne Informationen in Spalten (nicht in Zeilen) anzeigen:

Datenbanken
Anzahl der Datenbanken.

Nutzer Anzahl der Benutzer.

Schwimmbäder Anzahl der Pools.

free_clients
Anzahl der kostenlosen Kunden.

used_clients
Anzahl der verwendeten Clients.

login_clients
Anzahl der Kunden login Zustand.

free_servers
Anzahl der freien Server.

used_servers
Anzahl der verwendeten Server.

SHOW BENUTZER;
Name Der Nutzername

pool_mode
Der überschreibende pool_mode des Benutzers oder NULL, wenn stattdessen die Standardeinstellung verwendet wird.

SHOW DATENBANKEN;
Name Name des konfigurierten Datenbankeintrags.

Gastgeber Host pgbouncer stellt eine Verbindung her.

port Port, mit dem pgbouncer eine Verbindung herstellt.

Datenbank
Tatsächlicher Datenbankname, mit dem pgbouncer eine Verbindung herstellt.

force_user
Wenn der Benutzer Teil der Verbindungszeichenfolge ist, wird die Verbindung zwischen pgbouncer und
PostgreSQL wird auf den angegebenen Benutzer festgelegt, unabhängig vom Clientbenutzer.

Pool Größe
Maximale Anzahl von Serververbindungen.

pool_mode
Der Überschreibungsmodus „pool_mode“ der Datenbank oder NULL, wenn stattdessen der Standardwert verwendet wird.

SHOW FDS;
Interner Befehl – ​​zeigt die Liste der verwendeten FDS mit angehängtem internem Status an.

Wenn der verbundene Benutzer den Benutzernamen „pgbouncer“ hat, stellt er eine Verbindung über den Unix-Socket her und hat
Dieselbe UID wie der laufende Prozess, die tatsächlichen FDS werden über die Verbindung übergeben. Das
Der Mechanismus wird verwendet, um einen Online-Neustart durchzuführen. Hinweis: Dies funktioniert nicht auf Windows-Rechnern.

Dieser Befehl blockiert auch die interne Ereignisschleife und sollte daher nicht verwendet werden, während PgBouncer aktiv ist
in Benutzung.

fd Numerischer Wert des Dateideskriptors.

Projektauftrag Hauptvorteile von Pooler, Auftraggeber or Server.

Benutzer Benutzer der Verbindung über das FD.

Datenbank
Datenbank der Verbindung über das FD.

Adr IP-Adresse der Verbindung über das FD, Unix wenn ein Unix-Socket verwendet wird.

port Port, der von der Verbindung über das FD verwendet wird.

stornieren Abbruchtaste für diese Verbindung.

Link fd für den entsprechenden Server/Client. NULL, wenn inaktiv.

SHOW KONFIG;
Zeigt die aktuellen Konfigurationseinstellungen an, eine pro Zeile, mit den folgenden Spalten:

Haupt Name der Konfigurationsvariablen

Wert Konfigurationswert

änderbar
Entweder ja or nicht, zeigt an, ob die Variable während der Ausführung geändert werden kann. Wenn nichtden
Variable kann nur beim Booten geändert werden.

SHOW DNS_HOSTS;
Hostnamen im DNS-Cache anzeigen.

hostname
Hostname

ttl Wie viele Sekunden bis zur nächsten Suche.

Adresse Durch Kommas getrennte Liste von Adressen.

SHOW DNS_ZONES
DNS-Zonen im Cache anzeigen.

Zonenname
Zonenname.

seriell Aktuelle Seriennummer.

zählen Hostnamen, die zu dieser Zone gehören.

Prozess verbinden Befehle
PAUSE [db];
PgBouncer versucht, die Verbindung zu allen Servern zu trennen und wartet zunächst darauf, dass alle Abfragen abgeschlossen sind.
Der Befehl wird erst zurückgegeben, wenn alle Abfragen abgeschlossen sind. Zu verwenden zum Zeitpunkt von
Neustart der Datenbank.

Wenn ein Datenbankname angegeben wird, wird nur diese Datenbank angehalten.

DEAKTIVIEREN DB;
Alle neuen Clientverbindungen in der angegebenen Datenbank ablehnen.

AKTIVIEREN DB;
Erlauben Sie neue Clientverbindungen nach einer vorherigen DEAKTIVIEREN Befehl.

KILL DB;
Trennen Sie sofort alle Client- und Serververbindungen zur angegebenen Datenbank.

AUSSETZEN;
Alle Socket-Puffer werden geleert und PgBouncer hört auf, darauf auf Daten zu warten. Der
Der Befehl wird erst zurückgegeben, wenn alle Puffer leer sind. Zu verwenden zur Zeit von PgBouncer
Online-Neustart.

LEBENSLAUF [db];
Arbeiten Sie mit der vorherigen Arbeit fort PAUSE or AUSSETZEN Befehl.

ABSCHALTEN;
Der PgBouncer-Prozess wird beendet.

NEU LADEN;
Der PgBouncer-Prozess lädt seine Konfigurationsdatei neu und aktualisiert veränderbare Einstellungen.

Signale
SEUFZEND Konfiguration neu laden. Identisch mit dem Erteilen eines Befehls NEU LADEN; auf Konsole.

SIGINT Sicheres Herunterfahren. Dasselbe wie beim Ausstellen PAUSE; und ABSCHALTEN; auf Konsole.

ZIELLAUFZEIT
Sofortige Abschaltung. Dasselbe wie beim Ausstellen ABSCHALTEN; auf Konsole.

Freievent Einstellungen
Aus libevent-Dokumenten:

Es ist möglich, die Unterstützung für epoll, kqueue, devpoll und poll zu deaktivieren
oder wählen Sie durch Setzen der Umgebungsvariablen EVENT_NOEPOLL aus,
EVENT_NOKQUEUE, EVENT_NODEVPOLL, EVENT_NOPOLL oder EVENT_NOSELECT,
beziehungsweise.

Durch Festlegen der Umgebungsvariablen EVENT_SHOW_METHOD, libevent
Zeigt die verwendete Kernel-Benachrichtigungsmethode an.

Verwenden Sie pgbouncer online über die Dienste von onworks.net