Funzione FILE quickstart

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Il FILE tipo rappresenta file non strutturati come documenti, immagini e audio. Le funzioni SQL integrate creano, copiano e leggono file come FILE riferimenti.

Questa pagina riassume queste funzioni con esempi di riferimento per operazioni comuni, come:

  • Elencare i file in un volume del Catalogo Unity come FILE riferimenti con list_files.
  • Lettura dei metadati del file, come size e checksum (usati per identificare la versione del file).
  • Filtrare i file in base ai loro metadati.
  • Analisi del contenuto del documento con ai_parse_document.

Per il riferimento tipografico, vedi FILE tipo.

Per una panoramica concettuale, vedi FILE type e dati non strutturati.

Requisiti

  • Questi esempi utilizzano il samples.sec.contracts dataset, una raccolta di PDF contrattuali depositati dalla SEC disponibili di default in tutti gli spazi di lavoro. Per usare i tuoi file, punta il percorso a un volume del Catalogo Unity che li contiene.

Examples

File elenco e riferimenti di cattura

Per elencare i file su un percorso e salvare i FILE riferimenti in una tabella, usa list_files la funzione a valori di tabella:

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

Lettura dei metadati del file

Per leggere i uri, size, content_type, e checksum i campi di un FILE valore, si usa la notazione a punto:

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

Filtra i file per metadati

Per filtrare le righe usando i metadati del file, come percorso e dimensione:

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

Analizzate il contenuto dei documenti

Per estrarre contenuti strutturati da un documento, passa un FILE valore alla ai_parse_document funzione:

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

Notebook di esempio

Il seguente quaderno esegue tutti gli esempi precedenti sul samples.sec.contracts dataset:

Funzioni FILE quaderno di avvio rapido

Ottieni il notebook

Passaggi successivi

  • Last updated on