Integrar dados externos

  • 5 minutos

O operador externaldata retorna uma tabela cujo esquema é definido na própria consulta. E cujos dados são lidos de um artefato de armazenamento externo, como um blob no Armazenamento de Blobs do Azure ou um arquivo de Armazenamento do Azure Data Lake.

Sintaxe

 externaldata ( ColumnName : ColumnType [, ...] )
  [ StorageConnectionString [, ...] ]
  [with ( PropertyName = PropertyValue [, ...] )]

Argumentos

  • ColumnName, ColumnType: Os argumentos definem o esquema da tabela. A sintaxe é a mesma usada ao definir uma tabela. criar tabela.

  • StorageConnectionString: cadeias de conexão de armazenamento que descrevem os artefatos de armazenamento que contêm os dados a serem retornados.

  • PropertyName, PropertyValue, ...: Mais propriedades que descrevem como interpretar os dados recuperados do armazenamento, conforme listado em propriedades de ingestão.

Atualmente, as propriedades suportadas são:

ARGUMENTOS

Propriedade Type Description
format string Formato de dados. Se não for especificado, é feita uma tentativa para detetar o formato de dados da extensão de arquivo (padrão para CSV). Qualquer um dos formatos de dados de ingestão são suportados.
ignoreFirstRecord booleano Se definido como true, indica que o primeiro registro em cada arquivo é ignorado. Essa propriedade é útil ao consultar arquivos CSV com cabeçalhos.
ingestãoMapeamento string Um valor de cadeia de caracteres que indica como mapear dados do arquivo de origem para as colunas reais no conjunto de resultados do operador. Veja mapeamentos de dados.

Devolve

O operador externaldata retorna uma tabela de dados do esquema fornecido com dados analisados a partir do artefato de armazenamento especificado, indicado pela cadeia de conexão de armazenamento.

Nota

Este exemplo não está disponível no ambiente de demonstração.

Users
| where UserID in ((externaldata (UserID:string) [
    @"https://storageaccount.blob.core.windows.net/storagecontainer/users.txt" 
      h@"?...SAS..." // Secret token needed to access the blob
    ]))
| ...