Curso de MariaDB / Importar e exportar CSV com caminhos, permissões e UTF-8 corretos
Para importar CSV no MariaDB, ajuste separadores, aspas, quebras de linha e codificação, valide os valores originais em uma tabela intermediária e só então converta para os tipos de destino. LOAD DATA LOCAL INFILE lê um arquivo do cliente; SELECT INTO OUTFILE grava no servidor, portanto os caminhos e as permissões são diferentes.
Identificar qual computador lê ou grava o arquivo
CSV é um formato de texto com campos separados por vírgulas, embora ferramentas também usem outros separadores. O nome do formato não determina sozinho as regras de aspas, escape, codificação ou representação de valores ausentes; combine essas regras com quem produz e recebe o arquivo.
| Operação | Local do arquivo | Requisitos |
|---|---|---|
| LOAD DATA LOCAL INFILE | Computador cliente | LOCAL permitido no cliente e no servidor |
| LOAD DATA INFILE | Servidor de banco de dados | Privilégio FILE e política de caminhos do servidor |
| SELECT INTO OUTFILE | Servidor de banco de dados | FILE, secure_file_priv e permissões do sistema operacional |
Permita LOCAL apenas para um servidor confiável e considere quais arquivos do cliente podem ser lidos e enviados. Não amplie todas as permissões ou opções globais para ocultar um erro de importação. A prática do cliente e de arquivos SQL explica os caminhos, e a prática de INSERT ajuda a conferir a correspondência entre colunas e valores.
Preparar um arquivo UTF-8 e uma tabela de texto original
Crie um arquivo novo products.csv em C:/mariadb-lab no computador cliente, sem sobrescrever outro existente. Salve o conteúdo abaixo em UTF-8, codificação que preserva os caracteres do exemplo. A primeira linha é o cabeçalho; o primeiro nome em coreano significa “caderno grande”, contém uma vírgula e precisa de aspas.
product_id,product_name,price
1,"노트, 대형",3500.00
2,"머그컵",8000.00
3,"볼펜",1500.00
Conecte como course_user ao servidor de estudos, selecione shopcourse e confira SELECT VERSION(), DATABASE();. Verifique se csv45_stage e csv45_products não existem. Se existirem, examine os dados e as definições antes de decidir se são descartáveis. Não substitua tabelas de uma aplicação.
A tabela intermediária, também chamada de staging, conserva o texto original para revisão antes da conversão numérica. Prepare as duas tabelas:
USE shopcourse;
CREATE TABLE csv45_stage(raw_id TEXT,raw_name TEXT,raw_price TEXT)
ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE csv45_products(product_id INT PRIMARY KEY,
product_name VARCHAR(100) NOT NULL,price DECIMAL(10,2) NOT NULL CHECK(price>=0))
ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
Carregar o arquivo do cliente e conferir avisos
No terminal do sistema operacional, abra o cliente com LOCAL permitido para esse servidor de estudos confiável. Ajuste a porta se não usar 3306 e informe a senha quando solicitada:
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --local-infile=1 --default-character-set=utf8mb4 shopcourse
Dentro do cliente SQL, execute o bloco seguinte. SHOW WARNINGS consulta os avisos imediatamente após a carga, antes que outra instrução substitua essas informações.
LOAD DATA LOCAL INFILE 'C:/mariadb-lab/products.csv'
INTO TABLE csv45_stage CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n' IGNORE 1 LINES
(@id,@name,@price)
SET raw_id=@id,raw_name=@name,raw_price=TRIM(TRAILING '\r' FROM @price);
SHOW WARNINGS;
SELECT * FROM csv45_stage;
SELECT * FROM csv45_stage
WHERE raw_id IS NULL OR raw_id NOT REGEXP '^[0-9]+$'
OR raw_price IS NULL OR raw_price NOT REGEXP '^[0-9]+([.][0-9]{1,2})?$'
OR raw_name IS NULL OR raw_name='';
SELECT CAST(raw_id AS UNSIGNED) AS normalized_id,COUNT(*)
FROM csv45_stage GROUP BY CAST(raw_id AS UNSIGNED) HAVING COUNT(*)>1;
-- After format checks pass, verify numeric ranges and name length
SELECT * FROM csv45_stage
WHERE CAST(raw_id AS DECIMAL(65,0))<1
OR CAST(raw_id AS DECIMAL(65,0))>2147483647
OR CAST(raw_price AS DECIMAL(65,2))>99999999.99
OR CHAR_LENGTH(raw_name)>100;
A tabela deve conter três linhas e as três consultas de validação devem retornar conjuntos vazios. Se a política local_infile do servidor impedir a carga, revise-a com a administração. O modo estrito não garante que uma importação LOCAL rejeite toda entrada incorreta; confira os avisos e os textos originais.
O exemplo separa linhas por LF, caractere de avanço de linha, e remove um CR final, retorno de carro, do campo de preço. Assim, contempla também o caso simples habitual de arquivos CRLF do Windows. Quebras de linha dentro de campos e convenções de escape mais complexas exigem um acordo com a ferramenta que gera o arquivo. Execute primeiro a validação de formato; depois interprete a normalização numérica, as duplicidades e os limites.
Se o cliente estiver no Ubuntu, crie um diretório de trabalho no terminal e salve nele o CSV em UTF-8:
mkdir -p "$HOME/mariadb-lab"
printf '%s\n' "$HOME/mariadb-lab/products.csv"
Substitua o caminho de LOCAL pelo caminho absoluto real impresso pelo comando anterior. O bloco abaixo pressupõe, apenas como exemplo, que o usuário do Ubuntu se chame learner.
LOAD DATA LOCAL INFILE '/home/learner/mariadb-lab/products.csv'
INTO TABLE csv45_stage CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n' IGNORE 1 LINES
(@id,@name,@price)
SET raw_id=@id,raw_name=@name,raw_price=TRIM(TRAILING '\r' FROM @price);
SHOW WARNINGS;
Execute somente a carga de Windows ou de Ubuntu que corresponda ao cliente. Executar ambas acrescenta linhas repetidas à tabela intermediária. O caminho de exportação de um servidor Ubuntu é verificado separadamente adiante.
A referência oficial de LOAD DATA INFILE descreve LOCAL, as permissões e a interpretação do arquivo.
Transferir somente valores validados para as colunas tipadas
Exija resultados vazios nas verificações de formato, duplicidades normalizadas e limites. Os IDs precisam ser positivos e caber em INT com sinal, os preços em DECIMAL(10,2) e os nomes em até 100 caracteres. Os textos 01 e 1 viram o mesmo ID; verifique a unicidade depois de normalizar, não apenas comparando textos.
Se uma verificação falhar, corrija o arquivo ou defina uma política explícita antes de executar INSERT. Não faça a conversão apenas porque as tabelas já foram criadas.
INSERT INTO csv45_products(product_id,product_name,price)
SELECT CAST(raw_id AS UNSIGNED),raw_name,CAST(raw_price AS DECIMAL(10,2))
FROM csv45_stage;
SELECT product_id,product_name,price FROM csv45_products ORDER BY product_id;
Devem aparecer três produtos. O primeiro nome precisa conservar a vírgula, e os outros nomes significam caneca e caneta. Repita a consulta e compare cada campo com o CSV. Recarregar o mesmo arquivo pode acrescentar linhas à tabela intermediária; preserve o arquivo original e o diagnóstico antes de limpar uma tentativa com erro.
Exportar um CSV no servidor com uma conta autorizada
Use uma conta administrativa ou de exportação autorizada que tenha FILE. Confira secure_file_priv, a permissão de gravação do processo do servidor e um nome de arquivo novo. Em um servidor remoto, o caminho C: pertence ao servidor, não ao computador cliente.
SELECT @@secure_file_priv;
SELECT product_id,product_name,price FROM csv45_products ORDER BY product_id
INTO OUTFILE 'C:/mariadb-lab/products-export.csv'
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n';
O arquivo contém três registros CSV sem cabeçalho. Um arquivo existente não é sobrescrito. Se precisar de cabeçalho, acrescente-o por um procedimento de exportação explícito; mudar a extensão da saída tabulada de mariadb --batch para .csv não a transforma em CSV.
Em um servidor Ubuntu, consulte também secure_file_priv e as permissões de gravação da conta do serviço. Se o diretório aprovado for /var/lib/mysql-files/, pode usar um arquivo novo como o seguinte. Esse caminho não é o diretório pessoal do cliente.
SELECT product_id,product_name,price FROM csv45_products ORDER BY product_id
INTO OUTFILE '/var/lib/mysql-files/products-export-new.csv'
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n';
Substitua o diretório pelo realmente aprovado e execute uma única exportação nesse servidor. Não apague arquivos existentes nem amplie FILE apenas para evitar uma recusa. A referência oficial de SELECT INTO OUTFILE explica os requisitos e o formato de saída.
Conferir cada campo após exportar e limpar a prática
Compare vírgulas, caracteres Unicode, textos vazios, NULL e quebras de linha, além da quantidade de registros. As ferramentas CSV nem sempre compartilham uma convenção para NULL; defina se um campo vazio representa texto vazio ou um dado ausente. Este conjunto usa deliberadamente três campos preenchidos em cada linha.
Decida separadamente se precisa conservar os arquivos de origem e de exportação. Remova as tabelas abaixo somente se forem objetos descartáveis deste exercício. DROP TABLE apaga estruturas e dados e não pode ser desfeito com um ROLLBACK comum; remover as tabelas não remove os arquivos CSV.
DROP TABLE shopcourse.csv45_products;
DROP TABLE shopcourse.csv45_stage;




