Fungsi FILE mulai cepat

Important

Fitur ini ada di Beta. Admin ruang kerja dapat mengontrol akses ke fitur ini dari halaman Pratinjau . Lihat Kelola Pratinjau Azure Databricks.

Tipe ini FILE mewakili file tidak terstruktur seperti dokumen, gambar, dan audio. Fungsi SQL bawaan membuat, menyalin, dan membaca file sebagai FILE referensi.

Halaman ini merangkum fungsi-fungsi tersebut dengan contoh referensi untuk operasi umum, seperti:

  • Mencantumkan file dalam volume Unity Catalog sebagai FILE referensi dengan list_files.
  • Membaca metadata file, seperti size dan checksum (digunakan untuk mengidentifikasi versi file).
  • Memfilter file berdasarkan metadatanya.
  • Mengurai isi dokumen dengan ai_parse_document.

Untuk referensi tipe, lihat FILE tipe.

Untuk gambaran konseptual, lihat FILE type dan data tidak terstruktur.

Persyaratan

  • Contoh-contoh ini menggunakan samples.sec.contracts dataset, kumpulan PDF kontrak yang diajukan SEC yang tersedia secara default di semua workspace. Untuk menggunakan file Anda sendiri, arahkan path ke volume Unity Catalog yang berisinya.

Examples

File daftar dan referensi tangkapan

Untuk mencantumkan file pada jalur dan menyimpan FILE referensi dalam tabel, gunakan list_files fungsi bernilai tabel:

CREATE TABLE documents AS
  SELECT path, size, modification_time, file
  FROM list_files('/Volumes/samples/sec/contracts/');

Metadata file baca

Untuk membaca urifield , size, content_type, dan checksum dari suatu FILE nilai, gunakan notasi titik:

SELECT file.uri, file.size, file.content_type, file.checksum
  FROM documents;

Filter file berdasarkan metadata

Untuk memfilter baris menggunakan metadata file, seperti path dan ukuran:

SELECT file.uri
  FROM documents
  WHERE file.uri ILIKE '%.pdf'
    AND file.size > 100000;

Mengurai isi dokumen

Untuk mengekstrak konten terstruktur dari dokumen, berikan nilai FILE ke ai_parse_document fungsi:

SELECT file.uri, ai_parse_document(file) AS parsed
  FROM documents
  WHERE file.uri ILIKE '%.pdf';

Contoh buku catatan

Notebook berikut menjalankan semua contoh sebelumnya terhadap samples.sec.contracts dataset:

Buku catatan quickstart fungsi FILE

Dapatkan buku catatan

Langkah berikutnya