You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by fu...@apache.org on 2006/03/24 08:10:11 UTC

svn commit: r388422 [13/16] - in /db/derby/docs/trunk/src/pt_BR: ./ ref/

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32613.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32613.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32613.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32613.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj32613" xml:lang="pt-br">
+<title>RTRIM</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>RTRIM (função)</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>RTRIM remove brancos do final da expressão cadeia de caracteres.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>RTRIM(<i>ExpressãoCaractere</i>)</b>
+</codeblock>
+<p>A ExpressãoCaractere é do tipo de dado CHAR, VARCHAR ou LONG VARCHAR, ou de
+qualquer tipo de dado nativo convertido implicitamente em uma cadeia de
+caracteres.</p>
+<p>RTRIM retorna NULL quando a <i>ExpressãoCaractere</i> é avaliada como nula.</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- retorna ' asdf'</ph>
+VALUES RTRIM(' asdf  ')
+
+<ph>-- retorna 'asdf'</ph>
+VALUES RTRIM('asdf  ')</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32654.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32654.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32654.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32654.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj32654" xml:lang="pt-br">
+<title>Cláusula GROUP BY</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Cláusula GROUP BY</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A cláusula GROUP BY, que faz parte da
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref>,</i>
+agrupa o resultado em subconjuntos que possuem valores correspondentes em uma
+ou mais colunas.
+Em cada grupo não há duas linhas com o mesmo valor na coluna, ou colunas, de
+agrupamento.
+Para as finalidades de agrupamento os valores nulos são considerados equivalentes.</p>
+<p>Normalmente a cláusula GROUP BY é utilizada junto com expressões de agregação.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>GROUP BY <i><xref href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i> [ , <i><xref
+href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i> ] *</b>
+</codeblock>
+<p>O
+<i><xref href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i>
+deve ser uma coluna do escopo corrente da consulta; não pode haver nenhuma
+coluna do bloco de consulta fora do escopo corrente.
+Por exemplo, se a cláusula GROUP BY estiver na subconsulta, então não poderá
+fazer referência a colunas da consulta externa.</p>
+<p>Os <i>ItensSelecionados</i> em uma
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i>
+com cláusula GROUP BY devem conter somente agregações ou colunas de
+agrupamento.</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- calcular o TEMPO_VÔO médio agrupado por aeroporto</ph>
+SELECT AVG (TEMPO_VÔO), AEROPORTO_ORIGEM
+FROM VÔOS
+GROUP BY AEROPORTO_ORIGEM
+
+SELECT MAX(CIDADE), REGIÃO
+FROM CIDADES, PAÍSES
+WHERE CIDADES.COD_ISO_PAÍS = PAÍSES.COD_ISO_PAÍS
+GROUP BY REGIÃO
+
+<ph>-- agrupar por um SMALLINT</ph>
+SELECT ID, AVG(SALÁRIO)
+FROM SAMP.EQUIPES
+GROUP BY ID
+
+-- Obter as colunas SALÁRIO_MÉDIO, NUM_EMP e NUM_DEP
+-- utilizando a cláusula AS
+-- Agrupar pela coluna DEP_TRAB utilizando o nome de
+-- correlação OUTROS
+SELECT OUTROS.DEP_TRAB AS NUM_DEP,
+       AVG(OUTROS.SALÁRIO) AS SALÁRIO_MÉDIO,
+       COUNT(*) AS NUM_EMP
+FROM SAMP.EMPREGADOS OUTROS
+GROUP BY OUTROS.DEP_TRAB;
+</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32693.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32693.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32693.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32693.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj32693" xml:lang="pt-br">
+<title>AVG</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função de agregação AVG</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>AVG é uma função de agregação que calcula a média de uma expressão sobre
+um conjunto de linhas (consulte
+<xref href="rrefsqlj33923.dita#rrefsqlj33923"></xref>).
+AVG somente é permitida nas expressões que têm como resultado tipos de dado
+numéricos.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>AVG ( [ DISTINCT | ALL ] <i>Expressão</i> )</b></codeblock>
+<p>
+<indexterm>DISTINCT<indexterm>qualificador na função de agregação AVG</indexterm></indexterm>
+O qualificador DISTINCT elimina as linhas duplicadas.
+O qualificador ALL mantém as linhas duplicadas.
+ALL é o valor padrão, se nem ALL nem DISTINCT for especificado.
+Por exemplo, se uma coluna contiver os valores 1.0, 1.0, 1.0, 1.0 e 2.0,
+AVG(coluna) retornará um valor menor que AVG(DISTINCT coluna).</p>
+<p>Somente é permitida uma expressão de agregação DISTINCT por
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i>.
+Por exemplo, a seguinte consulta não é válida:
+<codeblock><b>SELECT AVG (DISTINCT TEMPO_VÔO), SUM (DISTINCT MILHAS)
+FROM VÔOS</b>
+</codeblock>
+</p>
+<p>A expressão pode conter várias referências a colunas ou expressões, mas
+não pode conter outra agregação ou subconsulta.
+Deve ter como resultado um tipo de dado numérico do SQL-92.
+Portanto, podem ser chamados métodos que têm como resultado tipos de dado SQL-92.
+Se uma expressão for avaliada como NULL, a agregação saltará este valor.</p>
+<p>O tipo de dado do resultado é o mesmo da expressão em que opera (nunca
+estoura).
+Por exemplo, a seguinte consulta retorna o INTEGER <i>1</i>, que pode não ser
+o esperado:
+<codeblock><b>SELECT AVG(C1)
+FROM (VALUES (1), (1), (1), (1), (2)) AS MINHA_TABELA (C1)</b>
+</codeblock>
+</p>
+<p>Se for desejada uma precisão maior, a expressão deverá ser convertida para
+outro tipo de dado:
+<codeblock><b>SELECT AVG(CAST (C1 AS DOUBLE PRECISION))
+FROM (VALUES (1), (1), (1), (1), (2)) AS MINHA_TABELA (c1)</b>
+</codeblock>
+</p> </refsyn>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32714.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32714.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32714.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32714.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj32714" xml:lang="pt-br">
+<title>VARCHAR FOR BIT DATA</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Tipo de dado VARCHAR FOR BIT DATA</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>O tipo de dado VARCHAR FOR BIT DATA permite armazenar cadeias binárias
+menores ou iguais ao comprimento especificado.
+É útil para dados não estruturados, onde as cadeias de caracteres não são
+apropriadas (por exemplo, imagens).</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>{ VARCHAR | CHAR VARYING | CHARACTER VARYING } (<i>comprimento</i>) FOR BIT DATA </b></codeblock>
+<p>O <i>comprimento</i> é um literal inteiro sem sinal designando o comprimento
+em bytes.</p>
+<p>Diferentemente do tipo de dado CHAR FOR BIT DATA, não existe
+<i>comprimento</i> padrão para o tipo de dado VARCHAR FOR BIT DATA.
+O tamanho máximo do <i>comprimento</i> é de 32672 bytes.</p>
+</refsyn>
+<section>
+<title>Tipo do metadado do JDBC (java.sql.Types)</title>
+<p>VARBINARY</p>
+<p>
+<indexterm>Cadeias de bytes<indexterm>comprimento variável</indexterm></indexterm>
+VARCHAR FOR BIT DATA armazena cadeias de bytes de comprimento variável.
+Diferentemente dos valores CHAR FOR BIT DATA, os valores VARCHAR FOR BIT DATA
+não são completados até o comprimento do destino.</p>
+<p>Uma operação envolvendo valores VARCHAR FOR BIT DATA e CHAR FOR BIT DATA
+(por exemplo, uma concatenação) produz um valor VARCHAR FOR BIT DATA.</p>
+</section>
+<example>
+<p>O tipo do literal byte é sempre VARCHAR FOR BIT DATA, e não CHAR FOR BIT DATA.</p>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33215.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33215.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33215.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33215.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj33215" xml:lang="pt-br">
+<title>ExpressãoTabelaOuVisão</title>
+<refbody>
+<example> <codeblock><b>{<i> <xref href="rreftablename.dita#rreftablename">nome-da-tabela</xref></i> |<i> <xref
+href="rrefviewname.dita#rrefviewname">nome-da-visão</xref></i>}
+    [ [ AS ] <i><xref href="rrefcorrelationname.dita#rrefcorrelationname">nome-da-correlação</xref></i>
+        [ (<i><xref href="rrefsimplecolumnname.dita#rrefsimplecolumnname">nome-de-coluna-simples</xref></i> [ , <i><xref
+href="rrefsimplecolumnname.dita#rrefsimplecolumnname">nome-de-coluna-simples</xref></i>]* ) ] ] ]
+</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33520.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33520.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33520.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33520.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj33520" xml:lang="pt-br">
+<title>MIN</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função de agregação MIN</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>MIN é uma função de agregação que calcula o valor mínimo de uma expressão
+para um conjunto de valores (consulte
+<xref href="rrefsqlj33923.dita#rrefsqlj33923"></xref>).
+MIN é permitido apenas nas expressões que têm como resultado tipos de dado
+nativos (incluindo CHAR, VARCHAR, DATE, TIME, etc.).</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>MIN ( [ DISTINCT | ALL ] <i>Expressão</i> )</b>
+</codeblock>
+<p>Os qualificadores DISTINCT e ALL eliminam ou retêm linhas duplicadas,
+mas estes qualificadores não produzem efeito na função MIN.
+Somente é permitida uma expressão de agregação DISTINCT por
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i>.
+Por exemplo, a seguinte consulta não é permitida:
+<codeblock><b>SELECT COUNT (DISTINCT TEMPO_VÔO), MIN (DISTINCT MILHAS)
+FROM VÔOS</b>
+</codeblock>
+</p>
+<p>A <i>Expressão</i> pode conter várias referências a colunas ou expressões,
+mas não pode conter outra agregação ou subconsulta.
+Deve ter como resultado um tipo de dado nativo.
+Portanto, podem ser chamados métodos que têm como resultado tipos de dado
+nativos (Por exemplo, um método que retorna <i>java.lang.Integer</i> ou
+<i>int</i> tem como resultado um INTEGER.)
+Se uma expressão for avaliada como NULL, a agregação saltará este valor.</p>
+<p>As regras de comparação do tipo determinam o valor máximo.
+Para CHAR, VARCHAR e
+<xref href="rrefsqlj15147.dita#rrefsqlj15147">LONG VARCHAR</xref>,
+o número de espaços em branco no final do valor pode afetar o resultado.</p>
+<p>O tipo de dado do resultado é idêntico ao da expressão em que opera
+(nunca estoura).</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- não é válido:</ph>
+SELECT DISTINCT TEMPO_VÔO, MIN(DISTINCT MILHAS) FROM VÔOS
+
+<ph>-- não é válido:</ph>
+SELECT COUNT(DISTINCT TEMPO_VÔO), MIN(DISTINCT MILHAS) FROM VÔOS
+
+<ph>-- encontrar a data mais próxima:</ph>
+SELECT MIN (DATA_VÔO) FROM DISPONIBILIDADE_VÔO;</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33562.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33562.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33562.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33562.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,718 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj33562" xml:lang="pt-br">
+<title>CAST</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função CAST</indexterm>
+<indexterm>Conversões<indexterm>de tipos de dado SQL-92 usando CAST</indexterm></indexterm>
+<indexterm>Conversões<indexterm>usando a função CAST (explícita)</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>CAST converte o valor de um tipo de dado para outro, e fornece tipo de dado
+para o parâmetro dinâmico (?) e para o valor NULL.</p>
+<p>As expressões CAST são permitidas em qualquer lugar onde uma expressão é
+permitida.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>CAST ( [ <i>Expressão</i> | NULL | ? ]
+    AS <i>TipoDado</i>)</b>
+</codeblock>
+<p>O tipo de dado para o qual a expressão está sendo convertida é o
+<i>tipo de destino</i>.
+O tipo de dado da expressão a partir da qual está sendo feita a conversão é o
+<i>tipo de origem</i>.</p>
+</refsyn>
+<section>
+<title>Conversões CAST entre tipos de dado SQL-92</title>
+<p>A tabela a seguir mostra as conversões explícitas válidas entre tipos de
+origem e tipos de destino para os tipos de dado do SQL.
+<table>
+<title>Conversões explícitas entre tipos de origem e tipos de destino para os
+tipos de dado do SQL</title>
+<desc>Esta tabela mostra quais conversões explícitas entre tipos de dado são
+válidas.
+A primeira coluna da tabela lista o tipo de origem, enquanto a primeira
+linha lista os tipos de destino.
+"S" indica que a conversão da origem para o destino é válida.</desc>
+<tgroup cols="19">
+<colspec colname="colspec0" colwidth="330*"/>
+<colspec colname="col2"
+colwidth="84*"/>
+<colspec colname="col3" colwidth="84*"/>
+<colspec colname="col4"
+colwidth="84*"/>
+<colspec colname="col5" colwidth="84*"/>
+<colspec colname="col6"
+colwidth="81*"/>
+<colspec colname="colspec1" colwidth="84*"/>
+<colspec colname="colspec9"
+colwidth="84*"/>
+<colspec colname="colspec8" colwidth="84*"/>
+<colspec colname="colspec7"
+colwidth="84*"/>
+<colspec colname="colspec6" colwidth="81*"/>
+<colspec colname="colspec5"
+colwidth="84*"/>
+<colspec colname="colspec4" colwidth="87*"/>
+<colspec colname="colspec3"
+colwidth="81*"/>
+<colspec colname="colspec2" colwidth="84*"/>
+<colspec colname="colspec10"
+colwidth="84*"/>
+<colspec colname="colspec13" colwidth="84*"/>
+<colspec colname="colspec12"
+colwidth="84*"/>
+<colspec colname="colspec11" colwidth="84*"/>
+<thead>
+<row>
+<entry colname="colspec0" valign="top">Tipos</entry>
+<entry colname="col2" valign="top"> <lines>S
+M
+A
+L
+L
+I
+N
+T</lines></entry>
+<entry colname="col3" valign="top"> <lines>I
+N
+T
+E
+G
+E
+R</lines></entry>
+<entry colname="col4" valign="top"> <lines>B
+I
+G
+I
+N
+T</lines></entry>
+<entry colname="col5" valign="top"> <lines>D
+E
+C
+I
+M
+A
+L</lines></entry>
+<entry colname="col6" valign="top"> <lines>R
+E
+A
+L</lines></entry>
+<entry colname="colspec1" valign="top"> <lines>D
+O
+U
+B
+L
+E</lines></entry>
+<entry colname="colspec9" valign="top"> <lines>F
+L
+O
+A
+T</lines></entry>
+<entry colname="colspec8" valign="top"> <lines>C
+H
+A
+R</lines></entry>
+<entry colname="colspec7" valign="top"> <lines>V
+A
+R
+C
+H
+A
+R</lines></entry>
+<entry colname="colspec6" valign="top"> <lines>L
+O
+N
+G
+
+V
+A
+R
+C
+H
+A
+R</lines></entry>
+<entry colname="colspec5" valign="top"> <lines>C
+H
+A
+R
+
+F
+O
+R
+
+B
+I
+T
+
+D
+A
+T
+A</lines></entry>
+<entry colname="colspec4" valign="top"> <lines>V
+A
+R
+C
+H
+A
+R
+
+F
+O
+R
+
+B
+I
+T
+
+D
+A
+T
+A</lines></entry>
+<entry colname="colspec3" valign="top"> <lines>L
+O
+N
+G
+
+V
+A
+R
+C
+H
+A
+R
+
+F
+O
+R
+
+B
+I
+T
+
+D
+A
+T
+A</lines></entry>
+<entry colname="colspec2" valign="top"> <lines>C
+L
+O
+B</lines></entry>
+<entry colname="colspec10" valign="top"> <lines>B
+L
+O
+B</lines></entry>
+<entry colname="colspec13" valign="top"> <lines>D
+A
+T
+E</lines></entry>
+<entry colname="colspec12" valign="top"> <lines>T
+I
+M
+E</lines></entry>
+<entry colname="colspec11" valign="top"> <lines>T
+I
+M
+E
+S
+T
+A
+M
+P</lines></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="colspec0">SMALLINT</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">INTEGER</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">BIGINT</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">DECIMAL</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">REAL</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">DOUBLE</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">FLOAT</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">S</entry>
+<entry colname="colspec1">S</entry>
+<entry colname="colspec9">S</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">CHAR</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">S</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">S</entry>
+<entry colname="colspec12">S</entry>
+<entry colname="colspec11">S</entry>
+</row>
+<row>
+<entry colname="colspec0">VARCHAR</entry>
+<entry colname="col2">S</entry>
+<entry colname="col3">S</entry>
+<entry colname="col4">S</entry>
+<entry colname="col5">S</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">S</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">S</entry>
+<entry colname="colspec12">S</entry>
+<entry colname="colspec11">S</entry>
+</row>
+<row>
+<entry colname="colspec0">LONG VARCHAR</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">S</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">CHAR FOR BIT DATA</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">S</entry>
+<entry colname="colspec4">S</entry>
+<entry colname="colspec3">S</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">S</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">VARCHAR FOR BIT DATA</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">S</entry>
+<entry colname="colspec4">S</entry>
+<entry colname="colspec3">S</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">S</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">LONG VARCHAR FOR BIT DATA</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">S</entry>
+<entry colname="colspec4">S</entry>
+<entry colname="colspec3">S</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">S</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">CLOB</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">S</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">S</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">BLOB</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">-</entry>
+<entry colname="colspec7">-</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">S</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">-</entry>
+</row>
+<row>
+<entry colname="colspec0">DATE</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">S</entry>
+<entry colname="colspec12">-</entry>
+<entry colname="colspec11">S</entry>
+</row>
+<row>
+<entry colname="colspec0">TIME</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">-</entry>
+<entry colname="colspec12">S</entry>
+<entry colname="colspec11">S</entry>
+</row>
+<row>
+<entry colname="colspec0">TIME STAMP</entry>
+<entry colname="col2">-</entry>
+<entry colname="col3">-</entry>
+<entry colname="col4">-</entry>
+<entry colname="col5">-</entry>
+<entry colname="col6">-</entry>
+<entry colname="colspec1">-</entry>
+<entry colname="colspec9">-</entry>
+<entry colname="colspec8">S</entry>
+<entry colname="colspec7">S</entry>
+<entry colname="colspec6">-</entry>
+<entry colname="colspec5">-</entry>
+<entry colname="colspec4">-</entry>
+<entry colname="colspec3">-</entry>
+<entry colname="colspec2">-</entry>
+<entry colname="colspec10">-</entry>
+<entry colname="colspec13">S</entry>
+<entry colname="colspec12">S</entry>
+<entry colname="colspec11">S</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</p>
+<p>Se a conversão for válida, então CAST será permitida.
+Incompatibilidades de tamanhos entre os tipos de origem e de destino podem
+causar erros em tempo de execução.</p>
+</section>
+<section>
+<title>Notas</title>
+<p>Nesta discussão, os tipos de dado SQL-92 do
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+são categorizados da seguinte maneira:
+<ul>
+<li><i>numérico</i>   <ul>
+<li>numérico exato (SMALLINT, INTEGER, BIGINT, DECIMAL, NUMERIC)</li>
+<li>numérico aproximado (FLOAT, REAL, DOUBLE PRECISION)</li>
+</ul>
+</li>
+<li><i>cadeia</i>
+<ul>
+<li>cadeia de caracteres (CLOB, CHAR, VARCHAR, <xref href="rrefsqlj15147.dita#rrefsqlj15147">LONG VARCHAR</xref>)</li>
+<li>cadeia de bits (BLOB, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA, <xref href="rrefsqlj30118.dita#rrefsqlj30118">LONG VARCHAR FOR BIT DATA</xref>)</li>
+</ul>
+</li>
+<li><i>data/hora</i>
+<ul>
+<li><xref href="rrefsqlj18730.dita#rrefsqlj18730"></xref></li>
+<li><xref href="rrefsqlj21908.dita#rrefsqlj21908"></xref></li>
+<li><xref href="rrefsqlj27620.dita#rrefsqlj27620"></xref></li>
+</ul>
+</li>
+</ul>
+</p>
+</section>
+<section>
+<title>Conversões de tipos de dado numéricos</title>
+<p>Um tipo numérico pode ser convertido para qualquer outro tipo numérico.
+Se o tipo de destino não puder representar o componente não-fracionário sem
+truncamento, será lançada uma excessão.
+Se o destino numérico não puder representar o componente fracionário (escala)
+da origem numérica, então a origem será truncada em silêncio para caber no
+destino.
+Por exemplo, converter 763.1234 para INTEGER tem como resultado 763.</p>
+</section>
+<section>
+<title>Conversões de/para cadeias de bits</title>
+<p>As cadeias de bits podem ser convertidas para outras cadeias de bits, mas não
+para cadeias de caracteres.
+As cadeias que são convertidas para cadeias de bits são preenchidas com zero
+no final, para se ajustarem ao tamanho da cadeia de bits do destino.
+O tipo BLOB é mais limitado, e requer conversão explícita.
+Na maioria dos casos o tipo BLOB não pode ser convertido de, ou para, outros
+tipos.</p>
+</section>
+<section id="sqlj75614">
+<title>Conversões de valores de data/hora</title>
+<p>Um valor data/hora sempre pode ser convertido de e para TIMESTAMP.
+Se DATE for convertido para TIMESTAMP, o componente TIME do TIMESTAMP
+resultante será sempre 00:00:00.
+Se um valor de dado TIME for convertido para TIMESTAMP, o componente DATE de
+TIMESTAMP será definido como o valor de CURRENT_DATE do momento da execução de
+CAST.
+Se TIMESTAMP for convertido para DATE, o componente TIME será truncado em
+silêncio.
+Se TIMESTAMP for convertido para TIME, o componente DATE será truncado em
+silêncio.
+</p>
+</section>
+<example>
+<codeblock><b>SELECT CAST (MILHAS AS INT)
+FROM VÔOS
+
+-- converter de carimbo do tempo para texto
+INSERT INTO MINHA_TABELA (COLUNA_TEXTO)
+VALUES (CAST (CURRENT_TIMESTAMP AS VARCHAR(100)))
+
+-- NULL deve ser convertido para algum tipo de dado para poder ser usado
+SELECT LINHA_AÉREA
+FROM LINHAS_AÉREAS
+UNION ALL
+VALUES (CAST (NULL AS CHAR(2)))
+
+-- conversão de precisão dupla para decimal
+SELECT CAST (TEMPO_VÔO AS DECIMAL(5,2))
+FROM VÔOS
+
+-- conversão de SMALLINT para BIGINT
+VALUES CAST (CAST (12 AS SMALLINT) AS BIGINT)</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33602.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33602.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33602.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33602.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj33602" xml:lang="pt-br">
+<title>Cláusula WHERE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Cláusula WHERE</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A cláusula WHERE é uma parte opcional da
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref>,</i>
+<xref href="rrefsqlj35981.dita#rrefsqlj35981">Instrução DELETE</xref> e da
+<xref href="rrefsqlj26498.dita#rrefsqlj26498">Instrução UPDATE</xref>.
+A cláusula WHERE permite selecionar linhas baseado em uma expressão booleana.
+Somente as linhas para as quais a expressão é avaliada como TRUE são retornadas
+no resultado, ou no caso da instrução DELETE, excluídas, ou no caso da
+instrução UPDATE, atualizadas.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>WHERE <i><xref href="rrefsqlj23075.dita#rrefsqlj23075">Expressão booleana</xref></i></b>
+</codeblock>
+<p>
+<indexterm>Cláusula WHERE<indexterm>Extensões ao SQL</indexterm></indexterm>
+São permitidas expressões booleanas na cláusula WHERE.
+A maioria das expressões gerais listadas na
+<xref href="rrefsqlj19433.dita#rrefsqlj19433/sqlj18370"></xref>
+podem resultar em um valor booleano.</p>
+<p>Além disso, lá estão as expressões booleanas mais comuns.
+Os operadores booleanos específicos listados na Tabela 10 recebem um ou mais
+operandos; as expressões retornam um valor booleano.</p>
+</refsyn>
+<example> <codeblock><b>
+<ph>-- descobrir os vôos onde nenhum assento da
+-- classe executiva foi reservado</ph>
+SELECT *
+FROM DISPONIBILIDADE_VÔO
+WHERE ASSENTOS_EXECUTIVOS_OCUPADOS IS NULL
+OR ASSENTOS_EXECUTIVOS_OCUPADOS = 0
+
+<ph>-- Junção das tabelas ATIV_EMP e EMPREGADOS
+-- selecionar todas as colunas da tabela ATIV_EMP, e adicionar o
+-- sobrenome do empregado (ÚLTIMO_NOME) da tabela EMPREGADOS
+-- a todas as linhas do resultado.</ph>
+SELECT SAMP.ATIV_EMP.*, ÚLTIMO_NOME
+FROM SAMP.ATIV_EMP, SAMP.EMPREGADOS
+WHERE ATIV_EMP.NUM_EMP = EMPREGADOS.NUM_EMP;
+
+<ph>-- Determinar o número do empregado e o salário dos representantes de venda
+-- junto com o salário médio e a conta principal de seus departamentos.
+-- Esta consulta deverá criar primeiro um novo-nome-de-coluna especificado
+-- na cláusula AS, que está fora do FULLSELECT (DINFO),
+-- para obter as colunas SALÁRIO_MÉDIO e CONTA_EMP,
+-- assim como a coluna NUM_DEP utilizada na cláusula WHERE</ph>
+SELECT THIS_EMP.NUM_EMP, THIS_EMP.SALÁRIO, DINFO.SALÁRIO_MÉDIO, DINFO.CONTA_EMP
+ FROM EMPREGADOS THIS_EMP,
+   (SELECT OUTROS.DEP_TRAB AS NUM_DEP,
+           AVG(OUTROS.SALÁRIO) AS SALÁRIO_MÉDIO,
+           COUNT(*) AS CONTA_EMP
+    FROM EMPREGADOS OUTROS
+    GROUP BY OUTROS.DEP_TRAB
+   ) AS DINFO
+ WHERE THIS_EMP.CARGO = 'REP_VENDAS'
+           AND THIS_EMP.DEP_TRAB = DINFO.NUM_DEP;</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33772.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33772.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33772.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33772.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj33772" xml:lang="pt-br">
+<title>CURRENT_TIME</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função CURRENT_TIME</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>CURRENT_TIME retorna a hora corrente; o valor retornado não muda se for
+executado mais de uma vez na mesma instrução.
+Isto significa que o valor é fixo, mesmo que haja uma longa demora entre
+as linhas trazidas pelo cursor.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>CURRENT_TIME</b>
+</codeblock>
+<p>ou, como alternativa</p>
+<codeblock><b>CURRENT TIME</b>
+</codeblock>
+</refsyn>
+<example>
+<codeblock><b>VALUES CURRENT_TIME
+
+<ph>-- ou, como alternativa:</ph>
+VALUES CURRENT TIME</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33923.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33923.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33923.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj33923.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,156 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj33923" xml:lang="pt-br">
+<title>Agregações (funções de conjunto)</title>
+<refbody>
+<section>
+<p>Esta seção descreve as agregações (também descritas como <i>funções de
+conjunto</i> no ANSI SQL-92 e como <i>funções de coluna</i> em algumas
+literaturas sobre banco de dados).
+As agregações fornecem meios de avaliar uma expressão para um conjunto de
+linhas.
+Enquanto as outras funções nativas operam sobre uma única expressão, as
+funções de agregação operam sobre conjuntos de valores reduzindo-os a um
+único valor escalar.
+As agregações nativas podem calcular o valor mínimo, o valor máximo, a soma
+e a média de uma expressão com relação a um conjunto de valores, assim como
+contar linhas.
+Também podem ser criadas agregações do usuário para executar outras funções
+de conjunto, como calcular o desvio padrão.</p>
+</section>
+<section>
+<p><indexterm>Agregações<indexterm>e tipos de dado</indexterm></indexterm>
+As agregações nativas podem operar nos tipos de dado mostrados em
+<xref href="rrefsqlj33923.dita#rrefsqlj33923/sqlj92398"></xref>.
+<table frame="all" id="sqlj92398">
+<title>Tipos de dado permitidos pelas agregações nativas</title>
+<tgroup cols="3" colsep="1" rowsep="1">
+<colspec colname="1" colnum="1" colwidth="20*"/>
+<colspec colname="2" colnum="2" colwidth="20*"/>
+<colspec colname="3" colnum="3"
+colwidth="20*"/>
+<thead>
+<row>
+<entry colname="1"></entry>
+<entry align="left" colname="2" valign="bottom">Todos os tipos</entry>
+<entry align="left" colname="3" valign="bottom">Tipos de dado numéricos nativos</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="1">COUNT</entry>
+<entry colname="2">X</entry>
+<entry colname="3">X</entry>
+</row>
+<row>
+<entry colname="1">MIN</entry>
+<entry colname="2"></entry>
+<entry colname="3">X</entry>
+</row>
+<row>
+<entry colname="1">MAX</entry>
+<entry colname="2"></entry>
+<entry colname="3">X</entry>
+</row>
+<row>
+<entry colname="1">AVG</entry>
+<entry colname="2"></entry>
+<entry colname="3">X</entry>
+</row>
+<row>
+<entry colname="1">SUM</entry>
+<entry colname="2"></entry>
+<entry colname="3">X</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</p>
+</section>
+<section>
+<p><indexterm>Agregações<indexterm>requisitos</indexterm></indexterm>
+As agregações são permitidas apenas:
+<ul>
+<li>No <i>ItemSeleção</i> da
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref>.</i></li>
+<li>Na <xref href="rrefsqlj14854.dita#rrefsqlj14854">Cláusula HAVING</xref>.</li>
+<li>Na <xref href="rrefsqlj13658.dita#rrefsqlj13658">Cláusula ORDER BY</xref>
+(utilizando um nome aliás) se a agregação aparecer no resultado do bloco de
+consulta relevante.
+Ou seja, é permitido um aliás para uma agregação na
+<xref href="rrefsqlj13658.dita#rrefsqlj13658">Cláusula ORDER BY</xref> se,
+e somente se, a agregação aparecer no <i>ItemSeleção</i> da
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref>.</i></li>
+</ul>
+</p>
+</section>
+<section>
+<p>Todas as expressões nos <i>ItensSelecionados</i> da
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i>
+devem ser agregações ou colunas agrupadas (consulte a
+<xref href="rrefsqlj32654.dita#rrefsqlj32654"></xref>)
+(O mesmo é verdade se houver uma cláusula HAVING sem uma cláusula GROUP BY).
+Isto se deve ao fato do <i>ResultSet</i> da
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i>
+dever ser um escalar (valor único) ou um vetor (vários valores), mas não a uma
+mistura dos dois (as agregações têm como resultado um valor escalar, e a
+referência a uma coluna pode ter como resultado um vetor).
+Por exemplo, a consulta a seguir mistura valor escalar e vetor e, portanto,
+não é válida:
+<codeblock><b><ph>-- inválido</ph>
+SELECT MIN(TEMPO_VÔO), ID_VÔO
+FROM VÔOS</b>
+</codeblock>
+</p>
+</section>
+<section>
+<p>Não são permitidas agregações em referências externas (correlações).
+Isto significa que se a subconsulta contiver uma agregação, esta agregação
+não poderá avaliar uma expressão que inclua uma referência a uma coluna do bloco
+de consulta externo.
+Por exemplo, a seguinte consulta não é válida porque SUM opera sobre uma
+coluna da consulta externa:
+<codeblock><b>SELECT c1
+FROM t1
+GROUP BY c1
+HAVING c2 &gt;
+    (SELECT t2.x
+    FROM t2
+    WHERE t2.y = SUM(t1.c3)) </b>
+</codeblock>
+</p>
+</section>
+<section>
+<p>O cursor declarado em um <i>ResultSet</i> que inclui uma agregação no
+bloco de consulta externo não é atualizável.</p>
+</section>
+<section>
+<p>Esta seção inclui as seguintes agregações:
+<ul>
+<li><xref href="rrefsqlj32693.dita#rrefsqlj32693"></xref></li>
+<li><xref href="rrefsqlj38716.dita#rrefsqlj38716"></xref></li>
+<li><xref href="rrefsqlj27781.dita#rrefsqlj27781"></xref></li>
+<li><xref href="rrefsqlj33520.dita#rrefsqlj33520"></xref></li>
+<li><xref href="rrefsqlj13083.dita#rrefsqlj13083"></xref></li>
+</ul>
+</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34148.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34148.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34148.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34148.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj34148" xml:lang="pt-br">
+<title>Instrução DROP TABLE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução DROP TABLE</indexterm>
+<indexterm>Tabelas<indexterm>remoção</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A instrução DROP TABLE remove a tabela especificada.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>DROP TABLE <i><xref href="rreftablename.dita#rreftablename">nome-da-tabela</xref></i></b>
+</codeblock>
+</refsyn>
+<section id="sqlj38361">
+<title>Sistema de dependência de instrução</title>
+<p>Os gatilhos, as restrições (chave primária, unicidade, verificação e
+referencial da tabela sendo removida) e os índices da tabela são removidos em
+silêncio.
+A existência de um cursor aberto fazendo referência à tabela sendo removida
+faz com que a instrução DROP TABLE gere um erro, e a tabela não seja removida.</p>
+<p>A remoção da tabela invalida as instruções que dependem da tabela
+(Invalidar uma instrução faz com que esta seja recompilada na próxima execução.
+Consulte a <xref href="crefsqlj22771.dita#crefsqlj22771"></xref>.)</p>
+</section>
+</refbody>
+</reference>
+

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34177.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34177.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34177.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj34177.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj34177" xml:lang="pt-br">
+<title>CURRENT_DATE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função CURRENT_DATE</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>CURRENT_DATE retorna a data corrente; o valor retornado não muda se for
+executado mais de uma vez na mesma instrução.
+Isto significa que o valor é fixo, mesmo que haja uma longa demora entre
+as linhas trazidas pelo cursor.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>CURRENT_DATE</b>
+</codeblock>
+<p>ou, como alternativa</p>
+<codeblock><b>CURRENT DATE</b>
+</codeblock>
+</refsyn>
+<example>
+<codeblock><b><ph>-- descobrir os vôos futuros disponíveis:</ph>
+SELECT * FROM VÔOS_DISPONIBILIDADE WHERE DATA_VÔO &gt; CURRENT_DATE;</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35034.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35034.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35034.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35034.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj35034" xml:lang="pt-br">
+<title>INNER JOIN</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Expressão INNER JOIN</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>INNER JOIN (junção interna) é uma
+<xref href="rrefsqlj29840.dita#rrefsqlj29840">Operação JOIN</xref>
+que permite especificar uma cláusula de junção explícita.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b><i><xref href="rreftableexpression.dita#rreftableexpression">ExpressãoTabela</xref></i> [ INNER ] JOIN <i
+><xref href="rreftableexpression.dita#rreftableexpression">ExpressãoTabela</xref></i> { ON <i>ExpressãoBooleana</i> }</b>
+</codeblock>
+<p>A cláusula de junção pode ser especificada utilizando ON com uma expressão
+booleana.</p>
+<p>
+<indexterm>Cláusula ON<indexterm>parte da expressão INNER JOIN</indexterm></indexterm>
+O escopo das expressões na cláusula ON inclui as tabelas correntes, e as
+tabelas nos blocos de consulta externos ao SELECT corrente.
+No exemplo a seguir, a cláusula ON faz referência às tabelas correntes:
+<codeblock><b>SELECT *
+FROM SAMP.EMPREGADOS INNER JOIN SAMP.EQUIPES
+ON EMPREGADOS.SALÁRIO &lt; EQUIPES.SALÁRIO;
+</b>
+</codeblock>
+</p>
+<p>A cláusula ON pode fazer referência a tabelas que não estão sendo juntadas,
+e não é obrigada a fazer referência a nenhuma das tabelas sendo juntadas
+(embora tipicamente o faça).</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- Junção das tabelas ATIV_EMP e EMPREGADOS
+-- selecionar todas as colunas da tabela ATIV_EMP e
+-- adicionar o sobrenome do empregado (ÚLTIMO_NOME) da tabela
+-- EMPREGADOS a todas as linhas do resultado</ph>
+SELECT SAMP.ATIV_EMP.*, ÚLTIMO_NOME
+     FROM SAMP.ATIV_EMP JOIN SAMP.EMPREGADO
+     ON ATIV_EMP.NUM_EMP = EMPREGADOS.NUM_EMP;
+
+<ph>-- Juntar as tabelas EMPREGADOS e DEPARTAMENTOS,
+-- selecionar o número do empregado (NUM_EMP),
+-- o sobrenome do empregado (ÚLTIMO_NOME),
+-- o número do departamento (DEP_TRAB na tabela EMPREGADOS e
+-- NUM_DEP na tabela DEPARTAMENTOS)
+-- e o nome do departamento (NOME_DEP)
+-- de todos os empregados nascidos (DATA_NASC) antes de 1930.</ph>
+SELECT NUM_EMP, ÚLTIMO_NOME, DEP_TRAB, NOME_DEP
+     FROM SAMP.EMPREGADOS JOIN SAMP.DEPARTAMENTOS
+     ON DEP_TRAB = NUM_DEP
+     AND YEAR(DATA_NASC) &lt; 1930;
+
+<ph>-- Outro exemplo de "gerar" novos valores de dado,
+-- utilizando uma consulta que seleciona da cláusula VALUES
+-- (que é uma forma alternativa de FULLSELECT).</ph>
+SELECT *
+FROM (VALUES (3, 4), (1, 5), (2, 6))
+AS TABELA1_VALORES(C1, C2)
+JOIN (VALUES (3, 2), (1, 2),(0, 3))
+AS TABELA2_VALORES(C1, C2)
+ON TABELA1_VALORES.C1 = TABELA2_VALORES.C1;
+
+O que resulta em:
+<ph>
+C1         |C2         |C1         |2
+-----------------------------------------------
+3          |4          |3          |2
+1          |5          |1          |2
+
+-- Listar todos os departamentos, juntamente com o
+-- número do empregado e o último nome do gerente</ph>
+SELECT NUM_DEP, NOME_DEP, NUM_EMP, ÚLTIMO_NOME
+FROM DEPARTAMENTOS
+     INNER JOIN EMPREGADOS
+     ON NUM_GER = NUM_EMP;
+
+<ph>-- Listar todos os números do empregado e último nome, juntamente
+-- com o número do empregado e último nome de seus gerentes</ph>
+SELECT E.NUM_EMP, E.ÚLTIMO_NOME, M.NUM_EMP, M.ÚLTIMO_NOME
+        FROM EMPREGADOS E INNER JOIN
+        DEPARTAMENTOS INNER JOIN EMPREGADOS M
+        ON NUM_GER = M.NUM_EMP
+        ON E.DEP_TRAB = NUM_DEP;</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35981.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35981.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35981.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj35981.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj35981" xml:lang="pt-br">
+<title>Instrução DELETE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução DELETE</indexterm>
+<indexterm>VTIs R/W<indexterm>e DELETE</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<title>Sintaxe</title>
+<codeblock><b>{
+    DELETE FROM nome-da-tabela
+        [<i><xref href="rrefsqlj33602.dita#rrefsqlj33602">WHERE cláusula</xref></i>] |
+    DELETE FROM nome-da-tabela <xref href="rrefsqlj15309.dita#rrefsqlj15309">WHERE CURRENT OF</xref>
+}</b>
+</codeblock>
+</section>
+<section>
+<p>A primeira forma sintática, chamada de exclusão procurada, exclui todas as
+linhas identificadas pelo nome da tabela e pela cláusula WHERE.</p>
+</section>
+<section>
+<p>A segunda forma sintática, chamada de exclusão posicionada, exclui a linha
+corrente de um cursor atualizável aberto.
+Se não houver uma linha corrente, ou se a linha não mais satisfizer o comando
+do cursor, será lançada uma exceção.
+Para obter mais informações sobre cursores atualizáveis deve ser consultada a
+<xref href="rrefsqlj41360.dita#rrefsqlj41360"></xref>.</p>
+</section>
+<section>
+<title>Exemplos</title>
+<codeblock><b>DELETE FROM SAMP.CAIXA_ENTRADA;
+
+stmt.executeUpdate("DELETE FROM SAMP.CAIXA_ENTRADA WHERE CURRENT OF " +
+        resultSet.getCursorName())</b>
+</codeblock>
+</section>
+<section>
+<p>Uma instrução de exclusão procurada depende da tabela sendo atualizada,
+todos os seus conglomerados (unidades de armazenamento como <i>heaps</i> e
+índices), e todas as outras tabelas citadas na cláusula WHERE.
+Uma instrução CREATE ou DROP INDEX na tabela de destino de uma instrução
+de exclusão procurada preparada, invalida a instrução de exclusão procurada
+preparada.</p>
+</section>
+<section>
+<p>A instrução de exclusão posicionada depende do cursor e de todas as tabelas
+referenciadas pelo cursor.
+A exclusão posicionada pode ser compilada mesmo que o cursor ainda não tenha
+sido aberto.
+Entretanto, a remoção do cursor aberto através do método <i>close</i> do JDBC
+invalida a exclusão posicionada.</p>
+</section>
+<section>
+<p>Uma instrução CREATE ou DROP INDEX na tabela de destino de uma exclusão
+posicionada preparada, invalida a instrução de exclusão posicionada preparada.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj36146.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj36146.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj36146.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj36146.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj36146" xml:lang="pt-br">
+<title>Escala na aritmética decimal</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Precisão<indexterm>nas expressões de aritmética decimal</indexterm></indexterm>
+<indexterm>Escala<indexterm>na aritmética decimal</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>As instruções SQL podem envolver expressões aritméticas que utilizam tipos
+de dado decimais com <i>precisão</i> (o número total de dígitos, tanto à
+esquerda quanto à direita do ponto decimal) e <i>escala</i> (o número de
+dígitos da parte fracionária) diferentes.
+A precisão e a escala do tipo decimal resultante dependem da precisão e da
+escala dos operandos.</p>
+</section>
+<section>
+<p>Dada uma expressão aritmética envolvendo dois operandos decimais:
+<ul>
+<li><i>lp</i> significa a precisão do operando à esquerda</li>
+<li><i>rp</i> significa a precisão do operando à direita</li>
+<li><i>ls</i> significa a escala do operando à esquerda</li>
+<li><i>rs</i> significa a escala do operando à direita</li>
+</ul>
+</p>
+</section>
+<section>
+<p>São utilizadas as seguintes fórmula para determinar a escala do tipo de dado
+resultante para os seguintes tipos de expressões aritméticas:
+<ul>
+<li><i>multiplicação</i>   <p>ls + rs</p></li>
+<li><i>divisão</i>         <p>31 - lp + ls - rs</p></li>
+<li><i>AVG()</i>           <p>max(max(ls, rs), 4)</p></li>
+<li><i>todas as outras</i> <p>max(ls, rs)</p></li>
+</ul>
+</p>
+</section>
+<section>
+<p>Por exemplo, a escala do tipo de dado resultante da expressão a seguir é 27:
+<codeblock>11.0/1111.33
+<b>// 31 - 3 + 1 - 2 = 27 </b>
+</codeblock>
+</p>
+</section>
+<section>
+<p>São utilizadas as seguintes fórmula para determinar a precisão do tipo de
+dado resultante para os seguintes tipos de expressões aritméticas:
+<ul>
+<li><i>multiplicação</i>   <p>lp + rp</p></li>
+<li><i>adição</i>          <p>2 * (p - s) +  s</p></li>
+<li><i>divisão</i>         <p>lp - ls + rp + max(ls + rp - rs + 1, 4)</p></li>
+<li><i>todas as outras</i> <p>max(lp - ls, rp - rs) + 1 + max(ls, rs)</p></li>
+</ul>
+</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj37836.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj37836.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj37836.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj37836.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,225 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<reference id="rrefsqlj37836" xml:lang="pt-br">
+<title>especificação-de-coluna-gerada</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Atributos da coluna de identidade</indexterm>
+<indexterm>especificação-de-coluna-gerada</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<example>
+<codeblock><b>[ GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY
+[ ( START WITH ConstanteInteira
+[ ,INCREMENT BY ConstanteInteira] ) ]  ]  ]
+</b>
+</codeblock>
+</example>
+<section id="sqlj69411">
+<title>Atributos da coluna de identidade</title>
+<p>Nas colunas SMALLINT, INT e BIGINT com atributo de identidade, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+atribui automaticamente valores inteiros incrementados para a coluna.
+Os atributos da coluna de identidade se comportam como os outros valores padrão,
+ou seja, quando a instrução de inserção não especifica o valor para a coluna, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+fornece automaticamente o valor.
+Entretanto, o valor não é uma constante; o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+incrementa automaticamente o valor padrão na hora da inserção.</p>
+<p>A palavra chave IDENTITY somente pode ser especificada quando o tipo de dado
+associado à coluna for um dos seguintes tipos inteiros exatos.
+<ul>
+<li>SMALLINT</li>
+<li>INT</li>
+<li>BIGINT</li>
+</ul>
+</p>
+<p>Existem dois tipos de coluna de identidade no
+<ph conref="refconrefs.dita#prod/productshortname"></ph>:
+aquelas que são sempre geradas (GENERATED ALWAYS), e aquelas que são geradas por
+padrão (GENERATED BY DEFAULT).
+<dl>
+<dlentry>
+<dt>GENERATED ALWAYS</dt>
+<dd>Uma coluna de identidade que é sempre gerada, incrementa o valor padrão
+em todas as inserções e armazena o valor incrementado na coluna.
+Ao contrário dos outros valores padrão, não é possível inserir diretamente um
+valor ou atualizar uma coluna de identidade que é sempre gerada.
+Por isso, deve ser especificada a palavra chave DEFAULT ao fazer inserção
+na coluna de identidade, ou não incluir a coluna de identidade na lista
+de colunas na inserção.
+Por exemplo:
+<codeblock>CREATE TABLE SAUDAÇÕES (
+    I  INT GENERATED ALWAYS AS IDENTITY,
+    CH CHAR(50));
+INSERT INTO SAUDAÇÕES VALUES (DEFAULT, 'alô');
+INSERT INTO SAUDAÇÕES(CH) VALUES ('bom dia');</codeblock>
+Os valores gerados automaticamente na coluna de identidade GENERATED ALWAYS
+são únicos.
+A criação de uma coluna de identidade não cria um índice para a coluna.
+</dd>
+</dlentry>
+<dlentry>
+<dt>GENERATED BY DEFAULT</dt>
+<dd><p>Uma coluna de identidade gerada por padrão, somente incrementa e
+utiliza o valor padrão nas inserções quando não é fornecido nenhum valor
+explícito.
+Ao contrário da colunas sempre geradas, pode ser especificado um valor na
+instrução de inserção a ser utilizado no lugar do valor padrão gerado.</p>
+<p>Para utilizar o valor gerado, deve ser especificada a palavra chave
+DEFAULT ao inserir na coluna de identidade, ou não incluir a
+coluna de identidade na lista de colunas da inserção.
+Para especificar um valor, este deve ser incluído na instrução de inserção.
+Por exemplo:
+<codeblock>CREATE TABLE SAUDAÇÕES (
+    I  INT GENERATED BY DEFAULT AS IDENTITY,
+    CH CHAR(50));
+<b>-- especificar o valor "1":</b>
+INSERT INTO SAUDAÇÕES VALUES (1, 'olá');
+<b>-- usar o padrão gerado</b>
+INSERT INTO SAUDAÇÕES VALUES (DEFAULT, 'salut');
+<b>-- usar o padrão gerado</b>
+INSERT INTO SAUDAÇÕES(CH) VALUES ('bonjour'); </codeblock>
+Deve ser observado que ao contrário das colunas GENERATED ALWAYS, as colunas
+GENERATED BY DEFAULT não garantem unicidade.
+Portanto, no exemplo acima as linhas <codeph>olá</codeph> e
+<codeph>salut</codeph> possuem o valor de identidade igual a "1", porque a
+coluna gerada começa por "1" e o valor especificado pelo usuário também é "1".
+Para não permitir duplicidade, especialmente ao carregar ou importar dados, a
+tabela deve ser criada utilizando um valor para START WITH correspondente ao
+primeiro valor de identidade que o sistema deve atribuir.
+Para verificar esta condição e não permiti-la, pode ser utilizada uma chave
+primária ou restrição de unicidade na coluna de identidade GENERATED BY DEFAULT.
+</p>
+</dd>
+</dlentry>
+</dl>
+</p>
+<p>Por padrão, o valor inicial da coluna de identidade é 1, e o valor do
+incremento é 1.
+Podem ser especificados valores diferentes do padrão para o valor inicial e
+para o incremento ao definir a coluna utilizando as palavras chave
+STARTS WITH e INCREMENT BY.
+Se for especificado um número negativo para o valor do incremento, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+<i>decrementará</i> o valor a cada inserção.
+Se o valor for 0, ou positivo, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+incrementará o valor a cada inserção.</p>
+<p>Os valores máximos e mínimos permitidos nas colunas de identidade são
+determinados pelo tipo de dado da coluna.
+A tentativa de inserir um valor fora da faixa de valores suportados pelo tipo
+de dado lança uma exceção.
+<table frame="all">
+<title>Valores máximos e mínimos para colunas com especificação de coluna gerada</title>
+<tgroup cols="3" colsep="1" rowsep="1">
+<colspec colname="1" colnum="1" colwidth="16*"/>
+<colspec colname="2" colnum="2" colwidth="42*"/>
+<colspec colname="3" colnum="3" colwidth="42*"/>
+<thead>
+<row>
+<entry align="left" colname="1" valign="bottom">Tipo de dado</entry>
+<entry align="left" colname="2" valign="bottom">Valor máximo</entry>
+<entry align="left" colname="3" valign="bottom">Valor mínimo</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="1">SMALLINT</entry>
+<entry colname="2">32.767 (<i>java.lang.Short.MAX_VALUE</i>)</entry>
+<entry colname="3">-32.768 (<i>java.lang.Short.MIN_VALUE</i>)</entry>
+</row>
+<row>
+<entry colname="1">INT</entry>
+<entry colname="2">2.147.483.647 (<i>java.lang.Integer.MAX_VALUE</i>)</entry>
+<entry colname="3">-2.147.483.648 (<i>java.lang.Integer.MIN_VALUE</i>)</entry>
+</row>
+<row>
+<entry colname="1">BIGINT</entry>
+<entry colname="2">9.223.372.036.854.775.807 (<i>java.lang.Long.MAX_VALUE</i>)</entry>
+<entry colname="3">-9.223.372.036.854.775.808 (<i>java.lang.Long.MIN_VALUE</i>)</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</p>
+<p>Os valores gerados automaticamente na coluna de identidade são únicos.
+Deve ser utilizada uma restrição de chave primária ou de unicidade para
+garantir a unicidade.
+A criação da coluna de identidade <i>não</i> cria um índice para a coluna.</p>
+<p>A função <codeph>IDENTITY_VAL_LOCAL</codeph> é uma função não determinística
+que retorna o valor atribuído mais recentemente a uma coluna de identidade.
+Consulte <xref href="rrefidentityvallocal.dita#rrefidentityvallocal"></xref>
+para obter mais informações.</p>
+<note>Deve ser especificado o nome do esquema, da tabela e da coluna
+utilizando letras maiúsculas e minúsculas conforme os nomes estejam armazenados
+nas tabelas do sistema -- ou seja, todas as letras em maiúsculo, a menos que
+tenham sido utilizados identificadores delimitados para criar estes objetos
+no banco de dados.</note>
+<p>O <ph conref="refconrefs.dita#prod/productshortname"></ph>
+mantém o último valor incrementado para a coluna no cache.
+Também armazena o próximo valor incrementado para a coluna no disco na
+coluna <i>AUTOINCREMENTVALUE</i> da tabela do sistema <i>SYS.SYSCOLUMNS</i>.
+Desfazer a transação não desfaz este valor, portanto transações desfeitas
+podem deixar "espaços" nos valores inseridos automaticamente na coluna de
+identidade.
+O <ph conref="refconrefs.dita#prod/productshortname"></ph>
+se comporta desta maneira para evitar bloqueio na linha de <i>SYS.SYSCOLUMNS</i>
+pela duração da transação, e para manter a simultaneidade alta.
+</p>
+<p>
+<indexterm>Colunas de identidade<indexterm>e gatilhos</indexterm></indexterm>
+Quando acontece uma inserção em uma instrução-SQL-engatilhada, o valor
+inserido pela instrução-SQL-engatilhada na coluna de identidade é disponível
+a partir de <i>ConnectionInfo</i> somente dentro do código do gatilho.
+O código do gatilho também pode ver o valor inserido pela instrução que fez
+o gatilho disparar.
+Entretanto, a instrução que fez o gatilho disparar não pode ver o valor
+inserido pela instrução-SQL-engatilhada na coluna de identidade.
+Da mesma maneira, os gatilhos podem ser aninhados (ou recursivos).
+Uma instrução SQL pode fazer o gatilho T1 disparar.
+T1, por sua vez, executa uma instrução SQL que faz o gatilho T2 disparar.
+Se tanto T1 quanto T2 inserem linhas em uma tabela que faz o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+inserir em uma coluna de identidade, o gatilho T1 não poderá ver o valor
+produzido pela inserção feita por T2, mas T2 poderá ver o valor produzido pela
+inserção feita por T1.
+Cada nível de aninhamento pode ver os valores incrementados gerados por si
+próprio e pelos níveis de aninhamento anteriores, por todo o percurso até a
+instrução SQL de nível superior que deu início aos gatilhos recursivos.
+Somente podem existir 16 níveis de recursividade de gatilho.</p>
+</section>
+<section>
+<title>Exemplo</title>
+<codeblock>CREATE TABLE SAUDAÇÕES (
+    I INT GENERATED BY DEFAULT AS IDENTITY (START WITH 2, INCREMENT BY 1),
+    CH CHAR(50));
+-- especificar o valor  "1":
+INSERT INTO SAUDAÇÕES VALUES (1, 'olá');
+-- usar o valor gerado
+INSERT INTO SAUDAÇÕES VALUES (DEFAULT, 'salut');
+-- usar o valor gerado
+INSERT INTO SAUDAÇÕES(CH) VALUES ('bonjour'); </codeblock>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj37860.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj37860.dita?rev=388422&view=auto
==============================================================================
    (empty)

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38716.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38716.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38716.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38716.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj38716" xml:lang="pt-br">
+<title>COUNT</title>
+<prolog
+><metadata>
+<keywords>
+<indexterm>Função de agregação COUNT</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>COUNT é uma função de agregação que conta o número de linhas acessadas pela
+expressão (consulte <xref href="rrefsqlj33923.dita#rrefsqlj33923"></xref>).
+COUNT é permitida em todos os tipos de expressão.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>COUNT ( [ DISTINCT | ALL ] <i>Expressão</i> ) </b></codeblock>
+<p>
+<indexterm>DISTINCT<indexterm>qualificador na função de agregação COUNT</indexterm></indexterm>
+O qualificador DISTINCT elimina as linhas duplicadas.
+O qualificador ALL mantém as linhas duplicadas.
+É assumido ALL se não for especificado nem ALL nem DISTINCT.
+Por exemplo, se uma coluna contiver os valores 1, 1, 1, 1 e 2, COUNT(coluna)
+retornará um valor maior que COUNT(DISTINCT coluna).</p>
+<p>Somente é permitida uma expressão de agregação DISTINCT por
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i> .
+Por exemplo, a seguinte consulta não é permitida:
+</p>
+<codeblock><b><ph>-- consulta não permitida</ph>
+SELECT COUNT (DISTINCT TEMPO_VÔO), SUM (DISTINCT MILHAS)
+FROM VÔOS</b>
+</codeblock>
+<p>A expressão pode conter várias referências a colunas ou expressões, mas
+não pode conter outra agregação ou subconsulta.
+Se a <i>Expressão</i> resultar em NULL, a agregação não será processada para
+este valor.</p>
+<p>O tipo de dado do resultado de COUNT é
+<xref href="rrefsqlj30435.dita#rrefsqlj30435">BIGINT</xref>.</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- Contar o número de países em cada região,
+-- mostrando apenas as regiões que possuem ao menos 2 países</ph>
+SELECT COUNT (PAÍS), REGIÃO
+FROM PAÍSES
+GROUP BY REGIÃO
+HAVING COUNT (PAÍS) &gt; 1</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38831.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38831.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38831.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj38831.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+Copyright 1997, 2005 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<reference id="rrefsqlj38831" xml:lang="pt-br">
+<title>SYSCS_UTIL.SYSCS_SET_RUNTIMESTATISTICS</title>
+<refbody>
+<section>
+<p>O procedimento do sistema
+<codeph>SYSCS_UTIL.SYSCS_SET_RUNTIMESTATISTICS()</codeph>
+torna as estatísticas em tempo de execução da conexão ligadas ou desligadas.
+Por padrão, as estatísticas em tempo de execução estão desligadas.
+Quando o atributo <codeph>runtimestatistics</codeph> está ligado, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+mantém informações sobre o plano de execução de cada instrução executada
+pela conexão (exceto COMMIT), até que este atributo seja desligado.
+Para desligar o atributo <codeph>runtimestatistics</codeph>, este procedimento
+deve ser chamado com um argumento igual a zero.
+Para ligar o atributo <codeph>runtimestatistics</codeph>, este procedimento
+deve ser chamado com um argumento diferente de zero.</p>
+</section>
+<section>
+<p>Nas instruções que não retornam linhas, o objeto é criado quando todo o
+processamento interno está completo, antes de retornar para o programa cliente.
+Nas instruções que retornam linhas, o objeto é criado quando a primeira chamada
+a <codeph>next()</codeph> retorna zero linhas, ou se for encontrada uma
+chamada a <codeph>close()</codeph>, o que ocorrer primeiro.</p>
+</section>
+<section>
+<title>Sintaxe</title>
+<codeblock>SYSCS_UTIL.SYSCS_SET_RUNTIMESTATISTICS(IN SMALLINT ENABLE)</codeblock>
+</section>
+<section>
+<title>Exemplo</title>
+<codeblock>-- estabelecer a conexão
+-- ligar RUNTIMESTATISTIC para a conexão:
+<b>CALL SYSCS_UTIL.SYSCS_SET_RUNTIMESTATISTICS(1);</b>
+-- executar uma consulta complexa
+-- caminhar pelo conjunto de resultados
+-- acessar as informações de estatísticas em tempo de execução:
+<b>CALL SYSCS_UTIL.SYSCS_SET_RUNTIMESTATISTICS(0);</b>
+</codeblock>
+</section>
+</refbody>
+</reference>