:: DEVELOPER ZONE
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}
© 1995-2005 MySQL AB. All rights reserved.
