외부 데이터 통합

• 5분

Externaldata 연산자는 해당 스키마가 쿼리 자체에 정의되어 있고 Azure Blob Storage의 BLOB 또는 Azure Data Lake Storage 파일 등의 외부 스토리지 아티팩트에서 데이터를 읽는 테이블을 반환합니다.

구문

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

인수

• ColumnName, ColumnType: 인수는 테이블의 스키마를 정의합니다. 구문은 create table에서 테이블을 정의할 때 사용되는 구문과 같습니다.

• StorageConnectionString: 반환할 데이터를 포함한 스토리지 아티팩트를 기술하는 스토리지 연결 문자열입니다.

• PropertyName, PropertyValue, ...: 수집 속성에 나열된 것과 같이, 스토리지에서 검색된 데이터를 해석하는 방법을 설명하는 추가 속성입니다.

현재 지원되는 속성은 다음과 같습니다.

인수

속성	Type	설명
format	문자열	데이터 형식 데이터 형식이 지정되지 않은 경우, 파일 확장자를 기반으로 데이터 형식을 감지합니다(기본값은 CSV). 모든 수집 데이터 형식이 지원됩니다.
ignoreFirstRecord	bool	True로 설정하면 모든 파일의 첫 번째 레코드를 무시합니다. 해당 속성은 헤더를 사용하여 CSV 파일을 쿼리할 때 유용합니다.
ingestionMapping	문자열	원본 파일의 데이터를 연산자 결과 집합의 실제 열에 매핑하는 방법을 나타내는 문자열 값입니다. 데이터 매핑을 참조하세요.

반환

Externaldata 연산자는 스토리지 연결 문자열로 나타내는 특정 스토리지 아티팩트에서 구문 분석된 데이터를 사용하여 지정된 스키마의 데이터 테이블을 반환합니다.

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