.create table based-on 명령

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

기존 테이블을 기반으로 빈 테이블을 새로 만듭니다. 이 명령은 특정 데이터베이스의 컨텍스트에서 실행되어야 합니다.

참고 항목

원본 테이블의 모든 속성은 다음 예외를 제외하고 새 테이블에 복사됩니다.

• 업데이트 정책
• 권한 있는 보안 주체: 명령을 사용하는 .create table based-on 경우 현재 보안 주체가 테이블 관리자에게 추가됩니다.

사용 권한

이 명령을 실행하려면 데이터베이스 관리자 권한이 있어야 합니다.

구문

.createtableName based-on otherTable [ifnotexists] [with (propertyName = propertyValue [, ...]])table

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

매개 변수

이름	Type	필수	설명
ifnotexists	string		지정한 경우 테이블이 아직 없는 경우에만 만들어집니다.
tableName	string	✔️	만들 테이블의 이름입니다. 대/소문자 구분 이름은 데이터베이스에서 고유해야 합니다.
otherTable	string	✔️	만들려는 테이블의 열, 문서 문자열 및 폴더의 원본으로 사용할 기존 테이블의 이름입니다.
propertyName, propertyValue	string		키-값 속성 쌍의 쉼표로 구분된 목록입니다. 지원되는 속성을 참조하세요.

지원되는 속성

속성	형식	설명
docstring	string	추가할 엔터티를 설명하는 무료 텍스트입니다. 이 문자열은 엔터티 이름 옆에 있는 다양한 UX 설정에 표시됩니다. 기본값은 tableName을 기반으로< 생성됩니다>.
folder	string	테이블을 추가할 폴더의 이름입니다. 기본값은 tableName과 동일한 폴더입니다.

반품

이 명령은 다음 명령을 실행하는 것과 유사하게 JSON 형식으로 새 테이블의 스키마를 반환합니다.

.show table MyLogs schema as json

참고 항목

• 테이블이 이미 있는 경우:
  • 플래그를 지정하면 ifnotexists 명령이 무시됩니다(변경 내용이 적용되지 않음).
  • 플래그를 지정하지 않으면 ifnotexists 오류가 반환됩니다.

예제

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")