FILE-Funktionen Quickstart

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

Der Typ FILE steht für unstrukturierte Dateien wie Dokumente, Bilder und Audio. Eingebaute SQL-Funktionen erstellen, kopieren und lesen Dateien als FILE Referenzen.

Diese Seite fasst diese Funktionen mit Referenzbeispielen für gängige Operationen zusammen, wie zum Beispiel:

  • Listen von Dateien in einem Unity-Katalog-Band als FILE Referenzen mit list_files.
  • Lesen von Dateimetadaten, wie size und checksum (zur Identifikation der Dateiversion).
  • Dateien nach ihren Metadaten filtern.
  • Dokumentinhalt mit Parsen .ai_parse_document

Für die Typreferenz siehe FILE Typ.

Für einen konzeptionellen Überblick siehe DATEITYP und unstrukturierte Daten.

Anforderungen

  • Diese Beispiele verwenden den samples.sec.contracts Datensatz, eine Sammlung von von SEC eingereichten Vertrags-PDFs, die standardmäßig in allen Arbeitsbereichen verfügbar sind. Um eigene Dateien zu verwenden, zeigen Sie den Pfad auf ein Unity-Katalog-Volume, das sie enthält.

Examples

Listendateien und Erfassungsreferenzen

Um die Dateien auf einem Pfad aufzulisten und die FILE Referenzen in einer Tabelle zu speichern, verwenden list_files Sie die table-valued function:

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

Lesedatei-Metadaten

Um das uri, size, content_type, und checksum die Felder eines FILE Wertes auszulesen, verwenden Sie die Punktnotation:

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

Dateien nach Metadaten filtern

Um Zeilen mit Dateimetadaten wie Pfad und Größe zu filtern:

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

Dokumentinhalt parsen

Um strukturierte Inhalte aus einem Dokument zu extrahieren, übergeben Sie einen FILE Wert an ai_parse_document Funktion:

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

Beispiel-Notebook

Das folgende Notizbuch führt alle vorherigen Beispiele mit dem samples.sec.contracts Datensatz aus:

FILE-Funktionen Quickstart-Notizbuch

Notebook abrufen

Nächste Schritte