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

[fu...@apache.org]

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj20937.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj20937.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj20937.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj20937.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,137 @@
+<?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="rrefsqlj20937" xml:lang="pt-br">
+<title>Instrução CREATE INDEX</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução CREATE INDEX</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section id="i1013640">
+<p id="sqlj31027">A instrução CREATE INDEX cria um índice em uma tabela.
+Os índices podem incluir uma ou mais colunas da tabela.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>CREATE [UNIQUE] INDEX <i><xref href="rrefindexname.dita#rrefindexname">nome-do-índice</xref></i>
+ON <i><xref href="rreftablename.dita#rreftablename">nome-da-tabela</xref></i> ( <i><xref href="rrefsimplecolumnname.dita#rrefsimplecolumnname">nome-de-coluna-simples</xref></i> [ ASC | DESC ]
+    [ , <i><xref href="rrefsimplecolumnname.dita#rrefsimplecolumnname">nome-de-coluna-simples</xref></i> [ ASC | DESC ]] * )</b>
+</codeblock>
+<p>No <ph conref="refconrefs.dita#prod/productshortname"></ph>,
+o número máximo de colunas para chave do índice é 16.</p>
+<p>O nome do índice não pode ter mais que 128 caracteres.</p>
+<p>O nome da coluna não pode aparecer mais de uma vez na mesma instrução
+CREATE INDEX.
+Entretanto, índices diferentes podem incluir a mesma coluna.</p>
+<p>O <ph conref="refconrefs.dita#prod/productshortname"></ph>
+pode utilizar os índices para melhorar o desempenho das instruções de
+manipulação de dados
+(consulte o <cite><ph conref="refconrefs.dita#pub/cittuning"></ph></cite>).
+Além disso, os índices UNIQUE fornecem uma maneira de verificar a integridade
+dos dados.</p>
+<p>Os nomes dos índices são únicos no esquema (Alguns sistemas de banco de dados
+permitem que tabelas diferentes no mesmo esquema possuam índices com o mesmo
+nome, mas o <ph conref="refconrefs.dita#prod/productshortname"></ph> não
+permite).
+É assumido que a tabela e o índice estão no mesmo esquema, se o nome do
+esquema for especificado para um dos nomes, mas não para o outro.
+Se o nome do esquema for especificado tanto para o índice quanto para a tabela,
+será lançada uma exceção se os nomes dos esquemas não forem o mesmo.
+Se não for especificado o nome do esquema nem para a tabela e nem para o índice,
+será utilizado o esquema corrente.</p>
+<p><indexterm>Índices descendentes</indexterm><indexterm>Índices<indexterm>criados em ordem descendenter</indexterm></indexterm>
+O <ph conref="refconrefs.dita#prod/productshortname"></ph> utiliza, por padrão,
+a ordem ascendente de cada coluna para criar o índice.
+Especificar ASC após o nome da coluna não modifica o comportamento padrão.
+A palavra chave DESC após o nome da coluna faz com que o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+utilize a ordem descendente da coluna para criar o índice.
+Utilizar a ordem descendente para uma coluna pode ajudar a melhorar o desempenho
+dos comandos que requerem resultados em uma ordem de classificação mista ou
+na ordem descendente, e para os comandos que selecionam o valor mínimo ou máximo
+de uma coluna indexada.</p>
+<p><indexterm>Índices<indexterm>especificação do tamanho da página</indexterm></indexterm></p>
+<p>Se for especificado um nome de índice qualificado, o nome do esquema não
+poderá começar por <codeph>SYS</codeph>.</p>
+</refsyn>
+<section id="sqlj27363">
+<title>Índices e restrições</title>
+<p><indexterm>Índices de apoio<indexterm>criados automaticamente para
+garantir as restrições de chave primária, unicidade e de chave estrangeira</indexterm></indexterm>
+<indexterm>Índices<indexterm>criação automática para restrições de
+chave primária, unicidade e de chave estrangeira</indexterm></indexterm>
+As restrições de unicidade, de chave primária, e de chave estrangeira, geram
+índices que impõem, ou "apoiam", a restrição (por isso, algumas vezes são
+chamados de <i>índices de apoio</i>).
+Se uma coluna, ou conjunto de colunas, tiver uma restrição UNIQUE ou
+PRIMARY KEY aplicada, não será permitido criar índice com estas colunas.
+O <ph conref="refconrefs.dita#prod/productshortname"></ph> já terá criado um
+índice com nome gerado pelo sistema.
+Os nomes gerados pelo sistema para os índices que apoiam as restrições
+são facilmente encontrados consultando as tabelas do sistema, se for
+especificado o nome da restrição.
+Por exemplo, para descobrir o nome do índice que apoia a restrição
+PK_VÔOS:</p>
+<codeblock><b>SELECT CONGLOMERATENAME FROM SYS.SYSCONGLOMERATES,
+SYS.SYSCONSTRAINTS WHERE
+SYS.SYSCONGLOMERATES.TABLEID = SYSCONSTRAINTS.TABLEID
+AND CONSTRAINTNAME = 'PK_VÔOS'</b>
+</codeblock>
+</section>
+<example>
+<codeblock><b>CREATE INDEX ÍNDICE_ORIGEM ON VÔOS(AEROPORTO_ORIGEM);
+<b>
+-- valores monetários são geralmente ordenados do maior para o menor,
+-- portanto o índice é criado na ordem descendente
+</b>
+CREATE INDEX PAG_DESC ON SAMP.EMPREGADOS (SALÁRIO);
+<ph>
+-- utilizar um tamanho de página maior para o índice
+</ph>
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.storage.pageSize','8192');
+CREATE INDEX IDX_VENDAS ON SAMP.VENDAS (VENDAS);
+CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.storage.pageSize',NULL);
+</b>
+</codeblock>
+</example>
+<section>
+<title>Tamanho da página e comprimento da chave</title>
+<note>Em um índice, o tamanho das colunas chave deve ser igual ou menor que a
+metade do tamanho da página.
+Se o comprimento das colunas chave, de uma linha existente na tabela, for
+maior que a metade do tamanho da página do índice, a criação do índice para a
+tabela com estas colunas chave falhará.
+Este erro somente ocorre ao criar o índice, quando uma linha existente na
+tabela não respeita este critério.
+Após o índice ser criado, as inserções falham se o tamanho da chave
+associada não respeitar este critério.</note>
+</section>
+<section>
+<title>Sistema de dependência de instruções</title>
+<p>As instruções preparadas envolvendo SELECT, INSERT, UPDATE,
+UPDATE WHERE CURRENT, DELETE e DELETE WHERE CURRENT na tabela referenciada
+pela instrução CREATE INDEX são invalidadas quando o índice é criado.
+Os cursores abertos nas tabelas não são afetados.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21571.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21571.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21571.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21571.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,160 @@
+<?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="rrefsqlj21571" xml:lang="pt-br">
+<title>Consulta</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>UNION</indexterm>
+<indexterm>UNION ALL</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A consulta cria uma tabela virtual baseada em tabelas existentes ou
+constantes transformadas em tabelas.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>{
+    ( <i>Consulta</i> ) |
+<i>    Consulta</i> INTERSECT [ ALL | DISTINCT ] <i>Consulta</i> |
+<i>    Consulta</i> EXCEPT [ ALL | DISTINCT ] <i>Consulta</i> |
+<i>    Consulta</i> UNION [ ALL | DISTINCT ] <i>Consulta</i> |
+<i>    <xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref></i> | <i><xref
+href="rrefsqlj11277.dita#rrefsqlj11277">VALUES Expressão</xref></i>
+}</b>
+</codeblock>
+<p>Pode-se colocar parênteses arbitrariamente em torno das consultas, ou
+utilizar parênteses para controlar a ordem de avaliação das operações
+INTERSECT, EXCEPT e UNION.
+Estas operações são avaliadas da esquerda para a direita quando não existem
+parênteses presentes, com exceção das operações INTERSECT, que são avaliadas
+antes das operações de UNION e EXCEPT.</p>
+</refsyn>
+<section>
+<title>Linhas duplicadas nos resultados de UNION, INTERSECT e EXCEPT ALL</title>
+<p>As palavras chave ALL e DISTINCT determinam se as linhas duplicadas são
+eliminadas do resultado da operação.
+Se for especificada a palavra chave DISTINCT, então o resultado não terá linhas
+duplicadas.
+Se for especificada a palavra chave ALL, então poderão existir linhas duplicadas
+no resultado, dependendo da existência de linhas duplicadas na entrada.
+DISTINCT é o padrão, portanto se não for especificado nem ALL nem DISTINCT
+as linhas duplicadas serão eliminadas.
+Por exemplo, UNION constrói um <i>ResultSet</i> intermediário com todas as
+linhas das duas consultas, e elimina as linhas duplicadas antes de retornar as
+linhas remanescentes.
+UNION ALL retorna todas as linhas das duas consultas como resultado.</p>
+<p>Dependendo da operação especificada, se o número de cópias de uma
+determinada linha na tabela à esquerda for L, e o número de cópias desta linha
+na tabela à direita for R, então o número de linhas duplicadas desta
+determinada linha contidas na tabela de saída será (assumindo que a palavra
+chave ALL foi especificada):
+<ul>
+<li>UNION: ( L + R ).</li>
+<li>EXCEPT: o maior entre ( L – R ) e 0 (zero).</li>
+<li>INTERSECT: o menor entre L e R.</li>
+</ul>
+</p>
+</section>
+<example>
+<title>Exemplos</title>
+<codeblock><b><ph>-- Uma expressão de seleção</ph>
+SELECT *
+FROM ORG;
+
+<ph>-- uma subconsulta</ph>
+SELECT *
+FROM (SELECT COD_CLASSE FROM CLASSE_AGENDA) AS CS;
+
+<ph>-- uma subconsulta</ph>
+SELECT *
+FROM (SELECT COD_CLASSE FROM CLASSE_AGENDA) AS CS (COD_CLASSE);
+
+<ph>-- uma união
+-- retornar todas as linhas das colunas NUM_DEP e GERENTE
+-- da tabela ORG
+-- e (1,2) e (3,4)
+-- NUM_DEP e GERENTE são colunas do tipo SMALLINT.</ph>
+SELECT NUM_DEP, GERENTE
+FROM ORG
+UNION ALL
+VALUES (1,2), (3,4);
+
+<ph>-- uma expressão de valores</ph>
+VALUES (1,2,3);
+
+<ph>-- Listar os números dos empregados (NUM_EMP)
+-- de todos os empregados na tabela EMPREGADOS
+-- cujo número do departamento (DEP_TRAB) começa por 'E', ou
+-- quem está alocado a projetos na tabela ATIV_EMP
+-- cujo número do projetor (NUM_PROJ) é igual a
+-- 'MA2100', 'MA2110' ou 'MA2112'.</ph>
+SELECT NUM_EMP
+FROM EMPREGADOS
+WHERE DEP_TRAB LIKE 'E%'
+UNION
+SELECT NUM_EMP
+FROM ATIV_EMP
+WHERE NUM_PROJ IN('MA2100', 'MA2110', 'MA2112');
+
+<ph>-- Realizar a mesma consulta do exemplo anterior
+-- e "marcar" as linhas da tabela EMPREGADOS com 'emp' e
+-- as linhas da tabela ATIV_EMP com 'ativ_emp'.
+-- Diferentemente do resultado do exemplo anterior,
+-- esta consulta pode retornar o mesmo NUM_EMP mais de uma vez,
+-- identificando de que tabela veio pela "marca" associada.</ph>
+SELECT NUM_EMP, 'emp'
+FROM EMPREGADOS
+WHERE DEP_TRAB LIKE 'E%'
+UNION
+SELECT NUM_EMP, 'ativ_emp'
+FROM ATIV_EMP
+WHERE NUM_PROJ IN('MA2100', 'MA2110', 'MA2112');
+
+<ph>-- Realizar a mesma consulta do exemplo anterior,
+-- porém utilizando UNION ALL para que as linhas
+-- duplicadas não sejam eliminadas.</ph>
+SELECT NUM_EMP
+FROM EMPREGADOS
+WHERE DEP_TRAB LIKE 'E%'
+UNION ALL
+SELECT NUM_EMP
+FROM ATIV_EMP
+WHERE NUM_PROJ IN('MA2100', 'MA2110', 'MA2112');
+
+<ph>-- Realizar a mesma consulta do exemplo anterior,
+-- incluindo dois empregados adicionais que no
+-- momento não se encontram em nenhuma tabela,
+-- e marcar estas linhas como "nova".</ph>
+SELECT NUM_EMP, 'emp'
+FROM EMPREGADOS
+WHERE DEP_TRAB LIKE 'E%'
+UNION
+SELECT NUM_EMP, 'ativ_emp'
+FROM ATIV_EMP
+WHERE NUM_PROJ IN('MA2100', 'MA2110', 'MA2112')
+UNION
+VALUES ('NEWAAA', 'nova'), ('NEWBBB', 'nova');</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21583.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21583.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21583.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21583.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,71 @@
+<?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="rrefsqlj21583" xml:lang="pt-br">
+<title>Cláusula FROM</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Cláusula FROM</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A cláusula FROM é uma cláusula obrigatória  na
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref>.</i>
+Especifica as tabelas
+(<xref href="rreftableexpression.dita#rreftableexpression">ExpressãoTabela</xref>)
+das quais as outras cláusulas da consulta podem acessar as colunas a serem
+utilizadas nas expressões.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>FROM ExpressãoTabela [ , ExpressãoTabela ] *</b>
+</codeblock>
+</refsyn>
+<example>
+<codeblock><b>SELECT CIDADES.ID_CIDADE
+FROM CIDADES
+WHERE ID_CIDADE &lt; 5
+
+<ph>-- outros tipos de ExpressãoTabela</ph>
+SELECT TABLENAME, ISINDEX
+FROM SYS.SYSTABLES T, SYS.SYSCONGLOMERATES C
+WHERE T.TABLEID = C.TABLEID
+ORDER BY TABLENAME, ISINDEX;
+
+<ph>-- forçar a ordem de junção</ph>
+SELECT *
+FROM VÔOS, VÔOS_DISPONIBILIDADE
+WHERE VÔOS_DISPONIBILIDADE.ID_VÔO = VÔOS.ID_VÔO
+AND VÔOS_DISPONIBILIDADE.NÚMERO_SEGMENTO = VÔOS.NÚMERO_SEGMENTO
+AND VÔOS.ID_VÔO &lt; 'AA1115'
+
+<ph>-- a ExpressãoTabela pode ser uma OperaçãoJunção. Portanto,
+-- podem haver várias operações de junção na cláusula FROM</ph>
+SELECT PAÍSES.PAÍS, CIDADES.NOME_CIDADE, VÔOS.AEROPORTO_DESTINO
+FROM PAÍSES LEFT OUTER JOIN CIDADES
+ON PAÍSES.COD_ISO_PAÍS = CIDADES.COD_ISO_PAÍS
+LEFT OUTER JOIN VÔOS
+ON CIDADES.AEROPORTO = VÔOS.AEROPORTO_DESTINO;</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21908.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21908.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21908.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj21908.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,67 @@
+<?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="rrefsqlj21908" xml:lang="pt-br">
+<title>TIME</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Tipo de dado TIME</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>TIME fornece armazenamento para valor da hora do dia.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>TIME</b></codeblock>
+</refsyn>
+<section>
+<title>Tipo Java correspondente em tempo de compilação</title
+><p><i>java.sql.Time</i></p>
+</section>
+<section>
+<title>Tipo do metadado do JDBC (java.sql.Types)</title>
+<p>TIME</p>
+<p>Datas, horas e carimbos do tempo não podem ser misturados em expressões,
+exceto com CAST.</p>
+<p>É permitido qualquer valor reconhecido pelo método <i>java.sql.Time</i>
+na coluna com tipo de dado data/hora SQL correspondente.
+O <ph conref="refconrefs.dita#prod/productshortname"></ph> suporta os seguintes
+formatos para TIME:
+<codeblock>hh:mm[:ss]
+hh.mm[.ss]
+hh[:mm] {AM | PM}</codeblock>
+O primeiro dos três formatos acima é o formato de <i>java.sql.Time</i>.</p>
+<p>As horas podem ter um ou dois dígitos.
+Os minutos e os segundos, se estiverem presentes, devem ter dois dígitos.</p>
+<p>O <ph conref="refconrefs.dita#prod/productshortname"></ph>
+também aceita cadeias no formato de data/hora específico do idioma, utilizando
+o idioma do servidor de banco de dados.
+No caso de haver ambiguidade, os formatos nativos acima têm precedência.</p>
+</section>
+<example>
+<title>Exemplos</title>
+<codeblock><b>VALUES TIME('15:09:02')
+VALUES '15:09:02'</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj23075.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj23075.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj23075.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj23075.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,259 @@
+<?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="rrefsqlj23075" xml:lang="pt-br">
+<title>Expressão booleana</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Expressão booleana</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>As expressões booleanas são permitidas na cláusula WHERE e nas restrições
+de verificação.
+As expressões booleanas nas restrições de verificação possuem limitações não
+descritas aqui; para obter mais informações deve ser consultada a
+<xref href="rrefsqlj13590.dita#rrefsqlj13590"></xref>.
+As expressões booleanas nas cláusulas WHERE possuem uma sintaxe bem liberal;
+consulte, por exemplo, a
+<xref href="rrefsqlj33602.dita#rrefsqlj33602">Cláusula WHERE</xref>.</p>
+</section>
+<section>
+<p>As expressões booleanas podem incluir um ou mais operadores booleanos,
+listados em <xref href="rrefsqlj23075.dita#rrefsqlj23075/sqlj34517"></xref>.
+<table expanse="page" frame="all" id="sqlj34517">
+<title>
+<ph><indexterm>Operadores booleanos<indexterm>parte da cláusula WHERE</indexterm></indexterm></ph>
+Operadores booleanos SQL
+</title>
+<tgroup cols="3" colsep="1" rowsep="1">
+<colspec colname="1" colnum="1" colwidth="24*"/>
+<colspec colname="2" colnum="2" colwidth="46*"/>
+<colspec colname="3" colnum="3" colwidth="30*"/>
+<thead>
+<row>
+<entry align="left" colname="1" valign="bottom">Operador</entry>
+<entry align="left" colname="2" valign="bottom">Explicação e exemplo</entry>
+<entry align="left" colname="3" valign="bottom">Sintaxe</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="1">
+<indexterm>operador booleano AND</indexterm>
+<indexterm>operador booleano OR</indexterm>
+<indexterm>operador booleano NOT</indexterm>
+AND, OR, NOT
+</entry>
+<entry colname="2">
+Avalia os operandos, que são expressões booleanas
+<codeblock><b>(AEROPORTO_ORIGEM = 'SFO') OR
+    (AEROPORTO_DESTINO = 'GRU')
+<ph>-- retorna verdade</ph></b>
+</codeblock>
+</entry>
+<entry colname="3"> <codeblock><b>{
+<b><i>  Expressão</i></b> AND
+<b><i>    Expressão </i></b>|
+<b><i>  Expressão</i></b> OR
+<b><i>    Expressão</i></b> |
+  NOT <b><i>Expressão</i></b>
+}</b>
+</codeblock>
+</entry>
+</row>
+<row>
+<entry colname="1">Comparações
+<indexterm>Operadores de comparação booleanos</indexterm>
+</entry>
+<entry colname="2">
+&lt;, =, &gt;, &lt;=, &gt;=, &lt;&gt; são aplicáveis a todos os tipos nativos.
+<codeblock><b>DATE('1998-02-26') &lt;
+    DATE('1998-03-01')
+<ph>-- retorna verdade</ph></b>
+</codeblock></entry>
+<entry colname="3"> <codeblock><b><b><i>Expressão</i></b>
+{
+  &lt; |
+  = |
+  &gt; |
+  &lt;= |
+  &gt;= |
+  &lt;&gt;
+}
+<b><i>Expressão</i></b></b>
+</codeblock></entry>
+</row>
+<row>
+<entry colname="1">IS NULL, IS NOT NULL
+<indexterm>Operador booleano IS NULL</indexterm>
+<indexterm>Operador booleano IS NOT NULL</indexterm>
+</entry>
+<entry colname="2">Testa se o resultado de uma expressão é nulo ou não.
+  <codeblock><b>WHERE NOME_DO_MEIO IS NULL</b>
+</codeblock></entry>
+<entry colname="3">
+<codeblock><b><b><i>Expressão</i></b> IS [ NOT ]
+  NULL</b>
+</codeblock>
+</entry>
+</row>
+<row>
+<entry colname="1">LIKE
+<indexterm>Operador booleano LIKE</indexterm>
+<indexterm>LIKE<indexterm>CARACTERE DE escape</indexterm></indexterm>
+</entry>
+<entry colname="2">
+Tenta fazer a correspondência entre uma expressão de caractere e um padrão de
+caractere, que é uma cadeia de caracteres que inclui um ou mais caracteres
+curinga.
+<p>O caractere % corresponde a qualquer número (zero ou mais) de caracteres
+na posição correspondente na primeira expressão de caractere.</p>
+<p>O caractere _ corresponde a um caractere
+na posição correspondente na expressão de caractere.</p>
+<p>Qualquer outro caractere corresponde apenas a este caractere na posição
+correspondente na expressão de caractere.
+<codeblock><b>cidade LIKE 'Sant_'</b>
+</codeblock>
+</p>
+<p>Para tratar os caracteres % e _ como caracteres constante, o caractere
+deve ser precedido por um caractere de escape opcional, especificado na
+cláusula ESCAPE.
+<codeblock><b>SELECT a FROM tabA WHERE a
+LIKE '%=_' ESCAPE '='</b>
+</codeblock>
+</p>
+</entry>
+<entry colname="3"> <codeblock><b><b><i>ExpressãoCaractere</i></b>
+  [ NOT ] LIKE
+<b><i>  ExpressãoCaractere
+  ComCaractereCuringa</i></b>
+  [ ESCAPE
+  '<b><i>CaractereDeEscape</i></b>']</b>
+</codeblock></entry>
+</row>
+<row>
+<entry colname="1">BETWEEN
+<indexterm>Operador booleano BETWEEN</indexterm>
+</entry>
+<entry colname="2">
+Testa se o primeiro operando está entre o segundo e o terceiro operandos.
+O segundo operando deve ser menor que o terceiro operando.
+Aplicável apenas aos tipos de dado onde se pode aplicar &lt;= e &gt;=.
+<codeblock><b>WHERE DATA_DE_RESERVA BETWEEN
+    DATE('1998-02-26') AND
+    DATE('1998-03-01')</b>
+</codeblock>
+</entry>
+<entry colname="3">
+<codeblock><b><b><i>Expressão</i></b> [ NOT ]
+BETWEEN <b><i>Expressão</i></b>
+  AND <b><i>Expressão</i></b></b>
+</codeblock>
+</entry>
+</row>
+<row>
+<entry colname="1">IN
+<indexterm>Operador booleano IN</indexterm>
+</entry>
+<entry colname="2">
+Opera sobre uma subconsulta a tabela ou uma lista de valores.
+Retorna TRUE se o valor da expressão à esquerda está presente no resultado da
+subconsulta a tabela ou na lista de valores.
+A subconsulta a tabela pode retornar várias linhas, mas deve retornar uma
+única coluna.
+<codeblock><b>WHERE DATA_DE_RESERVA NOT IN
+    (SELECT DATA_DE_RESERVA FROM
+RESERVAS_EM_HOTEL WHERE QUARTOS_DISPONÍVEIS = 0)</b>
+</codeblock></entry>
+<entry colname="3">
+<codeblock><b>{
+<b><i>  Expressão</i></b> [ NOT ]
+    IN
+    <b><i><xref href="rreftablesubquery.dita#rreftablesubquery">SubconsultaTabela</xref></i></b> |
+<b><i>  Expressão</i></b> [ NOT ]
+    IN ( <b><i>Expressão</i></b>
+    [, <b><i>Expressão</i></b> ]* )
+}</b>
+</codeblock>
+</entry>
+</row>
+<row>
+<entry colname="1">EXISTS
+<indexterm>Operador booleano EXISTS</indexterm>
+</entry>
+<entry colname="2">
+Opera sobre uma subconsulta a tabela.
+Retorna TRUE se a subconsulta a tabela retornar alguma linha,
+e FALSE se não retornar nenhuma linha.
+A subconsulta a tabela pode retornar várias colunas (somente se for utilizado
+* para indicar várias colunas) e linhas.
+<codeblock><b>WHERE EXISTS
+  (SELECT *
+  FROM VÔOS
+  WHERE AEROPORTO_DESTINO = 'SFO'
+  AND AEROPORTO_ORIGEM = 'GRU')</b>
+</codeblock>
+</entry>
+<entry colname="3">
+<codeblock><b>[NOT] EXISTS <b><i><xref href="rreftablesubquery.dita#rreftablesubquery">SubconsultaTabela</xref></i></b></b>
+</codeblock>
+</entry>
+</row>
+<row>
+<entry colname="1">Comparação quantificada
+<indexterm>Operador booleano de comparação quantificada</indexterm>
+</entry>
+<entry colname="2">
+A comparação quantificada é um operador de comparação
+(&lt;, =, &gt;, &lt;=, &gt;=, &lt;&gt;)
+com ALL, ANY ou SOME aplicado.
+<p>Opera sobre subconsultas a tabela, que podem retornar várias linhas, mas
+devem retornar uma única coluna.</p>
+<p>Se for utilizado ALL, a comparação deverá ser verdade para todos os valores
+retornados pela subconsulta a tabela.
+Se for utilizado ANY ou SOME, a comparação deverá ser verdade para pelo menos um
+valor da subconsulta a tabela.
+ANY e SOME são equivalentes.
+<codeblock><b>WHERE TAXA_NORMAL &lt; ALL
+(SELECT ORÇAMENTO/550 FROM GRUPOS) </b>
+</codeblock>
+</p>
+</entry>
+<entry colname="3"> <codeblock><b><b><i>Expressão</i></b>
+  OperadorComparação
+  {
+    ALL |
+    ANY |
+    SOME
+  }
+  <b><i><xref href="rreftablesubquery.dita#rreftablesubquery">SubconsultaTabela</xref></i></b></b>
+</codeblock>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj24513.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj24513.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj24513.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj24513.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,93 @@
+<?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="rrefsqlj24513" xml:lang="pt-br">
+<title>Instrução CREATE TABLE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução CREATE TABLE</indexterm><indexterm>Padrões</indexterm>
+<indexterm>Padrões de coluna</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A instrução CREATE TABLE cria uma tabela. As tabelas contêm colunas e
+restrições, que são regras que os dados devem estar em conformidade.
+A restrição no nível-de-tabela especifica uma coluna ou várias colunas.
+As colunas possuem um tipo de dado e podem especificar restrições de coluna
+(restrições no nível-de-coluna).</p>
+<p>Para obter informações sobre as restrições deve ser consultada a
+<xref href="rrefsqlj13590.dita#rrefsqlj13590"></xref>.</p>
+<p>Pode ser especificado um valor padrão para a coluna.
+O valor padrão é o valor a ser inserido na coluna quando não é especificado
+nenhum outro valor.
+Quando não é especificado explicitamente, o valor padrão para a coluna é NULL.
+Consulte <xref href="rrefsqlj30540.dita#rrefsqlj30540/sqlj64478"></xref>.</p>
+<p>Podem ser especificadas propriedades de armazenamento, como o tamanho da
+página para a tabela, chamando o procedimento do sistema
+<codeph>SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY</codeph>.</p>
+<p>Se for especificado um nome de tabela qualificado, o nome do esquema não
+poderá começar por <i>SYS</i>.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>CREATE TABLE <i><xref href="rreftablename.dita#rreftablename">nome-da-tabela</xref></i>
+    ( {<i><xref href="rrefsqlj30540.dita#rrefsqlj30540">definição-da-coluna</xref></i> | <i><xref
+href="rrefsqlj42154.dita#rrefsqlj42154">restrição no nível-de-tabela</xref></i>}
+    [ , {<i><xref href="rrefsqlj30540.dita#rrefsqlj30540">definição-da-coluna</xref></i> | <i><xref
+href="rrefsqlj42154.dita#rrefsqlj42154">restrição no nível-de-tabela</xref></i>} ] * )</b>
+</codeblock>
+</refsyn>
+<example>
+<title>Exemplos</title>
+<codeblock><b>CREATE TABLE DISPONIBILIDADE_HOTEL (
+    ID_HOTEL           INT NOT NULL,
+    DATA_RESERVA       DATE NOT NULL,
+    QUARTOS_RESERVADOS INT DEFAULT 0,
+    PRIMARY KEY (ID_HOTEL, DATA_RESERVA));
+
+<ph>-- A definição de chave primária no nível-de-tabela permite
+-- incluir duas colunas na definição da chave primária</ph>
+
+PRIMARY KEY (ID_HOTEL, DATA_RESERVA))
+
+<ph>-- Atribuir um atributo de coluna de identidade a uma coluna INTEGER,
+-- e também definir uma restrição de chave primária na coluna</ph>
+
+CREATE TABLE PESSOAS (
+    ID_PESSOA INT NOT NULL GENERATED ALWAYS AS IDENTITY
+    CONSTRAINT PK_PESSOAS PRIMARY KEY,
+    PESSOA VARCHAR(26));
+
+<ph>-- Atribuir um atributo de coluna de identidade a uma coluna SMALLINT
+-- com valor inicial igual a 5 e valor do incremento igual a 5.</ph>
+
+CREATE TABLE GRUPOS (
+    ID_GRUPO SMALLINT NOT NULL
+        GENERATED ALWAYS AS IDENTITY (START WITH 5, INCREMENT BY 5),
+    ENDEREÇO VARCHAR(100),
+    TEL      VARCHAR(15));</b>
+</codeblock>
+<note>Para obter mais exemplos de instruções CREATE TABLE utilizando
+várias restrições deve ser consultada a
+<xref href="rrefsqlj13590.dita#rrefsqlj13590"></xref>.</note>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj25228.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj25228.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj25228.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj25228.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,47 @@
+<?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="rrefsqlj25228" xml:lang="pt-br">
+<title>SESSION_USER</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função SESSION_USER</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>SESSION_USER retorna o identificador de autorização ou nome do usuário
+corrente.
+Se não houver usuário corrente, será retornado <i>APP.</i></p>
+<p><xref href="rrefsqlj42476.dita#rrefsqlj42476">USER</xref>,
+<xref href="rrefsqlj42324.dita#rrefsqlj42324">CURRENT_USER</xref>,
+e SESSION_USER são sinônimos.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>SESSION_USER</b>
+</codeblock>
+</refsyn>
+<example>
+<codeblock><b>VALUES SESSION_USER</b></codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj26498.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj26498.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj26498.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj26498.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,117 @@
+<?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="rrefsqlj26498" xml:lang="pt-br">
+<title>Instrução UPDATE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>UPDATE statement</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A instrução UPDATE define o valor na coluna.</p>
+<p>Pode ser atualizada a linha corrente de um cursor atualizável aberto.
+Se não houver linha corrente, ou a linha corrente não satisfizer mais a
+consulta do cursor, será lançada um exceção.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>{
+    UPDATE <i><xref href="rreftablename.dita#rreftablename">nome-da-tabela</xref></i>
+        SET <i><xref href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i> = <i><xref
+href="rrefsqlj76354.dita#rrefsqlj76354">Valor</xref></i>
+        [ , <i><xref href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i> = <i><xref
+href="rrefsqlj76354.dita#rrefsqlj76354">Valor</xref></i>} ]*
+        [<i><xref href="rrefsqlj33602.dita#rrefsqlj33602">Cláusula WHERE</xref></i>] |
+    UPDATE <i><xref href="rreftablename.dita#rreftablename">nome-da-tabela</xref></i>
+        SET <i><xref href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i> = <i><xref
+href="rrefsqlj76354.dita#rrefsqlj76354">Valor</xref></i>
+        [ , <i><xref href="rrefcolumnname.dita#rrefcolumnname">nome-da-coluna</xref></i> = <i><xref
+href="rrefsqlj76354.dita#rrefsqlj76354">Valor</xref></i> ]*
+        <i><xref href="rrefsqlj15309.dita#rrefsqlj15309">WHERE CURRENT OF</xref></i>
+}</b>
+</codeblock>
+<p>A primeira forma sintática é chamada de atualização procurada.
+A segunda forma sintática é chamada de atualização posicionada.</p>
+<p>Nas atualizações procuradas, são atualizadas todas as linhas da tabela para
+as quais a cláusula WHERE é avaliada como TRUE.</p>
+<p>Nas atualizações posicionadas, somente podem ser atualizadas as colunas
+incluídas na
+<xref href="rrefsqlj31783.dita#rrefsqlj31783">Cláusula FOR UPDATE</xref>
+da instrução SELECT que criou o cursor.
+Se a instrução SELECT não incluir a cláusula FOR UPDATE, o cursor será
+apenas-de-leitura, não podendo ser utilizado para atualizações.</p>
+<p>A especificação de DEFAULT para o valor atualizado, define o valor da coluna
+como o valor padrão definido nesta tabela.</p>
+</refsyn>
+<example> <codeblock><b><ph>-- Todos os empregados, exceto o gerente,
+-- do departamento (DEP_TRAB) 'E21' foram temporariamente
+-- reatribuídos. Indique isto alterando seus cargos (CARGO)
+-- para NULL, e os valores de seus pagamentos (SALÁRIO, BÔNUS, COMISS)
+-- para zero, na tabela EMPREGADOS.</ph>
+UPDATE EMPREGADOS
+  SET CARGO=NULL, SALÁRIO=0, BÔNUS=0, COMISS=0
+  WHERE DEP_TRAB = 'E21' AND CARGO &lt;&gt; 'GERENTE'
+
+-- Promover o cargo (CARGO) de determinado empregado para GERENTE
+UPDATE EMPREGADOS
+        SET CARGO = 'GERENTE'
+        WHERE CURRENT OF CURS1;
+
+<ph>-- Multiplicar a equipe do projeto (PROJ_EQUIPE) por 1.5</ph>
+stmt.executeUpdate("UPDATE PROJETO SET PROJ_EQUIPE = "
+"PROJ_EQUIPE * 1.5" +
+"WHERE CURRENT OF" + ResultSet.getCursorName());
+
+<ph>-- Alterar o cargo (CARGO) do empregado número (NUM_EMP) '000290'
+-- na tabela EMPREGADOS para o seu valor DEFAULT que é NULL</ph>
+UPDATE EMPREGADOS
+  SET CARGO = DEFAULT
+  WHERE NUM_EMP = '000290';
+</b>
+</codeblock>
+</example>
+<section>
+<title>Sistema de dependência de instrução</title>
+<p>A instrução de atualização procurada depende da tabela sendo atualizada, de
+todos os seus conglomerados (unidades de armazenamento como <i>heaps</i> e
+índices), todas as suas restrições, e de todas as outras tabelas referenciadas
+na cláusula WHERE e nas expressões SET.
+A execução de uma instrução CREATE ou DROP INDEX, ou de uma instrução
+ALTER TABLE, na tabela de destino de uma instrução de atualização procurada
+preparada, invalida a instrução de atualização procurada preparada.</p>
+<p>A instrução de atualização posicionada depende do cursor e de todas as
+tabelas que o cursor faz referência.
+A atualização posicionada pode ser compilada mesmo se o cursor ainda não tiver
+sido aberto.
+Entretanto, a remoção do cursor aberto através do método <i>close</i> do JDBC
+invalida a atualização posicionada.</p>
+<p>A execução de uma instrução CREATE ou DROP INDEX, ou de uma instrução
+ALTER TABLE, na tabela de destino de uma instrução de atualização posicionada
+preparada, invalida a instrução de atualização posicionada preparada.</p>
+<p>A remoção de um aliás invalida a instrução de atualização preparada, se a
+instrução utilizar o aliás.</p>
+<p>Remover ou adicionar gatilhos na tabela de destino da atualização
+invalida a instrução de atualização.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27281.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27281.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27281.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27281.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,56 @@
+<?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="rrefsqlj27281" xml:lang="pt-br">
+<title>FLOAT</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Tipo de dado FLOAT<indexterm>como aliás para REAL ou DOUBLE PRECISION</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>O tipo de dado FLOAT é um aliás para o tipo de dado REAL ou DOUBLE PRECISION,
+dependendo da precisão especificada.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>FLOAT [ (<i>precisão</i>) ]</b>
+</codeblock>
+<p>A <i>precisão</i> padrão para FLOAT é 53, e é equivalente a DOUBLE PRECISION.
+A precisão igual a 23, ou menor, torna FLOAT equivalente a REAL.
+A precisão igual a 24, ou maior, torna FLOAT equivalente a DOUBLE PRECISION.
+Se for especificada uma precisão igual a 0, ocorrerá um erro.
+Se for especificada uma precisão negativa, ocorrerá um erro de sintaxe.</p>
+</refsyn>
+<section>
+<title>Tipo do metadado do JDBC (java.sql.Types)</title>
+<p>REAL ou DOUBLE</p>
+</section>
+<section>
+<title>Limitações</title>
+<p>Se estiver sendo utilizada uma precisão igual a 24, ou maior, os limites para
+FLOAT serão semelhantes aos de DOUBLE.</p>
+<p>Se estiver sendo utilizada uma precisão igual a 23, ou menor, os limites para
+FLOAT serão semelhantes aos de REAL.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27620.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27620.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27620.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27620.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,68 @@
+<?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="rrefsqlj27620" xml:lang="pt-br">
+<title>TIMESTAMP</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>TIMESTAMP data type</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>TIMESTAMP armazena o valor combinado de DATE e TIME.
+Permite um valor de segundos fracionário com até nove dígitos.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>TIMESTAMP</b></codeblock>
+</refsyn>
+<section>
+<title>Tipo Java correspondente em tempo de compilação</title>
+<p><i>java.sql.Timestamp</i></p>
+</section>
+<section>
+<title>Tipo do metadado do JDBC (java.sql.Types)</title>
+<p>TIMESTAMP</p>
+<p>Datas, horas e carimbos do tempo não podem ser misturados em expressões,
+exceto com CAST.</p>
+<p>O <ph conref="refconrefs.dita#prod/productshortname"></ph>
+suporta os seguintes formatos para TIMESTAMP:
+<codeblock>yyyy-mm-dd hh[:mm[:ss[.nnnnnn]]]
+yyyy-mm-dd-hh[.mm[.ss[.nnnnnn]]]</codeblock>
+O primeiro dos dois formatos acima é o formato de <i>java.sql.Timestamp</i>.</p>
+<p>O ano sempre deve ter quatro dígitos. Os meses, dias e horas podem ter um
+ou dois dígitos. Os minutos e os segundos, se estiverem presentes, devem ter
+dois dígitos. Os nanossegundos, se estiverem presentes, podem ter de um a seis
+dígitos.</p>
+<p>O <ph conref="refconrefs.dita#prod/productshortname"></ph>
+também aceita cadeias no formato de data/hora específico do idioma, utilizando
+o idioma do servidor de banco de dados.
+No caso de haver ambiguidade, os formatos nativos acima têm precedência.</p>
+</section>
+<example>
+<title>Exemplos</title>
+<codeblock><b>VALUES '1960-01-01 23:03:20'
+VALUES TIMESTAMP('1962-09-23 03:23:34.234')
+VALUES TIMESTAMP('1960-01-01 23:03:20')</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27767.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27767.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27767.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27767.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="rrefsqlj27767" xml:lang="pt-br">
+<title>Promoção de tipo numérico nas expressões</title>
+<refbody>
+<section>
+<p>Nas expressões que utilizam apenas os tipos inteiros, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+promove o tipo do resultado para pelo menos INTEGER.
+Nas expressões que misturam tipos inteiros e não inteiros, o
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+promove o resultado da expressão para o tipo mais alto da expressão.
+A tabela <xref href="#rrefsqlj27767/sqlj39640"></xref> mostra a promoção
+dos tipos de dado nas expressões.
+<table frame="all" id="sqlj39640">
+<title>Promoção de tipo nas expressões</title>
+<tgroup cols="2" colsep="1" rowsep="1">
+<colspec colname="1" colnum="1" colwidth="62*"/>
+<colspec colname="2" colnum="2" colwidth="38*"/>
+<thead>
+<row>
+<entry align="left" colname="1" valign="bottom">Maior tipo que aparece na expressão</entry>
+<entry align="left" colname="2" valign="bottom">Tipo do resultado da expressão</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="1">DOUBLE PRECISION</entry>
+<entry colname="2">DOUBLE PRECISION</entry>
+</row>
+<row>
+<entry colname="1">REAL</entry>
+<entry colname="2">DOUBLE PRECISION</entry>
+</row>
+<row>
+<entry colname="1">DECIMAL</entry>
+<entry colname="2">DECIMAL</entry>
+</row>
+<row>
+<entry colname="1">BIGINT</entry>
+<entry colname="2">BIGINT</entry>
+</row>
+<row>
+<entry colname="1">INTEGER</entry>
+<entry colname="2">INTEGER</entry>
+</row>
+<row>
+<entry colname="1">SMALLINT</entry>
+<entry colname="2">INTEGER</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</p>
+</section>
+<section>
+<p>Por exemplo:
+<codeblock><b><ph>-- retorna precisão dupla</ph>
+VALUES 1 + 1.0e0
+<ph>-- retorna decimal</ph>
+VALUES 1 + 1.0
+<ph>-- retorna inteiro</ph>
+VALUES CAST (1 AS INT) + CAST (1 AS INT)</b>
+</codeblock>
+</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27781.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27781.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27781.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj27781.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="rrefsqlj27781" xml:lang="pt-br">
+<title>MAX</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função de agregação MAX</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>MAX é uma função de agregação que calcula o valor máximo de uma expressão
+para um conjunto de valores (consulte
+<xref href="rrefsqlj33923.dita#rrefsqlj33923"></xref>).
+MAX é permitido apenas nas expressões que resultam em tipos de dado nativos
+(incluindo CHAR, VARCHAR, DATE, TIME, CHAR FOR BIT DATA, etc.).</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>MAX ( [ DISTINCT | ALL ] <i>Expressão</i> )</b></codeblock>
+<p>O qualificador DISTINCT elimina as linhas duplicadas.
+O qualificador ALL mantém as linhas duplicadas.
+Estes qualificadores não produzem efeito na expressão MAX.
+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), MAX (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>Para os tipos de dado 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 como MAX é
+avaliada.
+Por exemplo, se 'z' e 'z ' estiverem armazenados em uma coluna, não pode ser
+controlado qual dos dois será retornado como máximo, porque o espaço em
+branco não possui valor.</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>-- encontrar a data mais tarde da tabela DISPONIBILIDADE_VÔO</ph>
+SELECT MAX (DATA_VÔO) FROM DISPONIBILIDADE_VÔO
+
+<ph>-- encontrar o vôo mais longo a partir de cada aeroporto,
+-- mas somente quando o vôo mais longo tiver mais de 10 horas</ph>
+SELECT MAX(TEMPO_VÔO), AEROPORTO_ORIGEM
+FROM VÔOS
+GROUP BY AEROPORTO_ORIGEM
+HAVING MAX(TEMPO_VÔO) &gt; 10
+</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj28468.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj28468.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj28468.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj28468.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,115 @@
+<?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="rrefsqlj28468" xml:lang="pt-br">
+<title>Letras maiúsculas e caracteres especiais</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Diferenciação de letras maiúsculas e minúsculas em palavras chave e identificadores</indexterm>
+<indexterm>Palavras chave
+<indexterm>diferenciação de letras maiúsculas e minúsculas</indexterm>
+</indexterm>
+<indexterm>Caracteres especiais
+<indexterm>escapes nas instruções SQL</indexterm>
+</indexterm>
+<indexterm>Caractere de escape
+<indexterm>para apóstrofo</indexterm>
+</indexterm>
+<indexterm>Cadeias de caracteres
+<indexterm>delimitadas por apóstrofos nas instruções SQL</indexterm>
+</indexterm>
+<indexterm>Escapes Unicode
+<indexterm>suporte nas instruções SQL</indexterm>
+</indexterm>
+<indexterm>Identificadores Java
+<indexterm>diferenciação de letras maiúsculas e minúsculas no SQL</indexterm>
+</indexterm>
+<indexterm>* como curinga no SELECT do SQL</indexterm>
+<indexterm>% como curinga no SQL</indexterm>
+<indexterm>_ como curinga no SQL</indexterm>
+<indexterm>Caracteres curinga no SQL</indexterm>
+<indexterm>Delimitadores de comentários no SQL</indexterm>
+<indexterm>-- (delimitador de cmentário no SQL)</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>Ao utilizar classes e métodos do JDBC, são submetidas instruções SQL ao
+<ph conref="refconrefs.dita#prod/productshortname"></ph>
+na forma de cadeias.
+O conjunto de caracteres permitido nas cadeias contendo instruções SQL é o
+Unicode.
+Nestas cadeias se aplicam as seguintes regras:
+<ul>
+<li>Aspas delimitam os identificadores especiais, referidos no SQL-92 como
+<i>identificadores delimitados</i>.</li>
+<li>Apóstrofos delimitam cadeias de caracteres.</li>
+<li>Na cadeia de caracteres, para representar um apóstrofo (também chamado de
+aspas simples) são usados dois apóstrofos (Em outras palavras, o apóstrofo é o
+caractere de escape do apóstrofo).
+<p>As aspas não necessitam de caractere de escape.
+Para representar aspas deve-se, simplesmente, utilizar aspas.
+Entretanto, deve ser observado que no programa Java as aspas necessitam do
+caractere de escape contrabarra (\).</p>
+<ph><b>Exemplo:</b></ph>
+<codeblock><b><ph>
+-- o apóstrofo é o caractere de escape do apóstrofo</ph>
+
+VALUES 'Maria D''Almeida'
+
+<ph>-- no ij não há necessidade de caractere de escape para aspas</ph>
+
+VALUES 'Ele disse, "Bom dia!"'
+
+<ph>-- no programa Java aspas necessitam de escape</ph>
+
+n = stmt.executeUpdate(
+    "UPDATE minhaTabela SET stringCol = 'Ele disse, \"Bom dia!\"'");
+</b>
+</codeblock>
+</li>
+<li>As palavras chave do SQL não são sensíveis a letras maiúsculas e minúsculas.
+Por exemplo, a palavra chave SELECT pode ser escrita como SELECT, Select,
+select, ou sELECT.</li>
+<li>Os identificadores no estilo SQL-92 não são sensíveis a letras maiúsculas e
+minúsculas
+(consulte <i><xref href="crefsqlj34834.dita#crefsqlj34834">IdentificadorSQL92</xref></i>),
+a menos que estejam delimitados.</li>
+<li>Os identificadores no estilo Java são sensíveis a letras maiúsculas e
+minúsculas.</li>
+<li>O * é um caractere curinga na
+<i><xref href="rrefselectexpression.dita#rrefselectexpression">ExpressãoSeleção</xref>.</i>
+Consulte <xref href="rrefselectexpression.dita#rrefselectexpression/sqlj38441"></xref>.
+Também pode ser o operador de multiplicação.
+Em todos os outros casos é um meta-símbolo da sintaxe, sinalizando itens que
+podem ser repetidos zero ou mais vezes.</li>
+<li>% e _ são caracteres curinga quando utilizados nas cadeias de caracteres
+após o operador LIKE (exceto quando precedidos pelo caractere de escape).
+Consulte <xref href="rrefsqlj23075.dita#rrefsqlj23075"></xref>.</li>
+<li>De acordo com o padrão SQL-92, dois hífens (--) e o caractere de nova-linha
+delimitam um comentário.
+Os dois hífens iniciam o comentário, e o caractere de nova-linha termina o
+comentário.</li>
+</ul>
+</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29026.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29026.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29026.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29026.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,34 @@
+<?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="rrefsqlj29026" xml:lang="pt-br">
+<title>Funções nativas</title>
+<refbody>
+<section>
+<p>A função nativa é uma expressão na qual a palavra chave do SQL ou o operador
+especial executa alguma operação.
+As funções nativas utilizam palavras chave ou operadores nativos especiais.
+As funções nativas são IdentificadoresSQL92 e não diferenciam letras maiúsculas
+e minúsculas.
+Deve ser observado que as funções em escape, como TIMESTAMPADD e TIMESTAMPDIFF,
+são acessíveis apenas utilizando a sintaxe de escape do JDBC para funções,
+podendo ser encontradas em
+<xref href="rrefjdbc1020262.dita#rrefjdbc1020262"></xref>.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29840.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29840.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29840.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29840.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,68 @@
+<?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="rrefsqlj29840" xml:lang="pt-br">
+<title>Operação JOIN</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Operação JOIN</indexterm>
+<indexterm>Junções externas</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>As operações de junção (JOIN), que estão entre as
+<i><xref href="rreftableexpression.dita#rreftableexpression">ExpressõesTabela</xref></i>
+possíveis na
+<xref href="rrefsqlj21583.dita#rrefsqlj21583">CláusulaFROM</xref>,
+realizam junções entre duas tabelas (Também pode ser realizada a junção entre
+duas tabelas utilizando um teste de igualdade explícito na cláusula WHERE,
+como "WHERE t1.col1 = t2.col2".)</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b><i>Operação de junção</i></b></codeblock>
+<p>As operações de junção são:
+<ul>
+<li><xref href="rrefsqlj35034.dita#rrefsqlj35034"></xref>
+<p>Especifica a junção entre duas tabelas com uma cláusula de junção explícita.
+Consulte <xref href="rrefsqlj35034.dita#rrefsqlj35034"></xref>.</p></li>
+<li><xref href="rrefsqlj18922.dita#rrefsqlj18922"></xref>
+<p>Especifica a junção entre duas tabelas com uma cláusula de junção explícita,
+preservando as linhas sem correspondência da primeira tabela.
+Consulte <xref href="rrefsqlj18922.dita#rrefsqlj18922"></xref>.</p></li>
+<li><xref href="rrefsqlj57522.dita#rrefsqlj57522"></xref>
+<p>Especifica a junção entre duas tabelas com uma cláusula de junção explícita,
+preservando as linhas sem correspondência da segunda tabela.
+Consulte <xref href="rrefsqlj57522.dita#rrefsqlj57522"></xref>.</p></li>
+</ul>
+</p>
+<p>Em todos os casos podem ser especificadas restrições adicionais para uma ou
+mais tabelas sendo juntadas nas cláusulas de junção externa, ou na
+<xref href="rrefsqlj33602.dita#rrefsqlj33602">Cláusula WHERE</xref>.</p>
+</refsyn>
+<section>
+<title>Expressões de junção e otimização de consulta</title>
+<p>Para obter informações sobre quais tipos de junção são otimizadas, consulte
+<cite><ph conref="refconrefs.dita#pub/cittuning"></ph></cite>.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29930.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29930.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29930.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj29930.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,54 @@
+<?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="rrefsqlj29930.dita" xml:lang="pt-br">
+<title>UCASE ou UPPER</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Função UPPER</indexterm>
+<indexterm>Função UCASE</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>UCASE, ou UPPER, recebe uma expressão caractere como parâmetro, e retorna uma
+cadeia onde os caracteres alfabéticos foram convertidos para letras
+maiúsculas.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>UCASE ou UPPER ( <i>ExpressãoCaractere</i> ) </b></codeblock>
+<p>Se o tipo do parâmetro for CHAR , o tipo retornado será CHAR.
+Senão, o tipo retornado será VARCHAR.
+<note>As funções UPPER e LOWER seguem o idioma do banco de dados.
+Consulte <i><xref href="rrefattrib56769.dita#rrefattrib56769"></xref></i>
+para obter mais informações sobre como especificar o idioma.</note>
+</p>
+<p>O comprimento e o comprimento máximo do valor retornado são idênticos ao
+comprimento e comprimento máximo do parâmetro.</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- retorna 'ASD1#W'</ph>
+VALUES UPPER('aSD1#w')</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30118.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30118.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30118.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30118.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,43 @@
+<?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="rrefsqlj30118" xml:lang="pt-br">
+<title>LONG VARCHAR FOR BIT DATA</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Tipo de dado LONG VARCHAR FOR BIT DATA</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>O tipo de dado LONG VARCHAR FOR BIT DATA permite armazenar cadeias de bits
+de até 32.700 bytes.
+É idêntico a
+<xref href="rrefsqlj32714.dita#rrefsqlj32714">VARCHAR FOR BIT DATA</xref>,
+exceto por não ser necessário especificar o comprimento máximo ao criar
+colunas deste tipo.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>LONG VARCHAR FOR BIT DATA</b></codeblock>
+</refsyn>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30435.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30435.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30435.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30435.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,67 @@
+<?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="rrefsqlj30435" xml:lang="pt-br">
+<title>BIGINT</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Tipo de dado BIGINT</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>BIGINT fornece 8 bytes de armazenamento para valores inteiros.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>BIGINT</b></codeblock>
+</refsyn>
+<section>
+<title>Tipo Java correspondente em tempo de compilação</title>
+<p><i>java.lang.Long</i></p>
+</section>
+<section>
+<title>Tipo do metadado do JDBC (java.sql.Types)</title>
+<p>BIGINT</p>
+</section>
+<section>
+<title>Valor mínimo</title>
+<p id="sqlj76321">-9223372036854775808 (<i>java.lang.Long.MIN_VALUE</i>)</p>
+</section>
+<section>
+<title>Valor máximo</title>
+<p id="sqlj25246">9223372036854775807 (<i>java.lang.Long.MAX_VALUE</i>)</p>
+<p>Quando misturado com outros tipos de dado nas expressões, o tipo de dado
+do resultado segue as regras mostradas em
+<xref href="rrefsqlj27767.dita#rrefsqlj27767"></xref>.</p>
+<p>A tentativa de colocar um valor inteiro com tamanho de armazenamento maior
+em um local com tamanho de armazenamento menor falha apenas se o valor não
+puder ser armazenado no local com tamanho menor.
+Os tipos inteiros sempre podem ser colocados com sucesso em valores
+numéricos aproximados, embora com uma possível perda de precisão.
+Os valores BIGINT podem ser armazenados em decimais, se a precisão do DECIMAL
+for grande o suficiente para o valor.</p>
+</section>
+<example>
+<codeblock><b>9223372036854775807</b></codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30540.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30540.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30540.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj30540.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,48 @@
+<?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="rrefsqlj30540" xml:lang="pt-br">
+<title>definição-da-coluna</title>
+<refbody>
+<example> <codeblock><b><i><xref href="rrefsimplecolumnname.dita#rrefsimplecolumnname">nome-de-coluna-simples</xref></i> <i>tipo-de-dado</i>
+    [ <i><xref href="rrefsqlj16095.dita#rrefsqlj16095">restrição no nível-de-coluna</xref></i> ]*
+    [ [ WITH ] DEFAULT { expressão-constante | NULL }
+       |<i><xref href="rrefsqlj37836.dita#rrefsqlj37836">especificação-de-coluna-gerada</xref></i> ]
+    [ <i><xref href="rrefsqlj16095.dita#rrefsqlj16095">restrição no nível-de-coluna</xref></i> ]*
+</b>
+</codeblock>
+</example>
+<section>
+<p>A sintaxe do <i>tipo-de-dado</i> está descrita em
+<xref href="crefsqlj31068.dita#crefsqlj31068"></xref>.</p>
+<p>As sintaxes de
+<i><xref href="rrefsqlj16095.dita#rrefsqlj16095">restrição no nível-de-coluna</xref></i>
+e
+<i><xref href="rrefsqlj42154.dita#rrefsqlj42154">restrição no nível-de-tabela</xref></i>
+estão descritas na
+<xref href="rrefsqlj13590.dita#rrefsqlj13590"></xref>.</p>
+</section>
+<section id="sqlj64478">
+<title>Valor padrão da coluna</title>
+<p>Na definição do valor padrão, a <i>expressão-constante</i> é uma
+expressão que não faz referência a nenhuma tabela.
+Pode incluir constantes, registros especiais de data e hora, esquemas correntes,
+usuários e nulo.</p>
+</section>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31580.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31580.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31580.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31580.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="rrefsqlj31580" xml:lang="pt-br">
+<title>Instrução CREATE SCHEMA</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução CREATE SCHEMA</indexterm>
+<indexterm>Esquemas<indexterm>criação</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>O esquema é uma forma de agrupar logicamente objetos em uma única coleção, e
+fornecer um espaço de nomes único para os objetos.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>CREATE SCHEMA <i><xref href="rrefschemaname.dita#rrefschemaname">nome-do-esquema</xref></i></b></codeblock>
+<p>A instrução CREATE SCHEMA é utilizada para criar esquemas.
+O nome do esquema não pode possuir mais de 128 caracteres.
+Os nomes dos esquemas devem ser únicos no banco de dados.</p>
+</refsyn>
+<example><codeblock><b><ph>-- Criar um esquema para as tabelas relacionadas com os empregados
+</ph>
+CREATE SCHEMA EMP;
+<ph>
+-- Criar um esquema para as tabelas relacionadas com as linhas aéreas
+</ph>
+CREATE SCHEMA VÔOS
+<ph>
+-- Criar uma tabela chamada "disponibilidade" em cada esquema
+</ph>
+CREATE TABLE VÔOS.DISPONIBILIDADE (
+    ID_VÔO                            CHAR(6) NOT NULL,
+    NUM_SEGMENTO                      INT NOT NULL,
+    DATA_VÔO                          DATE NOT NULL,
+    ASSENTOS_ECONÔMICOS_OCUPADOS      INT,
+    ASSENTOS_EXECUTIVOS_OCUPADOS      INT,
+    ASSENTOS_PRIMEIRA_CLASSE_OCUPADOS INT,
+    CONSTRAINT PK_VÔOS_DISPONIBILIDADE
+    PRIMARY KEY (ID_VÔO, NUM_SEGMENTO, DATA_VÔO));
+
+CREATE TABLE EMP.DISPONIBILIDADE (
+    ID_HOTEL         INT NOT NULL,
+    DATA_RESERVA     DATE NOT NULL,
+    QUARTOS_OCUPADOS INT,
+    CONSTRAINT PK_HOTEL_DISPONIBILIDADE PRIMARY KEY (ID_HOTEL, DATA_RESERVA));</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31648.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31648.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31648.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31648.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,55 @@
+<?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="rrefsqlj31648" xml:lang="pt-br">
+<title>Instrução DROP SCHEMA</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução DROP SCHEMA</indexterm>
+<indexterm>Esquemas<indexterm>remoção</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A instrução DROP SCHEMA remove um esquema.
+O esquema de destino deve estar vazio para a remoção ser bem-sucedida.</p>
+<p>Nem o esquema <i>APP</i> (o esquema padrão do usuário), e nem o esquema
+<i>SYS</i>, podem ser removidos.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>DROP SCHEMA <i><xref href="rrefschemaname.dita#rrefschemaname">nome-do-esquema</xref></i> RESTRICT</b>
+</codeblock>
+<p>A palavra chave RESTRICT impõe a regra que,
+para o esquema poder ser removido do banco de dados,
+não pode existir nenhum objeto definido no esquema especificado.
+A palavra chave RESTRICT é requerida.</p>
+</refsyn>
+<example>
+<codeblock><b><ph>-- Remover o esquema SAMP
+-- O esquema SAMP somente poderá ser removido do banco de dados
+-- se não existir nenhum objeto definido no esquema SAMP.</ph>
+
+DROP SCHEMA SAMP RESTRICT</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31783.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31783.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31783.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj31783.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,68 @@
+<?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="rrefsqlj31783" xml:lang="pt-br">
+<title>Cláusula FOR UPDATE</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Cláusula FOR UPDATE</indexterm>
+<indexterm>Cursores</indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>
+<indexterm>Cursores</indexterm>
+<indexterm>Atualizações no local</indexterm>
+A cláusula FOR UPDATE é uma parte opcional da
+<xref href="rrefsqlj41360.dita#rrefsqlj41360">Instrução SELECT</xref>.
+A cláusula FOR UPDATE especifica se o <i>ResultSet</i> de uma
+<xref href="rrefsqlj41360.dita#rrefsqlj41360">Instrução SELECT</xref>
+simples, que atende os requisitos para um <i>cursor</i>, é atualizável ou não.
+Para obter mais informações sobre poder ser atualizável, deve ser consultado
+<xref href="rrefsqlj41360.dita#rrefsqlj41360/sqlj15384">Requisitos para cursores
+atualizáveis e ResultSets atualizáveis</xref>.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>FOR
+{
+    READ ONLY | FETCH ONLY |
+    UPDATE [ OF <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>
+<p><i>nome-de-coluna-simples</i> faz referência aos nomes visíveis para a
+tabela especificada na cláusula FROM da consulta subjacente.</p>
+<p>Por padrão, os cursores são apenas-de-leitura.
+Para o cursor ser atualizável, deve ser especificado FOR UPDATE.</p>
+<p>O otimizador é capaz de utilizar um índice mesmo que a coluna do índice esteja
+sendo atualizada.
+Para obter mais informações sobre como os índices afetam os cursores deve ser
+consultado o <cite><ph conref="refconrefs.dita#pub/cittuning"></ph></cite>.</p>
+</refsyn>
+<example>
+<codeblock><b>SELECT RECEBIDO, ORIGEM, ASSUNTO, TEXTO_NOTA FROM SAMP.CAIXA_ENTRADA FOR UPDATE;
+</b>
+</codeblock>
+</example>
+</refbody>
+</reference>

Added: db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32268.dita
URL: http://svn.apache.org/viewcvs/db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32268.dita?rev=388422&view=auto
==============================================================================
--- db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32268.dita (added)
+++ db/derby/docs/trunk/src/pt_BR/ref/rrefsqlj32268.dita Thu Mar 23 23:09:52 2006
@@ -0,0 +1,106 @@
+<?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="rrefsqlj32268" xml:lang="pt-br">
+<title>Instrução SET SCHEMA</title>
+<prolog>
+<metadata>
+<keywords>
+<indexterm>Instrução SET SCHEMA</indexterm>
+<indexterm>Esquemas<indexterm>alteração da sessão padrão</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog>
+<refbody>
+<section>
+<p>A instrução SET SCHEMA define o esquema padrão para a sessão da conexão
+como sendo o esquema designado.
+O esquema padrão é utilizado como esquema de destino por todas as instruções
+emitidas pela conexão que não especificam explicitamente o nome do esquema.</p>
+<p>Para a instrução SET SCHEMA ser bem-sucedida, o esquema de destino deve
+existir.
+Se o esquema não existir, retornará um erro.
+Consulte a <xref href="rrefsqlj31580.dita#rrefsqlj31580"></xref>.</p>
+<p>A instrução SET SCHEMA não é transacional: Se a instrução SET SCHEMA for
+parte de uma transação desfeita, a mudança de esquema permanecerá aplicada.</p>
+</section>
+<refsyn>
+<title>Sintaxe</title>
+<codeblock><b>SET [CURRENT] SCHEMA [=]
+{ <i><xref href="rrefschemaname.dita#rrefschemaname">nome-do-esquema</xref> </i>|
+USER | ? | '&lt;constante-cadeia-de-caracteres&gt;' } | SET CURRENT SQLID [=]
+{
+<i><xref href="rrefschemaname.dita#rrefschemaname">nome-do-esquema</xref> </i>| USER | ? | '&lt;constante-cadeia-de-caracteres&gt;' }</b>
+</codeblock>
+<p>O <i><xref href="rrefschemaname.dita#rrefschemaname">nome-do-esquema</xref></i>
+é um identificador com comprimento máximo igual a 128.
+Não diferencia letras maiúsculas de minúsculas, a menos que esteja entre aspas
+(Por exemplo, SYS é equivalente a sYs, SYs, sys, etc.).</p>
+<p>USER é o usuário corrente.
+Se não houver usuário corrente definido, o esquema corrente padrão será o
+esquema <i>APP</i> (Se for especificado um nome de usuário na conexão, o nome
+de usuário será o esquema padrão para a conexão, caso exista um esquema com este
+nome).</p>
+<p>? é a especificação de um parâmetro dinâmico que pode ser utilizado em
+instruções preparadas.
+A instrução SET SCHEMA pode ser preparada uma vez e executada com valores de
+esquema diferentes.
+Os valores do esquema são tratados como constantes cadeia de caracteres,
+portanto diferenciando letras maiúsculas e minúsculas.
+Por exemplo, para designar o esquema <i>APP</i> deve ser utilizada a cadeia
+de caracteres "APP", em vez de "app".</p>
+</refsyn>
+<example> <codeblock><b><ph>-- os comandos a seguir são todos equivalentes,
+-- e funcionam assumindo que exista um esquema chamado HOTEL </ph>
+SET SCHEMA HOTEL
+SET SCHEMA hotel
+SET CURRENT SCHEMA hotel
+SET CURRENT SQLID hotel
+SET SCHEMA = hotel
+SET CURRENT SCHEMA = hotel
+SET CURRENT SQLID = hotel
+SET SCHEMA "HOTEL" <ph>-- identificador entre aspas</ph>
+SET SCHEMA 'HOTEL' <ph>-- cadeia de caracteres entre apóstrofos</ph>
+
+<ph>-- Este exemplo produz um erro, porque
+-- hotel em minúsculas não será encontrado</ph>
+SET SCHEMA = 'hotel'
+
+<ph>-- Este exemplo produz um erro, porque SQLID
+-- não é permitido sem CURRENT</ph>
+SET SQLID hotel
+
+<ph>-- Este exemplo define o esquema como o ID do usuário corrente</ph>
+SET CURRENT SCHEMA USER
+
+<ph>// Abaixo está um exemplo da utilização de SET SCHEMA em um programa Java</ph>
+PreparedStatement ps = conn.PrepareStatement("set schema ?");
+ps.setString(1,"HOTEL");
+ps.executeUpdate();
+... fazer alguma coisa
+ps.setString(1,"APP");
+ps.executeUpdate();
+
+ps.setString(1,"app"); <ph>//erro - a cadeia de caracteres diferencia
+// letras maiúsculas e minúsculas; app não será encontrado</ph>
+ps.setNull(1, Types.VARCHAR); <ph>//erro - não é permitido nulo</ph></b>
+</codeblock>
+</example>
+</refbody>
+</reference>