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 do Azure Data Lake Storage.

Sintaxe

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

Argumentos

  • ColumnName, ColumnType: os argumentos definem o esquema da tabela. A sintaxe é igual à usada na definição de uma tabela em create table.

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

  • PropertyName, PropertyValue, …: propriedades adicionais que descrevem como interpretar os dados recuperados no armazenamento, conforme listado nas propriedades de ingestão.

Atualmente, as propriedades suportadas são:

ARGUMENTOS

Propriedade Type Descrição
format string Formato dos dados. Se não for especificado, será feita uma tentativa de detectar o formato dos dados pela extensão do arquivo (o padrão é CSV). Todos os formatos de ingestão de dados são suportados.
ignoreFirstRecord bool Se definido como true, indica que o primeiro registro de cada arquivo será ignorado. Essa propriedade é útil na consulta a arquivos CSV com cabeçalhos.
ingestionMapping string Um valor de cadeia de caracteres que indica como mapear dados do arquivo de origem para as colunas reais do conjunto de resultados do operador. Confira os mapeamentos de dados.

Retornos

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

Observação

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
    ]))
| ...