postgres — online w chmurze

PROGRAM:

IMIĘ

postgres — serwer bazy danych PostgreSQL

STRESZCZENIE

Postgres [opcja...]

OPIS

Postgres jest serwerem bazy danych PostgreSQL. Aby aplikacja kliencka mogła uzyskać dostęp do pliku
baza danych, którą łączy (przez sieć lub lokalnie) z uruchomionym Postgres instancja. The
Postgres instancja następnie uruchamia oddzielny proces serwera do obsługi połączenia.

jeden Postgres instancja zawsze zarządza danymi dokładnie jednego klastra bazy danych. Baza danych
klaster to zbiór baz danych przechowywanych we wspólnej lokalizacji systemu plików (tzw
„obszar danych”). Więcej niż jeden Postgres instancja może działać w systemie jednocześnie, o ile
używają różnych obszarów danych i różnych portów komunikacyjnych (patrz poniżej). Gdy Postgres
uruchamia się, musi znać położenie obszaru danych. Lokalizacja musi być określona przez
dotychczasowy -D opcja lub PGDANE Zmienna środowiskowa; nie ma wartości domyślnej. zazwyczaj -D or
PGDANE wskazuje bezpośrednio na katalog obszaru danych utworzony przez initdb(1). Inne możliwe
układy plików są omówione w sekcji 18.2, „Lokalizacje plików” w dokumentacji.

Domyślnie Postgres uruchamia się na pierwszym planie i drukuje komunikaty dziennika do standardowego błędu
strumień. W zastosowaniach praktycznych Postgres powinien być uruchamiany jako proces w tle,
może w czasie rozruchu.

Postgres Polecenie można również wywołać w trybie pojedynczego użytkownika. Podstawowe zastosowanie tego trybu
jest podczas ładowania początkowego przez initdb(1). Czasami jest używany do debugowania lub katastrofy
powrót do zdrowia; zauważ, że uruchomienie serwera dla jednego użytkownika nie jest naprawdę odpowiednie do debugowania
serwera, ponieważ nie nastąpi realistyczna komunikacja i blokowanie międzyprocesowe. Gdy
wywoływany w trybie pojedynczego użytkownika z powłoki, użytkownik może wprowadzać zapytania i wyniki
zostanie wydrukowany na ekranie, ale w formie bardziej przydatnej dla programistów niż koniec
użytkownicy. W trybie pojedynczego użytkownika użytkownik sesyjny zostanie ustawiony na użytkownika o identyfikatorze 1 i
temu użytkownikowi nadawane są niejawne uprawnienia superużytkownika. Ten użytkownik tak naprawdę nie musi
istnieją, więc tryb pojedynczego użytkownika może być używany do ręcznego odzyskiwania z niektórych rodzajów
przypadkowe uszkodzenie katalogów systemowych.

OPCJE

Postgres akceptuje następujące argumenty wiersza poleceń. Do szczegółowego omówienia nt
opcje można znaleźć w dokumentacji w rozdziale 18, Konfiguracja serwera. Możesz zapisać
wpisując większość z tych opcji, konfigurując plik konfiguracyjny. Niektóre (bezpieczne) opcje mogą
być również ustawiane z łączącego się klienta w sposób zależny od aplikacji, aby ubiegać się tylko o
tamta sesja. Na przykład, jeśli zmienna środowiskowa PGOPCJE jest ustawiony, a następnie oparty na libpq
klienci przekażą ten ciąg do serwera, który zinterpretuje go jako Postgres
opcje wiersza polecenia.

Ogólne Cel
-B nbufory
Ustawia liczbę buforów współdzielonych do wykorzystania przez procesy serwera. Wartość domyślna
tego parametru jest wybierany automatycznie przez initdb. Określenie tej opcji jest
odpowiednik ustawienia parametru konfiguracyjnego shared_buffers.

-c Nazwa=wartość
Ustawia nazwany parametr czasu wykonywania. Parametry konfiguracyjne obsługiwane przez PostgreSQL
są opisane w Rozdziale 18, Konfiguracja serwera, w dokumentacji. Większość
inne opcje wiersza poleceń są w rzeczywistości krótkimi formami takiego przypisania parametrów. -c
może pojawić się wiele razy, aby ustawić wiele parametrów.

-C Nazwa
Drukuje wartość nazwanego parametru wykonawczego i kończy działanie. (Zobacz -c opcja powyżej
aby uzyskać szczegółowe informacje.) Może to być używane na działającym serwerze i zwraca wartości z
postgresql.conf, zmodyfikowany przez dowolne parametry podane w tym wywołaniu. To nie
odzwierciedlać parametry podane podczas uruchamiania klastra.

Ta opcja jest przeznaczona dla innych programów współpracujących z instancją serwera, takich jak
pg_ctl(1), aby zapytać o wartości parametrów konfiguracji. Aplikacje przeznaczone dla użytkownika powinny
zamiast tego użyj POKAZAĆ(7) lub widok pg_settings.

-d poziom debugowania
Ustawia poziom debugowania. Im wyższa jest ta wartość, tym więcej danych wyjściowych debugowania
zapisywane w dzienniku serwera. Wartości są od 1 do 5. Możliwe jest również przekazanie -d 0
dla określonej sesji, co uniemożliwi poziom logowania serwera nadrzędnego Postgres
proces propagowany do tej sesji.

-D katalog danych
Określa położenie w systemie plików plików konfiguracyjnych bazy danych. Patrz sekcja
18.2, „Lokalizacje plików”, w dokumentacji, aby uzyskać szczegółowe informacje.

-e
Ustawia domyślny styl daty na „europejski”, czyli kolejność DMY pól daty wejściowej.
Powoduje to również, że dzień jest drukowany przed miesiącem w niektórych danych wyjściowych
formaty. Zobacz sekcję 8.5, „Typy daty/czasu” w dokumentacji, aby uzyskać więcej informacji
informacje.

-F
Wyłącza fsync wzywa do poprawy wydajności, ryzykując uszkodzenie danych w
przypadku awarii systemu. Określenie tej opcji jest równoznaczne z wyłączeniem fsync
parametr konfiguracyjny. Przeczytaj szczegółową dokumentację przed użyciem!

-h hosta
Określa nazwę hosta IP lub adres, na którym Postgres jest nasłuchiwanie protokołu TCP/IP
połączenia z aplikacji klienckich. Wartością może być również lista wartości oddzielonych przecinkami
adresy lub *, aby określić nasłuchiwanie na wszystkich dostępnych interfejsach. Pusta wartość
określa, że ​​nie nasłuchuje żadnych adresów IP, w takim przypadku tylko gniazda domeny Unix
może być używany do łączenia się z serwerem. Domyślnie nasłuchuje tylko na hoście lokalnym.
Określenie tej opcji jest równoznaczne z ustawieniem konfiguracji adresy_odsłuchu
parametr.

-i
Umożliwia klientom zdalnym łączenie się za pośrednictwem połączeń TCP/IP (domena internetowa). Bez
tej opcji akceptowane są tylko połączenia lokalne. Ta opcja jest równoważna z ustawieniem
adresy_słuchania do * w postgresql.conf lub przez -h.

Ta opcja jest przestarzała, ponieważ nie umożliwia dostępu do pełnej funkcjonalności programu
adresy_słuchania. Zwykle lepiej jest ustawić adresy_słuchania bezpośrednio.

-k katalog
Określa katalog gniazda domeny Unix, w którym Postgres jest do słuchania
połączenia z aplikacji klienckich. Wartością może być również lista wartości oddzielonych przecinkami
katalogi. Pusta wartość określa, że ​​nie nasłuchuje na żadnych gniazdach domeny Unix, w
w takim przypadku do połączenia z serwerem można używać tylko gniazd TCP/IP. Wartość domyślna
jest normalnie / Tmp, ale można to zmienić w czasie kompilacji. Określenie tej opcji jest
odpowiednik ustawienia parametru konfiguracyjnego unix_socket_directories.

-l
Umożliwia bezpieczne połączenia przy użyciu protokołu SSL. PostgreSQL musiał zostać skompilowany z obsługą
SSL, aby ta opcja była dostępna. Aby uzyskać więcej informacji na temat korzystania z protokołu SSL, zobacz
Sekcja 17.9, „Bezpieczne połączenia TCP/IP z SSL” w dokumentacji.

-N maksymalna liczba połączeń
Ustawia maksymalną liczbę połączeń klienckich akceptowanych przez ten serwer. The
domyślna wartość tego parametru jest wybierana automatycznie przez initdb. Określenie tego
opcja jest równoważna ustawieniu parametru konfiguracyjnego max_connections.

-o dodatkowe opcje
Argumenty w stylu wiersza polecenia określone w dodatkowe opcje są przekazywane do wszystkich serwerów
rozpoczęte przez to procesy Postgres proces.

Przestrzenie wewnątrz dodatkowe opcje są uważane za oddzielne argumenty, chyba że są poprzedzone znakiem ucieczki
ukośnik odwrotny (\); napisz \\, aby reprezentować dosłowny ukośnik odwrotny. Wiele argumentów może
można również określić za pomocą wielu zastosowań -o.

Użycie tej opcji jest przestarzałe; wszystkie opcje wiersza poleceń dla procesów serwera mogą
być określony bezpośrednio na Postgres wiersz poleceń.

-p Port
Określa port TCP/IP lub lokalne rozszerzenie pliku gniazda domeny systemu Unix, na którym Postgres
jest nasłuchiwanie połączeń z aplikacji klienckich. Domyślnie przyjmuje wartość
PGPORT zmienna środowiskowa lub if PGPORT nie jest ustawiona, wówczas przyjmuje wartość domyślną
ustalona podczas kompilacji (zwykle 5432). Jeśli określisz port inny niż
port domyślny, wówczas wszystkie aplikacje klienckie muszą określić ten sam port przy użyciu jednego z nich
opcje wiersza poleceń lub PGPORT.

-s
Drukuj informacje o czasie i inne statystyki na końcu każdego polecenia. to jest przydatne
do testów porównawczych lub do dostrajania liczby buforów.

-S praca-pamięć
Określa ilość pamięci, która ma być używana przez sortowanie wewnętrzne i skróty
uciekanie się do tymczasowych plików dyskowych. Zobacz opis pamięć_robocza konfiguracja
parametr w rozdziale 18.4.1, „Pamięć”, w dokumentacji.

-V
--wersja
Wydrukuj wersję postgres i wyjdź.

--Nazwa=wartość
Ustawia nazwany parametr czasu wykonywania; krótsza forma -c.

--opisz-konfigurację
Ta opcja powoduje zrzut wewnętrznych zmiennych konfiguracyjnych serwera, opisów i
wartości domyślne rozdzielane tabulatorami KOPIA format. Przeznaczony jest przede wszystkim do użytku przez
narzędzia administracyjne.

-?
--help
Pokaż pomoc dotyczącą argumentów wiersza poleceń postgres i wyjdź.

Pół-wewnętrzny Opcje
Opisane tutaj opcje są używane głównie do celów debugowania, aw niektórych przypadkach do
pomoc w odzyskiwaniu poważnie uszkodzonych baz danych. Nie powinno być powodu, aby ich używać
w konfiguracji produkcyjnej bazy danych. Są one wymienione tutaj tylko do użytku przez system PostgreSQL
programiści. Ponadto te opcje mogą ulec zmianie lub zostać usunięte w przyszłej wersji
bez uprzedzenia.

-f { s | ja | o | b | t | n | m | H }
Zabrania używania określonych metod skanowania i łączenia: s oraz i wyłącza sekwencyjne i
odpowiednio skanuje indeks, o, b i t wyłącza skanowanie tylko indeksu, skanowanie indeksu mapy bitowej i
Skanuje odpowiednio TID, podczas gdy n, m i h wyłączają zagnieżdżoną pętlę, scalanie i łączenie mieszające
odpowiednio.

Ani skanowania sekwencyjnego, ani łączenia zagnieżdżonych pętli nie można całkowicie wyłączyć; -fs i
Opcje -fn po prostu zniechęcają optymalizator do korzystania z tych typów planów, jeśli takie istnieją
inna alternatywa.

-n
Ta opcja służy do debugowania problemów, które powodują nieprawidłowe zakończenie procesu serwera.
Zwykłą strategią w tej sytuacji jest powiadomienie o tym wszystkich innych procesów serwera
muszą zakończyć, a następnie ponownie zainicjować pamięć współdzieloną i semafory. To jest
ponieważ błędny proces serwera mógł wcześniej uszkodzić jakiś współdzielony stan
zakończenie. Ta opcja to określa Postgres nie będzie ponownie inicjować udostępnionych danych
Struktury. Doświadczony programista systemowy może następnie użyć debuggera do sprawdzenia
pamięć współdzielona i stan semafora.

-O
Umożliwia modyfikację struktury tabel systemowych. To jest używane przez initdb.

-P
Ignoruj ​​indeksy systemowe podczas czytania tabel systemowych, ale nadal aktualizuj indeksy, gdy
modyfikowanie tabel. Jest to przydatne podczas odzyskiwania z uszkodzonych indeksów systemowych.

-t pa[ser] | pl[anner] | wykonawca]
Wydrukuj statystyki czasu dla każdego zapytania odnoszącego się do każdego z głównych modułów systemu.
Tej opcji nie można używać razem z -s opcja.

-T
Ta opcja służy do debugowania problemów, które powodują nieprawidłowe zakończenie procesu serwera.
Zwykłą strategią w tej sytuacji jest powiadomienie o tym wszystkich innych procesów serwera
muszą zakończyć, a następnie ponownie zainicjować pamięć współdzieloną i semafory. To jest
ponieważ błędny proces serwera mógł wcześniej uszkodzić jakiś współdzielony stan
zakończenie. Ta opcja to określa Postgres zatrzyma wszystkie inne procesy serwera
wysyłając sygnał SIGSTOP, ale nie spowoduje ich zakończenia. To pozwala
programistów systemowych do ręcznego zbierania zrzutów pamięci ze wszystkich procesów serwera.

-v protokół
Określa numer wersji protokołu frontend/backend, który ma być używany przez a
konkretna sesja. Ta opcja jest przeznaczona wyłącznie do użytku wewnętrznego.

-W sekund
Opóźnienie o tej liczbie sekund występuje, gdy po nim uruchamiany jest nowy proces serwera
przeprowadza procedurę uwierzytelnienia. Ma to na celu danie możliwości
dołączyć do procesu serwera za pomocą debuggera.

Opcje dla Pojedynczy użytkownik Moda
Poniższe opcje dotyczą tylko trybu jednego użytkownika.

--pojedynczy
Wybiera tryb jednego użytkownika. To musi być pierwszy argument w wierszu poleceń.

baza danych
Określa nazwę bazy danych, do której ma zostać uzyskany dostęp. To musi być ostatni argument w sprawie
linia poleceń. Jeśli zostanie pominięty, domyślnie jest to nazwa użytkownika.

-E
Powtórz wszystkie polecenia.

-j
Wyłącza użycie znaku nowej linii jako ogranicznika instrukcji.

-r filename
Wyślij wszystkie dane wyjściowe dziennika serwera do filename. Ta opcja jest honorowana tylko wtedy, gdy jest dostarczona jako a
opcja wiersza poleceń.

ŚRODOWISKO

PGCLIENTENKODOWANIE
Domyślne kodowanie znaków używane przez klientów. (Klienci mogą to zmienić
indywidualnie.) Wartość tę można również ustawić w pliku konfiguracyjnym.

PGDANE
Domyślna lokalizacja katalogu danych

PGDATASTYL
Wartość domyślna parametru wykonawczego DateStyle. (Korzystanie z tego środowiska
zmienna jest przestarzała).

PGPORT
Domyślny numer portu (najlepiej ustawiony w pliku konfiguracyjnym)

TZ
Strefa czasowa serwera

DIAGNOSTYKA

Komunikat o błędzie wspominający o semget lub shmget prawdopodobnie wskazuje, że musisz skonfigurować
jądro, aby zapewnić odpowiednią pamięć współdzieloną i semafory. Więcej dyskusji zob
Sekcja 17.4, „Zarządzanie zasobami jądra” w dokumentacji. Możesz być w stanie
odłóż rekonfigurację jądra, zmniejszając współdzielone_bufory, aby zmniejszyć współdzielone
zużycie pamięci przez PostgreSQL i/lub poprzez zmniejszenie max_connections w celu zmniejszenia
zużycie semaforów.

Należy sprawdzić komunikat o błędzie sugerujący, że inny serwer jest już uruchomiony
ostrożnie, na przykład za pomocą polecenia

$ ps ax | grep Postgres

or

$ ps -jeśli | grep Postgres

w zależności od systemu. Jeśli masz pewność, że nie działa żaden serwer będący w konflikcie, ty
może usunąć plik blokady wymieniony w komunikacie i spróbować ponownie.

Komunikat o błędzie informujący o niemożności powiązania z portem może wskazywać, że ten port jest
już używany przez jakiś proces inny niż PostgreSQL. Możesz również otrzymać ten błąd, jeśli ty
zakończony Postgres i natychmiast uruchom go ponownie, używając tego samego portu; w tym przypadku musisz
po prostu poczekaj kilka sekund, aż system operacyjny zamknie port, zanim spróbujesz ponownie.
Na koniec ten błąd może wystąpić, jeśli podasz numer portu, który jest używany w systemie operacyjnym
uważa za zastrzeżone. Na przykład wiele wersji systemu Unix uwzględnia numery portów poniżej
1024, aby były „zaufane” i pozwalały na dostęp do nich tylko superużytkownikom systemu Unix.

UWAGI

Polecenie narzędzia pg_ctl(1) może być używany do uruchamiania i wyłączania Postgres serwer
bezpiecznie i wygodnie.

Jeśli to możliwe, do nie użyj SIGKILL, aby zabić main Postgres serwer. Zrobię to
zapobiec Postgres od zwalniania zasobów systemowych (np. pamięci współdzielonej i semaforów)
które zachowuje przed zakończeniem. Może to powodować problemy przy rozpoczynaniu nowego Postgres
uruchomić.

Aby zakończyć Postgres normalnie, mogą to być sygnały SIGTERM, SIGINT lub SIGQUIT
używany. Pierwszy będzie czekał, aż wszyscy klienci zakończą pracę, a drugi to zrobi
siłą odłącz wszystkich klientów, a trzeci natychmiast opuści bez odpowiedniego
shutdown, co powoduje uruchomienie odzyskiwania podczas ponownego uruchamiania.

Sygnał SIGHUP przeładuje pliki konfiguracyjne serwera. Istnieje również możliwość wysłania
SIGHUP do indywidualnego procesu serwera, ale zwykle nie jest to rozsądne.

Aby anulować uruchomione zapytanie, wyślij sygnał SIGINT do procesu wykonującego to polecenie. Do
zakończ proces zaplecza w sposób czysty, wyślij SIGTERM do tego procesu. Zobacz też
pg_cancel_backend oraz pg_terminate_backend w Sekcja 9.26.2, „Sygnalizacja serwera
Functions” w dokumentacji dla wywoływanych przez SQL odpowiedników tych dwóch akcji.

Postgres serwer używa SIGQUIT, aby nakazać podrzędnym procesom serwera zakończenie bez
zwykłe sprzątanie. Ten sygnał powinien nie być używany przez użytkowników. Niemądre jest również wysyłanie SIGKILL
do procesu serwera — main Postgres proces zinterpretuje to jako awarię i zrobi to
wymusić zamknięcie wszystkich procesów siostrzanych w ramach standardowej procedury przywracania po awarii.

Korzystaj z postgres online, korzystając z usług onworks.net