.drop 테이블 익스텐트 태그

테이블의 전체 또는 특정 익스텐트에서 특정 익스텐트 태그 를 삭제합니다. 명령은 특정 데이터베이스의 컨텍스트에서 실행됩니다.

참고

데이터 분할된 데이터베이스를 익스텐트라고 하며 모든 명령은 동의어로 "익스텐트" 또는 "익스텐트"를 사용합니다. 익스텐트 에 대한 자세한 내용은 익스텐트(데이터 분할된 데이터베이스) 개요를 참조하세요.

어떤 익스텐트에서 제거할 태그를 지정하는 방법에는 두 가지가 있습니다.

• 지정한 테이블의 모든 익스텐트에서 제거해야 하는 태그를 명시적으로 지정합니다.
• 결과가 테이블의 익스텐트 ID를 지정하고 각 익스텐트(제거해야 하는 태그)를 지정하는 쿼리를 제공합니다.

사용 권한

관련된 모든 원본 및 대상 테이블에 대해 테이블 관리 이상의 권한이 있어야 합니다.

Syntax

.drop [async] tableTableNameextenttags(태그 [, ...])with(extentCreatedOnFrom=FromDate,extentCreatedOnTo=ToDate)

.drop[async] tableTableNameextentextentCreatedOnFromtags(=withFromDate,=extentCreatedOnToToDate)<|쿼리

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

매개 변수

이름	형식	필수	Description
async	string		지정된 경우 작업은 비동기적으로 실행됩니다.
TableName	string	✔️	익스텐트 태그를 삭제할 테이블의 이름입니다.
Tag	string	✔️	삭제할 익스텐트 태그의 이름입니다.
FromDate	datetime		시작 날짜 범위입니다.
ToDate	datetime		종료 날짜 범위입니다.
쿼리	string	✔️	삭제할 익스텐트 태그를 반환하는 KQL(Kusto 쿼리 언어) 쿼리입니다. 쿼리를 사용하여 익스텐트 지정을 참조하세요.

참고

성능을 향상시키려면 및 extentCreatedOnTo 매개 변수를 가능한 가장 작은 범위로 설정합니다extentCreatedOnFrom.

제한

모든 익스텐트 는 컨텍스트 데이터베이스에 있어야 하며 동일한 테이블에 속해야 합니다.

반환

GUID(작업 ID)가 반환됩니다.

팁

• 작업의 상태 GUID를 사용하여 모니터링할 수 있습니다. .show operations 명령 사용
• .show operation details 명령을 사용하여 성공적인 실행 결과를 검색합니다.

쿼리를 사용하여 익스텐트 지정

삭제할 익스텐트 및 태그는 Kusto 쿼리를 사용하여 지정됩니다. "ExtentId"라는 열과 "Tags"라는 열이 있는 레코드 집합을 반환합니다.

참고

Kusto .NET 클라이언트 라이브러리를 사용하는 경우 다음 메서드는 필요한 명령을 생성합니다.

• CslCommandGenerator.GenerateExtentTagsDropByRegexCommand(string tableName, string regex)
• CslCommandGenerator.GenerateExtentTagsDropBySubstringCommand(string tableName, string substring)

반환 출력

출력 매개 변수	형식	Description
OriginalExtentId	string	태그가 수정된 원래 익스텐트용 GUID(고유 식별자)입니다. 익스텐트를 작업의 일부로 삭제합니다.
ResultExtentId	string	태그를 수정한 결과 익스텐트용 GUID(고유 식별자)입니다. 익스텐트를 만들고 작업의 일부로 추가합니다. 실패 시 - "실패".
ResultExtentTags	string	작업이 실패할 경우 결과 익스텐트에 태그가 지정된 태그 컬렉션(남아 있는 경우) 또는 "null"입니다.
세부 정보	string	작업이 실패할 경우 오류 세부 정보를 포함합니다.

예제

태그 하나 삭제

태그가 지정된 테이블의 drop-by:Partition000 모든 익스텐트에서 태그를 삭제합니다.

.drop extent tags from table MyOtherTable ('drop-by:Partition000')

여러 태그 삭제

다음 중 하나로 태그가 지정된 drop-by:20230312104500테이블의 모든 범위에서 , a random tag및 drop-by:20230312 태그를 삭제합니다.

.drop table [My Table] extent tags ('drop-by:20230312104500','a random tag','drop-by:20230312') with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12))

지정된 생성 시간 범위에서 모든 drop-by 태그 삭제

지정한 생성 시간 범위에서 테이블 MyTable 의 익스텐트에서 모든 drop-by 태그를 삭제합니다.

.drop table MyTable extent tags with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n') 
  | mv-expand Tags to typeof(string)
  | where Tags startswith 'drop-by'

특정 regex와 일치하는 모든 태그 삭제

테이블MyTable의 익스텐트에서 regex drop-by:StreamCreationTime_20160915(\d{6}) 와 일치하는 모든 태그를 삭제합니다.

.drop table MyTable extent tags with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <| 
  .show table MyTable extents 
  | where isnotempty(Tags)
  | extend Tags = split(Tags, '\r\n')
  | mv-expand Tags to typeof(string)
  | where Tags matches regex @"drop-by:StreamCreationTime_20160915(\d{6})"

샘플 출력

OriginalExtentId	ResultExtentId	ResultExtentTags	세부 정보
e133f050-a1e2-4dad-8552-1f5cf47cab69	0d96ab2d-9dd2-4d2c-a45e-b24c65aa6687	Partition001
cdbeb35b-87ea-499f-b545-defbae091b57	a90a303c-8a14-4207-8f35-d8ea94ca45be
4fcb4598-9a31-4614-903c-0c67c286da8c	97aafea1-59ff-4312-b06b-08f42187872f	Partition001 Partition002
2dfdef64-62a3-4950-a130-96b5b1083b5a	0fb7f3da-5e28-4f09-a000-e62eb41592df