Funções FILE quickstart

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

O FILE tipo representa ficheiros não estruturados, como documentos, imagens e áudio. As funções SQL incorporadas criam, copiam e leem ficheiros como FILE referências.

Esta página resume estas funções com exemplos de referência para operações comuns, tais como:

  • Listar ficheiros num volume do Unity Catalog como FILE referências com list_files.
  • Ler metadados de ficheiros, como size e checksum (usados para identificar a versão do ficheiro).
  • Filtrar ficheiros pelos seus metadados.
  • Análise do conteúdo do documento com ai_parse_document.

Para a referência tipográfica, veja FILE tipo.

Para uma visão conceptual, veja Tipo de ficheiro e dados não estruturados.

Requisitos

  • Estes exemplos utilizam o samples.sec.contracts conjunto de dados, uma coleção de PDFs de contratos arquivados pela SEC disponíveis por defeito em todos os espaços de trabalho. Para usar os seus próprios ficheiros, aponte o caminho para um volume do Unity Catalog que os contenha.

Examples

Ficheiros de lista e referências de captura

Para listar os ficheiros num caminho e guardar as FILE referências numa tabela, use list_files a função de valor de tabela:

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

Metadados de ficheiros de leitura

Para ler os uri, size, content_type, e checksum os campos de um FILE valor, use a notação dos pontos:

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

Filtrar ficheiros por metadados

Para filtrar linhas usando metadados de ficheiros, como caminho e tamanho:

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

Análise do conteúdo do documento

Para extrair conteúdo estruturado de um documento, passe um FILE valor para ai_parse_document a função:

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

Bloco de notas de exemplo

O caderno seguinte executa todos os exemplos anteriores contra o samples.sec.contracts conjunto de dados:

Funções FILE bloco de notas rápidas

Obter caderno

Passos seguintes

  • Last updated on