* [gentoo-commits] gentoo commit in xml/htdocs/doc/es: postgres-howto.xml
@ 2008-07-17 15:22 John Christian Stoddart (chiguire)
0 siblings, 0 replies; 5+ messages in thread
From: John Christian Stoddart (chiguire) @ 2008-07-17 15:22 UTC (permalink / raw
To: gentoo-commits
chiguire 08/07/17 15:22:52
Modified: postgres-howto.xml
Log:
improvements-rewrites by jose maria alonso
Revision Changes Path
1.3 xml/htdocs/doc/es/postgres-howto.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/es/postgres-howto.xml?r1=1.2&r2=1.3
Index: postgres-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- postgres-howto.xml 9 Aug 2007 11:59:23 -0000 1.2
+++ postgres-howto.xml 17 Jul 2008 15:22:51 -0000 1.3
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.2 2007/08/09 11:59:23 chiguire Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.3 2008/07/17 15:22:51 chiguire Exp $ -->
<guide link="/doc/en/postgres-howto.xml" lang="es">
<title>PostgreSQL Guide</title>
@@ -44,9 +44,9 @@
<c>PostgreSQL</c>. Las ventajas de uno sobre el otro suele traer un
debate largo y tendido, sin embargo es justo decir que PostgreSQL ha
tenido una concepción más firme de lo que supone son las verdaderas
-estructuras que corresponden a un manejadore de bases de datos
-relacional que MySQL. La mayoría de las características standard como
-<b>FOREIGN KEY</b> fueron apenas agregados en MySQL versión 5. Sin
+estructuras que corresponden a un manejador de bases de datos
+relacional que MySQL. La mayoría de las características estándar como
+<b>FOREIGN KEY</b> fueron apenas agregadas en MySQL versión 5. Sin
embargo, cualesquiera sea el caso, este documento asume que ha
seleccionado PostgreSQL como el manejador de bases de dato que va a
utilizar. El primer lugar donde comenzar es el proceso
@@ -63,7 +63,7 @@
<p>
Para comenzar debemos primero hacer <c>emerge</c> al paquete
PostgreSQL. Para hacer esto, ejecute primero el siguiente comando para
-asegurar que las opciones necesarios están correctamente configuradas:
+asegurar que las opciones necesarias están correctamente configuradas:
</p>
<pre caption="Revisando las opciones para construir PostgreSQL">
@@ -184,14 +184,14 @@
<ti>zlib</ti>
<ti>
Esta opción realmente no se utiliza por PostgreSQL, sino por el
- comando <c>pg_dump</c> para comprimir las descargas de data
+ comando <c>pg_dump</c> para comprimir las descargas de datos
producidas.
</ti>
</tr>
</table>
<p>
-Una vez afinado la construcción de PostgreSQL a sus necesidades
+Una vez afinada la construcción de PostgreSQL a sus necesidades
específicas, continúe con el <c>emerge</c>:
</p>
@@ -350,8 +350,8 @@
</pre>
<p>
-La base de datos fue creata exitosamente y podemos confirmar que la
-base de datos puede rllevar a cabo tareas básicaS. Seguiremos con
+La base de datos fue creada exitosamente y podemos confirmar que la
+base de datos puede llevar a cabo tareas básicas. Seguiremos con
un drop (borrando) la base de datos con el comando <c>dropdb</c>:
</p>
@@ -375,19 +375,19 @@
<body>
<p>
-Tal como mensionamos anteriormente, teniendo que hacer login como el
-usuario postgres no es deseable en un entorno multi-usuario. In la
-mayoría de los casos habrán varios usuarios y servicios con acceso al
+Tal como mencionamos anteriormente, teniendo que hacer login como el
+usuario postgres no es deseable en un entorno multi-usuario. En la
+mayoría de los casos habrá varios usuarios y servicios con acceso al
servidor y cada uno tendrá distintas necesidades y permisos. Para
-manejar esta sicuación se utiliza el comando <c>createuser</c>. Est
+manejar esta situación se utiliza el comando <c>createuser</c>. Este
comando es una alternativa al uso de algunas consultas SQL y es más
flexible desde el punto de vista del administrador. Continuaremos
creando dos usuarios, un 'superusario' que a su vez puede agregar
otros usuarios y administrar la base de datos y un usuario normal:
</p>
-<pre caption="Configurando un superuser">
-<comment>(reemplace a chris con el usuario que desea usar)</comment>
+<pre caption="Configurando un superusuario">
+<comment>(reemplace a chris con el usuario que desea crear)</comment>
$ <i>createuser -a -d -P -E -U postgres -W chris</i>
Enter password for new user:
Enter it again:
@@ -435,7 +435,7 @@
Ahora tenemos un usuario que puede crear bases de datos y agregar
otros usuarios y el principal usuario postgres que puede hacer
cualquier cosa. El usuario creado anteriormente puede hacer login al
-servidor y más nada. En general, los usuarios necesitan insertar y
+servidor y nada más. En general, los usuarios necesitan insertar y
recuperar datos y a veces hacer otras tareas. Para que este usuario
nuevo pueda hacer algo, debemos establecer los permisos
adecuados. Esto se puede hacer fácilmente pasando el parámetro
@@ -454,8 +454,8 @@
Bien, ahora tenemos la base de datos MyDB y al usuario testuser que
tiene acceso a ella. Para probar esto, haremos login como testuser a
la nueva base de datos con el programa <c>psql</c>. Este programa es
-lo usado para conectarse a una base de datos PostgreSQL desde la línea
-de comando. Para establecer la conexión a la nueva base de datos
+el usado para conectarse a una base de datos PostgreSQL desde la línea
+de comandos. Para establecer la conexión a la nueva base de datos
haremos:
</p>
@@ -474,10 +474,10 @@
</pre>
<p>
-Ahora que testuser está conectado al la base de datos puede comenzar a
+Ahora que testuser está conectado a la base de datos puede comenzar a
ejecutar algunos comandos. Para ir viendo cómo es el manejo de
-PostgreSQL, la siguiente sección mostrará algunos de los comandos
-básicos al nacegar con el cliente <c>psql</c>.
+PostgreSQL, en la siguiente sección se mostrarán algunos comandos
+básicos cuando naveguemos con el cliente <c>psql</c>.
</p>
</body>
</section>
@@ -496,7 +496,7 @@
<table>
<tr>
<th>Comando</th>
- <th>Usoe</th>
+ <th>Uso</th>
<th>Equivalente MySQL</th>
</tr>
<tr>
@@ -516,7 +516,7 @@
</tr>
<tr>
<ti>\o [FILE]</ti>
- <ti>Envíe los resultados de la consulta al archivo <c>FILE</c></ti>
+ <ti>Envía los resultados de la consulta al archivo <c>FILE</c></ti>
<ti>INTO OUTFILE, pero graba todo (no solo los SELECT)</ti>
</tr>
<tr>
@@ -535,7 +535,13 @@
</table>
<p>
-Con la excepción de <c>\c[onnect]</c>, todos los comandos se usarán más adelante en esta sección. Hasta ahora, la base de datos está vacía y dicho esto, necesitamos insertar alguna data. Sin embargo, el primer paso para insertar data es colocarla en una tabla. En este momento no tenemos tablas en la base de datos, por lo que debemos crear una. Esto lo hacemos con el comando <c>CREATE TABLE</c>. Crearemos una table de ítems, que contendrá los campos Product ID, Description y price:
+Con la excepción de <c>\c[onnect]</c>, todos los comandos se usarán más adelante
+en esta sección. Hasta ahora, la base de datos está vacía y dicho esto,
+necesitamos insertar alguna datos. Sin embargo, el primer paso para insertar
+datos es colocarla en una tabla. En este momento no tenemos tablas en la base de
+datos, por lo que debemos crear una. Esto lo hacemos con el comando
+<c>CREATE TABLE</c>. Crearemos una tabla de ítems, que contendrá los campos
+Product ID, Description y price:
</p>
<pre caption="Creando la tabla products">
@@ -568,31 +574,31 @@
<p>
De hecho, la tabla fue creada exitosamente. Habiendo cumplido este
-paso, debe ser poblada con data. La siguiente sección tratará este
+paso, debe ser poblada con datos. La siguiente sección tratará este
tema.
</p>
</body>
</section>
<section>
-<title>Insertando la data en la base de datos</title>
+<title>Insertando la datos en la base de datos</title>
<body>
<p>
Esta sección examinará dos maneras de poblar la tabla recién creada
-con data. Primero veamos el comando más básico, <c>INSERT</c>:
+con datos. Primero veamos el comando más básico, <c>INSERT</c>:
</p>
-<pre caption="Sintaxis de INSERT">
+<pre caption="Sintáxis de INSERT">
INSERT INTO [tablename] (column1,column2,column3) VALUES(value1,value2,value3)
</pre>
<p>
-<c>tablename</c> contiene el nombre de la tabla a la cual insertaremos
-data. (column1,column2,column3) permite especificar las columnas
-específicas a las cuales insertar los
+<c>tablename</c> contiene el nombre de la tabla en la cual insertaremos
+datos. (column1,column2,column3) permite especificar las columnas
+específicas en las cuales insertar los
valores. VALUES(value1,value2,value3) es el listado de los
-valores. Estos valores estan en el mismo orden que el orden de las
+valores. Estos valores estan en el mismo orden que las
columnas (column1 recibe value1, column2 recibe value2, column3 recibe
value3). La cuenta de columnas y valores <e>debe</e> ser
igual. Continuemos e insertemos un ítem en la tabla:
@@ -609,7 +615,7 @@
columnas a no ser que esté 300% seguro que nunca agregará una columna.
</impo>
-<pre caption="Insertando data en la tabla">
+<pre caption="Insertando datos en la tabla">
MyDB=> <i>INSERT INTO products (description,price) VALUES('A test product', 12.00);</i>
INSERT 17273 1
</pre>
@@ -638,12 +644,12 @@
<p>
Ahora usaremos el comando <c>COPY</c> para poblar nuestra tabla con
-data:
+datos:
</p>
<impo>
El comando <c>COPY FROM STDIN</c> se usa porque solamente el usuario
-postgres puede insertar data de un archivo (obviamente por razones de
+postgres puede insertar datos de un archivo (obviamente por razones de
seguridad).
</impo>
@@ -660,8 +666,8 @@
<p>
Desafortunadamente esta línea no retorna la misma información de
resultado que el enunciado <c>INSERT INTO</c>. Entonces ¿cómo sabremos
-si la data fue insertada? La siguiente sección examinará cómo realizar
-consultas para revisar nuestra data.
+si los datos fueron insertados? La siguiente sección examinará cómo realizar
+consultas para revisar nuestros datos.
</p>
</body>
</section>
@@ -672,7 +678,7 @@
<p>
Esta sección mostrará cómo usar el enunciado <c>SELECT</c> para
-visualizar la data en nuestras tablas. El formato básico <c>SELECT</c>
+visualizar los datos en nuestras tablas. El formato básico <c>SELECT</c>
es así:
</p>
@@ -681,7 +687,7 @@
</pre>
<p>
-Existen dos manera de seleccionar columnas. La primera usa el <c>*</c>
+Existen dos maneras de seleccionar columnas. La primera usa el <c>*</c>
para seleccionar todas la columnas y la segunda especifica una lista
de columnas que desea ver. La segunda es muy práctica cuando desea
encontrar una columna específica en una lista larga. Comenzamos usando
@@ -735,7 +741,7 @@
<p>
Ahora vemos un listdo de productos cuyo precio es mayor a $2.00,
-permitiéndonos enfocar aún más en la data. Esta formas de consulta de
+permitiéndonos enfocar aún más en los datos. Estas formas de consulta de
información son muy poderosas y pueden ayudar a crear informes
extremadamente útiles.
</p>
--
gentoo-commits@lists.gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/es: postgres-howto.xml
@ 2011-08-18 13:19 JosA MarAa Alonso (nimiux)
0 siblings, 0 replies; 5+ messages in thread
From: JosA MarAa Alonso (nimiux) @ 2011-08-18 13:19 UTC (permalink / raw
To: gentoo-commits
nimiux 11/08/18 13:19:44
Modified: postgres-howto.xml
Log:
#330927 - Revamped documentation for PostgreSQL. thanks to Aaron W. Swenson and Mikkel A. Clausen
Revision Changes Path
1.4 xml/htdocs/doc/es/postgres-howto.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?r1=1.3&r2=1.4
Index: postgres-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- postgres-howto.xml 17 Jul 2008 15:22:51 -0000 1.3
+++ postgres-howto.xml 18 Aug 2011 13:19:44 -0000 1.4
@@ -1,766 +1,891 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.3 2008/07/17 15:22:51 chiguire Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.4 2011/08/18 13:19:44 nimiux Exp $ -->
-<guide link="/doc/en/postgres-howto.xml" lang="es">
-<title>PostgreSQL Guide</title>
+<guide lang="es">
+<title>Guía rápida de PostgreSQL</title>
<author title="Autor">
- <mail link="chriswhite@gentoo.org">Chris White</mail>
+ <mail link="titanofold@gentoo.org">Aaron W. Swenson</mail>
</author>
<author title="Editor">
- <mail link="neysx@gentoo.org">Xavier Neys</mail>
+ <mail link="pgsql-bugs@gentoo.org">Mikkel A. Clausen</mail>
</author>
<author title="Traductor">
<mail link="chiguire@gentoo.org">John Christian Stoddart</mail>
</author>
-
+<author title="Traductor">
+ <mail link="nimiux"/>
+</author>
<abstract>
-La intención de esta guía es mostrar la configuración básica de
-PostgreSQL. La configuración descrita aquí debería ser suficiente para
-usar en aplicaciones web básicas y cualquier otro programa que
-proporcione soporte para PostgreSQL.
+Este documento es una guía rápida de PostgreSQL. Cubre la instalación
+y configuración de PostgreSQL. Esta guía complementa la documentación
+oficial, pero no la sustituye.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.2</version>
-<date>2007-04-25</date>
+<version>8</version>
+<date>2011-08-08</date>
<chapter>
<title>Introduction</title>
<section>
-<title>PostgreSQL introduction</title>
+<title>Algunas cosas acerca de PostgreSQL</title>
<body>
<p>
-Al conversar con la mayoría de los desarrolladores acerca del uso de
-distintas soluciones al manejo de bases de datos, los dos principales
-manejadores de bases de datos formarán la respuesta. Una sería
-<c>MySQL</c> y la otra sería la materia de este documento,
-<c>PostgreSQL</c>. Las ventajas de uno sobre el otro suele traer un
-debate largo y tendido, sin embargo es justo decir que PostgreSQL ha
-tenido una concepción más firme de lo que supone son las verdaderas
-estructuras que corresponden a un manejador de bases de datos
-relacional que MySQL. La mayoría de las características estándar como
-<b>FOREIGN KEY</b> fueron apenas agregadas en MySQL versión 5. Sin
-embargo, cualesquiera sea el caso, este documento asume que ha
-seleccionado PostgreSQL como el manejador de bases de dato que va a
-utilizar. El primer lugar donde comenzar es el proceso
-<c>emerge</c>. En la siguiente sección, el proceso de instalación
-usando emerge será descrito, al igual que la configuración básica.
+<uri link="http://www.postgresql.org">PostgreSQL</uri> es un sistema de
+base de datos relacional (RDBMS). Soporta muchas características de estos
+sistemas como transacciones, esquemas y claves ajenas y a menudo se le
+considera más segura y que cumple mejor los estándares SQL que cualquier
+otra base de datos bien sea comercial o de otro tipo.
+</p>
+
+<p>
+Visite la página <uri link="http://www.postgresql.org/about/">Acerca de
+</uri> (en inglés) en postgresql.org para más información.
</p>
+
</body>
</section>
-
<section>
-<title>Instalación de PostgreSQL</title>
+<title>Lo que cubre este documento</title>
<body>
<p>
-Para comenzar debemos primero hacer <c>emerge</c> al paquete
-PostgreSQL. Para hacer esto, ejecute primero el siguiente comando para
-asegurar que las opciones necesarias están correctamente configuradas:
+Este documento le guiará a través de los pasos específicos que se deben
+realizar para instalar la base de datos relacional PostgreSQL en Gentoo.
</p>
-<pre caption="Revisando las opciones para construir PostgreSQL">
-# <i>emerge -pv postgresql</i>
+<p>
+Los ebuilds cubiertos en este artículo son los siguientes: <uri
+link="http://packages.gentoo.org/package/dev-db/postgresql-docs">
+dev-db/postgresql-docs</uri>, <uri
+link="http://packages.gentoo.org/package/dev-db/postgresql-base">
+dev-db/postgresql-base</uri> y <uri
+link="http://packages.gentoo.org/package/dev-db/postgresql-server">
+dev-db/postgresql-server</uri>.
+</p>
-These are the packages that I would merge, in order:
+<p>
+En este documento se presupone que va a instalar la última versión estable
+de PostgreSQL. En el momento de escribir este documento, esta versión es
+la 9.0.3. Modifique los comando en este artículo de forma adecuada para
+especificar la versión.
+</p>
-Calculating dependencies ...done!
-[ebuild N ] dev-db/postgresql-8.0.4 -doc -kerberos +nls +pam +perl
--pg-intdatetime +python +readline (-selinux) +ssl -tcl +xml +zlib 0 kB
-</pre>
+<impo>
+La rama 8.2 branch ya no será mantenida por el equipo de desarrollo de
+PostgreSQL a partir de diciembre de 2011. Comience a planificar su
+migración.
+</impo>
+
+</body>
+</section>
+<section>
+<title>Sobre los ebuilds</title>
+<body>
<p>
-Aquí está una lista de lo que significa cada una de las distintas
-opciones de construcción:
+Los ebuilds de PostgreSQL en Portage se caracterizan por estar basados en
+ranuras (slots) para su versión principal. Esto le permite tener dos
+versiones principales de PostgreSQL funcionando a la vez, las librerías
+y servidores de la 8.4 y la 9.0 puede estar instaladas en el mismo sistema.
+Esto es útil en aquellas circunstancias en que necesite mover datos
+de una base de datos antigua a una nueva, o necesite tener una base de
+datos en producción y una de pruebas en la misma máquina. También, esto
+evita que una base de datos o sus librerías y ejecutables sean sobreescritos
+por una actualización incompatible. Esto requeriría una migración que
+también se cubre en esta guía.
</p>
-<table>
-<tr>
- <th>Parámetro USE</th>
- <th>Significado</th>
-</tr>
-<tr>
- <ti>doc</ti>
- <ti>
- Este parámetro USE activa o desactiva la instalación de la
- documentación, aparte de las páginas man. La única buena razón
- para desactivar esta opción es si no dispone de mucho espacio en
- disco o alternativamente tiene otra forma de acceso a la
- documentación (en línea, etc.)
- </ti>
-</tr>
-<tr>
- <ti>kerberos</ti>
- <ti>
- Al conectarse a la base de datos con esta opción activada, el
- administrador tiene la opción de usar el sistema <c>kerberos</c>
- para autentificar los usuarios/servicios a la base de datos.
- </ti>
-</tr>
-<tr>
- <ti>nls</ti>
- <ti>
- Si se activa esta opción, PostgreSQL puede utilizar cadenas
- traducidas para los usuarios que no hablan inglés.
- </ti>
-</tr>
-<tr>
- <ti>pam</ti>
- <ti>
- Si se activa esta opción y si el administrador la configura
- correctamente, los usuarios/servicios podrán hacer login a una
- base de datos PostgreSQL usando <c>PAM</c> (Pluggable
- Authentication Module).
- </ti>
-</tr>
-<tr>
- <ti>perl</ti>
- <ti>
- Si se activa esta opción se construirán los enlaces de <c>perl</c>
- para PostgreSQL.
- </ti>
-</tr>
-<tr>
- <ti>pg-intdatetime</ti>
- <ti>
- Si activamos esta opción PostgreSQL soportará enteros de 64 bits.
- </ti>
-</tr>
-<tr>
- <ti>python</ti>
- <ti>
- Si se activa esta opción se construirán PostgreSQL con enlaces
- para <c>python</c>.
- </ti>
-</tr>
-<tr>
- <ti>readline</ti>
- <ti>
- Si se activa esta opción, PostgreSQL soportará la edición de línea
- de comando estilo <c>readline</c>. Esto incluye historial de
- comando e isearch.
- </ti>
-</tr>
-<tr>
- <ti>selinux</ti>
- <ti>
- Si activamos esta opción, se instalará una política <c>selinux</c>
- para PostgreSQL.
- </ti>
-</tr>
-<tr>
- <ti>ssl</ti>
- <ti>
- Si activamos esta opción, PostgreSQL usará la librería
- <c>OpenSSL</c> para encriptar el tráfico entre clientes y
- servidores PostgreSQL.
- </ti>
-</tr>
-<tr>
- <ti>tcl</ti>
- <ti>
- Si se activa esta opción se construirá PostgreSQL con enlaces para
- <c>tcl</c>.
- </ti>
-</tr>
-<tr>
- <ti>xml2</ti>
- <ti>
- Si activamos esta opción, se construirá soporte al estilo
- <c>XPATH</c>. Para más información acerca del soporte de XML con
- PostgreSQL, vea:
- <uri link="http://www.throwingbeans.org/tech/postgresql_and_xml.html">
- PostgreSQL and XML</uri>.
- </ti>
-</tr>
-<tr>
- <ti>zlib</ti>
- <ti>
- Esta opción realmente no se utiliza por PostgreSQL, sino por el
- comando <c>pg_dump</c> para comprimir las descargas de datos
- producidas.
- </ti>
-</tr>
-</table>
+<p>
+Además, las correcciones de fallos y de seguridad que se envían a través
+de las actualizaciones de versiones menores, se pueden aplicar sin el
+miedo de corromper la base de datos o la instalación de PostgreSQL. Se
+puede actualizar la versión 9.0.2 a la 9.0.3 ya que su compatibilidad está
+garantizada y no requiere interacción por su parte salvo hacer emerge
+y reiniciar el proceso servidor; ninguna migración, reconfiguración o
+inicialización son necesarias.
+</p>
<p>
-Una vez afinada la construcción de PostgreSQL a sus necesidades
-específicas, continúe con el <c>emerge</c>:
+Lea la <uri link="http://www.postgresql.org/support/versioning">Política
+de versiones de PostgreSQL</uri> (en inglés) para más información.
</p>
-<pre caption="Haciendo el emerge de PostgreSQL">
-# <i>emerge postgresql</i>
-<comment>(Esta salida ha sido recortada)</comment>
->>> /usr/lib/libecpg.so.5 -> libecpg.so.5.0
->>> /usr/bin/postmaster -> postgres
- * Make sure the postgres user in /etc/passwd has an account setup with /bin/bash as the shell
- *
- * Execute the following command
- * emerge --config =postgresql-8.0.4
- * to setup the initial database environment.
- *
->>> Regenerating /etc/ld.so.cache...
->>> dev-db/postgresql-8.0.4 merged.
-</pre>
+</body>
+</section>
+<section>
+<title>Qué aspectos no cubre este documento</title>
+<body>
<p>
-Tal como se evidencia en la salida einfo, hay configuraciones
-post-instalación que deben ser atendidas. El siguiente capítulo
-tratará la configuración de PostgreSQL.
+Algunos aspectos de PostgreSQL no se cubren en este documento. La <uri
+link="http://www.postgresql.org/docs/">documentación oficial</uri> (en
+inglés) tiene cerca de 2.000 pages, por lo que muchos detalles quedarán
+fuera de esta guía de inicio. Únicamente se cubrirán los aspectos
+específicos de Gentoo y algunas pautas básicas de configuración.
</p>
+
</body>
</section>
</chapter>
-<chapter>
-<title>Configuración de PostgreSQL</title>
+<chapter id="installation">
+<title>Instalación</title>
<section>
-<title>Estableciendo el entorno inicial de base de datos</title>
+<title>Los ebuilds obsoletos</title>
<body>
<p>
-Tal como notamos en la salida del <c>emerge</c> recién hecho, debemos
-establecer el entorno inicial para las bases de datos. Sin embargo,
-antes de hacer esto, debemos considerar un asunto. A diferencia de
-MySQL, la contraseña del usuario "root" de PostgreSQL es la de usuario
-actual, aunque el ebuild solo crea el usuario <e>no</e> la
-contraseña. Así que, antes de comenzar, debemos establecer la
-contraseña para el usuario postgres:
+Si tiene alguno de los siguientes ebuilds instalados, entonces su sistema
+tiene instalada una versión antigua y obsoleta de PostgreSQL para Gentoo
+y debería migrar inmediatamente: dev-db/postgresql-libs,
+dev-db/postgresql-client, dev-db/libpq y/o dev-db/postgresql.
</p>
-<pre caption="Estableciendo la contraseña">
-# <i>passwd postgres</i>
-New UNIX password:
-Retype new UNIX password:
-passwd: password updated successfully
-</pre>
-
<p>
-Ahora que esto está configurado, podemos continuar con la creación del
-entorno inicial para las bases de datos:
+Este documento cubre la <uri link="#oldmigration">migración</uri> desde los
+antiguos ebuilds a los nuevos.
</p>
-<pre caption="Configurando el entorno para las bases de datos con emerge --config">
-# <i>emerge --config =postgresql-8.0.4</i>
-
-
-Configuring pkg...
-
- * Creating the data directory ...
- * Initializing the database ...
-The files belonging to this database system will be owned by user "postgres".
-This user must also own the server process.
-
-The database cluster will be initialized with locale C.
+</body>
+</section>
+<section>
+<title>Ajustes USE</title>
+<body>
-fixing permissions on existing directory /var/lib/postgresql/data ... ok
-creating directory /var/lib/postgresql/data/global ... ok
-creating directory /var/lib/postgresql/data/pg_xlog ... ok
-creating directory /var/lib/postgresql/data/pg_xlog/archive_status ... ok
-creating directory /var/lib/postgresql/data/pg_clog ... ok
-creating directory /var/lib/postgresql/data/pg_subtrans ... ok
-creating directory /var/lib/postgresql/data/base ... ok
-creating directory /var/lib/postgresql/data/base/1 ... ok
-creating directory /var/lib/postgresql/data/pg_tblspc ... ok
-selecting default max_connections ... 100
-selecting default shared_buffers ... 1000
-creating configuration files ... ok
-creating template1 database in /var/lib/postgresql/data/base/1 ... ok
-initializing pg_shadow ... ok
-enabling unlimited row size for system tables ... ok
-initializing pg_depend ... ok
-creating system views ... ok
-loading pg_description ... ok
-creating conversions ... ok
-setting privileges on built-in objects ... ok
-creating information schema ... ok
-vacuuming database template1 ... ok
-copying template1 to template0 ... ok
+<table>
+ <tr>
+ <th>Ajuste USE</th>
+ <th>Significado</th>
+ </tr>
+ <tr>
+ <ti>doc</ti>
+ <ti>
+ Instala la <uri link="http://www.postgresql.org/docs/">documentación
+ en línea</uri> en su sistema (la documentación está en inglés).
+ </ti>
+ </tr>
+ <tr>
+ <ti>kerberos</ti>
+ <ti>Soporte para la autenticación usando Kerberos.</ti>
+ </tr>
+ <tr>
+ <ti>ldap</ti>
+ <ti>
+ Soporte para realizar la autenticación y búsqueda de parámetros de
+ conexión utilizando LDAP.
+ </ti>
+ </tr>
+ <tr>
+ <ti>nls</ti>
+ <ti>
+ Habilita los mensajes en otros idiomas aparte del inglés. Es
+ utilizado junto con la variable LINGUAS.
+ </ti>
+ </tr>
+ <tr>
+ <ti>pam</ti>
+ <ti>
+ Soporta para realizar la autenticación utilizando PAM (Pluggable
+ Authentication Modules).
+ </ti>
+ </tr>
+ <tr>
+ <ti>perl</ti>
+ <ti>
+ Habilita el soporte para utilizar Perl a la hora de escribir funciones
+ y procedimientos disparadores (trigger procedures).
+ </ti>
+ </tr>
+ <tr>
+ <ti>pg-intdatetime (Depreciada)</ti>
+ <ti>
+ Utiliza el nuevo método de alta resolución con enteros de 64 bits
+ para el formateo de sellos de tiempo (timestamps) en lugar del antiguo
+ método en coma flotante. A menos que tuviera una instalación antigua
+ que utilizara este método ahora depreciado, deje este ajuste
+ habilitado (lea la nota de abajo).
+ </ti>
+ </tr>
+ <tr>
+ <ti>pg_legacytimestamp</ti>
+ <ti>
+ Utiliza el antiguo método en coma flotante para el formateo de sellos
+ de tiempo (timestamps) en lugar del método de mayor resolución con
+ enteros de 64 bits. A menos que tenga una instalación previa que
+ utilizara este método ahora depreciado, deje este ajuste
+ deshabilitado (lea la nota de abajo).
+ </ti>
+ </tr>
+ <tr>
+ <ti>python</ti>
+ <ti>
+ Habilita el soporte para utilizar Python a la hora de escribir funciones
+ y procedimientos disparadores (trigger procedures).
+ </ti>
+ </tr>
+ <tr>
+ <ti>readline</ti>
+ <ti>
+ Seguro que desea que este ajuste está habilitado. Si se deshabilita,
+ se perderá la capacidad de editar las líneas de comandos y la historia
+ en psql.
+ </ti>
+ </tr>
+ <tr>
+ <ti>selinux</ti>
+ <ti>
+ Instala la directriz de SELinux respectiva. Este ajuste solo puede ser
+ habilitando cuando se usa un perfil SELinux.
+ </ti>
+ </tr>
+ <tr>
+ <ti>ssl</ti>
+ <ti>Habilita el soporte para las conexiones SSL.</ti>
+ </tr>
+ <tr>
+ <ti>tcl</ti>
+ <ti>
+ Habilita el soporte para utilizar Tcl a la hora de escribir funciones
+ y procedimientos disparadores (trigger procedures).
+ </ti>
+ </tr>
+ <tr>
+ <ti>threads</ti>
+ <ti>
+ Hace que las librerías clientes sean seguras en lo que a hilos de
+ ejecución (threads) se refiere. El resto de su sistema puede que sea
+ igualmente seguro respecto a los hilos de ejecución.
+ </ti>
+ </tr>
+ <tr>
+ <ti>uuid</ti>
+ <ti>
+ Incluye soporte para generar identificadores únicos y aleatorios de
+ 128 bits. Esto es útil para mezclar bases de datos de modo que las
+ probabilidades de colisión sean extremadamente bajas.
+ </ti>
+ </tr>
+ <tr>
+ <ti>xml</ti>
+ <ti>Habilita el soporte SQL/XML.</ti>
+ </tr>
+ <tr>
+ <ti>zlib</ti>
+ <ti>Soporte para archivos comprimidos en pg_dump y pg_restore.</ti>
+ </tr>
+</table>
-WARNING: enabling "trust" authentication for local connections
-You can change this by editing pg_hba.conf or using the -A option the
-next time you run initdb.
+<note>
+Si se cambia el ajuste 'pg-intdatetime' o el 'pg_legacytimestamp' será
+necesario hacer un volcado (dump) y restauración (restore) de su base de
+datos si alguna de ellas utiliza sellos de tiempo. Los métodos son
+incompatibles el uno con el otro.
+</note>
-Success. You can now start the database server using:
+</body>
+</section>
+<section>
+<title>Comienzo de la instalación</title>
+<body>
- /usr/bin/postmaster -D /var/lib/postgresql/data
-or
- /usr/bin/pg_ctl -D /var/lib/postgresql/data -l logfile start
+<pre caption="Haciendo emerge del servidor de PostgreSQL">
+# <i>emerge -av dev-db/postgresql-server</i>
- *
- * You can use /etc/init.d/postgresql script to run PostgreSQL instead of pg_ctl.
- *
+[ebuild N ] dev-db/postgresql-docs-9.0.3 0 kB
+[ebuild N ]dev-db/postgresql-base-9.0.3 USE="doc nls pam readline ssl zlib
+ -kerberos -ldap -pg_legacytimestamp -threads" LINGUAS="-af -cs -de -es -fa -fr
+ -hr -hu -it -ko -nb -pl -pt_BR -ro -ru -sk -sl -sv -tr -zh_CN -zh_TW" 0 kB
+[ebuild N ] dev-db/postgresql-server-9.0.3 USE="doc nls perl python
+ -pg_legacytimestamp (-selinux) -tcl -uuid -xml" LINGUAS="-af -cs -de -es -fa
+ -fr -hr -hu -it -ko -nb -pl -pt_BR -ro -ru -sk -sl -sv -tr -zh_CN -zh_TW" 0 kB
</pre>
<p>
-Ahora que configuramos el entorno inicial, la siguiente sección
-tratará cómo verificar la instalación y configurar usuarios para que
-tengan acceso a la base de datos.
+Puede que reciba una notificación indicando que algunos de los paquetes de
+arriba están bloqueados por alguno de los siguientes paquetes:
+dev-db/postgresql-libs, dev-db/postgresql-client, dev-db/libpq o
+dev-db/postgresql. Estos paquetes ya <b>no se mantienen</b> y por tanto
+son obsoletos. Consulte la sección de <uri link="#oldmigration">migración
+</uri> para saber cómo tratar esta situación.
</p>
+
</body>
</section>
-
<section>
-<title>Configuración de base de datos PostgreSQL</title>
+<title>Preparación para la inicialización del cluster de base de datos</title>
<body>
<p>
-Ahora que configuramos PostgreSQL, es una buena idea verificar la
-instalación en esta coyuntura. Primero, veamos si el servicio arranca
-bien:
+Una vez que se ha terminado la instalación de los paquetes puede que
+desee editar el fichero <path>/etc/conf.d/postgresql-9.0</path>. Hay
+tres líneas dentro de él que afectan el comportamiento por defecto del
+servidor y que <b>no</b> pueden cambiarse más adelante sin borrar el
+directorio que contiene el cluster de la base de datos y reinicializar.
</p>
-<pre caption="Iniciando el servicio PostgreSQL">
-# <i>/etc/init.d/postgresql start</i>
-* Starting PostgreSQL ... [ ok ]
-</pre>
+<p>
+<e>PGDATA</e> define el lugar donde se almacenan los ficheros de
+configuración. <e>DATA_DIR</e> define el lugar donde se creará el cluster
+de base de datos y ficheros relacionados. <e>PG_INITDB_OPTS</e> puede
+contener <uri
+link="http://www.postgresql.org/docs/current/static/app-initdb.html">
+opciones extra</uri> que debe tener cuidad al definir. Las opciones extra
+<b>no</b> son obligatorias y los valores por defectos son, ejem...,
+razonables.
+</p>
<p>
-Una vez verificado esto, es una buena idea agregarlo al nivel de
-ejecución por defecto, para que inicie el servicio al arrancar la
-máquina:
+En el siguiente ejemplo, <e>PGDATA</e> muestra que los ficheros de
+configuración están almacenados en <path>/etc/postgresql-9.0/</path>.
+<e>DATA_DIR</e> muestra que el cluster de base de datos debe instalarse en
+<path>/var/lib/postgresql/9.0/data/</path>, que es el valor por defecto.
+Recuerde que es una <b>muy buena idea</b>, mantener la versión mayor en el
+nombre de la ruta. <e>PG_INITDB_OPTS</e> muestra que la localización por
+defecto debe ser <e>en_ES.UTF-8</e>. Esto es, orden y formateo usando
+el idioma español de España codificación de caracteres UTF-8.
</p>
-<pre caption="Agregando el servicio al nivel de ejecución default">
-# <i>rc-update add postgresql default</i>
-* postgresql added to runlevel default
+<pre caption="Ejemplo del contenido de /etc/conf.d/postgresql-8.4">
+<comment># Location of configuration files</comment>
+PGDATA="/etc/postgresql-9.0/"
+
+<comment># Where the data directory is located/to be created</comment>
+DATA_DIR="/var/lib/postgresql/9.0/data"
+
+<comment># Additional options to pass to initdb.
+# See 'man initdb' for available options.</comment>
+PG_INITDB_OPTS="--locale=es_ES.UTF-8"
</pre>
+<note>
+Esto determina únicamente la localización y codificación de caracteres
+por defecto. Puede especificar otras localizaciones y codificaciones de
+caracteres en el momento de crear la base de datos (<c>CREATE DATABASE</c>)
+en el mismo cluster de base de datos.
+</note>
+
+<p>
+Existen seis opciones de localización que se pueden sobreescribir con
+<e>--locale=</e>. La siguiente tabla muestra las seis opciones que, en
+caso de ser utilizadas, serán formateadas como:
+<c>--opción=lo_LO.CODIFICACIÓN</c>.
+</p>
+
+<table>
+ <tr>
+ <th>Opción</th>
+ <th>Efectos</th>
+ </tr>
+ <tr>
+ <ti>lc-collate</ti>
+ <ti>Ordenación de cadenas de caracteres</ti>
+ </tr>
+ <tr>
+ <ti>lc-ctype</ti>
+ <ti>
+ Clasificación de caracteres (¿Qué es una letra? ¿Son equivalentes
+ las mayúsculas?)
+ </ti>
+ </tr>
+ <tr>
+ <ti>lc-messages</ti>
+ <ti>Idioma de los mensajes</ti>
+ </tr>
+ <tr>
+ <ti>lc-monetary</ti>
+ <ti>Formato de las cantidades que expresan divisas</ti>
+ </tr>
+ <tr>
+ <ti>lc-numeric</ti>
+ <ti>Formato de los números</ti>
+ </tr>
+ <tr>
+ <ti>lc-time</ti>
+ <ti>Formato de fechas y horas</ti>
+ </tr>
+</table>
+
<p>
-Ahora que el servicio ha iniciado, es hora de intentar establecer una
-base de datos de prueba. Para empezar, creémos una base de datos de
-prueba usando el comando <c>createdb</c>. Pasaremos la opción
-<c>-U</c> para configurar el usuario (por defecto toma el nombre del
-usuario actual) y la opción <c>-W</c> para solicitar la contraseña
-creada anteriormente y finalmente le damos el nombre a la base de
-datos que queremos crear:
+Por ejemplo, si quiere que el idioma por defecto de las bases de datos
+sea el español de España, pero quiere que los mensajes aparezcan, digamos,
+en Sueco, entonces su variable <e>PG_INITDB_OPTS</e> tendría este aspecto:
</p>
-<pre caption="Creando una base de datos con createdb">
-$ <i>createdb -U postgres -W test</i>
-Password:
-CREATE DATABASE
+<pre caption="Ejemplo">
+PG_INITDB_OPTS="--locale=en_ES.UTF-8 --lc-messages=sv_SE.UTF-8"
</pre>
<p>
-La base de datos fue creada exitosamente y podemos confirmar que la
-base de datos puede llevar a cabo tareas básicas. Seguiremos con
-un drop (borrando) la base de datos con el comando <c>dropdb</c>:
+Se puede encontrar una lista completa de idiomas y codificaciones de
+caracteres soportados por el servidor en la documentación, sin embargo,
+recuerde que para que esto funciones, su sistema debe tener soporte para
+los respectivos idiomas y codificaciones de caracteres. Compare la salida
+de <c>locale -a</c> con las <uri
+link="http://www.postgresql.org/docs/current/static/multibyte.html">
+codificaciones</uri> listadas en la documentaciones.
</p>
-<pre caption="Borrando una base de datos con dropdb">
-$ <i>dropdb -U postgres -W test</i>
-Password:
-DROP DATABASE
+<p>
+Puede cambiar la localización y codificación seleccionadas en el <uri
+link="http://www.postgresql.org/docs/current/static/sql-createdatabase.html">
+momento de crear</uri> la base de datos. Para cambiar la localización de
+la base de datos una vez creada, tendrá que eliminarla y comenzar de
+nuevo.
+</p>
+
+<pre caption="Finalizar la instalación">
+# <i>emerge --config dev-db/postgresql-server:9.0</i>
</pre>
<p>
-En este momento, solo el usuario postgres puede ejecutar
-comandos. Obviamente este no es el tipo de configuración que uno
-necesita en un entorno multi-usuario. La siguiente sección tratará el
-trabajo con cuentas de suarios.
+Esto creará el cluster de base de datos y almacenará los ficheros
+relacionados con el servidor en <e>PGDATA</e> y <e>DATA_DIR</e>.
</p>
+
</body>
</section>
+</chapter>
+<chapter>
+<title>Configuración</title>
<section>
-<title>Estableciendo cuentas de usuario para bases de datos</title>
+<title>Localización de los ficheros de configuración</title>
<body>
<p>
-Tal como mencionamos anteriormente, teniendo que hacer login como el
-usuario postgres no es deseable en un entorno multi-usuario. En la
-mayoría de los casos habrá varios usuarios y servicios con acceso al
-servidor y cada uno tendrá distintas necesidades y permisos. Para
-manejar esta situación se utiliza el comando <c>createuser</c>. Este
-comando es una alternativa al uso de algunas consultas SQL y es más
-flexible desde el punto de vista del administrador. Continuaremos
-creando dos usuarios, un 'superusario' que a su vez puede agregar
-otros usuarios y administrar la base de datos y un usuario normal:
+En esta sección nos centraremos en los ficheros presentes en el directorio
+<e>PGDATA</e>, <path>/etc/postgresql-9.0</path>, con especial relevancia en
+<path>postgresql.conf</path> y <path>pg_hba.conf</path>.
</p>
-<pre caption="Configurando un superusuario">
-<comment>(reemplace a chris con el usuario que desea crear)</comment>
-$ <i>createuser -a -d -P -E -U postgres -W chris</i>
-Enter password for new user:
-Enter it again:
-Password:
-CREATE USER
-</pre>
+</body>
+</section>
+<section>
+<title>postgresql.conf</title>
+<body>
<p>
-Listo, ya hemos creado el superusuario. La opción <c>-a</c> en la
-línea de comando especifica que este usuario puede agregar otros
-usuarios. La <c>-d</c> significa que puede crear otras bases de
-datos. La <c>-P</c> permite ingresar una contraseña para el usuario y
-la <c>-E</c> lo encriptará para fines de seguridad. Ahora probaremos
-los permisos de este usuario creando un usuario normal:
+Este es el fichero de configuración principal. Una línea que puede tener
+un especial interés es <e>listen_addresses</e>. Esta variable define a qué
+direcciones PostgreSQL se ceñirá. Por defecto, únicamente se utilizan
+localhost y el zócalo (socket) Unix. Cambiar <e>listen_addresses</e> no
+es suficiente para permitir conexiones remotas. Esto se cubrirá en la
+siguiente sección. La <uri
+link="http://www.postgresql.org/docs/current/static/runtime-config.html">
+documentación oficial</uri> es fácil de comprender y bastante exhaustiva en
+todos los ajustes disponibles. Le animo a leerla ya que algunas cosas
+comentadas aquí pueden haber cambiado.
</p>
-<pre caption="Configurando un usuario normal">
-<comment>(reemplace a chris con el usuario recién creado)</comment>
-$ <i>createuser -A -D -P -E -U chris -W testuser</i>
-Enter password for new user:
-Enter it again:
-Password:
-CREATE USER
-</pre>
+<p>
+De un interés secundario es el destino del registro. Por defecto, todo es
+registrado en <path>postmaster.log</path> en el directorio <e>DATA_DIR</e>.
+Existe una subsección completa en <path>postgresql.conf</path> que cubre
+un montón de opciones acerca de cómo, qué y dónde registrar. Esta
+subsección está etiquetada como: ERROR REPORTING AND LOGGING.
+</p>
<p>
-¡Éxito! Nuestro nuevo usuario fue creado usando el superusuario
-previamente creado. Las opciones <c>-A</c> y <c>-D</c> hacen lo
-opuesto de <c>-a</c> y <c>-d</c> y al contrario, niegan al usuario la
-posibilidad de crear usuarios y bases de datos. Ahora que tenemos unos
-usuarios con los cuales trabajar y cómo crear bases de datos, veremos
-en el siguiente capítulo como usar una nueva base de datos.
+Aparte de <e>listen_addresses</e> y las opciones de registro, el resto
+de valores por defecto en <path>postgresql.conf</path> son los
+suficientemente razonables para que todo funcione correctamente.
</p>
+
</body>
</section>
-</chapter>
-
-<chapter>
-<title>Usando PostgreSQL</title>
<section>
-<title>Estableciendo los permisos</title>
+<title>pg_hba.conf</title>
<body>
<p>
-Ahora tenemos un usuario que puede crear bases de datos y agregar
-otros usuarios y el principal usuario postgres que puede hacer
-cualquier cosa. El usuario creado anteriormente puede hacer login al
-servidor y nada más. En general, los usuarios necesitan insertar y
-recuperar datos y a veces hacer otras tareas. Para que este usuario
-nuevo pueda hacer algo, debemos establecer los permisos
-adecuados. Esto se puede hacer fácilmente pasando el parámetro
-<c>-O</c> al comando <c>createdb</c>. Comenzaremos creando una nueva
-base de datos, <b>MyDB</b> con nuestro superusuario cuyo dueño será el
-previo usuario testuser:
+El fichero <path>pg_hba.conf</path> indica a quién se permite la conexión
+al servidor de base de datos y qué método de autenticación se debe utilizar
+para establecer esta conexión. De nuevo, la documentación es lo
+suficientemente exhaustiva acerca de los ajustes y lo que éstos significan,
+sin embargo, algunas cosas se cubren aquí para que queden más claras.
</p>
-<pre caption="Creando la base de datos MyDB">
-$ <i>createdb -O testuser -U chris -W MyDB</i>
-Password:
-CREATE DATABASE
+<pre caption="Fichero pg_hba.conf por defecto">
+<comment># TYPE DATABASE USER CIDR-ADDRESS METHOD
+
+# "local" is for Unix domain socket connections only</comment>
+local all all trust
+<comment># IPv4 local connections:</comment>
+host all all 127.0.0.1/32 trust
+<comment># IPv6 local connections:</comment>
+host all all ::1/128 trust
</pre>
<p>
-Bien, ahora tenemos la base de datos MyDB y al usuario testuser que
-tiene acceso a ella. Para probar esto, haremos login como testuser a
-la nueva base de datos con el programa <c>psql</c>. Este programa es
-el usado para conectarse a una base de datos PostgreSQL desde la línea
-de comandos. Para establecer la conexión a la nueva base de datos
-haremos:
+Como ya se ha mencionado anteriormente, el servidor por defecto es seguro.
+O al menos debería. Por defecto, hay únicamente un rol de base de datos
+disponible para conectarse: <e>postgres</e>. La única forma de iniciar
+una conexión a la base de datos es a través del zócalo (socket) Unix
+<path>/var/run/postgresql/.s.PGSQL.5432</path>, cuyo propietario es el
+usuario y grupo de sistema <e>postgres</e>, la conexión a través de
+localhost también es posible. En lo que se refiere al anterior "debería ser
+seguro": Cualquier usuario del sistema puede conectarse a la base de datos
+a través de locahost. Incluso como el superusuario de la base de datos
+<e>postgres</e>.
</p>
-<pre caption="Haciendo login a la base de datos MyDB como testuser">
-$ <i>psql -U testuser -W MyDB</i>
-Password:
-Welcome to psql 8.0.4, the PostgreSQL interactive terminal.
-
-Type: \copyright for distribution terms
- \h for help with SQL commands
- \? for help with psql commands
- \g or terminate with semicolon to execute query
- \q to quit
+<p>
+Por el contrario, para realizar una conexión a través del zócalo Unix, los
+usuarios — incluyendo los usuario de otros servicios como
+<e>apache</e> — deben pertenecer al grupo del sistema <e>postgres</e>.
+Utilice <c>gpasswd -a <e>usuario</e> postgres</c> para al usuario
+<e>usuario</e> al grupo <e>postgres</e>. Las conexiones de los usuarios que
+no estén en el grupo <e>postgres</e> serán rechazadas con el mensaje
+"Permission denied" (Permiso denegado).
+</p>
-MyDB=>
-</pre>
+<warn>
+Nunca deshabilite el zócalo Unix completamente. Los guiones de inicio
+necesitan acceso al mismo para funcionar de forma correcta. El método
+de acceso se puede cambiar libremente.
+</warn>
<p>
-Ahora que testuser está conectado a la base de datos puede comenzar a
-ejecutar algunos comandos. Para ir viendo cómo es el manejo de
-PostgreSQL, en la siguiente sección se mostrarán algunos comandos
-básicos cuando naveguemos con el cliente <c>psql</c>.
+El método <e>trust</e> (confiable) permite a cualquier conectarse a la base
+de datos sin usar una contraseña. Especifica exactamente lo que indica:
+Confía en todas las conexiones para el tipo dado a la base de datos dada
+para el usuario dado (pero no el usuario del sistema) desde la localización
+dada sin necesidad de contraseña. Esto permite que cualquier usuario del
+sistema pueda conectarse como otro usuario a través de una conexión
+localhost. Esto no es tan peligroso como parece, pero implica un riesgo
+de seguridad en la mayoría de las circunstancias.
</p>
-</body>
-</section>
-
-<section>
-<title>Comandos básicos de PostgreSQL y creación de una tabla</title>
-<body>
<p>
-Los que estén acostumbrados al uso de MySQL deberían leer esta
-sección. Es aquí donde se empiezan a ver las características únicas de
-PostgreSQL respecto a la manera de ejecutar comando. Para empezar,
-aquí presentamos una lista de comandos que discutiremos:
+Los dos métodos que probablemente utilice son: <e>password</e> (contraseña)
+y <e>md5</e>. El método password method únicamente especifica que se
+necesita una contraseña válida para iniciar una conexión a la base de datos
+y que esa contraseña es enviada "de forma clara". Este método es correcto
+cuando esta información no salga nunca de la máquina, como una conexión
+a través del zócalo Unix o de localhost. El método md5 es similar al
+método password pero utiliza un hash md5 para evitar el envío de la
+contraseña en claro. Este método es el que se debe utilizar cuando la
+contraseña va a viajar por una red.
</p>
-<table>
-<tr>
- <th>Comando</th>
- <th>Uso</th>
- <th>Equivalente MySQL</th>
-</tr>
-<tr>
- <ti>\c[onnect] [DBNAME|- [USER]]</ti>
- <ti>Conecta a otra base de datos</ti>
- <ti>USE DATABASE</ti>
-</tr>
-<tr>
- <ti>\q</ti>
- <ti>Salir de cliente <c>psql</c></ti>
- <ti>quit</ti>
-</tr>
-<tr>
- <ti>\i FILE</ti>
- <ti>Ejecuta comandos del archivo <c>FILE</c></ti>
- <ti>source FILE</ti>
-</tr>
-<tr>
- <ti>\o [FILE]</ti>
- <ti>Envía los resultados de la consulta al archivo <c>FILE</c></ti>
- <ti>INTO OUTFILE, pero graba todo (no solo los SELECT)</ti>
-</tr>
-<tr>
- <ti>\d [NAME]</ti>
- <ti>Describe una base de datos o tabla (otros ítems también)</ti>
- <ti>DESC(RIBE)</ti>
-</tr>
-<tr>
- <ti>\db [PATTERN]</ti>
- <ti>
- Lista las tablas disponibles que concuerden con el patrón
- <c>PATTERN</c> (a todas, si no hay patrón)
- </ti>
- <ti>SHOW TABLES</ti>
-</tr>
-</table>
+<p>
+En este punto, al autor del documento le gustaría incidir en las dos
+últimas líneas (cuatro últimas si incluimos los comentarios) del fichero
+<path>pg_hba.conf</path>. PostgreSQL tiene soporte nativo de IPv6 a pesar
+de que no se desee este soporte. Además, las direcciones IPv4 se mapean
+automáticamente a IPv6, <e>esto es</e>, 127.0.0.1 se mapeará a
+:FFFF:127.0.0.1 y a una IPV6 "pura" ::FFFF:7F00:0001.
+</p>
<p>
-Con la excepción de <c>\c[onnect]</c>, todos los comandos se usarán más adelante
-en esta sección. Hasta ahora, la base de datos está vacía y dicho esto,
-necesitamos insertar alguna datos. Sin embargo, el primer paso para insertar
-datos es colocarla en una tabla. En este momento no tenemos tablas en la base de
-datos, por lo que debemos crear una. Esto lo hacemos con el comando
-<c>CREATE TABLE</c>. Crearemos una tabla de ítems, que contendrá los campos
-Product ID, Description y price:
+Sin embargo, parece existir alguna confusión acerca de cómo los nombres
+de los servidores se mapean a direcciones IP addresses. Echemos un vistazo
+al fichero <path>/etc/hosts</path>.
</p>
-<pre caption="Creando la tabla products">
-MyDB=> CREATE TABLE products (
-MyDB(> product_id SERIAL,
-MyDB(> description TEXT,
-MyDB(> price DECIMAL
-MyDB(> );
-NOTICE: CREATE TABLE will create implicit sequence "products_product_id_seq"
-for serial column "products.product_id"
-CREATE TABLE
+<pre caption="Fichero /etc/hosts ejemplo">
+<comment># IPv4 and IPv6 localhost aliases</comment>
+127.0.0.1 localhost
+::1 localhost
</pre>
<p>
-Puede ignorar la advertencia (NOTICE), no hay problema. Mirando la
-última línea de la función, el comando <c>CREATE TABLE</c> parece
-indicar que ha concluido exitosamente, sin embargo, verifiquemos que
-la tabla fue creada correctamente con el comando <c>\d</c>:
+En el ejemplo de arriba, se puede comprobar que tanto las direcciones
+IPv4 como las IPv6 IP se mapean a localhost. Cuando <c>psql</c> lee este
+fichero, usará la primera coincidencia y la usará como la dirección de
+acceso, en este caso 127.0.0.1. Cuando PostgreSQL analiza esto, también
+coincidirá también con la dirección formateada IPv6 formatted address, por
+ejemplo la ::ffff:127.0.0.1. Si, por el contrario, la dirección IPv6 aparece
+en primer lugar, entonces <c>psql</c> mapeará localhost a ::1, y ::1
+no es lo mismo que ::ffff:127.0.0.1. Por lo tanto, si no tiene a ::1 como
+una dirección de acceso permitida, <c>psql</c> no podrá establecer la
+conexión. Además de todo esto, su núcleo debe tener soporte para el
+protocolo IPv6 protocol.
</p>
-<pre caption="Examinando la tabla recién creada">
-MyDB=> <i>\d products</i>
- Table "public.products"
- Column | Type | Modifiers
--------------+---------+------------------------------------------------------------------
- product_id | integer | not null default nextval('public.products_product_id_seq'::text)
- description | text |
- price | numeric |
-</pre>
-
<p>
-De hecho, la tabla fue creada exitosamente. Habiendo cumplido este
-paso, debe ser poblada con datos. La siguiente sección tratará este
-tema.
+Por lo tanto, es mejor indicar una única dirección IP a <c>psql</c> y en
+<path>pg_hba.conf</path> en lugar de tener que depender de que el fichero
+<path>/etc/hosts</path> esté ordenado de forma adecuada, así se elimina
+cualquier duda de qué direcciones está permitidas o a qué servidor se
+realizará la conexión.
</p>
+
</body>
</section>
+</chapter>
+
+<chapter>
+<title>Arrancando el servidor</title>
+
<section>
-<title>Insertando la datos en la base de datos</title>
+<title>¡Pruébelo!</title>
<body>
<p>
-Esta sección examinará dos maneras de poblar la tabla recién creada
-con datos. Primero veamos el comando más básico, <c>INSERT</c>:
-</p>
+Arranque ahora PostgreSQL y defina la contraseña para el superusuario de
+la base de datos <e>postgres</e>. Las siguientes órdenes se deben ejecutar
+con el usuario 'root' tal y como se muestra a continuación:
+</p>
+
+<pre caption="Arrancar el servidor">
+<comment>(Cambie 'trust' a 'password' para las conexiones a localhost)</comment>
+# <i>nano -w /etc/postgresql-9.0/pg_hba.conf</i>
+# <i>/etc/init.d/postgresql-9.0 start</i>
+postgresql-9.0 | * Starting PostgreSQL ... [ ok ]
+
+<comment>(Abra una conexión al servidor y cambie la contraseña)</comment>
+# <i>psql -U postgres</i>
+psql (9.0.3)
+Type "help" for help.
+
+postgres=# <i>\password</i>
+Enter new password:
+Enter it again:
+postgres=# <i>\q</i>
-<pre caption="Sintáxis de INSERT">
-INSERT INTO [tablename] (column1,column2,column3) VALUES(value1,value2,value3)
+<comment>(Cambie 'trust' a 'password' para la conexión local)</comment>
+# <i>nano -w /etc/postgresql-9.0/pg_hba.conf</i>
+# <i>/etc/init.d/postgresql-9.0 reload</i>
+postgresql-9.0 | * Reloading PostgreSQL configuration ... [ ok ]
+# <i>rc-update add postgresql-9.0 default</i>
+ * service postgresql-9.0 added to runlevel default
</pre>
<p>
-<c>tablename</c> contiene el nombre de la tabla en la cual insertaremos
-datos. (column1,column2,column3) permite especificar las columnas
-específicas en las cuales insertar los
-valores. VALUES(value1,value2,value3) es el listado de los
-valores. Estos valores estan en el mismo orden que las
-columnas (column1 recibe value1, column2 recibe value2, column3 recibe
-value3). La cuenta de columnas y valores <e>debe</e> ser
-igual. Continuemos e insertemos un ítem en la tabla:
+En este punto, está preparado para continuar con el <uri
+link="http://www.postgresql.org/docs/current/static/tutorial.html">tutorial
+oficial de PostgreSQL</uri> (en inglés). El tutorial le guiará en la
+creación de roles, bases de datos, esquemas y todas esas útiles y
+divertidas características de las bases de datos relacionales.
</p>
-<impo>
-En base a mi experiencia trabajando con bases de datos desde hace
-largo tiempo, personalmente recomiendo especificar los enunciados
-<c>INSERT</c> exactamente de esta manera. Algunos desarrolladores a
-veces cometen la equivocación de usar <c>INSERT INTO</c> sin
-especificar las columnas. Esto es improductivo, como si se agregara
-una nueva columna a la base de datos, causará un error si el valor de
-cuenta de columnas no es igual. Debe <e>siempre</e> especificar las
-columnas a no ser que esté 300% seguro que nunca agregará una columna.
-</impo>
+</body>
+</section>
+</chapter>
-<pre caption="Insertando datos en la tabla">
-MyDB=> <i>INSERT INTO products (description,price) VALUES('A test product', 12.00);</i>
-INSERT 17273 1
-</pre>
+<chapter id="migrating">
+<title>Migrando PostgreSQL</title>
+<section>
+<title>Cuándo necesita migrar</title>
+<body>
<p>
-La última línea requiere algo de explicación. El retorno de un comando
-insert es un OID (Object Identifier, en inglés o identificador de
-objeto) y la cantidad de hileras insertadas. Los OID están algo más
-allá de alcance de esta guía, pero puede obtener buena información en
-el <uri
-link="http://www.postgresql.org/docs/8.1/static/datatype-oid.html">manual
-PostgreSQL</uri>. Ahora, en una situación donde tiene 20.000
-productos, estos enunciados de inserción pueden ser algo tediosos. Sin
-embargo, no todo está perdido. El comando <c>COPY</c> puede utilizarse
-para insertar datos en una tabla desde un archivo o desde stdin. En
-este ejemplo asumamos que dispone de un archivo csv (valores separados
-por comas) que contiene el id del producto, la descripción y el
-precio. El archivo se parecería algo así:
+Existen dos razones por las que necesitará relizar una migración: Cuando
+cambie de una versión mayor a otra, <e>por ejemplo</e>, desde PostgreSQL
+8.4.7 a 9.0.3, pero no desde 9.0.2 to 9.0.3 o cuando cambie de una base
+de datos con formato de sello de tiempo (timestamp) en coma flotante
+a otra con el formato de enteros de 64 bits.
</p>
-<pre caption="Archivo products.csv">
-2,meat,6.79
-3,soup,0.69
-4,soda,1.79
-</pre>
+<note>
+Necesitará migrar su base de datos cuando cambie los ebuilds obsoletos
+— dev-db/libpq, dev-db/postgresql, dev-db/postgresql-libs, y
+dev-db/postgresql-client — a los nuevos ebuilds —
+dev-db/postgresql-docs, dev-db/postgresql-base y dev-db/postgresql-server.
+</note>
+
+</body>
+</section>
+<section id="post90">
+<title>Post-migración 9.0</title>
+<body>
<p>
-Ahora usaremos el comando <c>COPY</c> para poblar nuestra tabla con
-datos:
+La nueva utilidad <e>pg_upgrade</e> que incorporan las versiones 9.0 y
+posteriores, simplifican el proceso de migración drásticamente.
</p>
-<impo>
-El comando <c>COPY FROM STDIN</c> se usa porque solamente el usuario
-postgres puede insertar datos de un archivo (obviamente por razones de
-seguridad).
-</impo>
-
-<pre caption="Usando COPY para poblar la tabla products">
-MyDB=> <i>COPY products FROM STDIN WITH DELIMITER AS ',';</i>
-Enter data to be copied followed by a newline.
-End with a backslash and a period on a line by itself.
->> <i>2,meat,6.79</i>
->> <i>3,soup,0.69</i>
->> <i>4,soda,1.79</i>
->> <i>\.</i>
+<p>
+Sin embargo hay dos problemillas cuando se utiliza pg_upgrade. En primer
+lugar, no soporta el hecho de que los ficheros de configuración se
+encuentren en un directorio diferente del de datos. Esto se puede
+resolver usando enlaces simbólicos. En segundo lugar, sólo permite la
+migración de bases de datos a partir de la versión 8.3 or newer. Si tiene
+una versión de base de datos anterior, necesitará seguir las instrucciones
+<uri link="#pre90">Pre-migración 9.0</uri>.
+</p>
+
+<pre caption="Migrar con pg_upgrade">
+<comment>(Detenga los servidores desde los que va a migrar y a los que va a migrar)</comment>
+# <i>/etc/init.d/postgresql-8.4 stop</i>
+# <i>/etc/init.d/postgresql-9.0 stop</i>
+# <i>ln -s /etc/postgresql-8.4/*.conf /var/lib/postgresql/8.4/data/</i>
+# <i>ln -s /etc/postgresql-9.0/*.conf /var/lib/postgresql/9.0/data/</i>
+
+<comment>(Cambie el método de acceso a la base de datos del usuario 'postgres' a trust en conexiones locales para todas las bases de datos)</comment>
+# <i>nano -w /etc/postgresql-8.4/pg_hba.conf</i>
+# <i>nano -w /etc/postgresql-9.0/pg_hba.conf</i>
+
+<comment>Necesitará cambiar los permisos de '/var/lib/postgresql/' antes de continuar con el siguiente paso.</comment>
+# <i>su - postgres</i>
+$ <i>pg_upgrade -u postgres \
+ -d /var/lib/postgresql/8.4/data -D /var/lib/postgresql/9.0/data \
+ -b /usr/lib/postgresql-8.4/bin -B /usr/lib/postgresql-9.0/bin</i>
+<comment>(Si pg_upgrade le pide que realice alguna tarea, hágala)</comment>
+$ <i>logout</i>
+
+<comment>(Elimine los enlaces simbólicos que se han creado anteriormente)</comment>
+# <i>rm /var/lib/postgresql/8.4/data/*.conf</i>
+# <i>rm /var/lib/postgresql/9.0/data/*.conf</i>
+# <i>/etc/init.d/postgresql-9.0 start</i>
</pre>
-<p>
-Desafortunadamente esta línea no retorna la misma información de
-resultado que el enunciado <c>INSERT INTO</c>. Entonces ¿cómo sabremos
-si los datos fueron insertados? La siguiente sección examinará cómo realizar
-consultas para revisar nuestros datos.
-</p>
</body>
</section>
-
-<section>
-<title>Usando consultas en PostgreSQL</title>
+<section id="pre90">
+<title>Pre-migración 9.0: Con los ebuilds nuevos</title>
<body>
<p>
-Esta sección mostrará cómo usar el enunciado <c>SELECT</c> para
-visualizar los datos en nuestras tablas. El formato básico <c>SELECT</c>
-es así:
+Debido a que los nuevos ebuilds incorporan características de uso de
+ranuras (slots) más avanzadas que las antiguas, el tiempo en el que la
+base de datos está parada es mínimo, normalmente minutos en lugar de horas.
</p>
-<pre caption="Sintaxis de SELECT">
-SELECT (column1,column2|*) FROM (table) [WHERE (conditionals)]
-</pre>
+<p>
+En los ejemplos que siguen, se asume que está utilizando las localizaciones
+y puertos por defecto, y que está migrando desde la versión 8.3 a la 8.4.
+Cambie lo que necesite si su sistema no tiene los ajustes por defecto.
+</p>
<p>
-Existen dos maneras de seleccionar columnas. La primera usa el <c>*</c>
-para seleccionar todas la columnas y la segunda especifica una lista
-de columnas que desea ver. La segunda es muy práctica cuando desea
-encontrar una columna específica en una lista larga. Comenzamos usando
-<c>SELECT</c> con el <c>*</c> para buscar todas las columnas:
+Si no lo ha hecho aún, siga las <uri link="#installation">instrucciones de
+instalación</uri> antes de comenzar la migración. La compilación puede
+dificultar el rendimiento del servidor de base de datos, pero se puede
+continuar trabajando.
</p>
-<pre caption="Visualizando la tabla products">
-MyDB=> <i>SELECT * FROM products;</i>
- product_id | description | price
-------------+----------------+-------
- 1 | A test product | 12.00
- 2 | meat | 6.79
- 3 | soup | 0.69
- 4 | soda | 1.79
-(4 rows)
-</pre>
+<p>
+Se necesita modificar un par de ficheros antes de comenzar la migración.
+Cambie el valor de <e>PGPORT</e> en el fichero de configuración
+<path>/etc/conf.d/postgresql-8.4</path> a 6543. (Cualquier número de
+puerto distinto al definido en su antigua instalación funcionará
+igualmente).
+</p>
<p>
-Como vemos, todos los datos insertados anteriormente estan en la
-tabla. Ahora digamos que solamente queremos ver las descripciones y el
-precio y que no nos importa el id del producto. En este caso usaremos
-la forma de SELECT donde podamos escoger las columnas:
+A continuación, edite el fichero
+<path>/etc/postgresql-8.3/pg_hba.conf</path> de forma que únicamente el
+superusuario <e>postgres</e> pueda acceder a la base de datos a través
+del zócalo Unix.
</p>
-<pre caption="Visualizando columnas específicas de la tabla products">
-MyDB=> <i>SELECT description,price FROM products;</i>
- description | price
-----------------+-------
- A test product | 12.00
- meat | 6.79
- soup | 0.69
- soda | 1.79
-(4 rows)
+<pre caption="Migrar con las nuevos ebuilds">
+# <i>cp -p /etc/postgresql-8.3/pg_hba.conf /etc/postgresql-8.4/</i>
+
+<comment>(Lo que sigue debería ser seguro, Lea la documentación para estar más seguro)</comment>
+# <i> cp -p /etc/postgresql-8.3/postgresql.conf /etc/postgresql-8.4/</i>
+<comment>
+(No olvide copiar cualquier fichero de configuración que necesite)
+</comment>
+# <i>/etc/init.d/postgresql-8.3 reload</i>
+# <i>/etc/init.d/postgresql-8.4 start</i>
+
+<comment>(Comience entubando los datos desde el antiguo cluster al nuevo)</comment>
+# <i>pg_dumpall -U postgres -p 5432 | psql -U postgres -d postgres -p 6543</i>
+# <i>/etc/init.d/postgresql-8.3 stop</i>
+# <i>/etc/init.d/postgresql-8.4 stop</i>
+
+<comment>(Cambie PGPORT de nuevo al valor 5432.)</comment>
+# <i>nano -w /etc/conf.d/postgresql-8.4</i>
+<comment>(Permita de nuevo el acceso a los usuarios)</comment>
+# <i>nano -w /etc/postgresql-8.4/pg_hba.conf</i>
+# <i>/etc/init.d/postgresql-8.4 start</i>
+# <i>rc-update del postgresql-8.3 && rc-update add postgresql-8.4 default</i>
</pre>
<p>
-Ahora solo aparecen el producto y el precio, permitiéndonos enfocar
-solamente en los datos más importantes. Digamos que solamente queremos
-ver los ítems cuyo precio sea mayor a $2.00. Aquí es donde entra en
-juego la cláusula <c>WHERE</c>:
+Seguramente todo haya ido de acuerdo al plan y habrá actualizado de
+forma correcta su servidor y éste contendrá exactamente los mismos datos,
+bit a bit, tal y como estaban en el antiguo servidor.
+</p>
+
+</body>
+</section>
+<section id="oldmigration">
+<title>Pre-migración 9.0: Desde los ebuilds obsoletos</title>
+<body>
+
+<p>
+Necesitará programar la bajada de su servidor durante algún tiempo. Los
+antiguos ebuilds <b>no</b> se pueden instalar a la vez que los nuevos.
+Por lo tanto, debe asumir que su servidor estará caído durante algunas
+horas. Puede que incluso durante un fin de semana.
</p>
-<pre caption="Visualizando hileras específicas de la tabla products">
-MyDB=> <i>SELECT description,price FROM products WHERE price > 2.00;</i>
- description | price
-----------------+-------
- A test product | 12.00
- meat | 6.79
-(2 rows)
+<p>
+Antes de empezar, necesitará denegar el acceso al servidor, de modo que
+no se puedan realizar cambios en los datos. Seguramente también quiera
+hacer una copia de seguridad de los ficheros <path>postgresql.conf</path>
+y <path>pg_hba.conf</path> y de cualquier otro fichero de configuración
+que crea importante.
+</p>
+
+<pre caption="Pasos para migrar desde los ebuilds obsoletos">
+# <i>pg_dumpall -U postgres > backup_file</i>
+# <i>/etc/init.d/postgresql stop</i>
+# <i>emerge -C dev-db/postgresql dev-db/libpq dev-db/postgresql-client \
+ dev-db/postgresql-client</i>
+<comment>
+(Siga los pasos descritos en este documento para instalar y configurar el servidor)
+</comment>
+# <i>/etc/init.d/postgresql-8.4 start</i>
+# <i>psql -f backup_file postgres</i>
</pre>
<p>
-Ahora vemos un listdo de productos cuyo precio es mayor a $2.00,
-permitiéndonos enfocar aún más en los datos. Estas formas de consulta de
-información son muy poderosas y pueden ayudar a crear informes
-extremadamente útiles.
+Puede que algunos paquetes que estaban construidos contra los antiguos
+paquetes queden rotos, por lo tanto, una vez que haya instalado
+dev-db/postgresql-base y/o dev-db/postgresql-server <c>revdep-rebuild</c>
+para volver a construir cualquier paquete afectado.
+</p>
+
+</body>
+</section>
+</chapter>
+
+<chapter>
+<title>Utilidades</title>
+<section>
+<title>pgAdmin III</title>
+<body>
+
+<p>
+<uri link="http://www.pgadmin.org/">pgAdmin III</uri> es una utilidad
+gráfica para gestionar PostgreSQL.
</p>
+
</body>
</section>
+</chapter>
+<chapter>
+<title>Resolución de problemas</title>
<section>
-<title>Conclusión</title>
+<title>El servidor carece de funciones de instrumentación</title>
<body>
<p>
-Esto concluye la Guía PostgreSQL. Deseo darle un gran agradecimiento a
-Masatomo Nakano, previamente el desarrollador Gentoo a cargo de
-mantener PostgreSQL por su ayuda respondiendo mis preguntas. Cualquier
-sugerencia acerca de esta guía puede ser enviada a
-<mail>chriswhite@gentoo.org</mail>. Para información más extensa, vea
-la página web de <uri
-link="http://www.postgresql.org">PostgreSQL</uri>.
+Este problema es fácil de solucionar. Lo que es difícil es encontrar la
+respuesta. Lo que se necesita es importar un fichero que ya existe en
+el disco: <path>adminpack.sql</path>. Para resolver este problema, ejecute
+esta orden:
</p>
+
+<pre caption="Orden para añadir funciones de instrumentación">
+# <i>psql -U postgres --file /usr/share/postgresql-9.0/contrib/adminpack.sql</i>
+</pre>
+
</body>
</section>
</chapter>
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/es: postgres-howto.xml
@ 2011-09-20 17:25 JosA MarAa Alonso (nimiux)
0 siblings, 0 replies; 5+ messages in thread
From: JosA MarAa Alonso (nimiux) @ 2011-09-20 17:25 UTC (permalink / raw
To: gentoo-commits
nimiux 11/09/20 17:25:06
Modified: postgres-howto.xml
Log:
Fix bug #383081 - Correct version for codelisting, thanks to Joost Roeleveld for reporting
Revision Changes Path
1.5 xml/htdocs/doc/es/postgres-howto.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.5&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.5&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?r1=1.4&r2=1.5
Index: postgres-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- postgres-howto.xml 18 Aug 2011 13:19:44 -0000 1.4
+++ postgres-howto.xml 20 Sep 2011 17:25:06 -0000 1.5
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.4 2011/08/18 13:19:44 nimiux Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.5 2011/09/20 17:25:06 nimiux Exp $ -->
<guide lang="es">
<title>Guía rápida de PostgreSQL</title>
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>8</version>
-<date>2011-08-08</date>
+<version>9</version>
+<date>2011-09-15</date>
<chapter>
<title>Introduction</title>
@@ -353,7 +353,7 @@
el idioma español de España codificación de caracteres UTF-8.
</p>
-<pre caption="Ejemplo del contenido de /etc/conf.d/postgresql-8.4">
+<pre caption="Ejemplo del contenido de /etc/conf.d/postgresql-9.0">
<comment># Location of configuration files</comment>
PGDATA="/etc/postgresql-9.0/"
@@ -680,7 +680,7 @@
<body>
<p>
-Existen dos razones por las que necesitará relizar una migración: Cuando
+Existen dos razones por las que necesitará realizar una migración: Cuando
cambie de una versión mayor a otra, <e>por ejemplo</e>, desde PostgreSQL
8.4.7 a 9.0.3, pero no desde 9.0.2 to 9.0.3 o cuando cambie de una base
de datos con formato de sello de tiempo (timestamp) en coma flotante
@@ -709,7 +709,7 @@
Sin embargo hay dos problemillas cuando se utiliza pg_upgrade. En primer
lugar, no soporta el hecho de que los ficheros de configuración se
encuentren en un directorio diferente del de datos. Esto se puede
-resolver usando enlaces simbólicos. En segundo lugar, sólo permite la
+resolver usando enlaces simbólicos. En segundo lugar, solo permite la
migración de bases de datos a partir de la versión 8.3 or newer. Si tiene
una versión de base de datos anterior, necesitará seguir las instrucciones
<uri link="#pre90">Pre-migración 9.0</uri>.
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/es: postgres-howto.xml
@ 2012-05-04 9:38 JosA MarAa Alonso (nimiux)
0 siblings, 0 replies; 5+ messages in thread
From: JosA MarAa Alonso (nimiux) @ 2012-05-04 9:38 UTC (permalink / raw
To: gentoo-commits
nimiux 12/05/04 09:38:55
Modified: postgres-howto.xml
Log:
Update postgres instrumentation functions for multiple versions, bug 414415
Revision Changes Path
1.6 xml/htdocs/doc/es/postgres-howto.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.6&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.6&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?r1=1.5&r2=1.6
Index: postgres-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- postgres-howto.xml 20 Sep 2011 17:25:06 -0000 1.5
+++ postgres-howto.xml 4 May 2012 09:38:55 -0000 1.6
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.5 2011/09/20 17:25:06 nimiux Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.6 2012/05/04 09:38:55 nimiux Exp $ -->
<guide lang="es">
<title>Guía rápida de PostgreSQL</title>
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>9</version>
-<date>2011-09-15</date>
+<version>10</version>
+<date>2012-05-04</date>
<chapter>
<title>Introduction</title>
@@ -74,8 +74,8 @@
<p>
En este documento se presupone que va a instalar la última versión estable
de PostgreSQL. En el momento de escribir este documento, esta versión es
-la 9.0.3. Modifique los comando en este artículo de forma adecuada para
-especificar la versión.
+la 9.0.3. Modifique las ordenes indicadas en este documento de forma
+adecuada para especificar la versión.
</p>
<impo>
@@ -876,16 +876,24 @@
<body>
<p>
-Este problema es fácil de solucionar. Lo que es difícil es encontrar la
-respuesta. Lo que se necesita es importar un fichero que ya existe en
-el disco: <path>adminpack.sql</path>. Para resolver este problema, ejecute
-esta orden:
+Este problema es fácil de solucionar, la solución dependerá de la
+versión que esté utilizando. Lo que es más complicado es encontrar
+la respuesta. Lo que se necesita es una importación de un fichero
+que ya existe en el dispositivo de almacenamiento:
+<path>adminpack.sql</path>. Para resolver este problema, ejecute
+la orden apropiada para la versión que tenga instalada:
</p>
-<pre caption="Orden para añadir funciones de instrumentación">
+
+<pre caption="Añadir funciones de instrumentación para versiones anteriores a la 9.1">
# <i>psql -U postgres --file /usr/share/postgresql-9.0/contrib/adminpack.sql</i>
</pre>
+<pre caption="Añadir funciones de instrumentación para la versión 9.1 y posteriores">
+# <i>psql -U postgres -c "CREATE EXTENSION adminpack;"</i>
+</pre>
+
+
</body>
</section>
</chapter>
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/es: postgres-howto.xml
@ 2012-06-15 18:16 JosA MarAa Alonso (nimiux)
0 siblings, 0 replies; 5+ messages in thread
From: JosA MarAa Alonso (nimiux) @ 2012-06-15 18:16 UTC (permalink / raw
To: gentoo-commits
nimiux 12/06/15 18:16:09
Modified: postgres-howto.xml
Log:
add eselect step per comment #8 of bug #410717
Revision Changes Path
1.7 xml/htdocs/doc/es/postgres-howto.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.7&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?rev=1.7&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/es/postgres-howto.xml?r1=1.6&r2=1.7
Index: postgres-howto.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- postgres-howto.xml 4 May 2012 09:38:55 -0000 1.6
+++ postgres-howto.xml 15 Jun 2012 18:16:09 -0000 1.7
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.6 2012/05/04 09:38:55 nimiux Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/es/postgres-howto.xml,v 1.7 2012/06/15 18:16:09 nimiux Exp $ -->
<guide lang="es">
<title>Guía rápida de PostgreSQL</title>
@@ -28,8 +28,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>10</version>
-<date>2012-05-04</date>
+<version>11</version>
+<date>2012-06-13</date>
<chapter>
<title>Introduction</title>
@@ -722,6 +722,10 @@
# <i>ln -s /etc/postgresql-8.4/*.conf /var/lib/postgresql/8.4/data/</i>
# <i>ln -s /etc/postgresql-9.0/*.conf /var/lib/postgresql/9.0/data/</i>
+<comment>(Compruebe las versiones disponibles, a continuación, seleccione la suya)</comment>
+# <i>eselect postgresql list</i>
+# <i>eselect postgresql set 9.0</i>
+
<comment>(Cambie el método de acceso a la base de datos del usuario 'postgres' a trust en conexiones locales para todas las bases de datos)</comment>
# <i>nano -w /etc/postgresql-8.4/pg_hba.conf</i>
# <i>nano -w /etc/postgresql-9.0/pg_hba.conf</i>
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2012-06-15 18:16 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-07-17 15:22 [gentoo-commits] gentoo commit in xml/htdocs/doc/es: postgres-howto.xml John Christian Stoddart (chiguire)
-- strict thread matches above, loose matches on Subject: below --
2011-08-18 13:19 JosA MarAa Alonso (nimiux)
2011-09-20 17:25 JosA MarAa Alonso (nimiux)
2012-05-04 9:38 JosA MarAa Alonso (nimiux)
2012-06-15 18:16 JosA MarAa Alonso (nimiux)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox