> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SELECT no MySQL

> Como a instrução SELECT do MySQL lê dados de uma tabela: nomeando colunas, selecionando todas as colunas e calculando um valor, com exemplos executáveis no Sakila.

> [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md)
>
> All examples on this page work on VillageSQL. Install Now →

`SELECT` lê linhas de uma tabela. Esta lição cobre sua menor forma
útil: nomeie uma tabela, nomeie algumas colunas, receba linhas de volta.

Todos os exemplos consultam o banco de dados Sakila. Se você ainda não o carregou,
[carregue o Sakila primeiro](https://villagesql.com/docs/pt-BR/tutorial/load-sakila.md), depois abra o cliente com
`mysql -u root -p sakila` para que `sakila` seja o banco de dados atual.

## Como SELECT funciona

```sql theme={null}
SELECT COLUMN_LIST
FROM TABLE_NAME;
```

`COLUMN_LIST` é o que você quer em cada linha, normalmente nomes de coluna separados por
vírgulas. `TABLE_NAME` é a tabela de onde as linhas vêm.

Uma instrução termina no ponto e vírgula. O cliente continua lendo até encontrar um,
então uma linha sem ponto e vírgula deixa você em um prompt de continuação:

```text theme={null}
mysql> SELECT name FROM language
    -> ;
+----------+
| name     |
+----------+
| English  |
| Italian  |
| Japanese |
| Mandarin |
| French   |
| German   |
+----------+
6 rows in set (0.00 sec)
```

## Exemplos

### Selecione uma coluna

Peça à tabela `film` o título de cada filme e nada mais.

```sql theme={null}
SELECT title FROM film;
```

```text theme={null}
+-----------------------------+
| title                       |
+-----------------------------+
| ACADEMY DINOSAUR            |
| ACE GOLDFINGER              |
| ADAPTATION HOLES            |
| AFFAIR PREJUDICE            |
| AFRICAN EGG                 |
...
+-----------------------------+
1000 rows in set (0.01 sec)
```

Uma linha volta para cada linha da tabela, 1.000 delas aqui. `SELECT`
não filtra nada por conta própria. Escolher quais linhas você recebe é o trabalho do
[WHERE](https://villagesql.com/docs/pt-BR/tutorial/where.md).

### Selecione várias colunas

Separe os nomes das colunas com vírgulas. Elas voltam na ordem em que você as
pediu, que não precisa ser a ordem em que estão na tabela.

```sql theme={null}
SELECT title, release_year, rental_rate FROM film;
```

```text theme={null}
+-----------------------------+--------------+-------------+
| title                       | release_year | rental_rate |
+-----------------------------+--------------+-------------+
| ACADEMY DINOSAUR            |         2006 |        0.99 |
| ACE GOLDFINGER              |         2006 |        4.99 |
| ADAPTATION HOLES            |         2006 |        2.99 |
| AFFAIR PREJUDICE            |         2006 |        2.99 |
| AFRICAN EGG                 |         2006 |        2.99 |
...
+-----------------------------+--------------+-------------+
1000 rows in set (0.00 sec)
```

### Selecione todas as colunas

Um asterisco representa todas as colunas da tabela. A tabela `language` tem 6
linhas, então esta consulta imprime um resultado completo.

```sql theme={null}
SELECT * FROM language;
```

```text theme={null}
+-------------+----------+---------------------+
| language_id | name     | last_update         |
+-------------+----------+---------------------+
|           1 | English  | 2006-02-15 05:02:19 |
|           2 | Italian  | 2006-02-15 05:02:19 |
|           3 | Japanese | 2006-02-15 05:02:19 |
|           4 | Mandarin | 2006-02-15 05:02:19 |
|           5 | French   | 2006-02-15 05:02:19 |
|           6 | German   | 2006-02-15 05:02:19 |
+-------------+----------+---------------------+
6 rows in set (0.00 sec)
```

`SELECT *` tem seu lugar enquanto você explora uma tabela que não conhece.
Dentro do código de uma aplicação, nomeie suas colunas. Um asterisco envia todas as colunas pela
rede, quer o código as leia ou não, e muda de forma por baixo do
código no dia em que alguém adiciona uma coluna.

### Calcule um valor

A lista de seleção não precisa nomear uma coluna. Coloque uma expressão nela e o
resultado se torna uma coluna própria.

```sql theme={null}
SELECT title, rental_rate, rental_rate * 1.1 FROM film;
```

```text theme={null}
+-----------------------------+-------------+-------------------+
| title                       | rental_rate | rental_rate * 1.1 |
+-----------------------------+-------------+-------------------+
| ACADEMY DINOSAUR            |        0.99 |             1.089 |
| ACE GOLDFINGER              |        4.99 |             5.489 |
| ADAPTATION HOLES            |        2.99 |             3.289 |
| AFFAIR PREJUDICE            |        2.99 |             3.289 |
| AFRICAN EGG                 |        2.99 |             3.289 |
...
+-----------------------------+-------------+-------------------+
1000 rows in set (0.00 sec)
```

O cabeçalho dessa terceira coluna é a expressão que você digitou, o que é preciso
e feio. Um [alias de coluna](https://villagesql.com/docs/pt-BR/tutorial/column-aliases.md) dá a ela um nome escolhido por você.

## 2 coisas que pegam as pessoas de surpresa

**As palavras-chave ignoram maiúsculas e minúsculas.** `SELECT`, `select` e `SeLeCt` funcionam.

```sql theme={null}
select title from film;
```

```text theme={null}
+-----------------------------+
| title                       |
+-----------------------------+
| ACADEMY DINOSAUR            |
| ACE GOLDFINGER              |
| ADAPTATION HOLES            |
...
+-----------------------------+
1000 rows in set (0.00 sec)
```

Este tutorial escreve as palavras-chave em maiúsculas e todo o resto em minúsculas,
por convenção. Ela existe para que a forma de uma consulta longa seja lida de relance.

**Uma coluna com o nome errado gera um erro.** O MySQL não adivinha o que você quis dizer,
e não devolve um resultado vazio.

```sql theme={null}
SELECT titel FROM film;
```

```text theme={null}
ERROR 1054 (42S22): Unknown column 'titel' in 'field list'
```

`field list` é o nome que o servidor dá à lista de seleção, então essa mensagem localiza
o erro além de nomeá-lo. O mesmo erro termina de forma diferente quando o nome
errado está em outra parte da instrução, então leia o final da mensagem antes de sair
procurando.

## Resumo

* Use `SELECT` com uma lista de colunas e `FROM` com uma tabela para ler linhas.
* Liste as colunas na ordem em que você as quer de volta.
* Recorra a `SELECT *` enquanto explora, e nomeie suas colunas no código de uma aplicação.
* Coloque uma expressão na lista de seleção para calcular um valor por linha.
* Espere `ERROR 1054` quando o nome de uma coluna estiver errado.

## Veja também

* [Aliases de coluna](https://villagesql.com/docs/pt-BR/tutorial/column-aliases.md) — dê a uma coluna calculada um nome legível
* [Escolhendo tipos de dados no MySQL](https://villagesql.com/docs/pt-BR/guides/choosing-data-types.md) — o que os tipos de coluna destes resultados significam


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.