initdb

Nombre

initdb  --  Crea una nueva instalaci�n de la base de datos de PostgreSQL

Synopsis

initdb [ --pgdata|-D dbdir ]
       [ --sysid|-i sysid ]
       [ --pwprompt|-W ]
       [ --encoding|-E encoding ]
       [ --pglib|-L libdir ]
       [ --noclean | -n ] [ --debug | -d ] [ --template | -t ]
  

Inputs

--pgdata=dbdir, -D dbdir, PGDATA

Esta opci�n especifica en que parte del sistema de archivos ser� almacenada la base de datos. �sta es la �nica informaci�n requerida por el initdb, pero podemos omitirla estableciendo la variable de entorno PGDATA lo que puede ser conveniente ya que el servidor de la base de datos (postmaster) puede encontrar el directorio de la base de datos m�s adelante a trav�s de la misma variable.

--sysid=sysid, -i sysid

Selecciona �l id del sistema para el super usuario (root) de la base de datos. Por omisi�n apunta al id de aquel usuario que este ejecutando initdb. Realmente no es importante cu�l sea �l id del sistema para el super usuario, ya que uno podr�a elegir comenzar la numeraci�n con cualquier n�mero como 0 o 1.

--pwprompt, -W

Ocasiona que el initdb pregunte por el password del super usuario (root) de la base de datos. Si uno no planea usar la autentificaci�n a trav�s de passwords, entonces realmente no es importante. De cualquier manera uno no podr� utilizar la autentificaci�n a trav�s de passwords hasta que haya establecido un password.

--encoding=encoding, -E encoding

Selecciona la codificaci�n multibyte para la base de datos modelo (o plantilla). De hecho esta tambi�n ser� la codificaci�n por defecto para cualquier base de datos que uno cree m�s adelante, a menos que usted la cambie. Para utilizar la caracter�stica de codificaci�n multibyte, se debe especificar durante el tiempo de construcci�n (creaci�n de la BD), en cuyo caso uno tambi�n selecciona el valor por defecto para esta opci�n.

Otros par�metros utilizados menos com�nmente est�n tambi�n disponibles:

--pglib=libdir, -l libdir

initdb necesita algunos archivos de entrada para poder inicializar la base de datos. Esta opci�n indica d�nde encontrarlos. Normalmente, uno no tiene que preocuparse por esto puesto que el initdb conoce los esquemas de instalaci�n m�s comunes y encontrar�, normalmente, los archivos por s� mismo. Se le dir� si usted necesita especificar su ubicaci�n expl�citamente. Si sucede esto, uno de los ficheros se llama global1.bki.source y est� instalado tradicionalmente junto con los otros archivos en el directorio de bibliotecas (por ejemplo, /usr/local/pgsql/lib) /usr/local/pgsql/lib).

--template, -t

Replace the template1 Substituye la base de datos template1 en un sistema de base de datos existente, y no toca otra cosa. Esto es �til cuando se necesita actualizar el template1de la base de datos usando el initdb de una versi�n m�s nueva de PostgreSQL, o cuando el template1de la base de datos se ha corrompido por alg�n problema del sistema. Normalmente el contenido del template1 se mantendr� constante a trav�s de la vida del sistema de base de datos. No se puede destruir cualquier otra cosa ejecutando el initdb con la opci�n --template.

--noclean, -n

Por defecto, cuando initdb determina que un error evita que se cree totalmente el sistema de base de datos, remueve cualquier archivo que pudo haber creado, antes de determinar que no puede acabar el trabajo. Esta opci�n inhibe "tidying-up" y es por lo tanto, �til para depurar.

--debug, -d

Imprime la salida de depuraci�n de la "carga inicial backend" y algunos otros mensajes de poco inter�s para el p�blico en general. La "carga inicial backend" es la aplicaci�n que el initdb usa para crear las tablas del cat�logo. Esta opci�n genera una enorme cantidad de salida.

Salidas

initdb crear� los ficheros en el �rea de datos especificada que son las tablas del sistema y el marco de trabajo para una instalaci�n completa.

Descripci�n

initdb crea un nuevo sistema de base de datos de PostgreSQL database system. Un sistema de base de datos es una colecci�n de bases de datos que son todas administradas por el mismo usuario de UNIX y manejadas por un solo postmaster

Crear un sistema de base de datos consiste en crear los directorios en los cuales los datos de la base de datos ser�n almacenados. generar las tablas de cat�logo compartidas (son tablas que no pertenecen a ninguna base de datos determinada). crear el template1 de la base de datos. Cuando usted crea una nueva base de datos, todo el template1de la base de datos se copia. Contiene las tablas de cat�logo llenas para cosas como los tipos interconstruidos

No se debe ejecutar el initdb como root. Esto se debe ya que uno no puede ejecutar el servidor de la base de datos ni siquiera como root, pero el servidor necesita tener acceso a los archivos que initdbcrea. Adem�s, durante la fase de la inicializaci�n, cuando no hay usuarios y ning�n control de acceso instalado, postgres solamente se conectar� con el nombre de usuario actual de UNIX, as� que uno debe iniciar una sesi�n bajo la cuenta que poseer� el proceso del servidor.

Aunque initdb procurar� crear el directorio de datos respectivo, lo cierto es que no tendr� el permiso para hacerlo. Por lo tanto, es una buena idea crear el directorio de datos antes de ejecutar initdb y entregar la propiedad de �l al super usuario de la base de datos.