다음을 통해 공유

.alter-merge table 명령

  • 아티클

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

.alter-merge table 명령은 다음을 수행합니다.

  • 기존 열의 데이터 보호
  • 기존 테이블에 새 열 docstring및 폴더 추가
  • 테이블 이름의 범위를 지정하는 특정 데이터베이스의 컨텍스트에서 실행해야 합니다.

사용 권한

이 명령을 실행하려면 테이블 관리자 이상의 권한이 있어야 합니다.

구문

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

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

매개 변수

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

참고 항목

열 형식을 변경하려고 하면 명령이 실패합니다. 대신 .alter column를 사용하세요.

팁

기존 열 스키마를 변경하기 전에 가져오는 데 사용합니다 .show table [tableName] cslschema .

지원되는 속성

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

명령이 데이터에 미치는 영향

  • 기존 데이터는 수정 또는 삭제되지 않습니다.
  • 스키마 끝에 새 열이 추가됩니다.
  • 새 열의 데이터는 null로 간주됩니다.

예제

.alter-merge table MyTable (ColumnX:string, ColumnY:int) 
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")

관련 콘텐츠

테이블 설정을 추가로 재정의 .alter 하려면 테이블 명령을 사용합니다. 자세한 내용은 .alter 테이블을 참조 하세요.