archived-doc-es/reference/pgsql/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d2cb67973d1e82849a728cab9c51f6d5691e397f Maintainer: jvenegasperu Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="pgsql.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 
 <variablelist>
  <varlistentry xml:id="constant.pgsql-libpq-version">
   <term>
    <constant>PGSQL_LIBPQ_VERSION</constant> 
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Versión corta de libpq que contiene solamente números y puntos.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-libpq-version-str">
   <term>
    <constant>PGSQL_LIBPQ_VERSION_STR</constant> 
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Versión larga de libpq que incluye información del compilador.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-assoc">
   <term>
    <constant>PGSQL_ASSOC</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_fetch_array</function>. Devuelve un array asociativo de campos
     nombre y valor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-num">
   <term>
    <constant>PGSQL_NUM</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_fetch_array</function>. Devuelve un array indexado numéricamente de campos 
     numero y valor.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-both">
   <term>
    <constant>PGSQL_BOTH</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_fetch_array</function>. Devuelve un array de valores de campo
     que es numéricamente indexado (por número de campo) y asociado (por nombre de campo).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-force-new">
   <term>
    <constant>PGSQL_CONNECT_FORCE_NEW</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_connect</function> fuerza la creacion de una nueva conexión,
     en lugar de volver a utilizar una conexión idéntica existente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-bad">
   <term>
    <constant>PGSQL_CONNECTION_BAD</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_connection_status</function> indica que la conexión de la base de datos
     está en un estado no valido.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-ok">
   <term>
    <constant>PGSQL_CONNECTION_OK</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_connection_status</function> indica que la conexión de la base de datos
     está en un estado valido.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-set">
   <term>
    <constant>PGSQL_SEEK_SET</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_lo_seek</function>. La operación de busqueda empieza
     desde el inicio del objeto.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-cur">
   <term>
    <constant>PGSQL_SEEK_CUR</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_lo_seek</function>. La operación de busqueda empieza
     desde la posición actual.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-end">
   <term>
    <constant>PGSQL_SEEK_END</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_lo_seek</function>. La operación de busqueda empieza 
     desde el final del objeto.     
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-empty-query">
   <term>
    <constant>PGSQL_EMPTY_QUERY</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. Indica que la cadena enviada al servidor 
     estaba vacía.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-command-ok">
   <term>
    <constant>PGSQL_COMMAND_OK</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. Indica la conclusión con éxito de un 
     comando que no devuelve datos.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-tuples-ok">
   <term>
    <constant>PGSQL_TUPLES_OK</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. Indica la conclusión con éxito de un comando
     que retorna datos (como un <literal>SELECT</literal> o un <literal>SHOW</literal>).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-out">
   <term>
    <constant>PGSQL_COPY_OUT</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. La transferencia de la copia de salida de datos (del servidor)
     ha empezado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-in">
   <term>
    <constant>PGSQL_COPY_IN</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. La transferencia de la copia de la entrada de datos (al servidor)
     ha empezado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-bad-response">
   <term>
    <constant>PGSQL_BAD_RESPONSE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. La respuesta del servidor
     no se entendió.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-nonfatal-error">
   <term>
    <constant>PGSQL_NONFATAL_ERROR</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. Un error fatal
     (un aviso o advertencia) se produjo.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-fatal-error">
   <term>
    <constant>PGSQL_FATAL_ERROR</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_result_status</function>. Un error fatal
     ha ocurrido.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-idle">
   <term>
    <constant>PGSQL_TRANSACTION_IDLE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_transaction_status</function>. La conexión esta
     libre actualmente, no es usada por una transacción.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-active">
   <term>
    <constant>PGSQL_TRANSACTION_ACTIVE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_transaction_status</function>. Un comando 
     esta en progreso en la conexión. Una consulta ha sido enviada a través de la conexión
     y aún no concluido.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-intrans">
   <term>
    <constant>PGSQL_TRANSACTION_INTRANS</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_transaction_status</function>. La conexión
     esta inactiva, en un bloque de transacción.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-inerror">
   <term>
    <constant>PGSQL_TRANSACTION_INERROR</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_transaction_status</function>. La conexión
     esta inactiva, en un bloque de transacción fallida.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-unknown">
   <term>
    <constant>PGSQL_TRANSACTION_UNKNOWN</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Devuelto por <function>pg_transaction_status</function>. La conexion
     es mala.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-severity">
   <term>
    <constant>PGSQL_DIAG_SEVERITY</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     Según la gravedad; el contenido de los  campos puede ser <literal>ERROR</literal>, 
     <literal>FATAL</literal>, o <literal>PANIC</literal> (en un mensaje de error), o 
     <literal>WARNING</literal>, <literal>NOTICE</literal>, <literal>DEBUG</literal>, 
     <literal>INFO</literal>, o <literal>LOG</literal> (en un mensaje de aviso), o una traducción localizada 
     de uno de ellos. Siempre esta presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-sqlstate">
   <term>
    <constant>PGSQL_DIAG_SQLSTATE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     El código SQLSTATE para el error. El codigo SQLSTATE identifica el tipo de error 
     que ha ocurrido; esto puede ser utilizado por las aplicaciones de front-end para llevar a cabo operaciones 
     específicas (tales como el control de errores) en respuesta a un error de base de datos concreto. 
     Este campo no es localizable, y siempre esta presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-primary">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     El principal mensaje de error legible para un humano (generalmente una línea). Siempre esta presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-detail">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_DETAIL</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     Detalle: un mensaje de error secundario opcional que transporta más detalles sobre el problema. Puede funcionar a varias líneas.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-hint">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_HINT</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     Sugerencia: una sugerencia opcional qué hacer con el problema. Con esto se pretende diferir el detalle y ofrecer consejo
     (potencialmente inapropiados) en lugar de hechos concretos. Se puede ejecutar en varias lineas.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-statement-position">
   <term>
    <constant>PGSQL_DIAG_STATEMENT_POSITION</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     Una cadena que contiene un entero decimal que indica la posición del cursor como un índice de error en la cadena de la sentencia original.
     El primer carácter tiene el índice 1, y las posiciones se miden en caracteres no bytes.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-position">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_POSITION</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     Este se define como el campo <constant>PG_DIAG_STATEMENT_POSITION</constant>, Pero 
     este es usado cuando la posición del cursor se refiere al comando generado internamente
     en lugar de la cadena enviada por el cliente. El  
     campo <constant>PG_DIAG_INTERNAL_QUERY</constant> siempre aparece cuando este campo 
     esta presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-query">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_QUERY</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     El texto de un comando generado internamente falla. Esto podria ser, por ejemplo, una 
     consulta SQL emitida por una función PL/pgSQL.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-context">
   <term>
    <constant>PGSQL_DIAG_CONTEXT</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     Una indicación del contexto en el que se produjo el error. Actualmente
     esto incluye una pila de llamadas de rastreo de funciones, procedimientos activos y consultas 
     generados internamente. La traza es una entrada
     por línea, lo más reciente primero.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-file">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FILE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.
     El nombre del archivo en la ubicación del código fuente de PostgreSQL. donde se 
     reporto el error.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-line">
   <term>
    <constant>PGSQL_DIAG_SOURCE_LINE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Passed to <function>pg_result_error_field</function>.
     El numero de línea en la ubicación del código fuente PostgreSQL donde se 
     reporto el error.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-function">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FUNCTION</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_error_field</function>.     
     El nombre de la función en el código fuente de PostgreSQL que informa del error.
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="constant.pgsql-errors-terse">
   <term>
    <constant>PGSQL_ERRORS_TERSE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_set_error_verbosity</function>.
     Especifica que los mensajes devueltos solo incluyen la severidad, el texto principal,
     y la posición; lo que normalmente cabe en una sola línea.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-default">
   <term>
    <constant>PGSQL_ERRORS_DEFAULT</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_set_error_verbosity</function>.
     El modo predeterminado produce mensajes que incluyen todo lo anterior
     además de los campos de detalle, sugerencia, o contexto (que puede abarcar
     varias líneas).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-verbose">
   <term>
    <constant>PGSQL_ERRORS_VERBOSE</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_set_error_verbosity</function>.
     El modo detallado incluye todos los campos disponibles.
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="constant.pgsql-status-long">
   <term>
    <constant>PGSQL_STATUS_LONG</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_status</function>. Indica que 
     se desea el codigo numerico del resultado. 
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-status-string">
   <term>
    <constant>PGSQL_STATUS_STRING</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_result_status</function>. Indica que 
     se desea la etiqueta textual del resultado del comando. 
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="constant.pgsql-conv-ignore-default">
   <term>
    <constant>PGSQL_CONV_IGNORE_DEFAULT</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_convert</function>.     
     No hacer caso de los valores por defecto en la tabla durante la conversión.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-force-null">
   <term>
    <constant>PGSQL_CONV_FORCE_NULL</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_convert</function>.
     Utilice SQL <literal>NULL</literal> en lugar de una <type>string</type> vacía.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-ignore-not-null">
   <term>
    <constant>PGSQL_CONV_IGNORE_NOT_NULL</constant> 
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_convert</function>.
     Ignorar la conversión de &null; en las columnas SQL <literal>NOT NULL</literal>.
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="constant.pgsql-dml-no-conv">
   <term>
    <constant>PGSQL_DML_NO_CONV</constant>
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> y <function>pg_delete</function>.
     Todos los parámetros pasados tal cual. Se requiere el escape manual
     si los parámetros contienen datos proporcionados por el usuario. Use <function>pg_escape_string</function>
     para ello.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-exec">
   <term>
    <constant>PGSQL_DML_EXEC</constant>
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> y <function>pg_delete</function>.
     Ejecutar consultas por estas funciones.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-async">
   <term>
    <constant>PGSQL_DML_ASYNC</constant>
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> y <function>pg_delete</function>.
     Ejecutar consultas asíncronas por estas funciones.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-string">
   <term>
    <constant>PGSQL_DML_STRING</constant>
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> y <function>pg_delete</function>.
     Devolver es string de consulta ejecutado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-escape">
   <term>
    <constant>PGSQL_DML_ESCAPE</constant>
    (<type>integer</type>)
   </term>
   <listitem>
    <simpara>
     Pasado a <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> y <function>pg_delete</function>.
     Aplicar escape a todos los parámetros en lugar de llamar a <function>pg_convert</function>
     internamente. Esta opción omite la búsqueda de metadatos. Las consultas podrían ser tan rápidas como
     <function>pg_query</function> y <function>pg_send_query</function>.
    </simpara>
   </listitem>
  </varlistentry>
  
  
 </variablelist>
</appendix>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->