.alter-merge 테이블 정책 미러링 명령
적용 대상: ✅Microsoft Fabric
테이블의 미러링 정책을 변경합니다. 미러링 정책은 델타 parquet 형식으로 데이터베이스에 테이블의 논리적 복사본을 만들고 쿼리 속도를 향상시키기 위해 파일을 분할할 수 있습니다. 각 파티션은 파티션 목록에 나열된 PartitionName을 사용하여 별도의 열로 표시됩니다. 즉, 대상에 원본 테이블보다 더 많은 열이 있습니다.
구문
(.alter | .alter-merge) table TableName policy mirroring [partition by (Partitions)] dataformat = parquet
[with (IsEnabled=IsEnabledValue)]
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| TableName | string | ✔️ | 엔터티 이름 규칙을 준수하는 테이블 이름 입니다. |
| 파티션 | string | 데이터를 더 작은 파티션으로 나누는 데 사용되는 열의 쉼표로 구분된 목록입니다. 파티션 서식을 참조 하세요. |
파티션 서식 지정
파티션 목록은 다음 표에 표시된 양식 중 하나를 사용하여 지정된 파티션 열의 조합입니다.
| 파티션 유형 | 구문 | 주의 |
|---|---|---|
| 가상 열 | PartitionName : (datetime | string) |
가상 열에 대해 자세히 읽어보세요. |
| 문자열 열 값 | PartitionName = : string ColumnName |
|
| 문자열 열 값 hash() | PartitionName hash(long = : ColumnName 번호, ) |
해시는 모듈로 번호입니다. |
| 잘린 날짜/시간 열(값) | PartitionName datetime : = (startofyearstartofweek | | | startofdaystartofmonth) ( ColumnName ) |
startofyear, startofmonth, startofweek 또는 startofday 함수에 대한 설명서를 참조하세요. |
잘린 날짜/시간 열 값 = bin ( ColumnName , TimeSpan ) |
bin 함수에 대해 자세히 알아보세요. |
참고 항목
각 파티션은 파티션 목록에 나열된 PartitionName을 사용하여 별도의 열로 표시됩니다. PartitionName 은 다른 파티션 이름과 미러된 테이블의 열 이름 중에서 대/소문자를 구분하지 않는 고유 문자열이어야 합니다.
속성
| 속성 | 형식 | 설명 |
|---|---|---|
IsEnabled |
bool |
미러링 정책이 사용되는지 여부를 결정하는 부울 값입니다. 기본값은 true입니다. 미러링 정책을 사용하지 않도록 설정하고 설정 false하면 기본 미러링 데이터가 일시 삭제되고 데이터베이스에 유지됩니다. |
참고 항목
미러링 정책을 사용하도록 설정하면 테이블 이름을 바꿀 수 없습니다.
예제
.alter 테이블 정책 미러링
다음 예제에서는 myTable이라는 테이블이 미러됩니다. 데이터는 먼저 이름으로 분할된 다음 날짜별로 분할됩니다.
.alter table myTable policy mirroring
partition by (Name: string=Name, Date: datetime= startofday(timestamp))
dataformat=parquet
with
(IsEnabled=true)