Функции FILE для быстрого запуска

Important

Эта функция доступна в бета-версии. Администраторы рабочей области могут управлять доступом к этой функции на странице "Предварительные версии ". См. статью "Управление предварительными версиями Azure Databricks".

Тип FILE представляет собой неструктурированные файлы, такие как документы, изображения и аудио. Встроенные SQL-функции создают, копируют и читают файлы как FILE ссылки.

На этой странице эти функции приведены примеры для распространённых операций, таких как:

  • Перечисление файлов в томе каталога Unity как FILE ссылки с list_files.
  • Чтение метаданных файлов, таких size как и checksum (используемые для идентификации версии файла).
  • Фильтрация файлов по метаданным.
  • Разбор содержимого документа с ai_parse_documentпомощью .

Для справочника типа см.FILE тип.

Для концептуального обзора см. тип FILE и неструктурированные данные.

Требования

  • В этих примерах используется samples.sec.contracts набор данных — коллекция PDF-файлов контрактов, поданных SEC, доступных по умолчанию во всех рабочих пространствах. Чтобы использовать свои файлы, укажите путь на том Unity Catalog, который их содержит.

Examples

Файлы списка и ссылки на захват

Чтобы перечислить файлы по пути и сохранить FILE ссылки в таблице, используйте list_files функцию table-value:

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

Метаданные чтения файла

Чтобы прочитать uri, size, content_type, и checksum поля FILE значения, используйте точечную нотацию:

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

Фильтр файлов по метаданным

Для фильтрации строк с помощью метаданных файла, таких как путь и размер:

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

Разбор содержимого документа

Чтобы извлечь структурированное содержимое из документа, передайте FILE значение функцииai_parse_document:

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

Пример записной книжки

Следующий блокнот запускает все предыдущие примеры с набором samples.sec.contracts данных:

Функции FILE Quickstart notebook

Получите ноутбук

Дальнейшие действия