Integracja danych zewnętrznych

Ukończone

Operator externaldata zwraca tabelę, której schemat jest zdefiniowany w samym zapytaniu. Dane są odczytywane z zewnętrznego artefaktu magazynu, takiego jak obiekt blob w usłudze Azure Blob Storage lub plik usługi Azure Data Lake Storage.

Składnia

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

Argumenty

  • ColumnName, ColumnType: argumenty definiują schemat tabeli. Składnia jest taka sama jak składnia używana podczas definiowania tabeli w. utwórz tabelę.

  • Storage Połączenie ionString: parametry połączenia magazynu, które opisują artefakty magazynu przechowujące dane do zwrócenia.

  • PropertyName, PropertyValue, ...: Więcej właściwości opisujących sposób interpretowania danych pobranych z magazynu, jak wymieniono we właściwościach pozyskiwania.

Obecnie obsługiwane właściwości to:

ARGUMENTY

Właściwość Type Opis
format string Format danych. Jeśli nie zostanie określony, zostanie podjęta próba wykrycia formatu danych z rozszerzenia pliku (wartość domyślna to CSV). Obsługiwane są dowolne formaty danych pozyskiwania.
ignoreFirstRecord bool Jeśli ustawiono wartość true, oznacza, że pierwszy rekord w każdym pliku jest ignorowany. Ta właściwość jest przydatna podczas wykonywania zapytań dotyczących plików CSV z nagłówkami.
ingestionMapping string Wartość ciągu wskazująca sposób mapowania danych z pliku źródłowego na rzeczywiste kolumny w zestawie wyników operatora. Zobacz mapowania danych.

Powroty

Operator externaldata zwraca tabelę danych danego schematu z danymi przeanalizowanymi z określonego artefaktu magazynu wskazanego przez parametry połączenia magazynu.

Uwaga

Ten przykład nie jest dostępny w środowisku demonstracyjnym.

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