Integrare dati esterni

  • 5 minuti

L'operatore externaldata restituisce una tabella il cui schema è definito nella query stessa e i cui dati vengono letti da un artefatto di archiviazione esterna, ad esempio un BLOB in Archiviazione BLOB di Azure o un file di Azure Data Lake Storage.

Sintassi

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

Argomenti

  • ColumnName, ColumnType: gli argomenti definiscono lo schema della tabella. La sintassi è identica a quella usata per la definizione di una tabella in .create table.

  • StorageConnectionString: stringhe di connessione per l'archiviazione che descrivono gli elementi di archiviazione contenenti dati da restituire.

  • PropertyName, PropertyValue, ...: altre proprietà che descrivono come interpretare i dati recuperati dall'archiviazione, come elencato nelle proprietà di inserimento.

Attualmente, le proprietà supportate sono:

ARGOMENTI

Proprietà Type Descrizione
format string Formato dati. Se non è specificato, viene effettuato un tentativo di rilevare il formato dati dall'estensione di file, il valore predefinito è CSV. Sono supportati tutti i formati dati di inserimento.
ignoreFirstRecord bool Se impostato su true, indica che il primo record di ogni file viene ignorato. Questa proprietà è utile quando si eseguono query sui file CSV con intestazioni.
ingestionMapping string Valore stringa che indica come eseguire il mapping dei dati dal file di origine alle colonne effettive nel set di risultati dell'operatore. Vedere Mapping dei dati.

Valori restituiti

L'operatore externaldata restituisce una tabella dati dello schema specificato con i dati analizzati dall'artefatto di archiviazione specificato, indicati dalla stringa di connessione per l'archiviazione.

Nota

L'esempio non è disponibile nell'ambiente demo.

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