Incidentu reaģēšana

MySQL kļūda 1290: "running with the --secure-file-priv option" un kā to novērst

INTO OUTFILE un LOAD DATA neizdodas, jo serveris lasa un raksta failus tikai vienā direktorijā vai vispār nevienā. Iestatījumu mainīt vajag reti: lietojiet atļauto direktoriju vai pārceliet darbu ar failiem uz klienta pusi. Un ja ziņojumā ir --read-only, jūs rakstāt replikā.

· 14 min lasīšanai · AG Data komanda

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:

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):

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 ','"

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:

Galvenās atziņas

MySQL Kļūdas Imports/eksports Drošība
Sadarbība ar mums

Pārvietojat lielus datu apjomus MySQL un no tā?

Mēs plānojam eksportus, importus un migrācijas, kas nepiepilda servera diskus un neatver drošības caurumus, un labojam lietotnes, kas raksta tikai lasāmās replikās.

Sazināties Vairāk no emuāra