fungsi try_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, atau NULL jika file tersebut tidak ada atau tidak dapat diakses.

Syntax

try_to_file(path)

Arguments

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

Returns

Nilai yang FILE merujuk pada file pada , pathatau NULL jika file tersebut tidak ada atau tidak dapat diakses.

Fungsi ini adalah versi to_file fungsi yang tahan kesalahan. Untuk mengumpulkan metadata file, Azure Databricks melakukan panggilan jarak jauh ke lokasi penyimpanan file. Jika file tidak ada atau tidak dapat diakses, fungsi ini akan kembali NULL alih-alih menimbulkan error.

Kondisi kesalahan umum

  • 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 try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Jika jalur tidak ada atau tidak dapat diakses, try_to_file mengembalikan NULL:

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

NULL
  • Last updated on