CSV dosyası içe aktarma
7 dk okuma
CSV içe aktarma, yüklediğiniz bir dosyayı okur ve satırlarını bir veri tablosuna yazar. Arka planda küçük partiler halinde çalışır; bu yüzden çok büyük bir dosya bile zaman aşımına uğramaz ya da sitenizi engellemez.
Tabloyu açın, Import & feed sekmesine gidin ve CSV import kartını kullanın: "Upload a CSV file whose first row holds the column names. Large files are imported in the background."

Başlamadan önce
- Tablonun sütunları olmalıdır. Sütun yoksa sekmede Add columns first yazar.
- Dosyanın ilk satırı sütun adlarını içermelidir. Adlar yalnızca eşleşme önermek için kullanılır; tablonun anahtarlarına eşit olmaları gerekmez.
- Dosya bir
.csvveya.txtdosyası olmalı ve varsayılan olarak en fazla 50 MB olmalıdır (wpmcf/data_tables/import_max_bytes). Sunucunuzun kendi yükleme sınırı (PHP'deupload_max_filesizevepost_max_size) da geçerlidir. Daha büyük dosyalar için ikisini de yükseltin veya dosyayı bölün. - Mevcut satırları güncellemek için benzersiz bir sütun gerekir. Bkz. Create a data table.
- Bir tabloya aynı anda yalnızca bir içe aktarma çalışabilir.
Adım adım
- Import CSV düğmesine tıklayın. Import into "Table name" iletişim kutusu açılır.
- Choose CSV file düğmesine tıklayıp dosyayı seçin. Düğmenin üstündeki metinde şu yazar: "Choose a CSV file. The first row must contain column names; comma, semicolon and tab separators are detected automatically." Dikey çizgi
|ayracı da algılanır. - İletişim kutusu şimdi üç blok gösterir. Henüz hiçbir şey yazılmadı.
Sütunları eşleştirin. Her tablo sütunu için bir satır ve CSV column for {label} seçicisi bulunur. Dosyanın başlık adları seçicileri doldurur: bir sütunun anahtarı veya etiketi bir başlığa eşitse (büyük harfler, boşluklar, tireler ve diğer noktalama yok sayılır) eşleşir (Unit Priceileunit_priceeşleşir). Dosyanın doldurmadığı bir sütun için - Skip - seçin. Boş bir başlık Column 3 (konumu) olarak gösterilir. 12'den fazla CSV sütunu olduğunda seçicide Filter columns... kutusu bulunur.
Dosyanın ilk satırları. İlk beş satır; böylece sütunların ve metnin (aksanlar, tırnaklar) doğru okunduğunu denetleyebilirsiniz.
Mevcut satırlar. Tabloda zaten bulunan satırlarla ne yapılacağı (aşağıya bakın). - Import ~N rows düğmesine tıklayın. Sayı, dosya boyutundan yapılan bir tahmindir. Düğme, en az bir sütun eşleşene kadar (güncelleme için ayrıca bir eşleştirme sütunu seçilene kadar) devre dışı kalır.
- Bir ilerleme çubuğu Import progress ve
Importing... N rows processed. You can close this window; the import continues in the background.iletisini gösterir. İstediğiniz zaman Close düğmesine tıklayın ya da ileti Done ile bitene kadar izleyin.
Bittiğinde N rows imported, M failed. iletisini görürsünüz. Bazı satırlar başarısız olduysa Some rows could not be imported kutusu ilk beş veritabanı iletisini listeler; örneğin Duplicate entry 'I1' for key '...uq_sku'.

Mevcut satırlar
Existing rows seçenekleri, tabloda zaten bulunan satırlara ne olacağına karar verir:
Seçenek | Ne olur |
|---|---|
Onları koru ve yeni satırları ekle (varsayılan) | Dosyadaki her satır eklenir. Değeri benzersiz bir sütunla çakışan satır kendi başına başarısız olur; diğerleri eklenir. |
Aynı benzersiz değere sahip satırları güncelle, kalanları ekle | Dosyadaki her satır, Match rows by... alanında seçtiğiniz benzersiz sütunla mevcut bir satırla eşleştirilir. Eşleşen güncellenir, eşleşmeyen eklenir. Tabloda benzersiz sütun yoksa "Updating needs a column marked indexed + unique in its advanced settings." notuyla devre dışıdır. |
Onları yeni satırlarla değiştir (yeni verilerde olmayan satırlar silinir) | Tablo tam olarak dosyadaki satırlarla kalır. |
Update ve Replace ile Match rows by sütunu, eşleştirdiğiniz sütunlardan biri olmalıdır. Update modunda, eşleştirdiğiniz sütunlarda boş hücre saklanan değeri boşaltır. Eşleştirmediğiniz (atladığınız) sütunlara dokunulmaz.
Replace: iki yol
- Eşleştirme alanıyla değiştirme. Match rows by (recommended)... alanında benzersiz bir sütun seçin. Eşleşen satırlar güncellenir, yeni satırlar eklenir ve dosyada olmayan satırlar en sonda silinir. Satır kimlikleri korunur; bu yüzden bir satırı kimliğiyle hatırlayan her şey (URL'leriyle oluşturulan sayfalar, yapay zekâ içeriği ve elle yapılan düzenlemeler) de korunur. İletişim kutusu şunu söyler: "Rows are matched by this field: matching rows are updated, new rows added and rows missing from the new data deleted. Generated pages keep their URLs, AI content and hand edits."
- Eşleştirme alanı olmadan değiştirme (Do not match: replace all rows). Yeni satırlar önce tablonun bir çalışma kopyasına yüklenir. Çalışma kopyası yalnızca her satır hatasız okunduktan sonra tek adımda devreye alınır; o zamana kadar canlı tabloya dokunulmaz. Dosyada satır yoksa ya da herhangi bir satır başarısız olursa hiçbir şey değişmez ve ileti şunu söyler:
The new data has no rows, so the data table was left unchanged.veyaN rows could not be written, so the data table was left unchanged. Fix them and try again.Değişmeyen satırlar kimliğini korur; değişen bir satır kimliğini yalnızca sütunlarının en az yarısı değişmediyse korur, aksi halde yeni bir kimlik alır. İletişim kutusu uyarır: "Unchanged rows keep their identity, but a changed row may get a new one, so its generated page can lose its AI content and hand edits. Match rows by a unique field to avoid this."
Eşleştirme alanı ile yapılan bir değiştirme sırasında satırlar başarısız olursa, dosyada olmayan satırlar silinmez (başarısız olan satırlardan ayırt edilemezler): Rows missing from the file were kept because some rows failed; fix them and import again to remove the rest.
Değerler nasıl okunur
Dosyalar çoğu zaman düzensiz olduğundan içe aktarma, bir satırı elle yazmaktan daha hoşgörülüdür. Her hücre sütunun türünden geçer:
Sütun | Hücre | Saklanan |
|---|---|---|
Number |
|
|
Number |
| boş (hata yok) |
Select, Radio buttons | seçeneklerden biri olmayan bir değer | boş (hata yok) |
Date |
|
|
True / false |
| Evet |
True / false |
| Hayır |
Any | eşleştirilmiş bir sütunda boş hücre | boş |
Any |
|
|
Virgül, tırnak ("") ve satır sonu içeren tırnaklı hücreler doğru okunur.
Ayraçlar ve kodlamalar
- Ayraç: ilk satır karar verir: virgül, noktalı virgül, sekme veya dikey çizgi. Elle seçemezsiniz; bunları karıştıran bir dosyayı elektronik tablonuzdan standart bir CSV olarak yeniden kaydetmek en iyisidir.
- Kodlama dosyadan algılanır:
- UTF-8, bayt sırası işaretiyle veya işaretsiz (Excel'in olağan "CSV UTF-8" biçimi);
- UTF-16 little veya big endian, bayt sırası işaretiyle (Excel'in "Unicode Text" dışa aktarımı);
- geçerli UTF-8 olmayan her şey, site diline göre seçilen bir Windows kod sayfası olarak okunur: Windows-1254 (Türkçe), 1250 (Lehçe, Çekçe, Slovakça, Macarca, Romence, Hırvatça, Slovence ...), 1251 (Rusça, Ukraynaca, Bulgarca, Sırpça ...), 1253 (Yunanca), 1255 (İbranice), 1256 (Arapça, Farsça, Urduca), 1257 (Baltık), 1258 (Vietnamca), aksi halde 1252 (Batı Avrupa).
First rows of the file alanında aksanlar yanlış görünüyorsa (örneğin Ý, İ yerine), dosya site diliyle uyuşmayan bir kod sayfasındadır. Dosyayı elektronik tablonuzdan CSV UTF-8 olarak yeniden kaydedin veya varsayılan kod sayfasını wpmcf/import/fallback_encoding filtresiyle değiştirin (varsayılanı ve yerel ayarı alır, Windows-1254 gibi bir kod sayfası adı döndürür).
Sorun raporu
Bir içe aktarma bittiğinde, dosyada bulunan sorunları satır ve sütuna göre listeler; örneğin bir sütunun reddettiği bir değer ya da geçersiz bir e-posta adresi. Bu hücreleri dosyada düzeltin ve yeniden içe aktarın.
Büyük dosyalar ve arka plan
- Yüklenen dosya, rastgele bir adla
wp-content/uploads/wpmcf-imports/altında saklanır, doğrudan web erişimine karşı korunur ve sonuç ne olursa olsun içe aktarma biter bitmez silinir. Yüklediğiniz ama hiç içe aktarmadığınız bir dosya, iletişim kutusunu kapattığınızda ve her durumda bir gün sonra kaldırılır. - İçe aktarma bir görevdir. Satırlar 500'lük parçalar halinde yazılır; bir parti yaklaşık 20 saniye (veya PHP bellek sınırının %80'ine kadar) çalışır ve sonraki parti son partinin kaldığı yerden devam eder, bu yüzden yeniden başlatma tamamlanmış satırları asla tekrarlamaz. Partileri Action Scheduler çalıştırır. Kuyruğu neyin başlattığı ve takılmış göründüğünde ne yapılacağı için Background tasks sayfasına bakın.
- İletişim kutusunu kapatıp sayfadan ayrılabilirsiniz. Döndüğünüzde tabloda yeni satırlar olur. (Terk ettiğiniz bir içe aktarmanın ilerlemesi yeniden açılamaz; sonuç tablodur.)
- Bir içe aktarma sürerken aynı tabloya ikinci bir içe aktarma başlatmak reddedilir:
An import into this data table is still running. Wait until it is done, then start the next one.
İletiler
İleti | Anlamı |
|---|---|
| Yükleme başarısız oldu veya yarıda kesildi (çoğunlukla PHP'nin yükleme sınırı). |
| Uzantı |
| İçe aktarma boyut sınırı aşıldı. |
| İlk satır boş. |
| Hiçbir sütun eşleştirilmedi. |
| Update veya eşleştirme modunda, eşleştirme sütunu benzersiz değil ya da eşleştirilmemiş. |
| Bir günden fazla beklediniz veya iletişim kutusunu kapattınız. |
| İçe aktarma sürerken tablo silindi. |
| İçe aktarma sürerken lisansın süresi doldu. |
Geliştiriciler için
wpmcf/data_tables/import_max_bytesboyut sınırını değiştirir (varsayılan 50 MB).wpmcf/import/fallback_encodingvarsayılan kod sayfasını değiştirir.- Bir içe aktarma bittiğinde
wpmcf/data_tables/syncedtablo anahtarı ve bir özetle tetiklenir (['type' => 'import', 'mode' => ..., 'rows' => ..., 'failed' => ...]). Bkz. actions reference.
Hâlâ takıldınız mı? Destek ile iletişime geçin