fungsi to_file

Berlaku untuk:check ditandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 18 LTS ke atas

Important

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

Mengembalikan FILE nilai yang merujuk pada file di .path

Syntax

to_file(path)

Arguments

  • path: Sebuah STRING ekspresi yang menentukan jalur ke sebuah file. Misalnya, sebuah jalur dalam volume Unity Catalog.

Returns

Nilai yang FILE merujuk pada file di .path

Untuk mengumpulkan metadata file, Azure Databricks melakukan panggilan jarak jauh ke lokasi penyimpanan file. Jika file tidak ada atau tidak dapat diakses, Azure Databricks akan muncul kesalahan. Untuk mengembalikan NULL , gunakan try_to_file fungsi.

Kondisi kesalahan umum

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Untuk informasi lebih lanjut, lihat Kondisi kesalahan di Azure Databricks.

Examples

Untuk membuat FILE referensi dari jalur dalam volume:

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Jika jalur tidak ada atau pengguna tidak memiliki izin baca, to_file muncul kesalahan:

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on