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 terminal inicia o cliente mariadb e SOURCE lê um arquivo SQL do computador cliente; o servidor executa as instruções e o cliente mostra os resultados

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.