Teks/CSV

Ringkasan

Barang Deskripsi
Kondisi rilis Ketersediaan umum
Produk Excel
Power BI (Model Semantik)
Power BI (Dataflow)
Fabric (Dataflow Gen2)
Power Apps (Aliran Data)
Dynamics 365 Customer Insights
Analysis Services
Dokumentasi Referensi Fungsi File.Contents
Lines.FromBinary
Csv.Document

Nota

Beberapa kemampuan mungkin ada dalam satu produk tetapi tidak yang lain karena jadwal penyebaran dan kemampuan khusus host.

Kemampuan yang didukung

  • Mengimpor

Menyambungkan ke file teks/CSV lokal dari Power Query Desktop

Untuk memuat teks lokal atau file CSV:

  1. Pilih opsi Teks/CSV di Dapatkan Data. Tindakan ini meluncurkan browser file lokal tempat Anda dapat memilih file teks Anda.

    Cuplikan layar browser file terbuka saat Anda memilih berkas teks Anda.

    Pilih Buka untuk membuka file.

  2. Dari Navigator, Anda dapat mengubah data di editor Power Query dengan memilih Transformasi Data, atau memuat data dengan memilih Muat.

    Cuplikan layar teks sampel di Navigator.

Menyambungkan ke file teks/CSV dari Power Query Online

Untuk memuat teks lokal atau file CSV:

  1. Dari halaman Sumber data , pilih Teks/CSV.

  2. Di Pengaturan koneksi, unggah file atau masukkan jalur file ke teks lokal atau file CSV yang Anda inginkan.

    Cuplikan layar pemilihan file teks online.

  3. Pilih Gerbang Data di Lokasi dari Gerbang Data.

  4. Masukkan nama pengguna dan kata sandi.

  5. Pilih Selanjutnya.

  6. Dari Navigator, pilih Transformasi Data untuk mulai mengubah data di editor Power Query.

    Cuplikan layar jendela navigator online tempat Anda memilih Ubah data.

Memuat dari web

Untuk memuat teks atau file CSV dari web, pilih konektor Web, masukkan alamat web file, dan ikuti perintah kredensial apa pun.

Pembatas Teks/CSV

Power Query memperlakukan CSV sebagai file terstruktur dengan koma sebagai pemisah - kasus khusus file teks. Jika Anda memilih file teks, Power Query secara otomatis mencoba menentukan apakah file tersebut memiliki nilai yang dipisahkan pemisah, dan apa itu pemisah. Jika sistem dapat menyimpulkan pemisah, maka secara otomatis memperlakukannya sebagai sumber data terstruktur.

Teks tidak terstruktur

Jika file teks Anda tidak memiliki struktur, Anda mendapatkan satu kolom dengan baris baru untuk setiap baris yang dikodekan dalam teks sumber. Sebagai sampel untuk teks yang tidak terstruktur, pertimbangkan file Notepad dengan konten berikut:

Hello world.
This is sample data.

Saat memuatnya, Anda disajikan layar navigasi yang menampilkan masing-masing baris ini dalam baris tersendiri.

Cuplikan layar navigator dengan data yang dimuat dari file teks sederhana yang tidak terstruktur.

Anda hanya dapat mengonfigurasi satu opsi pada dialog ini, yang merupakan pilihan dropdown Asal File . Dropdown ini memungkinkan Anda memilih set karakter mana yang digunakan untuk menghasilkan file. Saat ini, kumpulan karakter tidak dideteksi secara otomatis, dan UTF-8 hanya dideteksi secara otomatis jika diawali dengan UTF-8 BOM.

Cuplikan layar pemilihan budaya file untuk Teks/CSV.

CSV

Anda dapat menemukan sampel file CSV di sini.

Selain asal file, CSV juga mendukung penentuan pembatas dan bagaimana deteksi jenis data ditangani.

Cuplikan layar navigator memperlihatkan data yang dimuat dari file csv.

Pemisah mencakup titik dua, koma, tanda sama dengan, titik koma, spasi, tab, pemisah kustom (yang dapat berupa string apa pun), dan lebar tetap (membagi teks berdasarkan jumlah karakter tertentu yang tetap).

Cuplikan layar pilihan pemisah untuk file csv.

Dropdown akhir memungkinkan Anda memilih bagaimana Anda ingin menangani deteksi jenis data. Anda dapat mendasarkannya pada 200 baris pertama atau pada seluruh himpunan data. Anda juga dapat memilih untuk menonaktifkan deteksi jenis data otomatis dan sebaliknya membiarkan semua kolom default ke 'Teks.' Peringatan: jika Anda memilih seluruh himpunan data, hal ini dapat menyebabkan beban awal data di editor menjadi lebih lambat.

Cuplikan layar pilihan inferensi jenis data untuk file csv.

Karena inferensi bisa salah, periksa kembali pengaturan sebelum memuat.

teks terstruktur

Saat Power Query mendeteksi struktur dalam file teks Anda, ia memperlakukan file teks sebagai file nilai yang dipisahkan pemisah. Ini memberi Anda opsi yang sama yang tersedia saat membuka CSV. CSV pada dasarnya adalah file dengan ekstensi yang menunjukkan jenis pembatas.

Misalnya, jika Anda menyimpan contoh berikut sebagai file teks, Power Query membacanya sebagai memiliki pembatas tab daripada teks yang tidak terstruktur.

Column 1	Column 2	Column 3
This is a string.	1	ABC123
This is also a string.	2	DEF456

Cuplikan layar memperlihatkan data yang dimuat dari file teks terstruktur.

Anda dapat menggunakan struktur ini untuk semua jenis file berbasis pemisah lainnya.

Mengedit sumber

Saat Anda mengedit langkah sumber (di panel Langkah yang diterapkan di Power Query Desktop), Anda akan melihat dialog yang sedikit berbeda dari saat Anda awalnya memuat file. Bergantung pada bagaimana Anda saat ini memperlakukan file (sebagai teks atau CSV), Anda akan melihat layar dengan berbagai dropdown.

Cuplikan layar dialog tempat Anda mengedit langkah sumber pada kueri yang mengakses file CSV.

Gunakan menu dropdown Pemisah baris untuk memilih apakah Anda ingin menerapkan hentian baris yang berada di dalam tanda kutip atau tidak.

Cuplikan layar dropdown tempat Anda memilih gaya pemisah baris untuk file CSV.

Misalnya, jika Anda mengedit sampel 'terstruktur' yang sebelumnya disediakan, Anda dapat menambahkan hentian baris.

Column 1	Column 2	Column 3
This is a string.	1	"ABC
123"
This is also a string.	2	"DEF456"

Jika Anda mengatur Jeda baris ke Abaikan jeda baris dalam tanda kutip, contoh dimuat dengan bagian kedua string berada di bawah bagian pertama, pada kolom yang sama.

Pemuatan file CSV dengan hentian baris yang dikutip diabaikan.

Jika Anda mengatur hentian Baris untuk Menerapkan semua hentian baris, sampel memuat baris tambahan, dengan konten setelah hentian baris menjadi satu-satunya konten di baris tersebut (output yang tepat mungkin bergantung pada struktur konten file).

Pemuatan file CSV dengan hentian baris yang dikutip diterapkan.

Gunakan menu tarik-turun Buka file sebagai untuk mengubah cara file akan dimuat. Pengaturan ini penting untuk pemecahan masalah. Untuk berkas terstruktur yang secara teknis bukan CSV (seperti berkas nilai yang dipisahkan tab yang disimpan sebagai berkas teks), biarkan Buka file sebagai tetap disetel ke CSV. Pengaturan ini juga menentukan dropdown mana yang tersedia di dialog lainnya.

Mengubah jenis file.

Teks/CSV menurut Contoh

Teks/CSV Menurut Contoh di Power Query adalah fitur yang tersedia secara umum di Power BI Desktop dan Power Query Online. Saat Anda menggunakan konektor Teks/CSV, Anda akan melihat opsi untuk Mengekstrak Tabel Menggunakan Contoh di sudut kiri bawah navigator.

Menggunakan opsi Ekstrak Tabel Menggunakan Contoh.

Saat Anda memilih tombol tersebut, Anda dibawa ke halaman Ekstrak Tabel Menggunakan Contoh . Pada halaman ini, Anda menentukan nilai output sampel untuk data yang ingin Anda ekstrak dari file Teks/CSV Anda. Setelah Anda memasukkan sel pertama kolom, sel lain di kolom diisi. Agar data diekstrak dengan benar, Anda mungkin perlu memasukkan lebih dari satu sel dalam kolom. Jika beberapa sel dalam kolom salah, Anda dapat memperbaiki sel pertama yang salah dan data diekstrak lagi. Untuk memastikan bahwa data berhasil diekstrak, periksa data di beberapa sel pertama.

Nota

Masukkan contoh dalam urutan kolom. Setelah kolom berhasil diisi, buat kolom baru dan mulai masukkan contoh di kolom baru.

Tentukan nilai output sampel untuk mengekstrak data.

Setelah selesai membuat tabel tersebut, Anda dapat memilih untuk memuat atau mengubah data. Perhatikan bagaimana kueri yang dihasilkan berisi perincian terperinci dari semua langkah yang disimpulkan untuk ekstraksi data. Langkah-langkah ini adalah langkah-langkah kueri reguler yang bisa Anda kustomisasi sesuai kebutuhan.

Perincian terperinci langkah-langkah untuk ekstraksi data.

Penyelesaian Masalah

Memuat file dari web

Jika Anda meminta file text/csv dari web dan juga menaikkan header menjadi judul, serta mengambil cukup banyak file sehingga perlu mengkhawatirkan potensi throttling, pertimbangkan untuk membungkus pemanggilan Web.Contents dengan Binary.Buffer(). Dalam hal ini, menyimpan file ke dalam buffer sebelum menerapkan header menyebabkan file tersebut hanya diminta satu kali.

Bekerja dengan file CSV besar

Jika Anda berurusan dengan file CSV besar di editor Power Query Online, Anda mungkin menerima Kesalahan Internal. Bekerja dengan file CSV berukuran lebih kecil terlebih dahulu, terapkan langkah-langkah di editor, dan setelah selesai, ubah jalur ke file CSV yang lebih besar. Metode ini memungkinkan Anda bekerja lebih efisien dan mengurangi kemungkinan Anda mengalami batas waktu di editor online. Anda tidak berharap mengalami kesalahan ini selama waktu refresh, karena layanan memungkinkan durasi batas waktu yang lebih lama.

Teks yang tidak terstruktur ditafsirkan sebagai terstruktur

Dalam kasus yang jarang terjadi, Power Query menginterpretasikan dokumen sebagai CSV ketika angka koma serupa muncul di seluruh paragraf. Jika masalah ini terjadi, edit langkah Sumber di editor Power Query, dan pilih Teks alih-alih CSV di pilih dropdown Buka File Sebagai.

Kolom di Power BI Desktop

Saat Anda mengimpor file CSV, Power BI Desktop menghasilkan langkah columns=x di editor Power Query, di mana x adalah jumlah kolom dalam file CSV selama impor awal. Jika nanti Anda menambahkan lebih banyak kolom dan mengatur sumber data untuk di-refresh, operasi refresh tidak menyertakan kolom apa pun di luar jumlah kolom x awal.

Kesalahan: Koneksi ditutup oleh host

Saat memuat file Teks/CSV dari sumber web dan mempromosikan header, Anda mungkin terkadang mengalami kesalahan berikut: "An existing connection was forcibly closed by the remote host" atau "Received an unexpected EOF or 0 bytes from the transport stream." Host dapat menyebabkan kesalahan ini dengan menggunakan tindakan perlindungan dan menutup koneksi yang mungkin dijeda sementara, seperti saat menunggu koneksi sumber data lain untuk operasi gabungan atau penambah. Untuk mengatasi kesalahan ini, coba tambahkan panggilan Binary.Buffer (disarankan) atau Table.Buffer . Fungsi-fungsi ini mengunduh file, memuatnya ke dalam memori, dan segera menutup koneksi. Tindakan ini mencegah jeda selama pengunduhan dan mencegah host menutup koneksi secara paksa sebelum konten diambil.

Contoh berikut mengilustrasikan solusi ini. Buffering ini perlu dilakukan sebelum tabel yang dihasilkan diteruskan ke Table.PromoteHeaders.

  • Orisinal:
Csv.Document(Web.Contents("https://.../MyFile.csv"))
  • Dengan Binary.Buffer:
Csv.Document(Binary.Buffer(Web.Contents("https://.../MyFile.csv")))
  • Dengan Table.Buffer:
Table.Buffer(Csv.Document(Web.Contents("https://.../MyFile.csv")))
  • Last updated on