| Documentation PostgreSQL 7.4.29 | ||||
|---|---|---|---|---|
| Pr�c�dent | Arri�re rapide | Avance rapide | Suivant | |
postgres [-A 0 | 1 ] [-B nombre_de_tampons] [-c
nom=valeur] [-d niveau-d�bogage] [--describe-config] [-D r�pertoire_donn�es] [-e] [-E] [-f s | i | t | n | m | h ] [-F] [-N] [-o nom_fichier] [-O] [-P] [-s | -t pa | pl | ex ] [-S sort-mem] [-W secondes] [--nom=valeur] base_de_donn�es
postgres [-A 0 | 1 ] [-B nombre_de_tampons] [-c
nom=valeur] [-d niveau-d�bogage] [-D r�pertoire_donn�es] [-e] [-f s | i | t | n | m | h ] [-F] [-o nom_fichier] [-O] [-p base_de_donn�es] [-P] [-s | -t pa | pl | ex ] [-S sort-mem] [-v protocole] [-W secondes] [--nom=valeur]
L'ex�cutable postgres est le processus serveur r�el PostgreSQL qui traite les requ�tes. Il n'est pas normalement appel� directement ; � la place, un serveur multi-utilisateurs postmaster est lanc�.
La deuxi�me forme ci-dessus est la fa�on dont postgres est appel� par postmaster (seulement conceptuellement, car postmaster et postgres sont en fait le m�me programme) ; il ne devrait pas �tre appel� directement de cette fa�on. La premi�re forme appelle le serveur directement dans un mode interactif simple utilisateur. La principale utilisation pour ce mode est le morceau du d�marrage par initdb. Quelque fois, il est utilis� pour le d�bogage ou la r�cup�ration du disastre.
Lorsqu'il est appel� en mode interactif � partir du shell, l'utilisateur peut entrer les requ�tes et les r�sultats seront affich�s � l'�cran mais dans une forme qui est plus utile pour les d�veloppeurs que pour les utilisateurs. Mais notez que lancer un serveur en simple utilisateur n'est pas vraiment convenable pour le d�bogage du serveur car il n'y a pas de communications interprocessus r�alistes et qu'aucun verrou n'aura lieu.
Lors de l'utilisation d'un serveur en mono utilisateur, l'utilisateur de la session sera initialis� avec l'ID 1. Cet utilisateur n'a pas besoin d'exister, de fa�on � ce qu'un serveur en mode mono utilisateur puisse �tre utilis� pour r�cup�rer manuellement � partir de certains types de dommages accidentels pour les catalogues syst�mes. Les pouvoirs implicites du super-utilisateur sont donn�s � l'utilisateur d'ID 1 dans le mode mono-utilisateur.
Quand postgres est lanc� par un postmaster, alors il h�rite de toutes les options initialis�es par ce dernier. En plus, les options sp�cifiques par postgres peuvent �tre pass�es de postmaster avec l'option -o.
Vous pouvez �viter d'avoir � saisir ces options en initialisant un fichier de configuration. Voir Section 16.4 pour plus de d�tails. Quelques options (s�res) peuvent aussi �tre initialis�es � partir du client se connectant d'une fa�on d�pendante de l'application. Par exemple, si la variable d'environnement PGOPTIONS est initialis�e, alors les clients bas�s sur libpq passeront cette cha�ne au serveur, qui l'interpr�teront comme des options en ligne de commande postgres.
Les options -A, -B, -c, -d, -D, -F et --name ont les m�mes significations que postmaster sauf que -d 0 emp�che le niveau de traces du serveur du postmaster d'�tre propag� � postgres.
Initialise le style de date par d�faut � <<�European�>>, c'est-�-dire l'ordre DMY des champs de date d'entr�e. Ceci fait aussi que le jour est affich� avant le mois dans certains formats de sortie des dates. Voir Section 8.5 pour plus d'informations.
Envoie toutes les traces du serveur dans nom_fichier. Si postgres est ex�cut� sous postmaster, cette option est ignor�e et la sortie standard des erreurs, stderr, h�rit�e de postmaster est utilis�e.
Ignore les index syst�me lors de la lecture des tables syst�mes (mais met toujours � jour les index lors de la modification des tables). Ceci est utile lors de la r�cup�ration des index syst�mes endommag�s.
Affiche l'information de l'heure et les autres statistiques � la fin de chaque commande. C'est utile pour conna�tre les performances ou pour faire une utilisation d'une configuration fine du nombre de tampons.
Sp�cifie les tailles m�moire � utiliser par les tris internes et les hachages avant le tri des fichiers temporaires du disque. La valeur est sp�cifi�e en Ko et vaut par d�faut 1024. Notez que, pour une requ�te complexe, plusieurs tris et/ou hachages pourraient �tre lanc�s en parall�le et chacune sera autoris�e � utiliser au plus sort-mem Ko avant qu'il commence � placer des donn�es dans des fichiers temporaires.
Sp�cifie le nom de la base de donn�es � acc�der. S'il est omis, il prend comme valeur par d�faut le nom de l'utilisateur.
Affiche toutes les commandes.
D�sactive l'utilisation des retours chariot comme d�limiteur d'une instruction.
Il existe plusieurs autres options qui pourraient �tre sp�cifi�es, utilis�es principalement dans des buts de d�bogage. Elles sont list�es ici pour �tre utilis�es par les d�veloppeurs du syst�me PostgreSQL. Utiliser une de ces options est hautement d�courag�. De plus, une de ces options pourrait dispara�tre ou changer dans une version future sans pr�venir.
Interdit l'utilisation de m�thodes de parcours et de jointure particuli�res : s et i d�sactivent respectivement les parcours s�quentiels et d'index alors que n, m et h d�sactivent respectivement les jointures � boucles imbriqu�es, les jointures d'assemblage et de d�coupage.
Note�: Ni les parcours s�quentiels ni les jointures de boucles imbriqu�es peuvent �tre compl�tement d�sactiv�s ; les options -fs et -fn d�couragent simplement l'optimiseur d'utiliser ces types de plan s'il n'y a pas d'autres alternatives.
Permet la modification de la structure des tables syst�me. Ceci est utilis� par initdb.
Indique que ce processus a �t� lanc� par un postmaster et sp�cifie la base de donn�es � utiliser, etc.
Affiche les statistiques temporelles pour chaque requ�te en relation avec chacun des modules syst�me majeurs. Cette option ne peut pas �tre utilis�e avec l'option -s.
Sp�cifie le num�ro de version du protocole client/serveur � utiliser pour cette session particuli�re.
D�s que cette option est rencontr�e, le processus dort pendant le temps sp�cifi� ici en secondes. Ceci donne aux d�veloppeurs le temps d'attacher un d�bogueur sur le processus serveur.
Cette option sauvegarde les variables internes de configuration du serveur ainsi que les descriptions et a comme valeur par d�faut le format COPY d�limit� par des tabulations. Elle est con�ue principalement pour �tre utilis�e par des outils d'administration.
Emplacement du r�pertoire de donn�es par d�faut.
Pour les autres, qui ont peu d'influence lors d'un mode mono utilisateur, voir postmaster.
Pour annuler une requ�te en cours d'ex�cution, envoyez le signal SIGINT au processus postgres ex�cutant cette commande.
Pour indiquer � postgres de recharger les fichiers de configuration, envoyez un signal SIGHUP. Normalement, il est mieux de lancer SIGHUP � postmaster ; le postmaster lancera � son tour SIGHUP � chacun de ces enfants. Mais dans certains cas, il pourrait �tre d�sirable d'avoir seulement un processus postgres pour recharger les fichiers de configuration.
Le postmaster utilise SIGTERM pour indiquer qu'un processus postgres quitte normalement et qu'un SIGQUIT termine sans le nettoyage normal. Ces signaux ne devraient pas �tre utilis�s par les utilisateurs. Il est aussi d�conseill� d'envoyer SIGKILL � un processus postgres --- le postmaster interpr�tera ceci comme un arr�t brutal dans postgres et forcera tous les processus postgres � quitter en faisant part de sa proc�dure standard de r�cup�ration de panne.
Lance un serveur en mode autonome avec une commande
postgres -D /usr/local/pgsql/data other-options my_database
Fournit le chemin correct au r�pertoire de la base de donn�es avec -D ou en s'assurant que la variable d'environnement PGDATA est configur�e. Sp�cifiez aussi le nom de la base de donn�es particuli�re avec laquelle vous souhaitez travailler.
Normalement, le serveur en mode mono utilisateur traite les retours chariot comme le terminateur d'entr�e de commande ; il n'y a pas de compr�hension des points virgules comme c'est le cas dans psql. Pour continuer une commande sur plusieurs lignes, vous devez tapez un antislash avant chaque nouvelle ligne sauf la derni�re.
Mais si vous utilisez l'option -N en ligne de commande, alors un retour chariot ne termine pas l'entr�e de la commande. Dans ce cas, le serveur lira l'entr�e standard jusqu'au marqueur de fin de fichier (EOF), alors il traite l'entr�e comme une seule cha�ne de commande. Les retours chariots avec antislash ne sont pas trait�s de fa�on sp�ciale dans ce cas.
Pour quitter la session, tapez EOF (habituellement, Control+D). Si vous avez utilis� -N, deux EOF cons�cutifs sont n�cessaires pour quitter.
Notez que le serveur en mode autonome ne fournit pas de fonctions avanc�es d'�dition de ligne (pas d'historique de commandes, par exemple).
| Pr�c�dent | Sommaire | Suivant |
| pg_resetxlog | Niveau sup�rieur | postmaster |