Curso de MariaDB / Conectar com o cliente e executar arquivos SQL com SOURCE
Inicie a conexão MariaDB no terminal e digite SQL dentro do cliente conectado. Para executar um arquivo SQL salvo em UTF-8, use SOURCE com um caminho no computador onde o cliente é executado; esse caminho não aponta para o sistema de arquivos do servidor do banco.
Preparar o servidor, a conta e o arquivo
Conclua a instalação no Windows ou a instalação no Ubuntu e confira se o servidor está em execução. Os exemplos comuns usam os valores abaixo. Substitua a porta se escolheu outra para sua instância.
| Item | Valor ou verificação |
|---|---|
| Protocolo e host | TCP com 127.0.0.1 |
| Porta | 3306, salvo se a instância utilizar outra |
| Conta | course_user com a senha escolhida |
| Conjunto de caracteres da conexão | utf8mb4 |
| Arquivo SQL | Texto UTF-8 com extensão .sql, não .sql.txt |
O shell executa o programa cliente; o cliente conectado transmite SQL ao servidor. SOURCE é interpretado pelo cliente, que lê o arquivo local e envia suas instruções. Confundir essas camadas faz com que comandos válidos sejam digitados no lugar errado.
Conectar pelo terminal e verificar a conexão
Execute no terminal, fora de qualquer conexão MariaDB existente:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
| Opção | Finalidade |
|---|---|
| --protocol=tcp | Usar TCP explicitamente em vez de um socket local |
| --host e --port | Selecionar o destino do servidor |
| --user | Selecionar o nome de usuário MariaDB |
| --password | Solicitar a senha em vez de incluí-la no comando |
| --default-character-set=utf8mb4 | Definir o conjunto de caracteres da conexão cliente |
| --abort-source-on-error | Interromper o restante da entrada SOURCE diante de um erro |
No Windows, se mariadb não estiver no caminho de pesquisa, use MariaDB Command Prompt ou o caminho completo apresentado no guia Windows. Um prompt como MariaDB [(none)]> indica ausência de banco padrão selecionado, não necessariamente uma falha de login.
Dentro do cliente, execute:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;
O servidor retorna versão, informações das contas, total 5 e a saudação Hello, café. O caractere acentuado permite uma verificação simples de codificação. USER() descreve a identidade da conexão, enquanto CURRENT_USER() identifica a conta usada para verificar privilégios. A referência oficial do cliente de linha de comando define opções e comandos.
Concluir, cancelar ou exibir uma instrução
Uma instrução SQL pode ocupar várias linhas. O cliente aguarda sua conclusão, normalmente indicada pelo ponto e vírgula:
SELECT
10 + 20 AS total;
O resultado é 30. Se ainda estiver digitando uma instrução incompleta e quiser descartá-la, use a ordem do cliente:
\c
Para exibir um resultado verticalmente, utilize o terminador \G no lugar do ponto e vírgula:
SELECT VERSION() AS server_version\G
\c e \G são convenções do cliente, não sintaxe SQL geral aceita por toda ferramenta. Para sair, use \q. Encerrar a conexão não para o servidor MariaDB nem remove seus dados.
Salvar um arquivo SQL UTF-8 completo
Crie um arquivo de texto simples chamado lesson04-check.sql com o exemplo inteiro:
SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;
Escolha UTF-8 no editor e confira a extensão real. O Windows pode ocultar extensões e deixar o nome lesson04-check.sql.txt. Use uma pasta sob seu controle, como C:\mariadb-course\ no Windows ou /home/yourname/mariadb-course/ no Ubuntu. Substitua yourname pelo componente real do diretório.
O arquivo guarda instruções, não é um backup do banco. Salvá-lo não executa SQL. Seu caminho é um local no sistema de arquivos do computador cliente; 127.0.0.1:3306 identifica o destino de uma conexão ao servidor.
Executar com SOURCE e conferir os resultados
Depois de conectar, use o caminho Windows com barras normais:
SOURCE C:/mariadb-course/lesson04-check.sql;
Ou utilize o caminho real do Ubuntu:
SOURCE /home/yourname/mariadb-course/lesson04-check.sql;
São alternativas, não comandos para executar em sequência. O cliente deve mostrar os mesmos três resultados, incluindo total 5 e a saudação com acento intacto. Este arquivo apenas consulta valores: repeti-lo não acrescenta nem remove linhas de tabelas.
Mesmo que cliente e servidor estejam em computadores distintos, SOURCE lê o arquivo no computador cliente. Com --abort-source-on-error, um erro interrompe o restante da entrada do arquivo. Isso não desfaz instruções que já tiveram sucesso nem torna a criação de tabelas reversível por rollback. Antes de repetir um arquivo que modifica dados, verifique até onde ele foi executado.
Resolver erros de arquivo, codificação e SQL
- Arquivo não encontrado: confira caminho completo, grafia, permissões e se a extensão é realmente .sql.
- Texto ilegível: confira UTF-8 do arquivo, conjunto de caracteres da conexão e codificação de exibição do terminal.
- Access denied: examine conta e permissões; é diferente de um arquivo ausente.
- Erro no meio do arquivo: examine o que já teve sucesso antes de repetir instruções que alteram dados.
No Windows, se o problema for a codificação de exibição do terminal, saia do cliente, execute o comando abaixo no terminal e conecte novamente com a opção de conexão UTF-8:
chcp 65001
Dentro do cliente, consulte as variáveis de caracteres quando necessário:
SHOW VARIABLES LIKE 'character_set_%';
Alterar a conexão não repara automaticamente texto armazenado incorretamente no passado. Identifique a origem do problema antes de mudar dados. Execute comandos do shell, comandos do cliente e SQL nos respectivos contextos.





