다음을 통해 공유


.create-merge tables 명령

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer

특정 데이터베이스의 컨텍스트에서 단일 대량 작업으로 기존 테이블의 스키마를 만들고 확장할 수 있습니다.

사용 권한

이 명령을 사용하려면 데이터베이스 사용자 권한과 기존 테이블을 확장하기 위한 테이블 관리자 권한이 필요합니다.

구문

.create-mergetables tableName1( columnName:columnType [, ...]) [, tableName2 (columnName:columnType [, ...]) ... ] [with (propertyName propertyValue = [, ...]])

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름 Type 필수 설명
tableName string ✔️ 만들거나 확장할 테이블의 이름입니다.
columnName, columnType string ✔️ 해당 열의 데이터 형식에 매핑된 기존 열 또는 새 열의 이름입니다. 매핑 목록은 출력 열 스키마를 정의합니다.
propertyName, propertyValue string 키-값 속성 쌍의 쉼표로 구분된 목록입니다. 지원되는 속성을 참조하세요.

지원되는 속성

속성 형식 설명
docstring string 추가할 엔터티를 설명하는 무료 텍스트입니다. 이 문자열은 엔터티 이름 옆에 있는 다양한 UX 설정에 표시됩니다.
folder string 테이블에 추가할 폴더의 이름입니다.

반품

  • 존재하지 않는 지정된 테이블이 만들어집니다.
  • 이미 존재하는 지정된 테이블에는 해당 스키마가 확장됩니다.
    • 존재하지 않는 열은 기존 테이블의 스키마 끝에 추가됩니다.
    • 명령에 지정되지 않은 기존 열은 기존 테이블의 스키마에서 제거되지 않습니다.
    • 명령의 데이터 형식으로 지정된 기존 열이 기존 테이블의 스키마에 있는 열과 다른 경우 오류가 발생합니다. 테이블이 만들어지지 않습니다.

예시

.create-merge tables 
  MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
  MyUsers (UserId:string, Name:string)

출력

tableName DatabaseName 폴더 DocString
MyLogs TopComparison
MyUsers TopComparison