다음을 통해 공유


.create table 명령

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

빈 테이블을 새로 만듭니다.

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

사용 권한

이 명령을 실행하려면 데이터베이스 사용자 이상의 권한이 있어야 합니다.

구문

.createtable tableName( columnName:columnType [, ...]) [with( propertyName = propertyValue [, ...]])

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

매개 변수

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

지원되는 속성

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

참고 항목

동일한(대/소문자 구분) 이름의 테이블이 데이터베이스 컨텍스트에 이미 있는 경우 명령은 다음 시나리오에서도 기존 테이블을 변경하지 않고 성공을 반환합니다.

  • 지정된 스키마가 기존 테이블의 스키마와 일치하지 않습니다.
  • folder 또는 docstring 매개 변수는 테이블에 설정된 값과 다른 값으로 지정됩니다.

예시

.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 ) 

출력

다음과 같은 JSON 형식으로 테이블의 스키마를 반환합니다.

.show table MyLogs schema as json

참고 항목

여러 테이블을 만들려면 성능을 향상시키고 데이터 로드를 .create tables 낮추려면 이 명령을 사용합니다.