다음을 통해 공유


.create-merge table 명령

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

새 테이블을 만들거나 기존 테이블을 확장합니다.

명령은 특정 데이터베이스의 컨텍스트에서 실행되어야 합니다.

사용 권한

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

구문

.create-mergetable tableName( columnName:columnType [, ...]) [with( propertyName = propertyValue [, ...]])

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

매개 변수

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

지원되는 속성

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

반품

테이블이 없으면 명령으로 .create table 정확하게 작동합니다.

T 테이블이 있고 명령을 보내는 경우 다음을 .create-merge table T (<columns specification>) 수행합니다.

  • 이전에 T에 <존재하지 않았던 열 사양> 의 열은 T 스키마의 끝에 추가됩니다.
  • 열 사양>에 없는 <T의 모든 열은 T에서 제거되지 않습니다.
  • 열 사양>의 <모든 열은 T에 있지만 데이터 형식이 다르면 명령이 실패합니다.