MySQL kļūda 1290 ar "--secure-file-priv" nozīmē, ka serveris atteicās lasīt vai rakstīt failu iestatījuma secure_file_priv dēļ. Tā skar SELECT ... INTO OUTFILE, servera puses LOAD DATA INFILE un LOAD_FILE(). Vairumā gadījumu risinājums ir lietot direktoriju, ko serveris atļauj, vai strādāt ar failiem klienta pusē, nevis izslēgt aizsardzību.
mysql> SELECT * FROM orders INTO OUTFILE '/tmp/orders.csv';
ERROR 1290 (HY000): The MySQL server is running with the --secure-file-priv option so it cannot execute this statement
Kļūda 1290 (ER_OPTION_PREVENTS_STATEMENT, SQLSTATE HY000) ir vispārīga: "The MySQL server is running with the %s option so it cannot execute this statement" (servera kļūdu saraksts). Opcijas nosaukums ziņojumā pasaka, kura problēma jums ir. Šajā rakstā apskatītas divas biežākās: --secure-file-priv un --read-only / --super-read-only.
Ko dara secure_file_priv
Mainīgais ierobežo datu importa un eksporta operācijas, piemēram, LOAD DATA, SELECT ... INTO OUTFILE un LOAD_FILE(), kas atļautas tikai lietotājiem ar privilēģiju FILE (servera sistēmas mainīgie). Tam ir trīs veidu vērtības:
- Tukšs: nekādu ierobežojumu. Dokumentācija to sauc par nedrošu iestatījumu.
- Direktorija: imports un eksports strādā tikai ar failiem šajā direktorijā. Direktorijai jāeksistē; serveris to neizveido.
- NULL: imports un eksports ir pilnībā atspējoti.
Tas nav dinamisks: to var iestatīt tikai servera startēšanas brīdī. Noklusējums atkarīgs no tā, kā MySQL ir būvēts: /var/lib/mysql-files DEB un RPM pakotnēm, tukšs STANDALONE izkārtojumam un citos gadījumos mysql-files zem instalācijas prefiksa. Ja iestatāt neeksistējošu ceļu, serveris ieraksta kļūdu žurnālā un beidz darbu; ja vērtība ir nedroša (tukša, datu direktorijā vai pieejama visiem), startējot tas ieraksta brīdinājumu.
1. solis: noskaidrojiet, kas atļauts
SHOW VARIABLES LIKE 'secure_file_priv';
-- +------------------+-----------------------+
-- | Variable_name | Value |
-- +------------------+-----------------------+
-- | secure_file_priv | /var/lib/mysql-files/ |
-- +------------------+-----------------------+
Direktorija nozīmē, ka rakstīt un lasīt drīkst tikai tur. NULL nozīmē, ka failu imports un eksports caur serveri ir izslēgts; ejiet uzreiz pie klienta puses iespējām zemāk. Tukša vērtība nozīmē, ka problēma nav šajā iestatījumā, un jāskatās failu atļaujas.
2. solis: lietojiet atļauto direktoriju
SELECT id, customer_id, total
FROM orders
WHERE created_at >= '2026-11-01'
INTO OUTFILE '/var/lib/mysql-files/orders_2026_11.csv'
FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n';
Detaļas, uz kurām cilvēki paklūp (SELECT ... INTO):
- Fails tiek izveidots uz servera hosta, nevis jūsu klēpjdatorā. Ar pārvaldītu vai attālu serveri jūs to savā datorā neredzēsiet.
- Mērķis nedrīkst būt esošs fails; MySQL to nepārrakstīs. Lietojiet jaunu nosaukumu vai vispirms izdzēsiet veco failu.
- Fails pieder operētājsistēmas lietotājam, ar kuru darbojas
mysqld, un tiek izveidots ar umask 0640. Lai to izlasītu, var vajadzētsudovai dalību grupā. - Vajag privilēģiju
FILE.
Tie paši noteikumi darbojas otrā virzienā: servera puses LOAD DATA INFILE prasa FILE un failu secure_file_priv direktorijā (LOAD DATA), un LOAD_FILE() klusi atgriež NULL, ja fails ir ārpus šīs direktorijas, nav lasāms vai ir lielāks par max_allowed_packet (virkņu funkcijas). Mūsu pieredzē NULL gadījums aizņem vairāk laika nekā kļūda, jo nekas nepasaka, kāpēc.
mysqldump --tab lieto to pašu mehānismu: .txt datu failus raksta serveris, tāpēc direktorijai jābūt rakstāmai serverim, kontam vajag FILE, un dokumentācija iesaka to lietot tikai uz tās pašas mašīnas, kur darbojas serveris (mysqldump). Ja --tab krīt ar 1290, norādiet secure_file_priv direktoriju. Par rezerves kopiju rīka izvēli skatiet mysqldump vai XtraBackup.
3. solis: vai strādājiet ar failiem klienta pusē
Bieži fails serverī nemaz nav vajadzīgs. Divas klienta puses iespējas pilnībā apiet secure_file_priv:
# export on the machine where you run the client
mysql -h db1 -u report -p --batch -e "SELECT id, customer_id, total FROM shop.orders" > orders.tsv
# import from the client machine: needs local_infile=ON on the server
mysql --local-infile=1 -h db1 -u loader -p shop \
-e "LOAD DATA LOCAL INFILE 'orders.csv' INTO TABLE orders FIELDS TERMINATED BY ','"
- Eksports: dokumentācija pati iesaka
mysql -e "SELECT ..." > file_name, lai izveidotu failu klienta hostā.--batchdod ar tabulēšanas zīmēm atdalītu izvadi. - Imports: ar
LOAD DATA LOCALklients nolasa failu un nosūta to pa savienojumu. PrivilēģijaFILEnav vajadzīga, un fails var būt jebkurā direktorijā, ko klients var lasīt. BetLOCALdarbojas tikai tad, ja to atļauj gan serveris, gan klients, un servera mainīgālocal_infilenoklusējums irOFF(local_infile).
LOCAL maina kļūdu apstrādi. Bez REPLACE LOAD DATA LOCAL uzvedas kā IGNORE: datu interpretācijas kļūdas kļūst par brīdinājumiem un ielāde turpinās pat stingrā SQL režīmā, jo serveris nevar apturēt faila pārsūtīšanu pusceļā (LOAD DATA). Pēc katras ielādes pārbaudiet SHOW WARNINGS un salīdziniet rindu skaitu.
4. solis: ja tiešām jāmaina
Dažreiz ETL darbam pamatoti vajag citu apmaiņas direktoriju. Iestatiet to opciju failā un restartējiet:
# /etc/mysql/mysql.conf.d/mysqld.cnf (path varies by distribution)
[mysqld]
secure_file_priv = /srv/mysql-exchange
# the directory must exist and be accessible to the mysqld user
# install -d -o mysql -g mysql -m 750 /srv/mysql-exchange
Neiestatiet tukšu virkni tikai tāpēc, lai kļūda pazustu. Kopā ar privilēģiju FILE tukša vērtība ļauj datubāzes kontam lasīt jebkuru failu, ko var lasīt mysqld lietotājs, un rakstīt jaunus failus visur, kur šis lietotājs var rakstīt. Izvēlieties atsevišķu direktoriju ārpus datu direktorijas, kas nav lasāma visiem, un piešķiriet FILE tikai kontiem, kam tas vajadzīgs. Distribūcijās ar AppArmor vai SELinux mūsu pieredzē arī drošības profilam var vajadzēt atļaut jauno ceļu, citādi pat pēc restarta būs atļauju kļūdas.
Otrā 1290: --read-only un --super-read-only
SELECT @@global.read_only, @@global.super_read_only;
Ja ziņojumā minēts --read-only vai --super-read-only, serveris atsaka rakstīšanu. Ar read_only atjaunināt joprojām var tikai lietotāji ar CONNECTION_ADMIN (vai novecojušo SUPER); super_read_only bloķē arī viņus. Replikācijas pavedieni, operācijas ar TEMPORARY tabulām un dažas uzturēšanas komandas joprojām darbojas, un read_only netiek replicēts, tāpēc katram serverim ir sava vērtība (servera sistēmas mainīgie).
Praksē tas gandrīz vienmēr nozīmē, ka lietotne ir pieslēgta replikai vai notika pārslēgšanās (failover), bet savienojuma virkne vai starpniekserveris joprojām norāda uz veco primāro serveri. Nelabojiet to, izslēdzot read_only replikā: rakstīšana tur atdala jūsu datus no primārā servera. Labojiet maršrutēšanu. Group Replication un InnoDB Cluster sekundārie serveri pēc konstrukcijas darbojas ar super_read_only=ON (single-primary režīms); skatiet MySQL Group Replication un InnoDB Cluster.
Kas mainās ar lieliem eksportiem un importiem
Ar 10 MB testa tabulu INTO OUTFILE uz /var/lib/mysql-files ir acumirklīgs. Ar produkcijas datiem:
- Diska vieta serverī.
/var/lib/mysql-filesparasti atrodas tajā pašā failu sistēmā, kur datu direktorija. Pilns lielas tabulas eksports var piepildīt disku, kas datubāzei vajadzīgs, lai turpinātu darbu. Mūsu pieredzē tas ir viens no biežākajiem pašu izraisītajiem pārtraukumiem migrāciju laikā. Norādietsecure_file_privuz atsevišķu sējumu vai eksportējiet no klienta puses. - Garas transakcijas. Vairākas stundas ilgs
SELECT ... INTO OUTFILEuz InnoDB darbojas kā viena gara lasīšana, kas aiztur purge; vēstures saraksts aug, kamēr tā darbojas. Eksportējiet pa atslēgu diapazoniem, nevis ar vienu milzīgu vaicājumu. - Paralēls imports. Lieliem failiem MySQL Shell
util.importTablesadala failu daļās (pēc noklusējuma 50M) un pēc noklusējuma ielādē tās līdz 8 pavedienos. Tas lietoLOAD DATA LOCAL INFILE, tāpēc mērķa serverīlocal_infilejābūtON(MySQL Shell paralēlais tabulu imports). Kad imports pabeigts, izslēdziet to atpakaļ. - Replikācija. Milzīgas ielādes rada milzīgas transakcijas binārajā žurnālā, un replikas tās piemēro kā vienu vienību, tāpēc mūsu pieredzē nobīde strauji pieaug. Ielādējiet paketēs, kuru atkārtošanu varat atļauties.
- Klusa datu zaudēšana ar LOCAL. Tā kā
LOCALpārvērš kļūdas brīdinājumos, desmit miljonu rindu imports var klusi izlaist vai saīsināt tūkstošiem rindu. Pārbaudiet rindu skaitu un kontrolsummas, ne tikai izejas kodu.
Galvenās atziņas
- Kļūda 1290 ir vispārīga; cēloni pasaka ziņojumā minētā opcija.
- Pārbaudiet
secure_file_priv: direktorija nozīmē lietot to,NULLnozīmē, ka servera puses failu operācijas ir izslēgtas. INTO OUTFILEraksta uz servera hosta, nekad nepārraksta un prasaFILE.- Failiem jūsu datorā lietojiet
mysql -e ... > fileunLOAD DATA LOCALar ieslēgtulocal_infile. - Nekad neiestatiet tukšu
secure_file_privprodukcijā; lietojiet atsevišķu direktoriju savā sējumā. - "--read-only" nozīmē, ka rakstāt replikā vai pazeminātā primārajā serverī: labojiet maršrutēšanu, nevis karogu.