.rename table 명령

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

기존 테이블의 이름을 변경합니다.

이 .rename tables 명령은 데이터베이스에 있는 여러 테이블의 이름을 단일 트랜잭션으로 변경합니다.

사용 권한

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

구문

.renametable OldName to NewName

.renametables NewName = OldName [ifexists] [, ...]

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

매개 변수

설명

이 명령은 범위의 데이터베이스 테이블에서만 작동합니다.

이 명령은 새 테이블을 만들지 않으며 기존 테이블을 제거하지도 않습니다. 명령에서 설명하는 변환은 데이터베이스의 테이블 수가 변경되지 않도록 해야 합니다.

이 명령은 위의 규칙을 준수하는 한 테이블 이름 또는 더 복잡한 순열 교환을 지원합니다. 예를 들어 데이터를 여러 스테이징 테이블로 수집한 다음 단일 트랜잭션의 기존 테이블로 교환합니다.

예제

다음 테이블ABCA_TEMP이 있는 데이터베이스를 상상해 보세요. 다음 명령은 바꿔 A 서 A_TEMP (이제 테이블이 A_TEMP 호출 A되도록, 그 반대로) 이름을 바꾸고 B NEWB있는 그대로 유지 C 합니다.

.rename tables A=A_TEMP, NEWB=B, A_TEMP=A

명령 시퀀스는 다음과 같습니다.

1. 새 임시 테이블을 만듭니다.
2. 기존 또는 존재하지 않는 테이블을 새 테이블로 바꿉니다.

// Drop the temporary table if it exists
.drop table TempTable ifexists

// Create a new table
.set TempTable <| ...

// Swap the two tables
.rename tables TempTable=Table ifexists, Table=TempTable

// Drop the temporary table (which used to be Table) if it exists
.drop table TempTable ifexists

구체화된 뷰의 원본 테이블 이름 바꾸기

이름을 바꿀 테이블이 구체화된 뷰의 원본 테이블인 경우 명령의 .rename 일부로 다음 속성을 지정할 수 있습니다.

.renametable OldName to NewName with (updateMaterializedViews=true)

테이블의 이름이 바뀌고 OldName을 참조하는 구체화된 모든 뷰가 트랜잭션 방식으로 NewName을 가리키도록 업데이트됩니다.