Curso de MariaDB / Criar um banco com CREATE DATABASE, USE e utf8mb4

CREATE DATABASE cria um banco de dados; USE seleciona o banco padrão da conexão atual. Defina utf8mb4 e uma collation adequada explicitamente para o banco de práticas e confira os valores armazenados: IF NOT EXISTS não atualiza os padrões de um banco existente.

Verificar a conta e o escopo do banco de práticas

Conecte como course_user seguindo o guia do cliente de linha de comando. A preparação concede direitos sobre shopcourse.*, permitindo criar e usar esse banco sem autorização para criar bancos arbitrários em outros lugares.

Mantenha o nome shopcourse ao longo do curso. Se o alterar, ajuste de forma consistente permissões e exemplos posteriores. Não use bancos de sistema como mysql para tabelas de prática. Confirme a conta antes de criar qualquer objeto:

SELECT CURRENT_USER() AS privilege_account;
SHOW GRANTS;

A conta esperada é course_user@127.0.0.1. Um resultado diferente pode indicar que a conexão usa outra identidade ou regra de host.

Criar shopcourse e conferir as configurações

Salve o exemplo completo em UTF-8 como lesson05-create-database.sql ou execute as instruções em ordem dentro do cliente:

CREATE DATABASE IF NOT EXISTS shopcourse
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

SHOW WARNINGS;
USE shopcourse;
SELECT DATABASE() AS current_database;
SHOW CREATE DATABASE shopcourse;

SELECT SCHEMA_NAME, DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME
FROM information_schema.SCHEMATA
WHERE SCHEMA_NAME = 'shopcourse';

Se usar um arquivo, execute SOURCE com o caminho local completo real, como explicado no guia do cliente. Em um banco novo, SELECT DATABASE() retorna shopcourse. A consulta ao esquema deve informar:

SCHEMA_NAME DEFAULT_CHARACTER_SET_NAME DEFAULT_COLLATION_NAME
shopcourse utf8mb4 utf8mb4_unicode_ci

Execute SHOW WARNINGS imediatamente depois da instrução cujas mensagens deseja conferir. SHOW CREATE DATABASE apresenta a definição armazenada; a formatação pode variar entre versões. O arquivo cria o banco, não a tabela products. As referências de CREATE DATABASE e SHOW CREATE DATABASE descrevem essas instruções.

Entender o que IF NOT EXISTS faz

IF NOT EXISTS evita um erro de banco já existente: mantém o banco e informa uma nota. Não limpa os dados nem reescreve conjunto de caracteres e collation. Por isso, repetir o exemplo com um shopcourse existente pode mostrar valores diferentes dos apresentados para uma criação nova.

Examine o banco existente antes de decidir o que mudar. Não utilize DROP DATABASE rotineiramente para fazer a saída coincidir com o exemplo. Preserve tabelas importantes e investigue suas definições. O sucesso de CREATE com IF NOT EXISTS não comprova que os padrões solicitados foram aplicados ao banco anterior.

Distinguir caracteres, collation e conexão

O conjunto de caracteres define como o texto é representado. A collation, ou regra de comparação e ordenação, define como cadeias são comparadas e ordenadas. utf8mb4 permite caracteres UTF-8 de quatro bytes; o nome mais curto utf8 foi historicamente um alias cujo significado depende da versão e configuração. Os exemplos usam o nome explícito.

Configuração Função
Padrões do banco Valores herdados por tabelas criadas depois, quando não são substituídos
Definição da tabela ou coluna Regras efetivamente declaradas ou herdadas para o texto armazenado
Caracteres da conexão Como cliente e servidor trocam texto
Collation Como comparações e ordenações tratam os caracteres

utf8mb4_unicode_ci é um exemplo amplamente disponível, não uma afirmação de que seja a collation mais nova ou padrão de toda versão. O guia oficial de caracteres e collations explica herança e configuração. Observe uma diferença específica de comparação:

SELECT
  _utf8mb4'A' COLLATE utf8mb4_unicode_ci =
  _utf8mb4'a' COLLATE utf8mb4_unicode_ci AS case_insensitive,
  _utf8mb4'A' COLLATE utf8mb4_bin =
  _utf8mb4'a' COLLATE utf8mb4_bin AS binary_comparison;
case_insensitive binary_comparison
1 0

1 significa verdadeiro e 0, falso. A collation sem distinção de maiúsculas trata essas duas letras ASCII como iguais; a binária as distingue. Esse teste pequeno não descreve a ordenação de todos os idiomas. Escolha as regras conforme as comparações de que sua aplicação precisa.

Selecionar o banco na conexão atual

USE shopcourse;
SELECT DATABASE() AS current_database;
SHOW TABLES;

USE seleciona um banco padrão apenas nesta conexão. Não muda permanentemente o padrão de todos os clientes ou logins futuros. Em um banco recém-criado, SHOW TABLES retorna um conjunto vazio porque ainda não há tabelas; isso é um resultado válido.

Quando a tabela existir, será possível referenciá-la pelo nome qualificado shopcourse.products. Um nome sem qualificação, como products, depende do banco selecionado. Abrir outra conexão não transfere automaticamente a seleção feita nesta sessão.

Diagnosticar permissões, seleção e texto

  • CREATE negado: confira CURRENT_USER() e SHOW GRANTS para o escopo do banco pretendido.
  • Unknown database: confira nome, servidor e porta da conexão.
  • No database selected: execute USE shopcourse antes de usar nomes de tabela sem qualificação.
  • Collation inesperada: examine um banco existente; IF NOT EXISTS não modifica seus padrões.
  • Texto incorreto: confira arquivo de origem, conexão e definições reais das tabelas ou colunas.

Alterar o padrão de caracteres do banco não converte as colunas de texto das tabelas existentes. Antes de mudar definições, salve as originais e avalie separadamente a conversão necessária. Não é preciso excluir o banco para diagnosticar problemas de conexão ou seleção. Confira as configurações e mude apenas aquela responsável pelo problema.