.replace extents 명령

이 명령은 특정 데이터베이스의 컨텍스트에서 실행됩니다. 원본 테이블에서 대상 테이블로 지정된 익스텐트 이동한 다음 대상 테이블에서 지정된 익스텐트 삭제합니다. 모든 삭제 및 이동 작업은 단일 트랜잭션에서 수행됩니다.

참고 항목

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

사용 권한

원본 및 대상 테이블에 대한 테이블 관리자 권한 이상이 있어야 합니다.

제한 사항

• 원본 테이블과 대상 테이블은 모두 컨텍스트 데이터베이스에 있어야 합니다.
• ExtentsToDropQuery에 지정된 모든 익스텐트에서 대상 테이블에 속해야 합니다.
• 원본 테이블의 모든 열은 이름과 데이터 형식이 같은 대상 테이블에 존재해야 합니다.
• 대상 테이블이 구체화된 뷰의 원본 테이블인 경우 구체화된 뷰가 이동된 익스텐트의 레코드를 처리하지 않으므로 명령이 실패할 수 있습니다. 구체화된 뷰 제한 사항 페이지에서 자세한 내용을 참조하세요. 이동 명령 중에 새 수집 시간을 설정하여 이 오류를 해결할 수 있습니다. 지원되는 속성을 참조하세요.setNewIngestionTime

구문

.replace[async] extents in table DestinationTableName [ with (PropertyName = PropertyValue [, ...]] <|{)ExtentsToDropQuery},{ExtentsToMoveQuery}

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

매개 변수

이름	Type	필수	설명
async	string		지정된 경우 명령은 비동기적으로 실행됩니다.
DestinationTableName	string	✔️	익스텐트 이동을 위한 테이블의 이름입니다.
FromDate	datetime		쿼리 창 시작 날짜입니다.
ToDate	datetime		쿼리 창 종료 날짜입니다.
PropertyName, PropertyValue	string		하나 이상의 지원되는 속성입니다.
ExtentsToDropQuery	string	✔️	이 쿼리의 결과는 대상 테이블에서 삭제해야 하는 익스텐트 ID를 지정합니다. "ExtentId"라는 열이 있는 레코드 집합을 반환해야 합니다.
ExtentsToMoveQuery	string	✔️	이 KQL(Kusto 쿼리 언어) 쿼리의 결과는 원본 테이블과 대상 테이블로 이동할 ID 범위를 지정합니다. "ExtentId" 및 "TableName"이라는 열이 있는 레코드 집합을 반환해야 합니다.

지원되는 속성

Property name	Type	필수	설명
setNewIngestionTime	bool		이 값으로 true설정하면 새 수집 시간이 이동되는 범위의 모든 레코드에 할당됩니다. 이는 구체화된 뷰 및 연속 데이터 내보내기와 같이 데이터베이스 커서에 의존하는 워크로드에서 레코드를 처리해야 하는 경우에 유용합니다.
extentCreatedOnFrom	datetime	✔️	이 시점 이후에 만든 익스텐트에서 적용합니다.
extentCreatedOnTo	datetime	✔️	이 시점 이전에 만든 익스텐트에서 적용합니다.

참고 항목

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

반품

명령이 동기적으로 실행되면 다음 스키마가 있는 테이블이 반환됩니다.

출력 매개 변수	Type	설명
OriginalExtentId	string	대상 테이블로 이동된 원본 테이블의 원래 익스텐트 또는 삭제된 대상 테이블의 익스텐트에 대한 고유 식별자(GUID)입니다.
ResultExtentId	string	원본 테이블에서 대상 테이블로 이동된 결과 범위의 고유 식별자(GUID)입니다. 대상 테이블에서 익스텐트 삭제된 경우 비어 있습니다. 실패 시: "실패".
세부 정보	string	작업이 실패하는 경우 오류 세부 정보를 포함합니다.

명령이 비동기적으로 실행되면 작업 ID(GUID)가 반환됩니다. .show operations 명령을 사용하여 작업의 상태를 모니터링하고 .show 작업 세부 정보 명령을 사용하여 성공적인 실행 결과를 검색합니다.

참고 항목

ExtentsToDropQuery 쿼리에서 반환된 익스텐스가 대상 테이블에 없으면 명령이 실패합니다. 이 문제는 replace 명령이 실행되기 전에 익스텐트 병합된 경우에 발생할 수 있습니다. 누락된 익스텐트에서 명령이 실패하는지 확인하려면 쿼리가 예상된 ExtentId를 반환하는지 확인합니다. 테이블 MyOtherTable에 삭제 범위가 없 으면 아래의 예제 #1이 실패합니다. 그러나 삭제할 쿼리가 익스텐트 ID를 반환하지 않았기 때문에 삭제 범위가 없더라도 예제 #2는 성공합니다.

예제

지정된 생성 시간 범위의 모든 익스텐트를 두 테이블에서 이동

지정된 생성 시간 범위의 두 특정 테이블(MyTable1, MyTable2)에서 테이블MyOtherTable로 모든 익스텐트를 이동하고 태그가 지정된 모든 익스텐트를 다음과 같이 drop-by:MyTag삭제합니다MyOtherTable.

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        .show table MyOtherTable extents where tags has 'drop-by:MyTag'
    },
    {
        .show tables (MyTable1,MyTable2) extents
    }

샘플 출력

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

지정한 생성 시간 범위의 모든 익스텐트를 한 테이블에서 다른 테이블로 이동하고 특정 익스텐트를 삭제합니다.

지정된 생성 시간 범위의 모든 익스텐트를 특정 테이블(MyTable1)에서 테이블 MyOtherTable로 이동하고 ID에 따라 특정 익스텐 MyOtherTable트를 삭제합니다.

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        print ExtentId = "2cca5844-8f0d-454e-bdad-299e978be5df"
    },
    {
        .show table MyTable1 extents 
    }

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        .show table MyOtherTable extents
        | where ExtentId == guid(2cca5844-8f0d-454e-bdad-299e978be5df) 
    },
    {
        .show table MyTable1 extents 
    }

idempotent 논리 구현

테이블에서 테이블로 이동할 t_source t_dest범위가 있는 경우에만 Kusto가 테이블에서 t_dest 익스텐트를 삭제하도록 idempotent 논리를 구현합니다.

.replace async extents in table t_dest with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
{
    let any_extents_to_move = toscalar( 
        t_source
        | where extent_tags() has 'drop-by:blue'
        | summarize count() > 0
    );
    let extents_to_drop =
        t_dest
        | where any_extents_to_move and extent_tags() has 'drop-by:blue'
        | summarize by ExtentId = extent_id()
    ;
    extents_to_drop
},
{
    let extents_to_move = 
        t_source
        | where extent_tags() has 'drop-by:blue'
        | summarize by ExtentId = extent_id(), TableName = 't_source'
    ;
    extents_to_move
}