Este manual utiliza algumas convenções tipográficas:
constant
Fonte de largura fixa é usada para nomes de comandos e
opções; instruções SQL; nomes de bancos de dados,
tabelas e colunas; código C e Perl; e variáveis de
ambiente. Exemplo: ``Para ver como o
mysqladmin
funciona, execute-o com a
opção --help
.''
filename
Fonte de largura fixa com aspas é usada para nomes e
caminhos de arquivos. Exemplo: ``A distribuição é
instalada sobre o diretório
/usr/local
.''
‘c
’
Fonte de largura constante com aspas é também usada para
indicar sequências de caracteres. Exemplo: ``Para
especificar um meta caracter, use o caractere
‘%
’.''
italic
Fonte Itálica é usada para dar ênfase, como aqui.
boldface
Fonte em negrito é usada em cabeçalhos de tabela e indicar ênfase especial.
Quando um comando deve ser executado por um programa, ele é
indicado por um prompt antes do comando. Por exemplo,
shell>
indica um comando que é executado
do seu shell atual e mysql>
indica um
comando que é executado no programa cliente
mysql
;
shell>digite um comando shell aqui
mysql>digite um comando mysql aqui
A ``shell'' é seu interpretador de comando. No Unix, ele é
normalmente um programa como sh
ou
csh
. No Windows, o equivalente é o
command.com
ou cmd.exe
,
normalmente executado como um console do Windows.
Comandos Shell são mostrados usando a sintaxe do Shell Bourne.
Se você usa um shell do estilo csh
, pode ser
necessário alterar algum de seus comandos. Por exemplo, a
sequência para configurar uma variável de ambiente e executar
um comando se parece com o listado abaixo na sintaxe Bourne
Shell:
shell> NOMEVAR=valor algum_comando
Para csh
ou tcsh
, execute
a sequência desta forma:
shell>setenv NOMEVAR valor
shell>algum_comando
Frequentemente, nomes de bancos de dados, tabelas e colunas
devem ser substituídos nos comandos. Para indicar que as
substituições são necessárias, este manual usa
nome_db
, nome_tbl
e
nome_col
. Por exemplo, você pode encontrar
uma expressão assim:
mysql> SELECT nome_col FROM nome_bd.nome_tbl;
Isso significa que se você estiver trabalhando numa expressão similar, forneceria seu próprio nome de banco de dados, tabela e colunas, talvez assim:
mysql> SELECT nome_autor FROM biblio_bd.lista_autor;
SQL keywords não caso sensitivas e podem ser escritas em maiúscula ou minúscula. Este manual utiliza letras maiúsculas.
Em descrições de sintaxe, colchetes
(‘[
’ e
‘]
’) são usados para indicar
palavras ou cláusulas opcionais. Por exemplo, na seguinte
instrução, IF EXISTS
é opcional:
DROP TABLE [IF EXISTS] nome_tbl
Quando elementos da sintaxe possuem mais de uma alternativa,
elas são separados por barras verticais
(‘|
’). Quando um menbro de um
conjunto de opções pode ser
escolhido, as alternativas são listadas em colchetes
(‘[
’ e
‘]
’):
TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)
Quando um membro de um conjunto de opções
deve ser selecionado, as
alternativas são listadas dentro de chaves
(‘{
’ e
‘}
’):
{DESCRIBE | DESC} nome_tbl {nome_col | metacar}
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.