1st translated version

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@81076 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
phaser 2002-05-03 18:30:09 +00:00
parent 38fb4c187c
commit ce31e485c3

View file

@ -1,58 +1,61 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<reference id="ref.pgsql">
<title>PostgreSQL functions</title>
<title>Funções PostgreSQL</title>
<titleabbrev>PostgreSQL</titleabbrev>
<partintro>
<para>
Postgres, developed originally in the UC Berkeley Computer Science
Department, pioneered many of the object-relational concepts now
becoming available in some commercial databases. It provides
SQL92/SQL99 language support, transaction integrity and type
extensibility. PostgreSQL is an open source descendant of this
original Berkeley code.
Postgres, desenvolvida originalmente no Deparetamento de Ciências
de Computação de Berkeley, foi pioneira em muitos dos conceitos de
relacionamento-objeto que agora estão tornando-se disponíveis em
alguns bancos de dados comerciais. Ele fornece suporte a linguagem
SQL92/SQL99, integridade de transações e extensibilidade de tipos.
Postgres é um descendente em código aberto do código original de
Berkeley.
</para>
<para>
PostgreSQL database is Open Source product and available without
cost. To use PostgreSQL support, you need PostgreSQL 6.5 or
later. PostgreSQL 7.0 or later to enable all PostgreSQL module
feature. PostgreSQL supports many character encoding including
multibyte character encoding. The current version and more
information about PostgreSQL is available at <ulink
url="&url.pgsql;">&url.pgsql;</ulink>.
O banco de dados PostgreSQL é um produto Open Source disponível
sem nenhum custo. Para usar o suporte a PostgreSQL você precisa
do PostgreSQL 6.5 ou superior. PostgreSQL 7.0 ou superior para
habilitar todas as funções do módulo PostgreSQL. PostgreSQL suporta
muitos códigos de caracteres incluindo a codificação de carcateres
multibyte. A versão atual e maiores informações sobre PostgreSQL
está disponível em <ulink url="&url.pgsql;">&url.pgsql;</ulink>.
</para>
<para>
In order to enable PostgreSQL support,
<option role="configure">--with-pgsql[=DIR]</option> is required when you compile
PHP. If shared object module is available, PostgreSQL module may
be loaded using <link linkend="ini.extension">extension</link>
directive in &php.ini; or <function>dl</function>
function. Supported ini directives are described in
<filename>php.ini-dist</filename> which comes with source distribution.
Para habilitar o suporte a PostgreSQL a opção de configuração
<option role="configure">--with-pgsql[=DIR]</option> é exigida quando
você compila o PHP. Se o módulo compartilhado está disponível, o módulo
PostgreSQL pode ser carregado usando a diretiva
<link linkend="ini.extension">extension</link> no &php.ini; ou
a função <function>dl</function>. Diretivas ini suportadas estão descritas
em <filename>php.ini-dist</filename> que vem com a distribuição.
</para>
<warning>
<para>
Using the PostgreSQL module with PHP 4.0.6 is not recommended due to
a bug in the notice message handling code. Use 4.1.0 or later.
Usar o módulo PostgreSQL com o PHP 4.0.6 não é recomendado devido a
um bug no código de manipulação de mensagens de nota. Use o 4.1.0 ou
superior.
</para>
</warning>
<warning>
<para>
PostgreSQL function names will be changed in 4.2.0 release to
confirm to current coding standards. Most of new names will have
additional underscores, e.g. pg_lo_open(). Some functions are
renamed to different name for consistency. e.g. pg_exec() to
pg_query(). Older names can be used in 4.2.0 and a few releases
from 4.2.0, but they may be deleted in the future.
Os nomes das funções PostgreSQL serão alterados na versão 4.2.0 para
confirmar os padrões de programação atuais. A maioria dos novos nomes
terão sublinhados adicionais, por exemplo pg_lo_open(). Algumas funções
foram renomeadas para uma maior consistência, por exemplo pg_exec() que
mudou para pg_query(). Os nomes antigos podem ser usados na 4.2.0 e em
algumas poucas outras atualizações após esta, mas eles serão deletados em
um futuro próximo.
</para>
<table>
<title>Function names changed</title>
<title>Nomes de funções alterados</title>
<tgroup cols="2">
<thead>
<row>
<entry>Old name</entry>
<entry>New name</entry>
<entry>Nomes antigos</entry>
<entry>Nomes novos</entry>
</row>
</thead>
<tbody>
@ -144,33 +147,33 @@
</tgroup>
</table>
<para>
The old <function>pg_connect</function>/<function>pg_pconnect</function>
syntax will be deprecated to support asynchronous connections in the
future. Please use a connection string for <function>pg_connect</function>
and <function>pg_pconnect</function>.
A antiga sintaxe <function>pg_connect</function>/<function>pg_pconnect</function>
será obsoleta para suportar conexões assíncronas no futoro. Por favor use
a string de conexão para <function>pg_connect</function>
e <function>pg_pconnect</function>.
</para>
</warning>
<para>
Not all functions are supported by all builds. It depends on your
libpq (The PostgreSQL C Client interface) version and how libpq is
compiled. If there is missing function, libpq does not support
the feature required for the function.
Nem todas as funções são suportadas por todas as compilações. Isso vai
depender da versão do seu libpq (A interface C do cliente PostgreSQL) e
como o seu libpq foi compilado. Se há alguma função ausente, a libpq não
suporta a característica exigida pela função.
</para>
<para>
It is also important that you use newer libpq than PostgreSQL
Server to be connected. If you use libpq older than PostgreSQL
Server expects, you may have problems.
Também é importante que você use uma libpq mais nova do que a que o
servidor espera. Se você usar uma libpq mais antiga do que a que o
servidor espera você poderá ter problemas.
</para>
<para>
Since version 6.3 (03/02/1998) PostgreSQL uses unix domain sockets
by default. TCP port will NOT be opened by default. A table is
shown below describing these new connection possibilities. This
socket will be found in <filename>/tmp/.s.PGSQL.5432</filename>.
This option can be enabled with the '-i' flag to
<command>postmaster</command> and it's meaning is: "listen on
TCP/IP sockets as well as Unix domain sockets".
Desde a versão 6.3 (03/02/1998) PostgreSQL usa sockets de domínio unix por
padrão. A porta TCP não será aberta por padrão. Uma tabela é mostrada
abaixo descrevendo essas novas possibilidades de conexão. Este socket será
encontrado em <filename>/tmp/.s.PGSQL.5432</filename>.
Espa opção pode ser habilitada com a chave '-i' para o
<command>postmaster</command> e seu significado é: "escute em sockets
TCP/IP assim como em sockets de domínio Unix".
<table>
<title>Postmaster and PHP</title>
<title>Postmaster e PHP</title>
<tgroup cols="3">
<thead>
<row>
@ -210,34 +213,35 @@
</table>
</para>
<para>
A connection to PostgreSQL server can be established with the
following value pairs set in the command string: <command>$conn =
pg_connect("host=myHost port=myPort tty=myTTY options=myOptions
dbname=myDB user=myUser password=myPassword ");
Uma conexão com o servidor PostgreSQL pode ser estabelecida com os
seguintes pares de valores definidos na string de comando: <command>$conn =
pg_connect("host=meuHost port=minhaPorta tty=meuTTY options=minhasOpcoes
dbname=meuDB user=meuUsuario password=minhaSenha ");
</command>
</para>
<para>
The previous syntax of:
A sintaxe anterior de:
<command>
$conn = pg_connect ("host", "port", "options", "tty", "dbname")
$conn = pg_connect ("host", "porta", "opcoes", "tty", "nomebd")
</command>
has been deprecated.
está obsoleta.
</para>
<para>
Environmental variables affect PostgreSQL server/client
behavior. For example, PostgreSQL module will lookup PGHOST
environment variable when the hostname is omitted in the connection
string. Supported environment variables are different from version
to version. Refer to PostgreSQL Programmer's Manual (libpq -
Environment Variables) for details.
Variáveis de ambiente afetam o comportamento do servidor/cliente
PostgreSQL. Por exemplo, o módulo PostgreSQL irá procurar pela variável de
ambiente PGHOST quando o nome de host é omitido na string de conexão. As
variáveis de ambiente suportadas variam de versão para versão. Vide o
Manual de PRogramador do PostgreSQL (Programmer´s Manual) na seção libpq -
Enviroment Variables para maiores detalhes.
</para>
<para>
Make sure you set environment variables for appropriate user. Use
<literal>$_ENV</literal> or <function>getenv</function> to check
which environment variables are available to the current process.
Certifique-se que você definou as variáveis de ambiente para o usuário
apropriado. Use <literal>$_ENV</literal> ou <function>getenv</function>
para verificar que variáveis de ambiente estão disponíveis para o processo
atual.
</para>
<example>
<title>Setting default parameters</title>
<title>Definindo os parâmetros padrões</title>
<programlisting>
<![CDATA[
PGHOST=psgql.exmaple.com
@ -254,20 +258,20 @@ export PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD PGDATESTYLE PGTZ PGCLIENTENCOD
</programlisting>
</example>
<para>
Starting with PostgreSQL 7.1.0, you can store up to 1GB into a
field of type text. In older versions, this was limited to the block
size (default was 8KB, maximum was 32KB, defined at compile time)
A partir do PostgreSQL 7.1.0, você pode armazenar até 1GB dentro de um
campo do tipo texto. Em versões mais antigas, isto era limitado ao tamanho
do bloco (padrão era 8KB e o máximo era 32KB definido em tempo de
compilação)
</para>
<para>
To use the large object (lo) interface, it is required to enclose
large object functions within a transaction block. A transaction
block starts with a SQL statement <command>BEGIN</command> and if
the transaction was valid ends with <command>COMMIT</command> or
<command>END</command>. If the transaction fails the transaction
should be closed with <command>ROLLBACK</command> or
<command>ABORT</command>.
<example>
<title>Using Large Objects</title>
Para usar a interface de objetos grandes (lo), é exigido que se encapsule
as funções de objetos grandes dentro de um bloco de transação. Um bloco de
transação inicia-se com a declaração SQL <command>BEGIN</command> e se a
transação foi válida termina com <command>COMMIT</command> ou
<command>END</command>. Se a transaão falhar, ela deve ser fechada com
<command>ROLLBACK</command> ou <command>ABORT</command>.
<>
<title>Usando Objetos Grandes</title>
<programlisting role="php">
<![CDATA[
<?php
@ -284,8 +288,8 @@ export PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD PGDATESTYLE PGTZ PGCLIENTENCOD
]]>
</programlisting>
</example>
You should not close the connection to the PostgreSQL server
before closing the large object.
Você não deve fechar a conexão com o servidor PostgreSQL antes de fechar o
objeto grande.
</para>
</partintro>