.alter column 명령
기존 테이블 열의 데이터 형식을 변경합니다.
Warning
열의 데이터 형식을 변경할 때 해당 열의 모든 기존 데이터는 이후 쿼리에서 null 값을 반환합니다.
사용 .alter column
후에는 다른 명령을 사용하여 열 형식을 이전 값으로 다시 변경하더라도 해당 데이터를 복구할 수 없습니다.
기존 데이터를 보존해야 하는 경우 데이터를 잃지 않고 열 형식을 변경하는 데 권장되는 절차를 참조하세요.
사용 권한
이 명령을 실행하려면 테이블 관리자 이상의 권한이 있어야 합니다.
구문
.alter
column
[DatabaseName.
] TableName .
ColumnName type
=
ColumnNewType
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
이름 | Type | 필수 | 설명 |
---|---|---|---|
DatabaseName | string |
테이블을 포함하는 데이터베이스의 이름입니다. | |
TableName | string |
✔️ | 변경할 열이 포함된 테이블의 이름입니다. |
ColumnName | string |
✔️ | 변경할 열의 이름입니다. |
ColumnNewType | string |
✔️ | 열의 새 데이터 형식 입니다. |
예시
.alter column ['Table'].['ColumnX'] type=string
데이터 손실 없이 열 형식 변경
기록 데이터를 유지하면서 열 형식을 변경하려면 올바르게 입력된 새 테이블을 만듭니다.
열 형식을 변경하려는 각 테이블에 T1
대해 다음 단계를 실행합니다.
올바른 스키마(올바른 열 형식 및 동일한 열 순서)를 사용하여 테이블을
T1_prime
만듭니다.필요한 데이터 변환을 적용하여 데이터를
T1_prime
T1
수집합니다. 아래 예제에서 Col1은 문자열 데이터 형식으로 변환됩니다..set-or-append T1_prime <| T1 | extend Col1=tostring(Col1)
테이블 이름을 교환할 수 있는 .rename tables 명령을 사용하여 테이블을 교환합니다.
.rename tables T_prime=T1, T1=T_prime
명령이 완료되면 기존 수집 파이프라인의 새 데이터가 해당 파이프라인으로
T1
흐릅니다.테이블 삭제
T1_prime
T1_prime
는 스키마가 변경되기 전에 기록 데이터의 복사본만 포함하며 스키마 및 데이터가T1
올바르게 업데이트되었는지 확인한 후 안전하게 삭제할 수 있습니다..drop table T1_prime
예시:
테이블 T1
의 열 "Col1" 데이터 형식을 guid에서 문자열로 변경합니다.
// Create table T1
.create table T1 (Col1:guid, Id:int)
// Ingest sample data into T1
.ingest inline into table T1 <|
b642dec0-1040-4eac-84df-a75cfeba7aa4,1
c224488c-ad42-4e6c-bc55-ae10858af58d,2
99784a64-91ad-4897-ae0e-9d44bed8eda0,3
d8857a93-2728-4bcb-be1d-1a2cd35386a7,4
b1ddcfcc-388c-46a2-91d4-5e70aead098c,5
// Create table T1_prime with the correct schema and same column order
.create table T1_prime (Col1:string, Id:int)
// Append data to the new table
.set-or-append T1_prime <| T1 | extend Col1=tostring(Col1)
// Rename tables
.rename tables T1_prime = T1, T1 = T1_prime
// Drop table T1_prime, which now has the old schema and data
.drop table T1_prime
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기