to_file fonksiyon

Şunun için geçerlidir:evet olarak işaretlendi Databricks SQL denetimi evet olarak işaretlendi Databricks Runtime 18 LTS ve üzeri

Important

Bu özellik Beta sürümündedir. Çalışma alanı yöneticileri Bu özelliğe erişimi Önizlemeler sayfasından denetleyebilir. Bkz. Azure Databricks önizlemelerini yönetme.

Dosyaya FILE referans veren bir değeri döndürür path.

Syntax

to_file(path)

Arguments

  • path: Bir dosyaya giden yolu belirten bir STRING ifade. Örneğin, bir Unity Kataloğu ciltindeki bir yol.

İadeler

Dosyaya FILE referans veren bir değer.path

Dosya meta verilerini toplamak için Azure Databricks, dosyanın depolama konumuna uzaktan çağrı yapar. Dosya mevcut değilse veya erişilemezse, Azure Databricks bir hata oluşturur. Bunun yerine return NULL için fonksiyon kullanıntry_to_file.

Yaygın hata koşulları

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

Daha fazla bilgi için bkz. Azure Databricks'te Hata koşulları.

Examples

Bir ciltteki bir yoldan referans FILE oluşturmak için:

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

Yol yoksa veya kullanıcı okuma izni to_file yoksa hata çıkar:

SELECT to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');
Error: TO_FILE_ERROR.FILE_NOT_EXISTS